1、1BD 42000820 5北斗/全球衛星導航系統（GNSS）導航電子地圖應用開發中間件接口規范Middleware interface specification for BeiDou/Global Navigation Satellite Systems (GNSS) navigation electronic map發I2015-10-19布2015-11-01 實施BD 4200082015目次前言III范圍1規范性引用文件1術語和定義、縮略語1術語和定義1縮略語1概述2坐標系類型2接口關系2接口技術協議2導航電子地圖應用開發中間件接口結構5概述5服務器端導航電子地圖應用開發中間件接口

2、結構6移動端導航電子地圖應用開發中間件接口結構6服務器端導航電子地圖應用開發中間件接口7功能7接口格式要求9移動端導航電子地圖應用開發中間件接口667.1功能667.2接口格式要求68附錄 A（資料性附錄） 常用編碼表116附錄 B（資料性附錄） 錯誤碼說明150IBD 4200082015前言為適應我國衛星導航發展對標準的需要，全國北斗衛星導航標準化技術委員會組織制定北斗專項標準，推薦有關方面參考采用。本標準由中國衛星導航系統管理辦公室提出。本標準由全國北斗衛星導航標準化技術委員會歸口。本標準起草單位：高德軟件有限公司、中國衛星導航工程中心、中國航天標準化研究所、北京超圖軟件股份有限公司、中

3、地數碼科技有限公司、北京智慧圖科技有限責任公司。本標準主要起草人：唐希勇、郜延紅、江城、靳萍、許冬彥、趙文晶、楊海燕、汪陶勝、梁軍、饒慶云、張發勇、余國宏、李少杰、王蒙、徐連明、陶劉強。IIIBD 4200082015北斗/全球衛星導航系統（GNSS）導航電子地圖應用開發中間件接口規范范圍本標準規定了全球衛星導航系統（GNSS）導航電子地圖應用開發中間件接口功能和具體接口技術規范（包括服務器端、移動端兩類接口）的一般要求。本標準適用于 GNSS 導航電子地圖應用開發中間件接口（以下簡稱“中間件接口”）的開發設計和使用。規范性引用文件下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件僅注

4、日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T 919-2002公路等級代碼GB/T 2260中華人民共和國行政區劃代碼GB/T 9390導航術語GB/T 17694地理信息術語GB/T 19392-2013車載衛星導航通用設備規范GB/T 28442-2012導航電子地圖數據分類與編碼術語和定義、縮略語術語和定義GB/T 9390、GB/T 17694 界定的術語和定義適用于本文件。縮略語下列縮略語適用于本文件。APIApplication Programming Interface，應用編程接口； JSONJavaScript Obje

5、ct Notation，JavaScript 對象表示法； PNGPortable Network Graphics，可移植網絡圖形格式； POIPoint of Interest，興趣點，可以理解為一個地理位置； RESTRepresentational State Transfer，表述性狀態轉移； TMCTraffic Message Channel， 交 通 信 息 頻 道 ； TTSText To Speech，語音合成；UMLUnified Modeling Language，統一建模語言；1BD 4200082015URIUniform Resource Identifier，統

6、一資源標識符； IDLInterface Description Language，接口描述語言； XMLExtensible Markup Language，可擴展標記語言。概述坐標系類型中間件接口坐標系采用 CGCS2000 為地圖統一坐標系。接口關系中間件接口是在導航電子地圖數據和基于位置服務的基礎上，為支撐個人與政府和行業位置服務應用開發而規定的基礎功能接口，中間件接口關系見圖 1。圖 1 GNSS 導航電子地圖應用開發中間件接口關系圖接口技術協議REST 架構中間件接口遵循 REST 設計風格，基于標準 HTTP 網絡傳輸協議，HTTP 版本應為 1.1 及以上。規定接口通過 URI

7、 進行唯一標識，使用 HTTP 協議的標準方法實現對接口的操作。請求格式HTTP 請求應以 URI 查詢參數和請求體參數的方式進行參數傳遞。其中 URI 查詢參數位于 URI 中絕對路徑的后面，以“?”開頭，形式是“參數名=參數值”，各個參數之間用“&”符號分割，不分先后順序。請求體參數組織格式與 URI 查詢參數一致 ，而且只有 POST， PUT 請求支持請求體參數 。URI 查詢參數請求見示例 1。2BD 4200082015http:/IP:PORT/CTX/services /components-rest/rest/sample.json?A=value_a&B=value_b其中

8、，A、B 為參數名，對應的參數值分別為value_a、value_b。示例 1：URI 查詢參數請求見示例 2。http:/IP:PORT/CTX/services/mapworld/rest/maps/image.png?center=x:96.17,y:27.57&scale=0.000000025632& width=512&height=512其中，center、scale、width、height 為參數名，對應的參數值分別為x:96.17 ，y:27.57、0.000000025632、512、512。示例 2：請求體參數請求見示例 3。URI: http:/IP:PORT/CTX

9、/services/data-world/rest/datasources/world/datasets/world/fields.json示例 3：請求體參數見示例 4。key=89iiroew6372&name=price&Caption=price&type=double&defaultValue=0.0&isRequired=true示例 4：響應格式對中間件接口 HTTP 請求作出響應，獲得資源或者操作結果的表述，表述支持 JSON 和 XML兩種格式，對于圖片資源支持 PNG、BMP、GIF、JPG 及 JPEG 特有的表述格式。XML 格式見示例 1。世界地圖StaticReso

10、urcemaphttp:/IP:PORT/CTX/services/map-world/rest/maps/%E4%B8%96%E7%95%8C%E5%9C%B0%E5%9B%BEapplication/xmltext/xmlapplication/jsonapplication/rjsontext/html示例 1：3BD 4200082015application/jsonpapplication/x-java-serialized-objectapplication/ajaxapplication/kmlapplication/ifxapplication/flexapplication

11、/islapplication/silverlightapplication/ijsapplication/javascriptapplication/html5application/smcapplication/supermapcloudJSON 格式見示例 2。resourceConfigID: map， name: 長春市區圖，path: http:/IP:PORT/CTX/services/map-changchun/rest/maps/%E9%95%BF%E6%98%A5%E5%B8%82%E5%8C%BA%E5%9B%BE，supportedMediaTypes: applica

12、tion/xml， text/xml， application/json，application/rjson， text/html， application/jsonp，application/x-java-serialized-object，application/ajax， application/kml，示例 2：4BD 4200082015application/ifx， application/flex， application/isl， application/silverlight， application/ijs， application/javascript， applica

13、tion/html5， application/smc， application/supermapcloud，resourceType: StaticResource參數格式請求參數格式說明見表 1。表1 請求參數結構表項目描述名稱請求參數名稱類型請求參數類型參數性質是否必填說明請求參數所遵循的要求和描述性說明響應參數格式說明見表 2。表2 響應參數結構表項目描述序號響應參數序號，根據參數類型層次說明父元素名稱響應參數父元素名稱子元素名稱響應參數子元素名稱約束元素的約束條件，參照附錄 A.1類型響應參數的數據類型長度響應參數的允許長度，參照附錄 A.1說明響應參數所遵循的要求和描述性說明導航電

14、子地圖應用開發中間件接口結構概述中間件接口包括服務器端導航電子地圖應用開發中間件接口和移動端導航電子地圖應用開發中間件接口兩大部分：第一部分對地圖服務接口、空間數據服務接口、空間分析服務接口、信息查詢服務接口、路徑規劃服務接口、用戶服務接口、地址匹配服務接口、元數據服務接口、動態交通服務接口、室內定位與導航服務接口、第三方數據融合服務接口和可擴展服務接口的訪問；第二部分通過 API 的形式，實現移動端以在線/離線方式對地圖顯示接口、自定義標繪接口、信息查詢服務接口、路徑計算接口、路徑引導接口、空間分析服務接口、動態交通服務接口、語音播報接口和可擴5BD 4200082015展服務接口的調用。服

15、務器端導航電子地圖應用開發中間件接口結構服務器端導航電子地圖應用開發中間件接口結構見圖 2。圖 2 服務器端導航電子地圖應用開發中間件接口結構圖服務器端導航電子地圖應用開發中間件接口結構一般包括： a） 地圖服務接口：對地圖和圖層進行訪問與操作的接口； b） 空間數據服務接口：對空間數據進行訪問與操作的接口；空間分析服務接口：對數據集、幾何對象的空間分析的接口；信息查詢服務接口：對空間數據進行查詢的接口；路徑規劃服務接口：計算兩點間路線的接口；用戶服務接口：中間件接口用戶管理的接口；地址匹配服務：地址信息匹配到相應的地理位置的接口； h） 元數據服務接口：所有獲取服務的列表和元信息的接口； i

16、） 動態交通服務接口：獲取道路狀況信息的接口；j） 室內定位與導航接口：室內搜索與路徑計算相關的接口； k） 第三方數據融合服務接口：第三方數據融合相關的服務接口； l） 可擴展服務接口：支持新增擴展服務的接口。移動端導航電子地圖應用開發中間件接口結構移動端導航電子地圖應用開發中間件接口結構見圖 3。6BD 4200082015圖 3 移動端導航電子地圖應用開發中間件接口結構圖移動端導航電子地圖應用開發中間件接口結構一般包括：事件監聽對象接口：中間件回調事件的接口，以消息驅動形式控制整個導航過程；地圖顯示接口：導航電子地圖顯示、控制相關的接口；用戶自定義標繪接口：用戶自定義標繪相關的接口；信息

17、查詢服務接口：首拼、關鍵字、周邊等信息搜索相關的接口；路徑規劃接口：路徑規劃及結果信息獲取相關的接口；路徑引導接口：路徑引導相關的接口；空間分析服務接口：緩沖區分析、疊加分析相關的空間分析接口；動態交通服務接口：實時交通獲取、顯示相關的接口；系統工具模塊：各個接口涉及的系統工具類； j） 可擴展服務接口：支持新增擴展服務的接口； k） 公用數據類型：各個接口公用的數據類型。服務器端導航電子地圖應用開發中間件接口功能概述服務器端導航電子地圖應用開發中間件接口應具備地圖服務、空間數據服務、空間分析服務、信息查詢服務、路徑規劃服務、用戶服務、地址匹配服務、元數據服務、動態交通服務、室內定位與導航、第

18、三方數據融合服務功能。地圖服務接口提供地圖相關資源，并可以對地圖和圖層進行訪問與操作，一般包括以下功能：獲取地圖列表，包括服務器上地圖的名稱、URI、資源類型等；7BD 4200082015獲取地圖當前狀態的基本信息，包括該地圖的中心點、比例尺、地圖顯示范圍、出圖圖片大小、地圖單位、距離度量單位等；獲取地圖圖片；獲取地圖的格網圖片；獲取某幅地圖的圖層集合；獲取某個圖層的信息。空間數據服務接口提供空間數據資源及屬性，并可以對空間數據進行訪問與操作，一般包括以下功能：獲取服務器端所提供的所有數據源信息；獲取數據源信息，如數據源名稱、數據源描述、引擎類型、投影信息、坐標單位、距離單位等；修改數據源信

19、息，如數據源描述、坐標單位、距離單位等；獲取數據源中的所有數據集信息；創建一個新的數據集，包括點、線、面數據集；獲取數據集信息，如數據集名稱、數據集類型、數據集范圍、數據集投影信息等；修改數據集信息，如數據集描述信息、字符集、投影坐標系等；刪除數據集；獲取一個數據集中要素（feature）信息集合。包括數據集中要素的個數、要素對應的幾何對象的類型、各個要素的 URI 等信息；對要素進行添加、刪除、修改操作；獲取一個要素的信息，包括屬性字段名稱列表、屬性字段值列表，以及要素對應的幾何對象；修改一個要素，包括屬性信息和空間信息；刪除一個要素；獲取字段信息集合；添加一個字段，僅支持在空數據集中進行字

20、段添加；對數據源中的數據進行查詢，獲取符合條件的要素集合。獲取要素集合的方式支持多種：ID 模式、幾何對象的緩沖區模式、緩沖區加屬性過濾器模式、空間查詢模式、空間查詢加屬性過濾器的模式、SQL 模式等。空間分析服務接口提供空間分析資源及幾何特征，可用于對幾何對象的空間分析服務，一般包括以下功能：對幾何對象資源進行緩沖區分析服務，支持圓頭緩存和平頭緩存；對幾何對象資源進行疊加分析服務，支持裁剪、擦除、相交、合并。信息查詢服務接口提供對空間數據的信息查詢服務，提供關鍵字和多邊形范圍內搜索查詢，一般包括以下功能：關鍵字查詢；8BD 4200082015幾何圖形查詢。路徑規劃服務接口提供起始點和終點間

21、路徑信息供客戶端調用，一般包括以下功能：允許設置途經點進行路徑計算；多種路徑計算模式，至少應提供時間最快、距離最短、費用最低 3 種計算方法。用戶服務接口應具備提供生成用戶令牌的功能。地址匹配服務接口應具備提供從已知的地址描述到對應地理坐標的轉換和已知的地理坐標到對應的地址描述的轉換服務的功能。元數據服務接口應具備提供獲取當前服務器提供所有服務的列表和元信息的功能。動態交通服務接口提供實時交通路況信息查詢服務，一般包括以下功能：分城市查詢動態交通；按矩形范圍查詢交通路況。室內定位與導航服務接口提供室內地圖相關搜索及算路服務，一般包括以下功能：查詢指定范圍內存在室內地圖的建筑物信息；查詢建筑內相

22、關要素的信息；室內外無縫路徑分析功能。第三方數據融合服務接口提供第三方數據融合相關的服務，一般包括以下功能：天氣預報；停車場。可擴展服務接口服務器端中間件接口可根據實際應用需要進行接口功能擴充。接口格式要求公用數據類型PrjCoordSys 結構結構體說明投影坐標系類。變量說明變量說明見表 3。9BD 4200082015表3 名稱類型說明coordSystemCoordSys投影坐標系的地理坐標系統對象coordUnitUnit投影系統坐標單位distanceUnitUnit距離（長度）單位epsgCodeint投影坐標系對應的 EPSG Codenamestring投影坐標系對象的名稱pr

23、ojectionProjection投影坐標系統的投影方式prjParameterPrjParameter投影坐標系統對象的投影參數prjCoordSysTypePrjCoordSysType投影坐標系類型，參照附錄 A.7CoordSys 結構結構體說明地理坐標系類型枚舉對象。變量說明變量說明見表 4。表4 名稱類型說明datumDatum投影坐標系所基于的地理坐標系對象nameString投影坐標系統名稱primeMeridianPrimeMeridian中央子午線對象spatialRefTypeSpatialRefType空間參照類型，用以區分平面坐標系、經緯坐標系、投影坐標系；枚舉類型

24、見“表 5 SpatialRefType 枚舉變量說明”coordSysTypeCoordSysType坐標系的具體類型，參照附錄 A.7unitUnit坐標單位SpatialRefType 枚舉變量說明見表 5。表5 枚舉常量說明SPATIALREF_EARTH_LONGITUDE_LATITUDE經緯坐標系，經緯坐標系由大地參照系、中央經線、坐標單位組成；在經緯坐標系中，單位可以是度，分，秒；東西向（水平方向）的范圍為-180 度至 180 度；南北向（垂直方向）的范圍為-90 度至 90 度SPATIALREF_EARTH_PROJECTION投影坐標系，投影坐標系統由地圖投影方式、投影

25、參數、坐標單位和地理坐標系組成；支持預定義的投影系統，自己定制的投影系統SPATIALREF_NONEARTH平面坐標系，平面坐標系不能進行投影轉換Unit 枚舉結構體說明距離單位枚舉類。變量說明變量說明見表 6。10BD 4200082015表6 枚舉常量說明CENTIMETER厘米DECIMETER分米DEGREE度FOOT英尺INCH英寸KILOMETER公里METER米MILE英里MILIMETER毫米MINUTE分RADIAN弧度SECOND秒YARD碼Point 結構結構體說明像素點坐標對象。變量說明變量說明見表 7。表7 名稱類型說明xint該 Point 的 x 坐標yint該

26、 Point 的y 坐標Point2D 結構結構體說明二維地理坐標點。變量說明變量說明見表 8。表8 名稱類型說明xdouble該 Point2D 的 x 坐標ydouble該 Point2D 的 y 坐標Rectangle 結構結構體說明矩形類。變量說明變量說明見表 9。表9 名稱類型說明leftTopPoint左上角坐標rightBottomPoint右下角坐標Rectangle2D 結構11BD 4200082015結構體說明二維矩形類。變量說明變量說明見表 10。表 10名稱類型說明leftBottomPoint2D左下角坐標rightTopPoint2D右上角坐標Geometry 結

27、構結構體說明幾何對象類。變量說明變量說明見表 11。表 11名稱類型說明idint幾何對象唯一標識符partsint幾何對象中各個子對象所包含的節點個數數組pointsPoint2D組成幾何對象節點的二維坐標對數組prjCoordSysPrjCoordSys幾何對象的投影坐標系styleStyle幾何對象的風格geometryTypeGeometryType幾何對象的類型Style 結構結構體說明風格類。該類用于定義點狀符號、線狀符號、填充符號風格及其相關屬性。變量說明變量說明見表 12。表 12名稱類型說明fillBackColorColor填充符號的背景色fillBackOpaqueboo

28、lean當前填充背景是否不透明fillForeColorColor填充符號的前景色fillGradientAngledouble漸變填充的旋轉角度fillGradientModeFillGradientMode漸變填充風格的漸變類型fillGradientOffsetRatioXdouble漸變填充中心點相對于填充區域范圍中心點的水平偏移百分比fillGradientOffsetRatioYdouble填充中心點相對于填充區域范圍中心點的垂直偏移百分比fillOpaqueRateint填充不透明度，合法值為 0100fillSymbolIDint填充符號的編碼，即在填充庫中填充風格的IDlin

29、eColorColor符號為線狀符號時，表示邊線的顏色；符號為點狀符號時，表示點的顏色lineSymbolIDint線狀符號的編碼，即線型庫中線型的 IDlineWidthdouble邊線寬度markerAngledouble點狀符號的旋轉角度markerSizedouble點狀符號的大小markerSymbolIDint點狀符號的編碼，即符號庫中點風格的 ID12BD 4200082015FillGradientMode 枚舉結構體說明漸變填充風格的漸變類型。變量說明變量說明見表 13。表 13枚舉常量說明CONICAL圓錐漸變LINEAR線性漸變NONE無漸變RADIAL輻射漸變SQUAR

30、E四角漸變GeometryType 枚舉結構體說明幾何對象類型枚舉。定義一系列幾何對象類型。變量說明變量說明見表 14。表 14枚舉常量說明ARC圓弧BSPLINE二次B 樣條曲線CARDINAL二維Cardinal 樣條曲線CHORD弓形CIRCLE圓CURVE二維曲線ELLIPSE橢圓ELLIPTICARC橢圓弧LINE線幾何對象類型LINE3D三維線LINEM路由對象，是一組具有 X/Y 坐標與線性度量值的點組成的線性地物對象PIE扇面POINT點幾何對象類型POINT3D三維點RECTANGLE矩形REGION面幾何對象類型REGION3D三維面ROUNDRECTANGLE圓角矩形TE

31、XT文本幾何對象類型UNKNOWN未定義Layer 結構結構體說明圖層類。該類提供圖層顯示和控制等便于地圖管理的一系列屬性。變量說明變量說明見表 15。13BD 4200082015表 15名稱類型說明boundsRectangle2D圖層范圍captionstring圖層的標題descriptionstring圖層的描述信息namestring圖層的名稱queryableboolean圖層中的對象是否可以查詢subLayersLayerCollection子圖層集layerTypeLayerType圖層類型visibleboolean圖層是否可視LayerType 枚舉結構體說明mapvie

32、wer 創建地圖圖層類型。變量說明變量說明見表 16。表 16枚舉常量說明CUSTOM自定義圖層WFSWFS 圖層WMSWMS 圖層MapParameter 結構結構體說明地圖參數。該類描述了地圖的所有的特征信息。變量說明變量說明見表 17。表 17名稱類型說明angledouble當前地圖的旋轉角度antialiasboolean是否反走樣地圖backgroundStyleStyle地圖的背景風格boundsRectangle2D地圖的全幅范圍cacheEnabledboolean是否使用緩存centerPoint2D地圖二維中心點坐標clipRegionGeometry地圖顯示裁剪的區域c

33、lipRegionEnabledboolean地圖顯示裁剪區域是否有效colorModeMapColorMode地圖的顏色模式coordUnitUnit地圖的坐標單位customEntireBoundsRectangle2D自定義的地圖全幅顯示范圍customEntireBoundsEnabledboolean自定義的地圖全幅顯示范圍是否有效customParamsstring用戶自定義參數descriptionstring當前地圖的描述信息distanceUnitUnit地圖的距離量度單位dynamicProjectionboolean是否允許地圖動態投影顯示layersList地圖中所有圖

34、層列表markerAngleFixedboolean指定點狀符號的角度是否固定maxScaledouble地圖的最大顯示比例尺maxVisibleTextSizedouble文本的最大可見尺寸，單位為毫米14BD 4200082015表 17（續）名稱類型說明maxVisibleVertexint最大幾何對象可見節點數，如果幾何對象的節點數超過指定個數，則該幾何對象不顯示minScaledouble地圖的最小顯示比例尺minVisibleTextSizedouble文本的最小可見尺寸，單位為毫米namestring目標地圖名稱overlapDisplayedboolean地圖對象在同一范圍內時

35、，是否重疊顯示，默認為 FalseoverlapDisplayedOptionsOverlapDisplayedOptions地圖的壓蓋過濾顯示選項，當 overlapDisplayed 為 false時有效paintBackgroundboolean是否繪制地圖背景prjCoordSysPrjCoordSys地圖投影系統，見 rectifyTypeRectifyType校驗方式returnImageboolean地圖圖片是否立即返回，即是否要求 GIS 服務器生成圖片returnTypeReturnType圖片返回類型scaledouble地圖的顯示比例尺textAngleFixedbool

36、ean文本角度是否固定textOrientationFixedboolean文本朝向是否固定keystring用戶密鑰viewBoundsRectangle2D視窗（viewer，地圖圖片范圍）對應的地圖范圍viewerRectangle視窗visibleScalesdouble返回地圖的可見比例尺數組visibleScalesEnabledboolean返回是否使用固定比例尺來顯示地圖RectifyType 枚舉結構體說明校驗方式枚舉類。調整中心點、比例尺、viewBounds 與 viewer 相一致。默認情況下，即該參數為 null 的時候，各個參數的優先級：viewer 比例尺 中心點

37、 viewBounds。變量說明變量說明見表 18。表 18枚舉常量說明BYCENTERANDMAPSCALE以中心點和比例尺為準BYVIEWBOUNDS以視圖范圍為準MapColorMode 枚舉結構體說明地圖顏色模式枚舉。變量說明變量說明見表 19。15BD 4200082015表 19枚舉常量說明BLACK_WHITE_REVERSE黑白反色模式BLACKWHITE黑白模式DEFAULT默認彩色模式，對應 32 位增強真彩色模式GRAY灰度模式ONLY_BLACK_WHITE_REVERSE黑白反色，其它顏色不變ReturnType 枚舉結構體說明圖片返回格式的枚舉類型。變量說明變量見表

38、 20。表 20枚舉常量說明BINARY只返回二進制內容BUFFEREDIMAGE直接返回 BuffedImageDEFAULT默認返回格式，返回url 地址FILEURI只返回文件地址URL只返回url 地址DatasourceInfo 結構結構體說明數據源信息。該類主要描述數據源的基本信息。變量說明變量說明見表 21。表 21名稱類型說明coordUnitUnit坐標單位descriptionstring數據源描述distanceUnitUnit距離單位engineTypeEngineType數據源引擎類型，該字段只讀namestring數據源的別名prjCoordSysPrjCoordS

39、ys投影信息EngineType 枚舉結構體說明數據源的引擎類型。變量說明變量說明見表 22。16BD 4200082015表 22枚舉常量說明DB2DB2 引擎類型GOOGLEMAPSGoogleMaps 引擎類型IMAGEPLUGINS影像只讀引擎類型ISERVERRESTREST 地圖服務引擎類型，該引擎為只讀引擎，且不能創建KINGBASEKingbase 引擎類型，針對 Kingbase 數據源，不支持多波段數據MAPWORLD天地圖服務引擎類型，該引擎為只讀引擎，且不能創建OGCOGC 引擎類型，針對于 Web 數據源ORACLEPLUSOracle 引擎類型ORACLESPATI

40、AL目前只支持屬性表、點、線、面和文本數據集，CAD 和路由等數據集暫不支持POSTGRESQLPostgreSQL 引擎類型SQLPLUSSQL Server 引擎類型UDB文件型引擎類型DatasetInfo 結構結構體說明數據集信息。直接已知子類：DatasetGridInfo、DatasetImageInfo、DatasetVectorInfo。變量說明變量說明見表 23。表 23名稱類型說明boundsRectangle2D數據集范圍，該字段只讀dataSourceNamestring數據源名稱，該字段只讀descriptionstring數據集的描述信息encodeTypeEnco

41、deType數據集存儲時的壓縮編碼方式，該字段只讀isReadOnlyboolean數據集是否為只讀namestring數據集名稱，該字段必須且只讀prjCoordSysPrjCoordSys數據集的投影信息tableNamestring表名，該字段只讀datasetTypeDatasetType數據集類型，該字段必填DatasetGridInfo 結構結構體說明柵格數據集信息類。該類包括返回和設置柵格數據集的相應的屬性信息等。變量說明變量說明見表 24。表 24名稱類型說明blockSizeint柵格數據集按像素分塊存儲，每一塊的大小，該字段只讀heightint柵格數據的高度，該字段只讀m

42、axValuedouble柵格數據集柵格行列中的最大值minValuedouble柵格數據集柵格行列中的最小值noValuedouble柵格數據集中沒有數據的像元的柵格值pixelFormatPixelFormat柵格數據存儲的像素格式，該字段只讀widthint柵格數據的寬度，該字段只讀17BD 4200082015DatasetImageInfo 結構結構體說明影像數據集信息類。包含了影像數據集的屬性信息，例如名稱、寬度、高度和存儲分塊大小等。變量說明變量說明見表 25。表 25名稱類型說明bandCountint波段的個數bandNamesstring波段的名稱blockSizeint影

43、像數據集按像素分塊存儲，每一塊的大小，該字段只讀colorSpaceTypeColorSpaceType色彩顯示模式heightint影像數據的高度，該字段只讀palettesList影像數據集各個波段的顏色調色板pixelFormatPixelFormat影像數據存儲的像素格式，該字段只讀widthint影像數據的寬度，該字段只讀DatasetVectorInfo 結構結構體說明矢量數據集信息類。變量說明變量說明見表 26。表 26名稱類型說明charsetCharset矢量數據集的字符集，見 4isFileCacheboolean是否使用文件形式的緩存recordCountint矢量數據集

44、中的記錄數Charset 枚舉結構體說明定義矢量數據集的字符集枚舉。變量說明變量說明見表 27。表 27枚舉常量說明ANSIASCII 字符集CHINESEBIG5在中國香港特別行政區和臺灣最常用的中文字符集DEFAULT擴展的 ASCII 字符集GB18030在中國大陸使用的中文字符集UNICODE在計算機科學領域中，Unicode（統一碼、萬國碼、單一碼、標準萬國碼）是業界的一種標準UTF32UTF-32 (or UCS-4)是一種將 Unicode 字符編碼的協定，對每一個 Unicode 碼位使用恰好 32 位元UTF8UTF-8（8 位元 Universal Character Se

45、t/Unicode Transformation Format）是針對Unicode 的一種可變長度字符編碼WINDOWS1252英文常用的編碼18BD 4200082015ColorSpaceType 枚舉結構體說明色彩空間枚舉。區別印刷系統和顯示系統。變量說明變量說明見表 28。表 28枚舉常量說明CMYK該類型主要在印刷系統使用RGB該類型主要在顯示系統中使用EncodeType 枚舉結構體說明定義數據集存儲時的壓縮編碼方式枚舉。變量說明變量說明見表 29。表 29枚舉常量說明BYTE單字節編碼方式DCTDCT（Discrete Cosine Transform），離散余弦編碼INT16

46、雙字節編碼方式INT24三字節編碼方式INT32四字節編碼方式LZWLZW 是一種廣泛采用的字典壓縮方法，其最早是用在文字數據的壓縮方面NONE不使用編碼方式PNGPNG 壓縮編碼方式，支持多種位深的圖像，是一種無損壓縮方式DatasetType 枚舉結構體說明數據集類型枚舉。變量說明變量說明見表 30。表 30枚舉常量說明CAD復合數據集LINE線數據集POINT點數據集REGION面數據集TABULAR純屬性數據集TEXT文本數據集FieldType 枚舉結構體說明字段類型枚舉。變量說明變量說明見表 31。19BD 4200082015表 31枚舉常量說明BOOLEAN布爾型BYTE字節型

47、CHAR變長的寬字節字符類型DATETIME日期型DOUBLE64 位精度浮點型INT1616 位整型INT3232 位整型INT6464 位整型LONGBINARY二進制型SINGLE32 位精度浮點型TEXT文本型WTEXT寬字符類型字段QueryParameter 結構結構體說明查詢參數類。該類用于設置查詢數據集的查詢參數。變量說明變量說明見表 32。表 32名稱類型說明attributeFilterstring屬性過濾條件fieldsstring查詢字段數組，如果不設置則使用系統返回的所有字段groupBystringSQL 查詢中結果分組條件的字段idsint查詢 id 數組join

48、ItemsJoinItem關聯查詢項數組linkItemsLinkItem與外部表的關聯信息數組namestring數據集名稱，或者圖層名稱orderBystringSQL 查詢和空間查詢中結果排序的字段JoinItem 結構結構體說明連接信息類。變量說明變量說明見表 33。表 33名稱類型說明foreignTableNamestring外部表的名稱joinFilterstring與外部表之間的連接表達式，即設定兩個表之間關聯的字段joinTypeJoinType兩個表之間連接的類型JoinType 枚舉結構體說明數據源的引擎類型。變量說明變量說明見表 34。20BD 4200082015表

49、34枚舉常量說明INNERJOIN內連接LEFTJOIN左連接LinkItem 結構結構體說明關聯信息類。變量說明變量說明見表 35。表 35名稱類型說明datasourceConnectionInfoDatasourceConnectionInfo關聯的外部數據源foreignKeysstring主空間數據集的外鍵foreignTablestring關聯的外部屬性表的名稱，即另一個矢量數據集所對應的DBMS 表linkFieldsstring欲保留的外部屬性表的字段linkFilterstring與外部屬性表的連接查詢條件namestring此關聯信息對象的名稱primaryKeysstri

50、ng外部屬性表的主鍵DatasourceConnectionInfo 結構結構體說明數據源連接信息類。變量說明變量說明見表 36。表 36名稱類型說明aliasstring數據源別名connectboolean數據源是否自動連接數據dataBasestring數據源連接的數據庫名driverstring數據源連接所需的驅動程序名engineTypeEngineType數據源連接的引擎類型exclusiveboolean是否以獨占方式打開數據源openLinkTableboolean是否把數據庫中的其他矢量數據集所對應的 DBMS 表作為 LinkTable 打開passwordstring登錄

51、數據源連接的數據庫或文件的密碼readOnlyboolean是否以只讀方式打開數據源serverstring數據庫服務器名、文件名或服務地址userstring登錄數據庫的用戶名GetFeatureMode 枚舉結構體說明數據查詢的模式（獲取要素的方式）枚舉。變量說明變量說明見表 37。21BD 4200082015表 37枚舉常量說明BOUNDS通過范圍查詢來獲取要素BOUNDS_ATTRIBUTEFILTER通過范圍查詢加屬性過濾器的模式來獲取要素BUFFER通過幾何對象的緩沖區來獲取要素BUFFER_ATTRIBUTEFILTER通過緩沖區加屬性過濾器的模式來獲取要素ID通過 ID 來獲

52、取要素SPATIAL通過空間查詢模式來獲取要素SPATIAL_ATTRIBUTEFILTER通過空間查詢加屬性過濾器的模式來獲取要素SQL通過 SQL 查詢來獲取要素SpatialQueryMode 枚舉結構體說明空間查詢模式枚舉，定義空間查詢操作模式常量。變量說明變量說明見表 38。表 38枚舉常量說明CONTAIN包含空間查詢模式CROSS交叉空間查詢模式DISJOINT分離空間查詢模式IDENTITY重合空間查詢模式INTERSECT相交空間查詢模式NONE無空間查詢OVERLAP疊加空間查詢模式TOUCH鄰接空間查詢模式WITHIN被包含空間查詢模式PixelFormat 枚舉結構體說

53、明定義柵格與影像數據存儲的像素格式枚舉。變量說明變量說明見表 39。表 39枚舉常量說明BIT16每個像元用 16 個比特，即 2 個字節表示BIT32每個像元用 32 個比特，即 4 個字節表示BIT64每個像元用 64 個比特，即 8 個字節表示BIT8每個像元用 8 個比特，即 1 個字節表示DOUBLE每個像元用 8 個字節來表示RGB每個像元用 24 個比特，即 3 個字節來表示RGBA每個像元用 32 個比特，即 4 個字節來表示SINGLE每個像元用 4 個字節來表示UBIT1每個像元用 1 個比特表示UBIT16每個像元用 16 個比特，即 2 個字節表示UBIT32每個像元用

54、 32 個比特，即 4 個字節來表示UBIT4每個像元用 4 個比特表示UBIT8每個像元用 8 個比特，即 1 個字節表示22BD 4200082015BufferAnalystParameter 結構結構體說明緩沖區分析參數類。左/右緩沖距離的設置僅對線對象/數據集有效，如果是點/面對象/數據集， 則只需要設置左緩沖距離，即使設置了右緩沖距離，在做緩沖分析時也不起作用。變量說明變量說明見表 40。表 40名稱類型說明endTypeBufferEndType緩沖區端點類型leftDistanceBufferDistance左側緩沖距離，單位：米radiusUnitBufferRadiusUn

55、it緩沖半徑單位，默認值為METERrightDistanceBufferDistance右側緩沖距離，單位：米semicircleLineSegmentint圓頭緩沖圓弧處線段的個數，即用多少個線段來模擬一個半圓，默認值為 4BufferDistance 結構結構體說明緩沖距離，可以是數值型的或者是字段表達式。變量說明變量說明見表 41。表 41名稱類型說明expstring使用表達式的計算值作為緩沖距離，表達式的結果應大于 0valuedouble使用數值作為緩沖距離，應為大于 0 的值ImageResult 結構結構體說明圖片結果類。變量說明變量說明見表 42。表 42名稱類型說明ima

56、geDatabyte圖片的二進制流imageParameterImageParameter圖片的參數，如圖片的范圍、比例尺、風格等imageURLstring圖片的 URL 地址ImageParameter 結構結構體說明圖片參數類。變量說明變量說明見表 43。23BD 4200082015表 43名稱類型說明boundsRectangle2D圖片的范圍centerPoint2D中心點，和比例尺一起決定圖片范圍prjCoordSysPrjCoordSys設置投影，見 scaledouble比例尺，和中心點一起決定圖片范圍styleStyle設置風格，包括點的風格、線的風格、面的風格等viewe

57、rRectangle視窗BufferEndType 枚舉結構體說明緩沖區端點類型枚舉。用以區分線對象緩沖區分析時的端點是圓頭緩沖還是平頭緩沖。變量說明變量說明見表 44。表 44枚舉常量說明FLAT平頭緩沖ROUND圓頭緩沖BufferRadiusUnit 枚舉結構體說明緩沖區半徑距離單位。變量說明變量說明見表 45。表 45枚舉常量說明CENTIMETER厘米DECIMETER分米FOOT英尺INCH英寸KILOMETER公里METER米MILE英里MILLIMETER毫米YARD碼PostResultType 枚舉結構體說明POST 請求的結果類型。枚舉說明 POST 請求對目標資源的影響

58、。變量說明變量說明見表 46。表 46枚舉常量說明AddContent給當前資源增加內容createAsynchronizedResource創建異步資源CreateChild創建子資源CreateChildAndReturnContent創建子資源，并返回子資源的內容24BD 4200082015ResourceType 枚舉結構體說明表示資源的類型。變量說明變量說明見表 47。表 47枚舉常量說明ArithmeticResource簡單算法資源ArithResultResource算法結果資源ArithResultSetResource算法結果集資源CatalogList目錄資源Domai

59、nArithmeticResource領域算法資源DomainArithResultResource領域算法結果資源StaticResource靜態資源DatasourceInfo 結構結構體說明數據源信息。一個數據源對應一種數據引擎，訪問不同的數據源應采用不同的引擎。變量說明變量說明見表 48。表 48參數類型說明coordUnitUnit坐標單位descriptionstring數據源描述distanceUnitUnit距離單位engineTypeEngineType數據源引擎類型，該字段只讀namestring數據源的別名。別名用于在工作空間中唯一標識數據源，該字段只讀prjCoordS

60、ysPrjCoordSys投影信息，見 DatasetInfo 結構結構體說明數據集詳細信息。變量說明變量說明見表 49。25BD 4200082015表 49名稱類型說明namestring數據集名稱，數據集的唯一標識。該標識不區分大小寫descriptionstring數據集的描述信息typedatasetType數據集類型，包括純屬性表數據集、點數據集、線數據集、面數據集、文本數據集、復合數據集（CAD 數據集）等矢量數據集，格網數據集，影像數據集，以及網絡數據集boundsRectangle2D數據集范圍，對矢量數據集來說，bounds 為數據集中所有對象的最小外界矩形；對于柵格，bo