聯(lián)通總部位置服務(wù)基礎(chǔ)業(yè)務(wù)平臺(tái)-GIS接口規(guī)范

Neusoft

聯(lián)通總部位置服務(wù)基礎(chǔ)業(yè)務(wù)平臺(tái)一

GIS接口規(guī)范

文檔編號(hào)：

版本：1.0

打印日期：July27,2013

拷貝份數(shù)：

Confidential

目標(biāo)：聯(lián)通總部位置服務(wù)基礎(chǔ)業(yè)務(wù)平臺(tái)一GIS接口規(guī)范

作者：東軟集團(tuán)股份有限公司

聯(lián)系人：彭紅剛

?1991-2004東軟集團(tuán)股份有限公司版權(quán)所有

目錄

4.GIS系統(tǒng)結(jié)構(gòu)11

42網(wǎng)自描:12

4.3.接口描述12

5.GIS接口協(xié)議13

5.1消息流程13

52服務(wù)類型13

533頭信息結(jié)構(gòu)78

5.3.4、、結(jié)毛代碼和錯(cuò)誤代碼27

因繪制請(qǐng)求(MPR)22

地理編碼應(yīng)答(GCA)37

1

Neusoft

5.8逆地理編碼(REVERSEGEOCODE)38

逆地理編碼請(qǐng)求(RGR)38

逆地理編碼應(yīng)答(RGA)38

5.9測(cè)算(COGO)39

測(cè)算請(qǐng)求(CGR)39

測(cè)算應(yīng)答(CGA)41

5.1()元數(shù)據(jù)(METADATA)42

元數(shù)據(jù)請(qǐng)求(MDR)42

元數(shù)據(jù)應(yīng)答(MDA)42

5.11公用元素的DTD45

GEOMETRY45

UOM(UnitofMeasure)49

ADT(AbstractDataType)50

UPDATE(GISUPDATEDATE)錯(cuò)誤!未定義書簽。

6.GIS接口協(xié)議DTD中的元素和屬性54

6.1頭信息結(jié)構(gòu)54

SESSIONID54

ServiceID55

GISID55

POIProviderlD55

6.2地圖繪制(MAPPING)56

Output56

Basemap60

Layer61

Style62

Name62

stylecontent62

Overlay63

6.3目錄服務(wù)(DIRECTORY)64

sortCriteria64

sortDirection64

POIProperties65

POIProperty66

POILocation67

Nearest67

Neusoft

WithinDistance68

MiniiniunDistance69

MaximiunDistance69

WithinBoundary70

POlContext70

MaxunutnResponses70

Bus77

BusLine72

Station74

AlongLine75

6.4路徑搜索(ROUTE)77

provideRouteHandle77

distanceUnit,77

RoutePlan78

RoutePreference79

BusRoutePreference79

WayPointList80

StartPoint81

ViaPoint82

EndPoint82

AvoidList83

AvoidFeature83

RouteInstructionRequest83

RouteGeometryRequest84

RouteMapRequest86

RouteMap87

RouteSummary87

TotalTime88

TotalDistance88

TotalCost88

BoundingBox89

RouteNavigationRequest89

RouteNavigation95

6.5地理藕碼(GEOCODE)96

GeocodeResponseList96

GeocodedAddress97

6.6逆地理編碼(REVERSEGEOCODE)97

Neusoft

ReverseGeocodePreference97

SearchArea98

ReverseGeocodedLocation98

SearchCentreDistance99

6.7測(cè)算(COGO)99

Reqcalculation99

PointToPointDistance100

PointlnGeometty101

Linebuffer102

ResCalculation103

Containment103

GeometryArea104

Geometry105

Area105

6.8元數(shù)據(jù)(METADATA)107

AvailableSRS107

AvailableLayers107

AvaiIableFormats108

AvailableStyles108

SRS109

Format109

VectorDatalnfo109

6.9公用元素DTD的屬性11()

pos110

Point112

LineString113

Polygon113

exterior114

interior114

LinearRing115

MultiPolygon115

polygonMember115

ArcByCenterPoint116

CircleByCenterPoint117

CircularArc118

startAngle118

Neusoft

endAngle119

Ellipse119

majorAxis120

minorAxis120

rotation120

boundedBy121

Envelope121

CompassPoint722

innerRadius122

OuterRadius123

Altitude123

Angle125

Distance126

Speed128

Time129

Timestamp131

6.10ADT132

AOI132

Map132

Content133

Data133

URL134

BBoxContext134

CenterContext134

DispalyScale136

DPI136

radius136

POI137

POIAttributeList139

POIInfoList140

POIInfo140

ReferenceSystem140

NamedReferenceSystern141

GIS141

Address142

freeFonnAddress144

StreetAddress144

Neusoft

Streetintersection144

Place145

PostalCode/46

Street146

IntersectingStreet146

Building147

Position148

Qop150

HorizontalAcc151

VerticalAcc151

Direction152

RouteGeometiy153

RouteHandle154

Neusoft

—?-

刖百

本標(biāo)準(zhǔn)為建設(shè)GIS平臺(tái)提供技術(shù)依據(jù)。

本標(biāo)準(zhǔn)包括的GIS平臺(tái)與定位管理平臺(tái)之間的接口要求和規(guī)定。

Neusoft

i.范圍

本規(guī)范規(guī)定了位置業(yè)務(wù)平臺(tái)和GIS平臺(tái)之間，以及SP與位置業(yè)務(wù)平臺(tái)之間涉及GIS訪問功能的接口協(xié)議。包括消息的類型和消息的元素的定義。

適用于GSM/GPRS/EDGE/TD-SCDMA網(wǎng)絡(luò)環(huán)境。

2.規(guī)范性引用文件

卜列文件中的條款通過本標(biāo)準(zhǔn)的引用而成為本標(biāo)準(zhǔn)的條款。凡是注日期的引用文件，其隨后所有的修改單（不包括勘誤的內(nèi)容）或修訂版均不適

用于本標(biāo)準(zhǔn)，然而，鼓勵(lì)根據(jù)本標(biāo)準(zhǔn)達(dá)成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本標(biāo)準(zhǔn)。

表2-1規(guī)范性引用文件

序號(hào)標(biāo)準(zhǔn)編號(hào)標(biāo)準(zhǔn)名稱發(fā)布單位

HypertextTransferProtocol-HTTP/1.1RFC2616,June1999

⑵ExtensibleMarkupLanguage(XML)1.0W3CRecommendation:REC-xml-20001006

3.術(shù)語、定義和縮略語

“必須”、“推薦”/“建議”、和“可選”等詞語在本標(biāo)準(zhǔn)中的使用需遵循以下指導(dǎo)。

-“必選”/“必須”項(xiàng)是指'業(yè)務(wù)、產(chǎn)品和設(shè)備所必須提供的功能或性能要求；對(duì)應(yīng)于RFC2119MUST,REQUIRED,SHALL?

-“推薦”/“建議”/“應(yīng)”項(xiàng)是指在標(biāo)準(zhǔn)中未作強(qiáng)制要求，若業(yè)務(wù)、產(chǎn)品和設(shè)備提供的功能或性能要求被認(rèn)為更佳；對(duì)應(yīng)于RFC2119RECOMMENDED,

SHOULD?

-“可選”/“可”項(xiàng)指參考性要求，是業(yè)務(wù)、產(chǎn)品和設(shè)備在目前階段可不提供的功能或性能要求；對(duì)應(yīng)于RFC2119MAY,OPTIONAL。

-必不能，不能，不得：表示絕對(duì)的禁止；對(duì)應(yīng)于RFC2119MUSTNOT,SHALLNOT。

-不推薦，不建議：表示若業(yè)務(wù)、產(chǎn)品和設(shè)備按照所述內(nèi)容制作，被認(rèn)為略次；對(duì)應(yīng)于RFC2119SHOULDNOT,NOTRECOMMENDED,

規(guī)范中除了明確指明為“推薦”/“建議”、“可選”外，均為必須要求。

Neusoft

3.1.術(shù)語和定義

表3-1術(shù)語/定義

術(shù)語/定義解釋

智能糾錯(cuò)針對(duì)用戶輸入的錯(cuò)詞，生活搜索搜索返回該搜索詞對(duì)應(yīng)的最可

能正確詞列表。如用戶輸入“文黨”，智能糾錯(cuò)系統(tǒng)要能夠給出

對(duì)應(yīng)的糾錯(cuò)詞”文檔”

搜索提示通過互聯(lián)網(wǎng)進(jìn)行搜索時(shí)，能夠?qū)τ脩舻妮斎胱龀鰟?dòng)態(tài)的提示，

減輕用戶輸入負(fù)擔(dān)

搜索推薦平臺(tái)通過挖掘所有用戶日志，建立遞進(jìn)關(guān)系和并列關(guān)系推薦模

型，對(duì)用戶的查詢進(jìn)行相關(guān)推薦

3.2.縮略語

表3-2縮略語

縮略語英文全稱中文含義

DTDDocumentTypeDefinitionXML文檔定義

LSPLocationServicePlatform位置服務(wù)平臺(tái)

GMTGreenwichMeanTime格林威治時(shí)間

HTTPHypertextTransferProtocol超文本傳輸協(xié)議

HTTPSHTTPSecure超文本傳輸協(xié)議安全

GISGeograhicInformationSystem地理信息系統(tǒng)

SSLSecureSocketLayer加密套接字協(xié)議層

URIUniformResourceIdentifier統(tǒng)一資源標(biāo)識(shí)符

URLUniformResourceLocator全球資源定位器

UTMUniversalTransverseMercator通川橫墨卡托投影

projection

XMLExtensibleMarkupLanguage擴(kuò)展標(biāo)記語言

POIPointofInterest興趣點(diǎn)

Neusoft

LBSLocaionBasedService基于位置的服務(wù)

POIPointofInterest興趣點(diǎn)

ESRIEnvironmentalSystemsResearch美國(guó)環(huán)境系統(tǒng)研究所

InstituteInc

GBKGB是指國(guó)標(biāo)，K是指擴(kuò)展，英文名稱是：GBK全稱《漢字內(nèi)碼擴(kuò)展規(guī)

ChineseInternalCodeSpecification范》(GBK)

WGSWorldGeodesicSystem世界測(cè)地系統(tǒng)

UGCUserGeneratedContent用戶產(chǎn)生內(nèi)容

Neusoft

4.GIS系統(tǒng)結(jié)構(gòu)

4.1.GIS系統(tǒng)體系架構(gòu)

圖4-1GIS系統(tǒng)體系架構(gòu)圖

GIS平臺(tái)主要?jiǎng)澐譃橐韵聨讉€(gè)部分：

Neusoft

?管理支撐平臺(tái)：包括用戶管理、SP管理、CP管理、服務(wù)配置管理、權(quán)限管理、日志管理、報(bào)表管理等功能：

?接入控制層：負(fù)責(zé)服務(wù)分發(fā)，日志、話單生成；

?地理信息服務(wù)能力層：提供符合GIS接口協(xié)議的地理信息基礎(chǔ)服務(wù)，以及二次開發(fā)組件；

?基礎(chǔ)位置信息內(nèi)容：存儲(chǔ)基礎(chǔ)地圖數(shù)據(jù)；

?地理信息服務(wù)內(nèi)容準(zhǔn)備層：將圖商提供的原始數(shù)據(jù)處理成GIS平臺(tái)可用的數(shù)據(jù)，存儲(chǔ)在基礎(chǔ)位置信息內(nèi)容層中。

GIS平臺(tái)的具體要求如下：

>G1S平臺(tái)的性能和穩(wěn)定性要符合電信級(jí)的應(yīng)用要求。能夠支持大用戶量，高并發(fā)的電信級(jí)用戶訪問。

>功能豐富且全面，可滿足各種空間、屬性查詢和空間分析及操作，GIS專業(yè)程度高。必須滿足GIS接口協(xié)議所涉及的GIS服務(wù)功能要求;

>開放性好，支持多種數(shù)據(jù)格式，便于和其它系統(tǒng)集成；

>可開發(fā)性好，支持多種語言開發(fā)，應(yīng)能提供可視化開發(fā)工具，簡(jiǎn)單易學(xué)、易懂，便于用戶實(shí)現(xiàn)二次開發(fā)；

>提供高、中、低端產(chǎn)品，適合不同的用戶類型；

>系統(tǒng)要具有跨平臺(tái)功能；

>應(yīng)該具有國(guó)內(nèi)外主流GIS平臺(tái)具有的通用功能；

>要能實(shí)現(xiàn)各種主流GIS格式間的低損轉(zhuǎn)換。

>提供用于分公司或者CP/SP的遠(yuǎn)程數(shù)據(jù)追加、更新、維護(hù)的接口

4.2.網(wǎng)元功能描述

>GIS平臺(tái)：根據(jù)各類位置業(yè)務(wù)應(yīng)用的需要，提供與之需求相對(duì)應(yīng)的GIS服務(wù)功能，如地圖繪制服務(wù)、目錄服務(wù)、逆地理編碼服務(wù)、路徑搜索服務(wù)

A寺/rA寺/r；

4.3.接口描述

GIS對(duì)外提供服務(wù)的接口:

Neusoft

?GIS服務(wù)接口：GIS系統(tǒng)對(duì)外提供的服務(wù)接口，業(yè)務(wù)系統(tǒng)通過定位管理平臺(tái)接入。

5.GIS接口協(xié)議

5.1消息流程

業(yè)務(wù)平臺(tái)通過HTTPPOST方式發(fā)送地理信息請(qǐng)求到GIS。請(qǐng)求行格式為：

POSTSPhostSPHTTP/1.1CRLF。

請(qǐng)求中必須包含實(shí)體頭Content-length,請(qǐng)求的消息體是XML格式的請(qǐng)求消息，其長(zhǎng)度由Content-length指定。所有GIS服務(wù)請(qǐng)求都被送到一個(gè)特定

的URL,下面是一個(gè)URL的例子：

http:〃host:port/GISQueryService/

GIS系統(tǒng)對(duì)請(qǐng)求進(jìn)行響應(yīng)并回送HTTP應(yīng)答消息。如果返回的地理信息為個(gè)URL,這個(gè)URL必須能在外部被訪問，也可以隨著URL指定一個(gè)用

戶名與訪問密碼。如果業(yè)務(wù)平臺(tái)的地理信息服務(wù)請(qǐng)求不在本協(xié)議規(guī)定之中，GIS將通過HTTP'404'錯(cuò)誤返回一個(gè)通用錯(cuò)誤消息(GEM),格式如下：

HTTP/1.1LSP404LSPNotFoundServiceCRLF.

5.2服務(wù)類型

接口定義了GIS系統(tǒng)支持的基本服務(wù)類型，每個(gè)基本的G1S服務(wù)實(shí)現(xiàn)一個(gè)具體的功能，完成一個(gè)服務(wù)至少需要一個(gè)請(qǐng)求和應(yīng)答消息。目前GIS

系統(tǒng)支持的服務(wù)類型如下表：

服務(wù)名稱描述

Neusoft

地圖繪制（Mapping）根據(jù)客戶端的請(qǐng)求（地圖范圍、圖層和繪制樣式

等），返回地圖數(shù)據(jù)。地圖數(shù)據(jù)可以是柵格形式的地

圖，也可以是特定格式的矢量數(shù)據(jù)。地圖柵格化定義

多種圖片格式輸出支持,例如GIF,JPEG,PNG,WP,

BMP等等。地圖圖片可以通過BASE-64編碼文檔的方

式在XML文檔里返回，也可以只返回URL。

“地圖繪制”還可以在“原始”的地圖上“繪制”

各種幾何元素或地理對(duì)象。

目錄服務(wù)(Directory)P0I的查找，包括：距離最近查找，一定范圍內(nèi)

查找，和根據(jù)屬性（如名稱、電話號(hào)碼等）查找。

路徑搜索（Route）提供兩點(diǎn)之間的各種方式（自駕車、公交車、步

行）的行駛路線。

“路徑搜索服務(wù)”支持如下的操作：

1.全路徑：依據(jù)請(qǐng)求指定的信息（自駕車、步

行、公交車方式，最短、最快以及不走高速公路，途

經(jīng)多點(diǎn)等等方式）返回整個(gè)路徑的信息。

2.途經(jīng)多點(diǎn)方式：依據(jù)請(qǐng)求指定的點(diǎn)序列（缺

省的情況下首末點(diǎn)為起止點(diǎn)），搜索經(jīng)過所有指定點(diǎn)

的路徑。

3.排除條件：基于不同的道路類型、地域類型，

可以指定是否走高速公路，城區(qū)，還可以指定不走的

道路。

4.時(shí)間與距離信息：服務(wù)將返回多個(gè)基于起點(diǎn)、

終點(diǎn)和分段路線的時(shí)間和距離計(jì)算結(jié)果。

返回結(jié)果即可以返回組織好的結(jié)果描述，也可以

返回節(jié)目描述元數(shù)據(jù)，由使用者根據(jù)需要選擇如何使

用（例如將返回的結(jié)果轉(zhuǎn)換為語音xml,然后利用相

應(yīng)的軟件手段處理并播放出來）。

地理編碼（GeoCode）把一個(gè)街道地址或郵編編碼成一個(gè)地理位置。

逆地理編碼（ReverseGeocode）把一個(gè)地理位置反編碼成一個(gè)街道地址或郵編。

Neusoft

測(cè)算(Cogo)進(jìn)行兒何要素的測(cè)算。目前該服務(wù)支持的操作包

括計(jì)算兩點(diǎn)之間的直線距離；判定點(diǎn)是否在某個(gè)指定

的區(qū)域內(nèi)。測(cè)算服務(wù)可以通過一次請(qǐng)求完成多個(gè)測(cè)算

操作。

元數(shù)據(jù)(MetaData)提供GIS系統(tǒng)元數(shù)據(jù)。目前能提供的元數(shù)據(jù)包括：

1)系統(tǒng)可提供的服務(wù)；2)地圖覆蓋的地理范圍，行

政區(qū)劃目錄，3)圖層信息，地物分類；4)屬性數(shù)據(jù)

列名稱和數(shù)據(jù)類型等。

5.3接口協(xié)議

GIS請(qǐng)求和應(yīng)答消息都由兩部分組成：消息頭(header或context)和消息體(body),消息頭包含了一些認(rèn)證信息等，消息體中則是請(qǐng)求的具體內(nèi)容。

5.3.1GIS請(qǐng)求DTD

<!ELEMENTGis_Req(HDR,(MPR|VMRDRRRTR|GCR|RGRCGR|MDR))>

<!ATTL1STGisReq

Ver(1.0.0|l.0.1)#IMPLIED

>

<!ENTITY%gis_mpr.dtdSYSTEM<,GIS_MPR_100.DTD”>

%gis_mpr.dtd;

<!ENTITY%gis_vmr.dtdSYSTEMKGIS_VMR_100.DTD”>

%gis_vmr.dtd;

<!ENTITY%gis_drr.dtdSYSTEM“GIS_DRR」00.DTD”>

%gisdrr.dtd;

Neusoft

<!ENTITY%gis_rtr.dtdSYSTEM“GIS_RTR」00.DTD”>

%gis_rtr.dtd;

<!ENTITY%gis_gcr.dtdSYSTEMuGIS_GCR_100.DTD”>

%gis_gcr.dtd;

<!ENTITY%gis_rgr.dtdSYSTEMwGIS_RGR_100.DTD”>

%gis_rgr.dtd;

<!ENTITY%gis_cgr.dtdSYSTEMaGIS_CGR_100.DTD”>

%gis_cgr.dtd;

<!ENTITY%gis_mdr.dtdSYSTEM“GIS_MDR」00.DTD”>

%gis_mdr.dtd;

<!ENTITY%gis_geometry.dtdSYSTEM“GIS_GE0METRY」00.DTD”>

%gis_geometry.dtd;

<!ENTITY%gis_uom.dtdSYSTEM“GIS_U0M」00.DTD”>

%gis_uom.dtd;

<!ENTITY%gis_adt.dtdSYSTEMaGIS_ADT_100.DTD”>

%gis_adt.dtd;

例子:

<?xmlversion

<!DOCTYPEGis_ReqSYSTEM<<GIS_100.dtd,,>

<Gis_ReqVer=,,l.().0,,>

<HDR>

</HDR>

<MPR>

</MPR>

</Gis_Req>

5.3.2GIS應(yīng)答DTD：

Neusoft

<!—GIS_RESPONSE—>

<!ELEMENTGis_Res(HDA,(MPA|VMADRARTA|GCA|RGA|MDA|CGA)?)>

<!ATTLISTGis_Res

Ver(1.0.0|1.0.1)#IMPLIED

>

<!ENTITY%gis_mpa.dtdSYSTENf<<GIS_MPA_100.DTD”>

%gis_mpa.dtd;

<!ENTITY%gis_vma.dtdSYSTEMaGIS_VMA_100.DTD”>

%gis_vma.dtd;

<!ENTITY%gis_dra.dtdSYSTEMaGIS_DRA_100.DTD”>

%gis_dra.dtd;

<!ENTITY%gis_rta.dtdSYSTEMttGIS_RTA_100.DTD”>

%gis_rta.dtd;

<!ENTITY%gis_gca.dtdSYSTEM“GIS_GCA」00.DTD”>

%gis_gca.dtd;

<!ENTITY%gis_rga.dtdSYSTEM“GIS_RGA100.DTD”>

%gis_rga.dtd;

<!ENTITY%gis_cga.dtdSYSTEMuGIS_CGA_100.DTD">

%gis_cga.dtd;

<!ENTITY%gis_mda.dtdSYSTEMuGTS_MDA_100.DTD”>

%gis_mda.dtd;

<!ENTITY%gis_geometry.dtdSYSTEMuGIS_GE0METRY_100.DTD">

%gis_geometry.dtd;

<!ENTITY%gisuom.dtdSYSTEM“GISJJOM100.DTD”>

%gis_uom.dtd;

<!ENTITY%gisadt.dtdSYSTEM“GISADT」00.DTD”>

Neusoft

%gis_adt.dtd;

<?xnilversion="L0">

<!DOCTYPEGis_ReqSYSTEM<4GIS_100.dtd,,>

<Gis_ResVedlOO'〉

<HDR>

</HDR>

<MPA>

</MPA>

</Gis_Res>

下面對(duì)消息頭和各類服務(wù)類型的DTD分別進(jìn)行描述。

5.3.3頭信息結(jié)構(gòu)

請(qǐng)求頭

<!ELEMENTHDR((ClientlSessionlD|(Client,SessionlD)),GISID?,SPID?,Region?)>

<!ATTLISTIIDR

VersionCDATA#FIXED”1.0.0”>

<!ELEMENTClient(Id,Pwd?,ServiceID?)>

<!ELEMENTId(#PCDATA)>

<!ELEMENTPwd(#PCDATA)>

<!ELEMENTServicelD(#PCDATA)>

<!ELEMENTSessionlD(#PCDATA)>

<!ELEMENTGISID(#PCDATA)>

<!-GISID的分配應(yīng)與GIS系統(tǒng)所覆蓋的行政區(qū)劃號(hào)碼的對(duì)應(yīng)。一>

Neusoft

<!ELEMENTSPID(#PCDATA)>

<!ELEMENTRegion(Envelope|Point|Place*)>

例子：

<HDRVersion=t€l.().(),>>

<Client>

<Id>XYZ123</ID>

<Pwd>123456</Pwd>

</Client>

<Region>

<Point>

<pos>-114.34250.234</pos>

<Point>

</Region>

</HDR>:

應(yīng)答頭

<!ELEMENTIIDA(SessionlD?,POIProviderlD*,(Success|Error))>

<!ATTLISTHDA

VersionCDATA#FIXED”1.0.0”>

<!ELEMENTSessionlD(#PCDATA)>

<!ELEMENTPOlProviderlD(ttPCDATA)>

<!ELEMENTSuccessEMPTY>

<!ATTLISTSuccess

SuccessCode(ResponselsTheRightIResponselsNull)#REQUIRED

MessageCDATA#IMPLIED

>

Neusoft

<!ELEMENTError(XMLError|SecurityErrorServiceError)+>

<!ATTLISTError

ServiceCDATA#IMPLED〃所請(qǐng)求的服務(wù)(例如：地圖繪制用MPR表示)

highestSeverity(Warning|Error)#IMPLIED

ErrorCodeCDATA#IMPLIED

>

<!ELEMENTXMLErrorEMPTY>

<!ATTLISTXMLError

ErrorCode(RequestVersionMismatchResponseVersionMismatch|ValueNotRecognized

INotSupported|InconsistentOtherXml|Unknown)^REQUIRED

severity(Warning|Error)#IMPLIED

locationlDIDREF#IMPLIED

locationPathCDATA#IMPLIED

messageCDATA#IMPLIED

>

<!ELEMENTSecurityErrorEMPTY>

<!ATTL1STSecurityError

ErrorCode(UserlDIllegal|PasswordIIlegalIAuthoritylllegalIUnknown)#REQUIRED

messageCDATA^IMPLIED

>

<!ELEMENTServiceErrorEMPTY>

<!ATTLISTServiceError

ErrorCode(OutService|ServicelsNull|Unknown)#REQUIRED

messageCDATA#IMPLIED

>

<!-locationlD:TheIDoftheelementassociatedwiththeerror.一>

<!一locationPath:thepathtotheXMLelementorattributeassociatedwiththeerror.一>

例子：

vHDAVersion="LOO'>

<SessionID>l5968</SessionID>

Neusoft

<ErrorService=,,MPR,?highestSeverity=,JEn

<SecurityErrormessage="Therequestiseiror."ErrorCode=Tasswordlllegar7>

<XMLErrorErrorCode="VaiueNotRecognized“message='Therequestiserror.^^severity=,,Error,7>

<ServiceErrorErrorCode=T,ServiceIsNuir7>

</Error>

</HDA>

5.3.4結(jié)果代碼和錯(cuò)誤代碼

以下是消息頭中(HDA)返回的結(jié)果代碼

服務(wù)成功(Success)返回：

結(jié)果代碼符號(hào)說明

1ResponselsTheRight服務(wù)正確返回結(jié)果

2ResponselsNull服務(wù)正確響應(yīng)，但是結(jié)果為空

錯(cuò)誤(Error)分類:

錯(cuò)誤名稱說明

XMLErrorXML內(nèi)容錯(cuò)誤

SecurictyError安全認(rèn)證錯(cuò)誤

ServiceErrorGIS服務(wù)錯(cuò)誤

XML內(nèi)容錯(cuò)誤碼:

結(jié)果代碼符號(hào)說明

3RequestVersionMismatch不支持的請(qǐng)求格式

4ResponseVersionMismatch不支持的應(yīng)答格式

5ValueNotRecognized元素內(nèi)容或?qū)傩灾挡荒茏R(shí)別

Neusoft

6NotSupported元素內(nèi)容或?qū)傩灾挡恢С?/p>

7Inconsistent元素內(nèi)容或?qū)傩灾蹬c其它元素內(nèi)容或?qū)傩灾?/p>

不一致

8OtherXml元素內(nèi)容或?qū)傩灾档钠渌e(cuò)誤

9SyntaxError語法錯(cuò)誤

10VersionError版本錯(cuò)誤

11Unknown未知的XML錯(cuò)誤

安全認(rèn)證錯(cuò)誤碼:

結(jié)果代碼符號(hào)說明

12UserlDDlegalUserID不存在

13PasswordlllegalPassword錯(cuò)誤

14Authoritylllegal權(quán)限錯(cuò)誤

15Unknown未知的權(quán)限認(rèn)證錯(cuò)誤

服務(wù)錯(cuò)誤碼:

結(jié)果代碼符號(hào)說明

16OutService例如，請(qǐng)求服務(wù)超過GIS系統(tǒng)的服務(wù)范圍（區(qū)

域范圍）

17ServicelsNull請(qǐng)求的服務(wù)不存在（服務(wù)未建立）

18Unknown未知的服務(wù)錯(cuò)誤

5.4地圖繪制(Mapping)

地圖繪制請(qǐng)求（MPR）

Neusoft

<!—MAPSR—>

<!ELEMENTMPR(Output+,Basemap?,Overlay*)>

<!ATTLISTMPR

source(paint|grid|sate|satelabel)CDATA#IMPLIED>

<!—MPR標(biāo)簽增加了source屬性，區(qū)分請(qǐng)求的不同數(shù)據(jù)源?！?/p>

<!ELEMENTOutput(BBoxContext|CenterContext)?>

<!ATTLISTOutput

widthCDATA^IMPLIED

heightCDATA#IMPLIED

formatCDATA#TMPLIED

BGcolorCDATA^IMPLIED

colorsCDATAIMPLIED

transparentCDATA#IMPLIED

content(URLData)ttTMPLIED

lang(CN|EN|BG)#IMPLIED

fixture(trueIfalse)#IMPLIED

dispReaITimeTraffic(true|false)^IMPLIED

>

<!—lang表示地圖的語言類型，CN為簡(jiǎn)體中文；EN為英語；BG為繁體中文一>

奧運(yùn)相關(guān)的應(yīng)用，和數(shù)據(jù)。

<!一注：fixture(固定位置)如果設(shè)置是true,那么完全根據(jù)請(qǐng)求經(jīng)緯度范圍描繪地

圖范圍；如果設(shè)置是false,那么可以根據(jù)請(qǐng)求經(jīng)緯度和地圖的比例，自適應(yīng)地圖范圍。3

<!一注：dispRealTimeTraffic表示是否在地圖上描畫實(shí)時(shí)交通信息。true代表描畫，

false代表不描畫-->

<!ELEMENTBasemap(Layer+)>

<!ATTLISTBasemap

filter(IncludeExclude)#REQUIRED

order(Yes|No)IMPLIED

Neusoft

<!一注：如果設(shè)置order二Yes則按照layername的順序排序.（這里filter設(shè)置為

Include)->

<!ELEMENTLayer(Style?)>

<!ATTLISTLayer

nameCDATA#REQUIRED>

<E!LEMENTStyle(NameStyleContent)>

<E!LEMENTName(#PCDATA)>

<E!LEMENTStyleContent(#PCDATA)>

<!ELEMENTOverlay((POIRouteGeometryPositionMap),Style?)>

<!ATTLISTOverlay

zorderCDATA#IMPLIED>

<!一當(dāng)OVERLAY中涉及的坐標(biāo)超出Output所要求的坐標(biāo)范圍時(shí)，返回的地圖應(yīng)包含OVERLAY

中要求的坐標(biāo)范圍。--〉

例子:

<MPR>

<Outputwidth=,,64(y,height=,,480,*format=,,image/png,,>

<BBoxContext>

<pos>-114.34250.234</pos>

<pos>-114.12350.031</pos>

</BBoxContext>

</Output>

<Basemapfilter=''Exclude”/>

<Layername='ToacT>

<Style>

<Name>pen001</Name>

</Style>

</Layer>

<Overlay>

<Position>

Neusoft

<!—ThisADTcontainsthelat/lonofJoe'sHouse—>

</Position>

</Overlay>

</MPR>

地圖繪制應(yīng)答(MPA)

<!ELEMENTMPA(Map+)>

例子：

<MPA>

<Map>

<Contentwidth="640"height="480"format="image/png”>

<URL>http:〃/Ibs/maps/hgt-837468.png</URL>

</Content>

<BBoxContext>

<pos>-l14.34250.234</pos>

<pos>>114.12350.031</pos>

</BBoxContext>

</Map>

</MPA>

</VMA>

5.5目錄服務(wù)(Directory)

目錄服務(wù)請(qǐng)求(DRR)

<!ELEMENTDRR(POILocation?,(POIProperties|Bus),MaximumResponses?)>

<!ATTLISTDRR

sortCriteria(NameTypeIDistance)#IMPLIED

sortDirection(Ascending|Descending)#IMPLIED

>

<!ELEMENTPOIProperties(POIProperty*)>

Neusoft

<!ATTLISTPOIProperties

directoryTypeCDATA#IMPLIED

POIProviderlDCDATA?IMPLIED

needSuggestWordsCDATA#IMPLIED

<!—是否返回關(guān)鍵字建議詞，如果不使用關(guān)鍵字檢索則不生效T

>

<!ELEMENTPOIPropertyEMPTY>

<!ATTLISTPOIProperty

name(IDPOINameSpellabb|PhoneNumberKeywordCUCS_OtypeJCUCS_Stype

CUCS_Atype|other)#REQUIRED

valueCDATA#REQUIRED

>

<!ELEMENTPOILocation(Address|NearestWithinDistance|WithinBoundary|

AlongLine)>

<!—POILocation標(biāo)簽不存在，目錄服務(wù)在全國(guó)查詢內(nèi)查詢一》

<!—Address可以輸入輸入行政區(qū)名稱，也可以輸入城市區(qū)號(hào)一>

。一Address是行政區(qū)名稱時(shí)，目錄服務(wù)(包括搜索引擎查詢)支持Address標(biāo)簽輸入

到省級(jí)，省市級(jí)，或者到省市區(qū)級(jí)的查詢一〉

<!ATTLISTPOILocation

autoextend(0|1)#IMPLIED

>

<!ELEMENTNearest(Address|POI|PositionAzimuth)>

<!ATTLISTNearest

nearestCriterion(Proximity|FastestShortest|Easiest)#IMPLIED

>

<!ELEMENTAzimuth(StartPoint,LineString+)>

<!ATTLISTAzimuth

direction(ForwardRight|ForwardLeft|BackLeft|BackRight)#IMPLIED

valueCDATA#REQUIRED

Neusoft

只支持右前方

uom(KM|M|DM|MI|YD|FT)#IMPLIED

>

<!一Azimuth：方位，LineString是道路串，StartPoint起始點(diǎn)，direction為結(jié)果所在方位，

value：為道路的緩沖距離，uom：緩沖距離的單位一》

<!ELEMENTWithinDistance((AddressIPOIIPosition|Azimuth),MinimumDistance?,

MaximumDistance?)>

<!ELEMENTMinimumDistanceEMPTY>

<!ATTLISTMinimumDistance

valueCDATA#REQUIRED

accuracyCDATA#IMPLIED

uom(KM|M|DM|MI|YD|FT)^IMPLIED

>

<!ELEMENTMaximumDistanceEMPTY>

<!ATTLISTMaximumDistance

valueCDATA#REQUIRED

accuracyCDATA#IMPLIED

uom(KM|M|DM|MI|YD|FT)#IMPLIED

>

<!ELEMENTWithinBoundary(A0I)>

<!ELEMENTMaximuniResponses(#PCDATA)>

。一改元素表示請(qǐng)求返回的POI個(gè)數(shù)的最大值，該值最大可設(shè)置為500個(gè)，缺省設(shè)置為500

個(gè)，即，當(dāng)請(qǐng)求消息不包含該參數(shù)時(shí)，返回消息中最多包含500個(gè)P0I點(diǎn)信息。當(dāng)符合條件

的P01點(diǎn)信息超過該參數(shù)的設(shè)置值(建設(shè)為n個(gè))時(shí)，返回前n各點(diǎn)。-->

<!ELEMENTAlongLine(Street,Place*)>

<!ATTLISTAlongLine

Neusoft

distanceCDATA#REQU1RED

accuracyCDATA#IMPLIED

uom(KM|M|DM|MI|YD|FT)#IMPLIED

<!ELEMENTBus(BusLinelStation)>

<!ATTLISTBus

type(bus|subwaytramcar|lightrail)#IMPLIED

>

<!ELEMENTBusLine(Station*,pos?)>

<!ATTLISTBusLine

KeywordCDATA^IMPLIED

NameCDATA#IMPLIED

FirstVehicleHourCDATA#IMPLIED

FinalVehicleHourCDATA#TMPLIED

DeparturelntervalCDATA#IMPLTED

DirectionCDATA#1MPLIED

TotalLineLengthCDATA#IMPLIED

LinelDCDATA#TMPLIED

KeyNameCDATAttlMPLIED

FrontNameCDATAIMPLIED

TerminalNameCDATA#IMPLIED

ServicePeriodCDATA#IMPLIED

TimelntervalCDATA#IMPLIED

CompanyCDATA^IMPLIED

BasicPriceCDATA#IMPLIED

TotalPriceCDATA#IMPLIED

AirCDATA#IMPLIED

ConunutationTicketCDATA#IMPLIED

AutoCDATA^IMPLIED

IcCardCDATA#IMPLIED

ExpresswayCDATA#IMPLIED

Neusoft

DataSourceCDATAttlMPLIED

LoopCDATA#IMPLIED

DoubleDeckCDATA#IMPLIED

PhotoIDCDATA^IMPLIED

PhotoFolderCDATA#IMPLIED

PaperTablelDCDATA#IMPLIED

SpeedCDATA?IMPLIED

TypeCDATA#IMPLIED

DescriptionCDATA#IMPLIED

StatusCDATA#IMPLIED

>

<!ELEMENTStation(Pos?)>

<!ATTLISTStation

KeywordCDATA#IMPLIED

nameCDATA_#IMPLIED

LinelDCDATA#TMPLTED

例子：

<DRR>

<POILocation>

<WithinDistance>

vPOI1D='T'>

<POIAttributeList>

<POlInfoList>

<POIInfoname="POIName"value="MyHoter7>

</POIInfoList>

</POIAttributeList>

</POI>

<MaximumDistancevalue=,,500,7>

</WithinDistance>

</POILocation>

<POIPropertiesdirectoryType="YellowPages"〉

Neusoft

<POIPropertyname="NAICS_type"value="Restauranl'7>

<POIPropertyname="NAICS_subType”value="Chinese'7>

</POIProperties>

<MaximumResponses>10</MaximumResponses>

</DRR>

目錄服務(wù)應(yīng)答(DRA)

<?xmlversion=H1.0nencoding=HUTF-8H?>

<!ELEMENTDRA((SuggestWords?,POIContext*)IBusContext)>

<!ELEMENTSuggestWords(SuggestWord*)>

<!ATTLISTSuggestWordssuggestWordCountCDATA#REQUIRED>

<!ELEMENTSuggestWord(#PCDATA)>

<!ELEMENTPOIContext(PO工，Distance?)>

<!ELEMENTBusContext(BusLine*)>

例子：

<DRA>

.1.<POIContext>

vPOI1D='T'>

.2.<POIAttributeList>

<POIInfoList>

<POIInfoname=TOIName"value="RedDragonChineseRestaurant,7>

</POIInfoList>

</POIAttributeList>

</POI>

<Dista