(高清版)GBT 39584-2020 導(dǎo)航電子地圖應(yīng)用開發(fā)中間件接口規(guī)范

ICS49.020V04中華人民共和國國家標(biāo)準(zhǔn)導(dǎo)航電子地圖應(yīng)用開發(fā)中間件接口規(guī)范p2020-12-14發(fā)布2021-07-01實(shí)施國家市場監(jiān)督管理總局國家標(biāo)準(zhǔn)化管理委員會(huì)ⅠGB／T39584—2020 1范圍 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 5接口類型和基本描述 5.2接口結(jié)構(gòu) 5.3接口分類 5.4接口協(xié)議 6服務(wù)器端中間件接口 6.1公共數(shù)據(jù)類型 6.2地圖服務(wù)接口 6.3空間數(shù)據(jù)服務(wù)接口 6.4空間分析服務(wù)接口 6.5信息查詢服務(wù)接口 6.6路徑規(guī)劃服務(wù)接口 6.7用戶服務(wù)接口 6.8地址匹配服務(wù)接口 6.9元數(shù)據(jù)服務(wù)接口 6.10動(dòng)態(tài)交通服務(wù)接口 6.11室內(nèi)定位與導(dǎo)航服務(wù)接口 6.12第三方數(shù)據(jù)融合服務(wù)接口 6.13擴(kuò)展服務(wù)接口 7客戶端中間件接口 7.1公共數(shù)據(jù)類型 7.2地圖顯示接口 7.3自定義標(biāo)繪接口 7.4信息查詢接口 7.5路線規(guī)劃接口 7.6路線引導(dǎo)接口 7.7空間分析接口 7.8動(dòng)態(tài)交通信息接口 7.9語音接口 7.10事件監(jiān)聽對象接口 7.11室內(nèi)導(dǎo)航接口 ⅡGB／T39584—20207.12系統(tǒng)工具接口 7.13擴(kuò)展接口 8接口驗(yàn)證 8.1數(shù)據(jù)服務(wù)接口驗(yàn)證 8.2數(shù)據(jù)加載驗(yàn)證 8.3信息檢索驗(yàn)證 8.4路線規(guī)劃驗(yàn)證 8.5語音導(dǎo)航驗(yàn)證 8.6空間分析驗(yàn)證 附錄A（規(guī)范性附錄）常用編碼表 附錄B（規(guī)范性附錄）服務(wù)器端中間件接口公共數(shù)據(jù)類型 附錄C（規(guī)范性附錄）客戶端中間件接口公共數(shù)據(jù)類型 附錄D（規(guī)范性附錄）錯(cuò)誤碼 GB／T39584—2020本標(biāo)準(zhǔn)按照GB/T1.1—2009給出的規(guī)則起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別這些專利的責(zé)任。本標(biāo)準(zhǔn)由中國衛(wèi)星導(dǎo)航系統(tǒng)管理辦公室提出。本標(biāo)準(zhǔn)由全國北斗衛(wèi)星導(dǎo)航標(biāo)準(zhǔn)化技術(shù)委員會(huì)(SAC/TC544)歸口。本標(biāo)準(zhǔn)起草單位：北京超圖軟件股份有限公司、中國衛(wèi)星導(dǎo)航工程中心、中國航天標(biāo)準(zhǔn)化研究所、三六零科技集團(tuán)有限公司、北京智慧圖科技有限責(zé)任公司、北京航天宏圖信息技術(shù)股份有限公司。本標(biāo)準(zhǔn)主要起草人：鐘耳順、李少杰、劉瑩、蔡文文、劉慶軍、曹玉堯、馬海波、楊海燕、饒慶云、張紹瑞、張楠、王維嘉。Ⅲ1GB／T39584—2020導(dǎo)航電子地圖應(yīng)用開發(fā)中間件接口規(guī)范本標(biāo)準(zhǔn)規(guī)定了導(dǎo)航電子地圖應(yīng)用開發(fā)中間件的接口結(jié)構(gòu)、接口分類、接口定義、接口協(xié)議及接口驗(yàn)證。本標(biāo)準(zhǔn)適用于導(dǎo)航電子地圖應(yīng)用開發(fā)中間件接口的設(shè)計(jì)與開發(fā)，也適用于導(dǎo)航應(yīng)用軟件對中間件接口的調(diào)用。2規(guī)范性引用文件下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T920公路路面等級與面層類型代碼GB/T2260中華人民共和國行政區(qū)劃代碼GB/T11457—2006信息技術(shù)軟件工程術(shù)語GB/T17694地理信息術(shù)語GB/T19392—2013車載衛(wèi)星導(dǎo)航設(shè)備通用規(guī)范GB/T28442—2012導(dǎo)航電子地圖數(shù)據(jù)分類與編碼GB/T30320地理空間數(shù)據(jù)庫訪問接口3術(shù)語和定義GB/T11457—2006、GB/T17694、GB/T30320界定的以及下列術(shù)語和定義適用于本文件。3.1含有空間位置地理坐標(biāo)，能夠與空間定位系統(tǒng)結(jié)合，準(zhǔn)確引導(dǎo)人或交通工具從出發(fā)地到達(dá)目的地的電子地圖或數(shù)據(jù)集。[GB/T28442—2012,定義2.2]3.2一種類型的軟件模塊，它處在系統(tǒng)軟件和應(yīng)用軟件之間，依賴系統(tǒng)軟件的支持，又為應(yīng)用軟件提供支持，以方便應(yīng)用軟件的開發(fā)。[GB/T11457—2006,定義2.954]3.3一種位于導(dǎo)航電子地圖數(shù)據(jù)和導(dǎo)航應(yīng)用軟件之間，為各類導(dǎo)航電子地圖數(shù)據(jù)提供統(tǒng)一的接入方式，為導(dǎo)航應(yīng)用程序的開發(fā)提供開發(fā)環(huán)境與標(biāo)準(zhǔn)接口的中間件。3.4v-運(yùn)行于服務(wù)器設(shè)備之上的導(dǎo)航電子地圖中間件，提供地圖發(fā)布、路線規(guī)劃等服務(wù)開發(fā)接口，供客戶2GB／T39584—2020端應(yīng)用程序或客戶端中間件調(diào)用。3.5-s運(yùn)行于客戶端設(shè)備之上的導(dǎo)航電子地圖中間件，提供地圖渲染、路線規(guī)劃、定位及導(dǎo)航等本地程序開發(fā)接口，供客戶端應(yīng)用程序調(diào)用。3.6可由兩個(gè)或多個(gè)非嵌套的計(jì)算機(jī)程序模型非顯式地作為參數(shù)在模塊之間傳送而能訪問的數(shù)據(jù)。[GB/T11457—2006,定義242]4縮略語下列縮略語適用于本文件。URI：統(tǒng)一資源標(biāo)識符(UniformResourceIdentifier)WFS：網(wǎng)絡(luò)要素服務(wù)(WebFeatureServices)5接口類型和基本描述導(dǎo)航電子地圖應(yīng)用開發(fā)中間件包含服務(wù)器端中間件和客戶端中間件兩類。服務(wù)器端中間件運(yùn)行于服務(wù)器操作系統(tǒng)之上，以HTTP協(xié)議提供應(yīng)用開發(fā)接口，供客戶端中間件或客戶端應(yīng)用程序調(diào)用?？蛻舳酥虚g件運(yùn)行于客戶端操作系統(tǒng)之上，以本地調(diào)用方式提供應(yīng)用開發(fā)接口，供客戶端應(yīng)用程序調(diào)用。地圖數(shù)據(jù)、中間件、中間件接口和應(yīng)用程序之間的關(guān)系如圖1所示。3GB／T39584—2020圖1導(dǎo)航電子地圖應(yīng)用開發(fā)中間件接口結(jié)構(gòu)圖服務(wù)器端地圖數(shù)據(jù)存儲(chǔ)于服務(wù)器設(shè)備上，數(shù)據(jù)包含背景地圖數(shù)據(jù)、檢索數(shù)據(jù)、道路數(shù)據(jù)、引導(dǎo)數(shù)據(jù)、實(shí)時(shí)交通數(shù)據(jù)、地址匹配數(shù)據(jù)等?？蛻舳藨?yīng)用程序或客戶端中間件通過服務(wù)器端中間件接口，以在線的方式訪問服務(wù)器端地圖數(shù)據(jù)。客戶端地圖數(shù)據(jù)存儲(chǔ)于客戶端設(shè)備上，以離線方式存儲(chǔ)于客戶端設(shè)備本地，數(shù)據(jù)包含背景地圖數(shù)據(jù)、檢索數(shù)據(jù)、道路數(shù)據(jù)、引導(dǎo)數(shù)據(jù)等?？蛻舳藨?yīng)用程序通過客戶端中間件接口，以離線方式訪問客戶端地圖數(shù)據(jù)。5.3.1服務(wù)器端中間件接口功能表1服務(wù)器端中間件接口功能序號接口分類功能描述1地圖服務(wù)接口對地圖和圖層進(jìn)行訪問與操作的接口2空間數(shù)據(jù)服務(wù)接口對空間數(shù)據(jù)進(jìn)行訪問與操作的接口3空間分析服務(wù)接口對數(shù)據(jù)集、幾何對象進(jìn)行空間分析的接口4信息查詢服務(wù)接口對空間數(shù)據(jù)進(jìn)行查詢的接口5路徑規(guī)劃服務(wù)接口構(gòu)成連接起點(diǎn)位置和終點(diǎn)位置的序列點(diǎn)或曲線的策略服務(wù)接口6用戶管理服務(wù)接口中間件連接用戶管理的接口7地址匹配服務(wù)地址信息匹配到相應(yīng)的地理位置的接口8元數(shù)據(jù)服務(wù)接口所有獲取服務(wù)的列表和元信息的接口9動(dòng)態(tài)交通服務(wù)接口獲取道路狀況信息的接口室內(nèi)定位與導(dǎo)航接口室內(nèi)定位與路徑計(jì)算相關(guān)的接口第三方數(shù)據(jù)融合服務(wù)接口第三方數(shù)據(jù)融合相關(guān)的服務(wù)接口擴(kuò)展服務(wù)接口用于新增擴(kuò)展服務(wù)的接口4GB／T39584—20205.3.2客戶端中間件接口功能客戶端中間件接口功能見表2。表2客戶端中間件接口功能序號接口分類功能描述1事件監(jiān)聽對象接口中間件回調(diào)事件的接口，以消息驅(qū)動(dòng)形式控制整個(gè)導(dǎo)航過程2地圖渲染接口導(dǎo)航電子地圖渲染、控制相關(guān)的接口3自定義標(biāo)繪接口用戶自定義標(biāo)繪相關(guān)的接口4信息查詢接口首拼、關(guān)鍵字、周邊等信息搜索相關(guān)的接口5路徑規(guī)劃接口路徑規(guī)劃及結(jié)果信息獲取相關(guān)的接口6路徑引導(dǎo)接口路徑引導(dǎo)相關(guān)的接口7空間分析接口緩沖區(qū)分析、疊加分析相關(guān)的空間分析接口8動(dòng)態(tài)交通信息接口實(shí)時(shí)交通獲取、顯示相關(guān)的接口9語音播報(bào)接口語音合成功能相關(guān)的接口室內(nèi)導(dǎo)航接口室內(nèi)定位、POI檢索、室內(nèi)路線規(guī)劃與引導(dǎo)等相關(guān)的接口系統(tǒng)工具各個(gè)接口涉及的系統(tǒng)工具類擴(kuò)展接口用于新增擴(kuò)展服務(wù)的接口5.4接口協(xié)議5.4.1服務(wù)器端中間件接口協(xié)議接口應(yīng)遵循REST軟件協(xié)議，應(yīng)基于標(biāo)準(zhǔn)HTTP網(wǎng)絡(luò)傳輸協(xié)議，HTTP版本應(yīng)為1.1及以上。接口應(yīng)通過URI進(jìn)行唯一標(biāo)識，應(yīng)使用HTTP協(xié)議的標(biāo)準(zhǔn)方法實(shí)現(xiàn)對接口的操作。HTTP請求應(yīng)以URI查詢參數(shù)或請求體參數(shù)的方式進(jìn)行參數(shù)傳遞。其中，只有POST和PUT請求既支持URI查詢參數(shù)，也支持請求體參數(shù)，其他HTTP請求只支持URI查詢參數(shù)。URI查詢參數(shù)分割，不分先后順序。請求體參數(shù)組織格式應(yīng)與URI查詢參數(shù)一致。HTTP請求見示例。5GB／T39584—2020〈list〉〈ChildResource〉〈name〉世界地圖〈/name〉〈/ChildResource〉〈/list〉[{"name":"城市地圖",A5%E5%B8%82%E5%8C%BA%E5%9B%BE","text/xml","text/html",6GB／T39584—2020],]參數(shù)類型，應(yīng)遵循附錄B相關(guān)要求，請求參數(shù)格式見表3。響應(yīng)參數(shù)格式見表4。表3服務(wù)器端中間件接口請求參數(shù)格式項(xiàng)目描述名稱請求參數(shù)名稱類型請求參數(shù)類型參數(shù)性質(zhì)是否必填說明請求參數(shù)所遵循的要求和描述性說明表4服務(wù)器端中間件接口響應(yīng)參數(shù)格式項(xiàng)目描述序號響應(yīng)參數(shù)序號，根據(jù)參數(shù)類型層次說明父元素名稱響應(yīng)參數(shù)父元素名稱子元素名稱響應(yīng)參數(shù)子元素名稱約束元素的約束條件，見A.1類型響應(yīng)參數(shù)的數(shù)據(jù)類型長度響應(yīng)參數(shù)的允許長度說明響應(yīng)參數(shù)所遵循的要求和描述性說明5.4.2客戶端中間件接口協(xié)議客戶端應(yīng)用程序采用本地類庫調(diào)用的方式調(diào)用客戶端中間件接口，客戶端中間件接口規(guī)范遵循本地調(diào)用方式規(guī)范，參數(shù)及返回值類型，應(yīng)遵循附錄C相關(guān)要求。GB／T39584—2020接口名稱應(yīng)具有與接口功能相對應(yīng)的含義，應(yīng)采用描述接口功能的單詞表示，單詞應(yīng)采用小寫字母。若接口名稱由至少兩個(gè)單詞組成，則除第一個(gè)單詞以外，其余單詞的首字母宜大寫。接口命名見示例。接口參數(shù)是可選項(xiàng)，應(yīng)根據(jù)接口功能確定是否需要參數(shù)。若存在參數(shù)，則參數(shù)說明見表5。表5客戶端中間件接口參數(shù)說明接口參數(shù)項(xiàng)目描述示例名稱接口參數(shù)名稱parameters類型接口參數(shù)類型說明接口參數(shù)所遵循的要求和描述性說明模塊初始化參數(shù)，見C.1接口返回值應(yīng)為可選項(xiàng)，應(yīng)根據(jù)接口功能確定是否需要返回值。若存在返回值，則應(yīng)指明返回值類型、取值及其表示的含義。返回值規(guī)范見示例。6服務(wù)器端中間件接口6.1公共數(shù)據(jù)類型服務(wù)器端中間件接口的公共數(shù)據(jù)類型見附錄B。6.2地圖服務(wù)接口提供地圖相關(guān)資源，并可以對地圖進(jìn)行訪問與操作，一般應(yīng)包括以下功能：單位、距離度量單位等。地圖服務(wù)接口包括地圖集合接口、地圖接口、圖像接口、圖像瓦片接口、圖層集合接口和圖層接口。78GB／T39584—2020地圖集合接口用于獲取服務(wù)器上提供的所有地圖集合信息，包括地圖的名稱、地圖資源訪問路徑、資源配置項(xiàng)ID、資源類型等。支持方式HTTPGET。請求參數(shù)見表6。表6地圖集合接口請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰響應(yīng)結(jié)構(gòu)見表7。表7地圖集合接口響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 地圖資源列表1.1ChildResourcename1stringV地圖的名稱1.2ChildResourcepath1stringV地圖資源的訪問路徑1.3ChildResource1stringV資源配置項(xiàng)ID1.4ChildResourceresourceType1stringV資源類型，見B.161.5ChildResourcesupportedMediaTypes1V支持的媒體表述類型地圖接口是對地圖進(jìn)行操作的入口，用于獲取該地圖當(dāng)前狀態(tài)的基本信息，包括中心點(diǎn)、比例尺、地圖顯示范圍、圖片大小、地圖單位、距離度量單位、包含的圖層、包含的圖片等，并可以對該地圖進(jìn)行修改或刪除，創(chuàng)建一個(gè)臨時(shí)圖層集，或創(chuàng)建一幅新地圖。9GB／T39584—2020支持方式HTTPGET。表8地圖接口請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰選填見B.1，指定請求地圖的坐標(biāo)參考系，服務(wù)器按照指定的坐標(biāo)參考系返響應(yīng)結(jié)構(gòu)見表9。表9地圖接口響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 地圖資源列表1.1ChildResourcename1stringV當(dāng)前地圖的名稱1.2ChildResourcecenter1Point2DV地圖顯示的中心點(diǎn)，見B.61.3ChildResource1doubleV地圖的顯示比例尺1.4ChildResourcemaxScale1doubleV地圖最大顯示比例尺，若該值為0，表示無比例尺顯示限制1.5ChildResourceminScale1doubleV地圖的最小顯示比例尺，若該值為0，表示無比例尺顯示限制ChildResourcebounds1Rectangle2DV地圖的全幅地理范圍1.7ChildResourceviewBounds1Rectangle2DV地圖窗口顯示區(qū)域，是一個(gè)矩形框1.8ChildResourceviewer1RectangleV用戶顯示視窗，即產(chǎn)生的圖片大小1.9ChildResource1V返回當(dāng)前地圖坐標(biāo)參考系，見ChildResourcecustomParams1stringV自定義參數(shù)ChildResourcekey1stringV用戶密鑰ChildResourceclipRegion1GeometryV地圖顯示裁剪的區(qū)域GB／T39584—2020序號父元素名稱子元素名稱約束類型長度說明ChildResourceclipRegionEnabled1booleanV地圖顯示裁剪的區(qū)域是否有效ChildResourcecustomEntireBounds1Rectangle2DV自定義的地圖全幅顯示范圍ChildResourcecustomEntireBoundsEnabled1booleanV自定義的地圖全幅顯示范圍是否有效ChildResourceangle1doubleV當(dāng)前地圖的旋轉(zhuǎn)角度ChildResourceantialias1booleanV地圖是否光滑顯示ChildResourcebackgroundStyle1StyleV地圖的背景風(fēng)格ChildResourcecoordUnit1UnitV地圖的坐標(biāo)單位ChildResourcedistanceUnit1UnitV地圖的距離量度單位ChildResourcedescription1stringV當(dāng)前地圖的描述信息ChildResourcedynamicProjection1booleanV是否允許地圖動(dòng)態(tài)投影顯示ChildResource1booleanV指定點(diǎn)狀符號的角度是否固定ChildResourcemaxVisibleTextSize1doubleV文本最大可見尺寸，單位為像素ChildResourceminVisibleTextSize1doubleV文本最小可見尺寸，單位為像素ChildResourcemaxVisibleVertex1longV最大幾何對象可見節(jié)點(diǎn)數(shù)，若超過指定數(shù)值，則幾何對象不顯示ChildResourceoverlapDisplayed1booleanV重疊時(shí)是否顯示對象ChildResourcepaintBackground1booleanV是否繪制地圖背景ChildResource1booleanV文本角度是否固定ChildResourcetextOrientationFixed1booleanV文本朝向是否固定圖像接口用于獲取地圖中的一幅地圖圖片。支持方式HTTPGET。請求參數(shù)見表10。GB／T39584—2020表10圖像接口請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰redirectboolean選填centerPoint2D必填指定地圖顯示的中心點(diǎn)，見B.6double必填指定地圖顯示的比例尺widthlong選填heightlong選填transparentboolean選填響應(yīng)結(jié)構(gòu)見表11。其中，地圖參數(shù)見表12,地圖顏色模式見表13,校驗(yàn)方式見表14,圖片返回格式見表15。序號父元素名稱子元素名稱約束類型長度說明1listChildResource*——圖像列表1.1ChildResourceImageUrl1stringV指向地圖圖片的URI1.2ChildResourcemapParam1MapPa-rameterV地圖參數(shù)，描述地圖特征，見表12地圖參數(shù)名稱類型說明angledouble當(dāng)前地圖的旋轉(zhuǎn)角度antialiasboolean地圖是否光滑顯示backgroundStyleStyle地圖的背景風(fēng)格boundsRectangle2D地圖的全幅范圍，見B.8cacheEnabledboolean是否使用緩存centerPoint2D地圖二維中心點(diǎn)坐標(biāo)，見B.6clipRegionGeometry地圖顯示裁剪的區(qū)域，見B.9clipRegionEnabledboolean地圖顯示裁剪區(qū)域是否有效colorMode地圖顏色模式，見表13coordUnitUnit地圖的坐標(biāo)單位枚舉，見B.4customEntireBoundsRectangle2D自定義的地圖全幅顯示范圍，見B.8customEntireBoundsEnabledboolean自定義的地圖全幅顯示范圍是否有效GB／T39584—2020名稱類型說明customParamsstring用戶自定義參數(shù)descriptionstring當(dāng)前地圖的描述信息distanceUnitUnit地圖的距離量度單位枚舉，見B.4dynamicProjectionboolean是否允許地圖動(dòng)態(tài)投影顯示layers地圖中所有圖層列表boolean指定點(diǎn)狀符號的角度是否固定maxScaledouble地圖的最大顯示比例尺maxVisibleTextSizedoublemm)maxVisibleVertexint最大的幾何對象可見節(jié)點(diǎn)數(shù)，若超過指定數(shù)值，則該幾何對象不顯示minScaledouble地圖的最小顯示比例尺minVisibleTextSizedoublemm)namestring目標(biāo)地圖的名稱overlapDisplayedbooleanpaintBackgroundboolean是否繪制地圖背景地圖投影系統(tǒng)，見B.1rectifyTypeRectifyType校驗(yàn)方式，見表14returnImageboolean地圖圖片是否立即返回，即是否要求服務(wù)器生成圖片returnTypeReturnType圖片返回格式，見表15double地圖的顯示比例尺boolean文本角度是否固定textOrientationFixedboolean文本朝向是否固定viewBoundsRectangle2D視窗對應(yīng)的地圖范圍，見B.8viewerRectanglevisibleScalesdouble[]返回地圖的可見比例尺數(shù)組visibleScalesEnabledboolean返回是否使用固定比例尺來顯示地圖表13地圖顏色模式枚舉類型說明BLACK_WHITE__REVERSE黑白反色模式BLACKWHITE黑白模式DEFAULT默認(rèn)彩色模式，對應(yīng)32位增強(qiáng)真彩色模式GRAY灰度模式ONLY_BLACK_WHITE__REVERSE黑白反色，其他顏色不變GB／T39584—2020表14校驗(yàn)方式枚舉類型說明BYCENTERANDMAPSCALE以中心點(diǎn)和比例尺為準(zhǔn)BYVIEWBOUNDS以視圖范圍為準(zhǔn)表15圖片返回格式枚舉類型說明BINARY只返回二進(jìn)制內(nèi)容BUFFEREDIMAGE直接返回緩沖圖片DEFAULT默認(rèn)返回格式，返回URL地址FILEURI只返回文件地址URL只返回URL地址圖像瓦片接口用于獲取由完整的地圖圖片以像素為單位按相同大小切割成而成的格網(wǎng)圖片。支持方式HTTPGET。請求參數(shù)見表16。注：參數(shù)確定了格網(wǎng)的位置等信息。表16圖像瓦片接口請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰redirect選填xint必填格網(wǎng)在地圖中的列號，從左向右遞增，地圖最左上角的格網(wǎng)，列號為0yint必填格網(wǎng)在地圖中的行號，從上向下遞增，地圖最左上角的格網(wǎng)，行號為0必填地圖比例尺，如0.0001表示比例尺為1∶10000widthint選填格網(wǎng)寬度，單位為像素，默認(rèn)值為256int選填格網(wǎng)高度，單位為像素，默認(rèn)值為256transparent選填GB／T39584—2020響應(yīng)結(jié)構(gòu)見表17。表17圖像瓦片接口響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 圖像瓦片列表1.1ChildResourceImageUrl1stringV指向地圖圖片的URI1.2ChildResourcemapParam1MapParameterV地圖參數(shù)，描述地圖特征，見表12圖層集合接口用于獲取地圖中的所有圖層信息。支持方式HTTPGET。請求參數(shù)見表18。表18圖層集合接口請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰響應(yīng)結(jié)構(gòu)見表19。表19圖層集合接口響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 1.1ChildResourcename1stringV圖層名稱，不區(qū)分大小寫，在圖層所在地圖中唯一標(biāo)識此圖層1.2ChildResourcebounds1doubleV圖層范圍1.3ChildResourcecaption1stringV圖層標(biāo)題，默認(rèn)為圖層名稱1.4ChildResourcedescription1stringV圖層描述信息1.5ChildResourcequeryable1booleanV圖層中的對象是否可被查詢GB／T39584—2020序號父元素名稱子元素名稱約束類型長度說明1.6ChildResourcevisible1booleanV圖層是否可見，若否，其他屬性設(shè)置無效1.7ChildResourcetype1LayerTypeV圖層類型，見B.141.8ChildResourcesubLayers1V子圖層集合1.9ChildResourcemaxScale1doubleV圖層最大可見比例尺，不可為負(fù)，若地圖當(dāng)前顯示比例尺大于該值，圖層不顯示，默認(rèn)值為0ChildResourceminScale1doubleV圖層最小可見比例尺，不可為負(fù)，若地圖當(dāng)前顯示比例尺小于該值，圖層不顯示，默認(rèn)值為0ChildResourceminVisibleGeometrySize1doubleV幾何對象的最小可見大小，單位為像素ChildResourceopaqueRate1longVChildResourcesymbolScalable1booleanV圖層符號大小是否隨圖縮放ChildResourcesymbolScale1booleanV圖層符號縮放基準(zhǔn)比例尺，僅在有效圖層接口用于通過圖層名稱或圖層索引號來獲得構(gòu)成地圖的一個(gè)具體的圖層數(shù)據(jù)。支持方式HTTPGET。請求參數(shù)見表20。表20圖層接口請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰響應(yīng)結(jié)構(gòu)見表21。GB／T39584—2020表21圖層接口響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 圖層列表1.1ChildResourcename1stringV圖層名稱，不區(qū)分大小寫，在圖層所在地圖中唯一標(biāo)識此圖層1.2ChildResourcebounds1doubleV圖層范圍1.3ChildResourcecaption1stringVname致1.4ChildResourcedescription1stringV圖層描述信息1.5ChildResourcequeryable1booleanV圖層中對象是否可被查詢1.6ChildResourcevisible1booleanV圖層是否可見，若否，其他屬性設(shè)置無效1.7ChildResourceType1LayerTypeV圖層類型，見B.141.8ChildResourcesubLayers1V子圖層集1.9ChildResourcemaxScale1doubleV圖層最大可見比例尺，不可為負(fù)，若地圖當(dāng)前顯示比例尺大于該值，則圖層不顯示，默認(rèn)值為0ChildResourceminScale1doubleV圖層最小可見比例尺，不可為負(fù)，若地圖當(dāng)前顯示比例尺小于該值，則圖層不顯示，默認(rèn)值為0ChildResourceminVisibleGeometrySize1doubleV幾何對象的最小可見大小，單位為像素ChildResourceopaqueRate1longVChildResourcesymbolScalable1booleanV圖層的符號大小是否隨圖縮放ChildResourcesymbolScale1doubleV圖層符號縮放基準(zhǔn)比例尺，僅在有效ChildResourcedisplayFilter1stringV圖層顯示過濾條件，在數(shù)據(jù)庫屬性數(shù)據(jù)上進(jìn)行過濾。如圖層屬值大于20的幾何對象將顯示在地圖窗口，其余對象不顯示ChildResourcerepresentationField1stringV存儲(chǔ)制圖表達(dá)信息字段，使相應(yīng)幾何對象在地圖窗口中顯示時(shí)，采用其他表現(xiàn)方式，原來的幾何對象不再顯示ChildResourcestyle1StyleV矢量圖層風(fēng)格GB／T39584—20206.3空間數(shù)據(jù)服務(wù)接口提供空間數(shù)據(jù)資源及屬性，并可以對空間數(shù)據(jù)進(jìn)行訪問與操作，一般應(yīng)包括以下功能：單位、距離單位等；f個(gè)要素的URI等信息；；kmn注：查詢方式包括：ID模式、幾何對象的緩沖區(qū)模式、緩沖區(qū)加屬性過濾器模式、空間查詢模式、空間查詢加屬性過空間數(shù)據(jù)服務(wù)接口包括數(shù)據(jù)接口、數(shù)據(jù)源集合接口、數(shù)據(jù)源接口、數(shù)據(jù)集集合接口、數(shù)據(jù)集接口、要素集合接口、要素接口、字段集合接口和要素結(jié)果集合接口。數(shù)據(jù)接口是數(shù)據(jù)查詢和操作的入口，用于提供數(shù)據(jù)源集合和數(shù)據(jù)查詢功能的信息?！磖oot_uri〉/data[.〈format〉］支持方式HTTPGET。請求參數(shù)見表22。表22數(shù)據(jù)接口請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰GB／T39584—2020響應(yīng)結(jié)構(gòu)見表23。表23數(shù)據(jù)接口響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource*——數(shù)據(jù)資源列表1.1ChildResourcename1stringV資源名稱1.2ChildResourcepath1stringV資源訪問路徑1.3ChildResource1stringV資源配置項(xiàng)ID1.4ChildResourceresourceType1stringV資源類型枚舉，見B.161.5ChildResourcesupportedMediaTypes1V支持的媒體類型集合6.3.3數(shù)據(jù)源集合接口數(shù)據(jù)源集合接口用于獲取服務(wù)器上的所有數(shù)據(jù)源的信息?！磀ata_uri〉/datasources[.〈format〉］支持方式HTTPGET。請求參數(shù)見表24。表24數(shù)據(jù)源集合接口請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰響應(yīng)結(jié)構(gòu)見表25。表25數(shù)據(jù)源集合接口響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 數(shù)據(jù)源集合資源列表1.1ChildResourcedatasourceNames1V數(shù)據(jù)源名稱列表1.2ChildResourcedatasourceCount1intV數(shù)據(jù)源集合中數(shù)據(jù)源的數(shù)目1.3ChildResourcechildUriList1V數(shù)據(jù)源訪問的URI列表GB／T39584—2020數(shù)據(jù)源接口用于獲取和修改服務(wù)器上的一個(gè)具體的數(shù)據(jù)源信息，也用于獲取該數(shù)據(jù)源所包含的數(shù)據(jù)集列表。數(shù)據(jù)源接口可獲取的數(shù)據(jù)源信息包括：數(shù)據(jù)源名稱、數(shù)據(jù)源描述、引擎類型、距離單位、坐標(biāo)單位、投影信息等。數(shù)據(jù)源接口可修改的數(shù)據(jù)源信息包括：數(shù)據(jù)源描述、坐標(biāo)單位、距離單位等。〈datasources_uri〉/name/{datasourceName}[.〈format〉］〈datasources_uri〉/index/{datasourceIndex}[.〈format〉］〈datasources_uri〉/{datasourceName}[.〈format〉］〈datasources_uri〉/{datasourceIndex}[.〈format〉］支持方式HTTPGET、PUT。GET方式接口參數(shù)說明GET方式用于獲取數(shù)據(jù)源信息，以及數(shù)據(jù)源所包含的數(shù)據(jù)集列表，請求參數(shù)見表26。GET名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰GET方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表27。其中，數(shù)據(jù)源信息見表28,數(shù)據(jù)源引擎類型見表29。GET序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 數(shù)據(jù)源資源列表1.1ChildResourcedatasourceInfo1DatasourceInfoV數(shù)據(jù)源信息，見表281.2ChildResourcechildUriList1V子資源，即數(shù)據(jù)集集合資源的URI列表表28數(shù)據(jù)源信息參數(shù)類型說明coordUnitUnit坐標(biāo)單位枚舉，見B.4descriptionstring數(shù)據(jù)源描述distanceUnitUnit距離單位枚舉，見B.4GB／T39584—2020表28（續(xù)）參數(shù)類型說明engineTypeEngineType數(shù)據(jù)源引擎類型，該字段只讀，見表29namestring數(shù)據(jù)源的別名，用于在工作空間中唯一標(biāo)識數(shù)據(jù)源，該字段只讀投影信息，見B.1表29數(shù)據(jù)源引擎類型枚舉類型說明DB2DB2數(shù)據(jù)庫引擎GOOGLEMAPS谷歌地圖引擎IMAGEPLUGINS影像只讀引擎ISERVERRESTREST地圖服務(wù)引擎，該引擎為只讀引擎，且不能創(chuàng)建KINGBASEMAPWORLD天地圖服務(wù)引擎，該引擎為只讀引擎，且不能創(chuàng)建OGCOGC引擎，針對Web數(shù)據(jù)源ORACLEPLUSORACLESPATIALPOSTGRESQLSQLPLUSUDB文件型數(shù)據(jù)庫引擎PUT方式接口參數(shù)說明PUT方式用于修改數(shù)據(jù)源信息，請求參數(shù)見表30。表30數(shù)據(jù)源接口PUT方式請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰descriptionstring必填數(shù)據(jù)源描述coordUnitUnit必填坐標(biāo)單位，見B.4distanceUnitUnit必填距離單位，見B.PUT方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表31。GB／T39584—2020表31數(shù)據(jù)源接口PUT方式響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource* datasource資源列表1.1ChildResource1booleanV數(shù)據(jù)源信息修改是否成功1.2ChildResourceerror1HttpErrorV出錯(cuò)信息，見D,操作成功無本字段6.3.5數(shù)據(jù)集集合接口數(shù)據(jù)集集合接口用于創(chuàng)建一個(gè)隸屬于當(dāng)前數(shù)據(jù)源的數(shù)據(jù)集合，包括點(diǎn)、線、面數(shù)據(jù)集?！磀atasource_uri〉/datasets[.〈format〉］支持方式HTTPGET、POST。GET方式接口參數(shù)說明GET方式用于獲取數(shù)據(jù)源中的所有數(shù)據(jù)集的信息，請求參數(shù)見表32。表32數(shù)據(jù)集集合接口GET方式請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰GET方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表33。GET序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 數(shù)據(jù)集集合資源列表1.1ChildResourcedatasetCount1intV數(shù)據(jù)源中數(shù)據(jù)集個(gè)數(shù)1.2ChildResourcedatasetsNames1V數(shù)據(jù)集名稱列表1.3ChildResourcechildUriList1V數(shù)據(jù)集訪問路徑（即數(shù)據(jù)集URI資源）列表POST方式接口參數(shù)說明POST方式用于創(chuàng)建一個(gè)新數(shù)據(jù)集，包含兩種情況。第一種，通過設(shè)置數(shù)據(jù)集名稱和數(shù)據(jù)集類型來創(chuàng)建新數(shù)據(jù)集，請求參數(shù)見表34,數(shù)據(jù)集類型見表35。第二種，通過復(fù)制數(shù)據(jù)集的方式創(chuàng)建新數(shù)據(jù)集，請求參數(shù)見表36。GB／T39584—2020POT名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰datasetNamestring必填數(shù)據(jù)集名稱datasetTypedatasetType必填數(shù)據(jù)集類型，見表35表35數(shù)據(jù)集類型枚舉類型說明CAD復(fù)合數(shù)據(jù)集LINE線數(shù)據(jù)集POINT點(diǎn)數(shù)據(jù)集REGION面數(shù)據(jù)集TABULAR純屬性數(shù)據(jù)集TEXT文本數(shù)據(jù)集POT名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰srcDatasourceNamestring必填源數(shù)據(jù)源名稱srcDatasetNamestring必填源數(shù)據(jù)集名稱destDatasetNamestring必填要?jiǎng)?chuàng)建的目標(biāo)數(shù)據(jù)集名稱POST方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表37。POT序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 數(shù)據(jù)集集合資源列表1.1ChildResource1booleanV創(chuàng)建數(shù)據(jù)集是否成功1.2ChildResourcenewResourceID1stringV新創(chuàng)建的數(shù)據(jù)集資源ID1.3ChildResourcenewResourceLocation1stringV新創(chuàng)建的數(shù)據(jù)集資源URI1.4ChildResourceerror1HttpErrorV出錯(cuò)信息，見附錄D,創(chuàng)建成功無此參數(shù)GB／T39584—2020數(shù)據(jù)集接口用于獲取隸屬于某個(gè)數(shù)據(jù)源的一個(gè)數(shù)據(jù)集的信息?！磀atasets_uri〉/name/{datasetName}[.〈format〉］〈datasets_uri〉/index/{datasetIndex}[.〈format〉］〈datasets_uri〉/{datasetName}[.〈format〉］〈datasets_uri〉/{datasetIndex}[.〈format〉］支持方式HTTPGET、PUT、DELETE。GET方式接口參數(shù)說明GET方式用于獲取數(shù)據(jù)集信息，請求參數(shù)見表38。GET名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰GET方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表39。其中，數(shù)據(jù)集信息見表40,壓縮編碼方式見表41,數(shù)據(jù)集字符集見表42,數(shù)據(jù)集像素格式見表43。GET序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 獲取數(shù)據(jù)集信息列表1.1ChildResourcedatasetInfo1DatasetInfoV數(shù)據(jù)集信息，見表401.2ChildResourcechildUriList1V子資源列表表40數(shù)據(jù)集信息名稱類型說明namestring數(shù)據(jù)集名稱，不區(qū)分大小寫，數(shù)據(jù)集的唯一標(biāo)識descriptionstring數(shù)據(jù)集的描述信息typedatasetType數(shù)據(jù)集類型，見表35boundsRectangle2D數(shù)據(jù)集范圍，見B.8dataSourceNamestring數(shù)據(jù)集所屬的數(shù)據(jù)源名稱encodeTypeEncodeType定義數(shù)據(jù)集存儲(chǔ)時(shí)的壓縮編碼方式，見表41GB／T39584—2020表40（續(xù)）名稱類型說明boolean數(shù)據(jù)集是否為只讀數(shù)據(jù)集的投影信息，見B.1tableNamestring表名，對數(shù)據(jù)庫型數(shù)據(jù)源，指此數(shù)據(jù)集在數(shù)據(jù)庫中所對應(yīng)的數(shù)據(jù)表名稱，對文本型數(shù)據(jù)源，指此數(shù)據(jù)集存儲(chǔ)屬性的表名稱charsetCharset定義數(shù)據(jù)集的字符集，見表42,當(dāng)數(shù)據(jù)集資源標(biāo)識為矢量數(shù)據(jù)集時(shí)存在isFileCacheboolean是否使用文件形式的緩存，當(dāng)數(shù)據(jù)集資源標(biāo)識為矢量數(shù)據(jù)集時(shí)存在blockSizelong像素分塊的大小，當(dāng)數(shù)據(jù)集資源標(biāo)識為格網(wǎng)或影像數(shù)據(jù)集時(shí)存在heightlong數(shù)據(jù)的高度，當(dāng)數(shù)據(jù)集資源標(biāo)識為格網(wǎng)數(shù)據(jù)集或影像數(shù)據(jù)集時(shí)存在widthlong數(shù)據(jù)的寬度，當(dāng)數(shù)據(jù)集資源標(biāo)識為格網(wǎng)數(shù)據(jù)集或影像數(shù)據(jù)集時(shí)存在pixelFormatPixelFormat定義數(shù)據(jù)集的像素格式，見表43,當(dāng)數(shù)據(jù)集資源標(biāo)識為格網(wǎng)或影像數(shù)據(jù)集時(shí)存在isMultiBandboolean影像是否多波段影像，當(dāng)數(shù)據(jù)集資源標(biāo)識為影像數(shù)據(jù)集時(shí)存在palette影像數(shù)據(jù)顏色調(diào)色板，當(dāng)數(shù)據(jù)集資源標(biāo)識為影像數(shù)據(jù)集時(shí)存在表41數(shù)據(jù)集編碼方式枚舉類型說明BYTE單字節(jié)編碼方式DCTDCT編碼方式INT16雙字節(jié)編碼方式INT24三字節(jié)編碼方式INT32四字節(jié)編碼方式LZWLZW編碼方式NONE無任何編碼方式PNGPNG編碼方式，支持多種位深的圖像GB／T39584—2020表42數(shù)據(jù)集字符集類型枚舉類型說明ANSIASCII字符集CHINESEBIG5中國香港和臺(tái)灣最常用的中文字符集DEFAULT擴(kuò)展的ASCII字符集GB18030在中國大陸使用的中文字符集UNICODEUnicode標(biāo)準(zhǔn)編碼UTF32UTF-32或UCS-4編碼UTF8UTF-8編碼WINDOWS1252英文常用編碼表43數(shù)據(jù)集像素格式枚舉類型說明BIT8每個(gè)像元用8個(gè)比特，即1個(gè)字節(jié)表示BIT16每個(gè)像元用16個(gè)比特，即2個(gè)字節(jié)表示BIT32每個(gè)像元用32個(gè)比特，即4個(gè)字節(jié)表示BIT64每個(gè)像元用64個(gè)比特，即8個(gè)字節(jié)表示RGB每個(gè)像元用24個(gè)比特，即3個(gè)字節(jié)表示RGBA每個(gè)像元用32個(gè)比特，即4個(gè)字節(jié)表示SINGLE每個(gè)像元用4個(gè)字節(jié)表示DOUBLE每個(gè)像元用8個(gè)字節(jié)表示UBIT1每個(gè)像元用1個(gè)比特表示UBIT4每個(gè)像元用4個(gè)比特表示UBIT8每個(gè)像元用8個(gè)比特，即1個(gè)字節(jié)表示UBIT16每個(gè)像元用16個(gè)比特，即2個(gè)字節(jié)表示UBIT32每個(gè)像元用32個(gè)比特，即4個(gè)字節(jié)來表示PUT方式接口參數(shù)說明PUT方式用于創(chuàng)建數(shù)據(jù)集或修改數(shù)據(jù)集信息。分為兩種情況。第一種，數(shù)據(jù)集資源不存在，對一個(gè)新的URI發(fā)送PUT請求，表示創(chuàng)建數(shù)據(jù)集，請求參數(shù)見表44。第二種，數(shù)據(jù)集資源存在，對其執(zhí)行PUT請求，表示修改數(shù)據(jù)集信息，請求參數(shù)見表45。GB／T39584—2020表44數(shù)據(jù)集接口PUT方式創(chuàng)建數(shù)據(jù)集請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰datasetNamestring必填數(shù)據(jù)集名稱datasetTypedatasetType必填數(shù)據(jù)集類型枚舉，見表35表45數(shù)據(jù)集接口PUT方式修改數(shù)據(jù)集請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰descriptionstring必填數(shù)據(jù)集描述信息選填投影坐標(biāo)系，見B.1charsetenum選填矢量數(shù)據(jù)集的字符集paletteList〈Color〉選填數(shù)據(jù)集類型為矢量數(shù)據(jù)集時(shí)傳遞此參數(shù)，空值表示編碼方式不變noValuedouble選填影像數(shù)據(jù)的顏色調(diào)色板PUT方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表46。表46數(shù)據(jù)集接口PUT方式響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource*——數(shù)據(jù)集資源列表1.1ChildResource1booleanV操作是否成功1.2ChildResourcenewResourceLocation1stringV新創(chuàng)建的數(shù)據(jù)集資源URI,若執(zhí)行修改操作，則無本字段1.3ChildResourceerror1HttpErrorV出錯(cuò)信息，見附錄D,創(chuàng)建成功無本字段DELETE方式接口參數(shù)說明DELETE方式用于刪除數(shù)據(jù)集，請求參數(shù)見表47。表47數(shù)據(jù)集接口DELETE方式請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰DELETE方式接口參數(shù)說明響應(yīng)結(jié)構(gòu)見表48。GB／T39584—2020表48數(shù)據(jù)集接口DELETE方式響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource*——數(shù)據(jù)集資源列表1.1ChildResource1booleanV刪除數(shù)據(jù)集是否成功1.2ChildResourceerror1HttpErrorV出錯(cuò)信息，見附錄D,操作成功無本字段要素集合接口用于獲取一個(gè)數(shù)據(jù)集中所有要素集合的列表，包括點(diǎn)、線、面數(shù)據(jù)集、文本數(shù)據(jù)集、復(fù)合數(shù)據(jù)集、純屬性表數(shù)據(jù)集，也用于對該數(shù)據(jù)集中的指定要素進(jìn)行添加、刪除或修改操作?！磀ataset_uri〉/features[.〈format〉］支持方式HTTPGET、POST、DELETE。GET方式接口參數(shù)說明GET方式用于獲取一個(gè)數(shù)據(jù)集中的要素集合的信息，包括要素的個(gè)數(shù)、要素對應(yīng)的幾何對象類型、各個(gè)要素的URI等，請求參數(shù)見表49。GET名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰fromIndexlong選填要素信息集合的起始索引號，默認(rèn)值為0toIndexlong選填要素信息集合的終止索引號，默認(rèn)值為GET方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表50。GET序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 要素集合資源列表1.1ChildResourcefeatureCount1longV數(shù)據(jù)集中要素的總數(shù)量1.2ChildResourcegeometryType1GeometryTypeV要素類型1.3ChildResourcechildUriList1V要素URI資源列表GB／T39584—20POST方式接口參數(shù)說明POST方式用于對要素集合中的要素進(jìn)行添加、刪除或修改操作。請求參數(shù)見表51。POT名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰returnContentboolean選填trueIDfalse表示返回新創(chuàng)建的要素結(jié)果資源URI_methodstring選填method=DELETE,則表示刪除要素POST方式接口響應(yīng)結(jié)構(gòu)對要素集合執(zhí)行POST請求，添加或修改要素時(shí)，應(yīng)在請求體中包含添加或修改的要素信息集合，要素信息見表52,響應(yīng)結(jié)構(gòu)見表53。POT序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 要素集合資源列表1.1ChildResource1booleanV操作是否成功1.2ChildResourcenewResourceID1stringV創(chuàng)建的要素結(jié)果資源ID1.3ChildResourcenewResourceLocation1stringV創(chuàng)建的要素結(jié)果資源URI1.4ChildResourceerror1HttpErrorV出錯(cuò)信息，見附錄D,操作成功無本字段POT名稱類型參數(shù)性質(zhì)說明fieldNames必填要素的屬性字段名集合fieldValues必填要素的屬性字段值集合geometryGeometry必填要素對應(yīng)的幾何對象，見B.9IDs必填DELET方式接口參數(shù)說明對要素進(jìn)行刪除時(shí)，應(yīng)在請求體中包含欲刪除要素的ID數(shù)組，請求體結(jié)構(gòu)見表54。GB／T39584—2020表54要素集合接口DELETE方式請求體結(jié)構(gòu)名稱類型參數(shù)性質(zhì)說明IDs必填要素的ID數(shù)組DELET方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表55。表55要素集合接口DELETE方式響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource*——要素集合資源列表1.1ChildResource1booleanV操作是否成功1.2ChildResourceerror1HttpErrorV出錯(cuò)信息，見附錄D,操作成功無本字段要素接口用于通過要素的ID號和索引號來獲取要素的信息，也用于修改或刪除要素。注：僅當(dāng)要素類型為點(diǎn)、線、面、文本、復(fù)合數(shù)據(jù)集、純屬性表數(shù)據(jù)集時(shí)，才可執(zhí)行修改或刪除要素的操作。〈features_uri〉/{featureID}[.〈format〉］〈data_uri〉/feature/{datasourceIndex}-{datasetIndex}-{featureIndex}[.〈format〉］支持方式HTTPGET、PUT、DELETE。GET方式接口參數(shù)說明GET方式用于獲取一個(gè)要素的信息，包括屬性字段名稱列表、屬性字段值列表、要素對應(yīng)的幾何對象等，請求參數(shù)見表56。GET名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰hasGeometryboolean選填GET方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表57。注：若不傳參數(shù)，對要素資源執(zhí)行GET請求，則得到的表述中會(huì)包含幾何對象的信息。GB／T39584—2020GET序號父元素名稱子元素名稱約束類型長度說明1listChildResource*——要素資源列表1.1ChildResourceID1longV要素ID1.2ChildResourcefieldNames1V要素屬性字段名集合1.3ChildResourcefieldValues1V要素屬性字段值集合1.4ChildResourcegeometry1GeometryV要素對應(yīng)的幾何對象，見B.PUT方式接口參數(shù)說明PUT方式用于修改一個(gè)要素，請求參數(shù)見表58。表58要素接口PUT方式請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰fieldNamesstring必填預(yù)修訂要素屬性字段名集合fieldValuesstring必填geometryGeometry必填要素對應(yīng)的幾何對象，見B.PUT方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表59。表59要素接口PUT方式響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 要素資源列表1.1ChildResource1booleanV操作是否成功1.2ChildResourceerror1HttpErrorV出錯(cuò)信息，見附錄D,操作成功無本字段DELETE方式接口參數(shù)說明DELETE方式用于刪除一個(gè)要素，請求參數(shù)見表60。表60要素接口DELETE方式請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰GB／T39584—20DELETE方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表61。表61要素接口DELETE方式響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 要素資源列表1.1ChildResourcekey1stringV用戶密鑰1.2ChildResource1booleanV操作是否成功1.3ChildResourceerror1HttpErrorV出錯(cuò)信息，見附錄D,操作成功無本字段字段集合接口用于獲取一個(gè)數(shù)據(jù)集中的所有屬性字段的集合信息，也用于添加一個(gè)新的字段。注：僅能在空數(shù)據(jù)集上執(zhí)行添加字段的操作?！磀ataset_uri〉/fields[.〈format〉］。支持方式HTTPGET、POST。GET方式接口參數(shù)說明GET方式用于獲取字段信息集合，請求參數(shù)見表62。GET名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰GET方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表63。GET序號父元素名稱子元素名稱約束類型長度說明1listChildResource*——字段集合資源列表1.1ChildResourcefieldNames1V字段名稱列表1.2ChildResourcechildUriList1V字段信息訪問路徑列表POST方式接口參數(shù)說明POST方式用于向空數(shù)據(jù)集添加字段，請求參數(shù)見表64。其中，字段類型見表65。GB／T39584—2020POT名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰namestring必填字段名稱，唯一標(biāo)識一個(gè)字段string必填字段別名，不同的字段可以有相同的別名TypeFieldType必填字段類型，見表65defaultValuestring必填字段默認(rèn)值isRequiredboolean必填是否為必填字段表65字段類型枚舉類型說明BOOLEAN布爾型BYTE字節(jié)型CHAR變長的寬字節(jié)字符類型DATETIME日期型DOUBLE64位精度浮點(diǎn)型INT1616位整型INT3232位整型INT6464位整型LONGBINARY二進(jìn)制型SINGLE32位精度浮點(diǎn)型TEXT文本型WTEXT寬字符類型字段POST方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表66。POT序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 字段集合資源列表1.1ChildResource1booleanV操作是否成功1.2ChildResourcenewResourceID1stringV新創(chuàng)建的字段資源ID1.3ChildResourcenewResourceLoaction1stringV新創(chuàng)建的字段資源URI1.4ChildResourceerror1HttpErrorV出錯(cuò)信息，見附錄D,創(chuàng)建成功無本字段GB／T39584—20206.3.10要素結(jié)果集合接口要素結(jié)果集合接口用于查詢當(dāng)前或不同數(shù)據(jù)源中的數(shù)據(jù)，獲取符合查詢條件的要素結(jié)果的集合?！磀ata_uri〉/featureResults[.〈format〉］支持方式HTTPGET、POST。6.3.10.3GET方式接口參數(shù)GET方式用于獲取符合查詢條件的要素結(jié)果資源的集合，請求參數(shù)見表67。GET名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰6.3.10.4GET方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表68。GET序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 要素結(jié)果集合資源列表1.1ChildResourcestring1stringV要素結(jié)果資源的名稱1.2ChildResourcestring1stringV要素結(jié)果資源的訪問路徑1.3ChildResourcestring1stringV資源配置項(xiàng)ID1.4ChildResourcestring1stringV資源類型1.5ChildResource1V數(shù)據(jù)源資源支持的表述媒體類型6.3.10.5POST方式接口參數(shù)說明POST方式用于根據(jù)給定條件，創(chuàng)建一個(gè)符合查詢條件的要素結(jié)果資源，URI參數(shù)見表69,請求體參數(shù)見表70,其中，數(shù)據(jù)查詢方式見表71,空間查詢模式見表72,查詢參數(shù)見表73。POTURI名稱類型參數(shù)性質(zhì)說明returnContentboolean選填fromIndexlong選填toIndexlong選填GB／T39584—2020POT名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰getFeatureModeGetFeatureMode必填數(shù)據(jù)查詢方式，見表71datasetNames必填數(shù)據(jù)集名稱數(shù)組(datasourceName:datasetName)ids必填要獲取資源ID數(shù)組boundsRectangle2D必填有效geometryGeometry必填SPATIAL、BUFFER__ATTRIBUTEFILTER、SPATIAL_ATTRIBUTEFILTER時(shí)有效bufferDistancedouble必填BUFFER__ATTRIBUTEFILTER時(shí)有效attributeFilterstring必填A(yù)TTRIBUTEFILTER、SPATIAL_ATTRIBUTEFILTER、BOUNDS_ATTRIBUTEFILTER時(shí)有效spatialQueryModespatialQueryMode必填TIAL、SPATIAL__ATTRIBUTEFILTER時(shí)有效queryParameterQueryParameter必填表71數(shù)據(jù)查詢方式枚舉類型說明BOUNDS通過范圍查詢來獲取要素BOUNDS__ATTRIBUTEFILTER通過范圍查詢加屬性過濾器的模式來獲取要素BUFFER通過幾何對象的緩沖區(qū)來獲取要素BUFFER__ATTRIBUTEFILTER通過緩沖區(qū)加屬性過濾器的模式來獲取要素ID通過ID來獲取要素SPATIAL通過空間查詢模式來獲取要素SPATIAL__ATTRIBUTEFILTER通過空間查詢加屬性過濾器的模式來獲取要素SQL通過SQL查詢來獲取要素GB／T39584—2020表72空間查詢模式枚舉類型說明CONTAIN包含空間查詢模式CROSS交叉空間查詢模式DISJOINT分離空間查詢模式IDENTITY重合空間查詢模式INTERSECT相交空間查詢模式OVERLAP疊加空間查詢模式TOUCH鄰接空間查詢模式WITHIN被包含空間查詢模式NONE無空間查詢表73查詢參數(shù)名稱類型說明attributeFilterstring屬性過濾條件fields查詢字段數(shù)組，若不設(shè)置則使用系統(tǒng)返回的所有字段groupBystringSQL查詢中結(jié)果分組條件的字段idsint[]查詢ID數(shù)組joinItemsJoinItem[]關(guān)聯(lián)查詢項(xiàng)數(shù)組，見表74linkItemsLinkItem[]與外部表的關(guān)聯(lián)信息數(shù)組，見表76namestring數(shù)據(jù)集名稱或圖層名稱orderBystring表74關(guān)聯(lián)查詢項(xiàng)名稱類型說明foreignTableNamestring外部表的名稱joinFilterstring與外部表之間的連接表達(dá)式，即設(shè)定兩個(gè)表之間關(guān)聯(lián)的字段joinTypeJoinType兩個(gè)表之間連接的類型枚舉，變量說明見表75表75表連接類型枚舉類型說明INNERJOIN內(nèi)連接LEFTJOIN左連接GB／T39584—2020表76關(guān)聯(lián)信息名稱類型說明datasourceConnectionInfoDatasourceConnectionInfo關(guān)聯(lián)的外部數(shù)據(jù)源連接信息，見表77foreignKeys主空間數(shù)據(jù)集的外鍵foreignTablestring關(guān)聯(lián)的外部屬性表名稱（另一矢量數(shù)據(jù)集對應(yīng)的DBMS表）linkFields欲保留的外部屬性表的字段linkFilterstring與外部屬性表的連接查詢條件namestring此關(guān)聯(lián)信息對象的名稱primaryKeys外部屬性表的主鍵表77數(shù)據(jù)源連接信息名稱類型說明aliasstring數(shù)據(jù)源別名connectboolean數(shù)據(jù)源是否自動(dòng)連接數(shù)據(jù)dataBasestring數(shù)據(jù)源連接的數(shù)據(jù)庫名driverstring數(shù)據(jù)源連接所需的驅(qū)動(dòng)程序名engineTypeEngineType數(shù)據(jù)源連接的引擎類型枚舉，變量說明見表29exclusiveboolean是否以獨(dú)占方式打開數(shù)據(jù)源openLinkTableboolean是否把數(shù)據(jù)庫中的其他矢量數(shù)據(jù)集所對應(yīng)的DBMS表作為LinkTable打開passwordstring登錄數(shù)據(jù)源連接的數(shù)據(jù)庫或文件的密碼boolean是否以只讀方式打開數(shù)據(jù)源serverstring數(shù)據(jù)庫服務(wù)器名、文件名或服務(wù)地址userstring登錄數(shù)據(jù)庫的用戶名6.3.10.6POST方式接口響應(yīng)結(jié)構(gòu)素描述結(jié)構(gòu)見表79。POT序號父元素名稱子元素名稱約束類型長度說明1listChildResource*——要素結(jié)果集合資源列表1.1ChildResource1booleanV數(shù)據(jù)查詢是否成功1.2ChildResourcenewResourceID1stringV創(chuàng)建的要素結(jié)果資源ID1.3ChildResourcenewResourceLocation1stringV創(chuàng)建的要素結(jié)果資源URIGB／T39584—2020表79元素結(jié)構(gòu)描述序號父元素名稱子元素名稱約束類型長度說明1listChildResource*——單個(gè)要素結(jié)構(gòu)列表1.1ChildResourceID1intV要素ID1.2ChildResourcefieldNames1V要素屬性字段名集合1.3ChildResourcefieldValues1V要素屬性字段值集合1.4ChildResourceGeometry1GeometryV要素對應(yīng)的幾何對象，見B.96.4空間分析服務(wù)接口提供空間分析資源及特征，用于對幾何對象的空間分析服務(wù)，一般應(yīng)包括以下功能：空間分析服務(wù)接口包括空間分析接口、幾何對象接口、緩沖區(qū)分析結(jié)果集合接口、緩沖區(qū)分析結(jié)果接口、疊加分析結(jié)果集合接口和疊加分析結(jié)果接口?？臻g分析接口用于獲取所有支持空間分析的資源的相關(guān)信息，即資源列表。支持方式HTTPGET。請求參數(shù)見表80。表80空間分析接口請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰響應(yīng)結(jié)構(gòu)見表81。GB／T39584—2020表81空間分析接口響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 空間分析資源列表1.1ChildResourcename1stringV資源名1.2ChildResourcepath1stringV資源路徑，即URL1.3ChildResourcesupportedMediaTypes1V支持的媒體類型集合幾何對象接口用于獲取所有對幾何對象進(jìn)行空間分析的資源信息，即所有支持的對幾何對象進(jìn)行空間分析的列表。支持方式HTTPGET。請求參數(shù)見表82。表82幾何對象接口請求參數(shù)名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰響應(yīng)結(jié)構(gòu)見表83。表83幾何對象接口響應(yīng)結(jié)構(gòu)序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 幾何對象資源列表1.1ChildResourcename1stringV資源名1.2ChildResourcepath1stringV資源路徑，即URL1.3ChildResourcesupportedMediaTypes1V支持的媒體類型集合6.4.4緩沖區(qū)分析結(jié)果集合接口緩沖區(qū)分析結(jié)果集合接口用于獲取或創(chuàng)建對幾何對象進(jìn)行緩沖區(qū)分析的結(jié)果集合資源。GB／T39584—2020支持方式HTTPGET、POST。GET方式接口參數(shù)說明GET方式用于獲取對幾何對象進(jìn)行緩沖區(qū)分析的結(jié)果集資源，請求參數(shù)見表84。GET名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰GET方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表85。GET序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 緩沖區(qū)分析結(jié)果集合資源列表1.1ChildResourcename1stringV子資源名1.2ChildResourcepath1string子資源路徑，即URL1.3ChildResourcesupportedMediaTypes1子資源支持的媒體類型列表POST方式接口參數(shù)說明POST方式用于創(chuàng)建一個(gè)幾何對象緩沖區(qū)分析結(jié)果資源，其URI參數(shù)見表86,請求體參數(shù)見表87。其中，緩沖區(qū)分析參數(shù)見表88。POTURI名稱類型參數(shù)性質(zhì)說明returnCon-tentboolean選填POT名稱類型參數(shù)性質(zhì)說明keystring必填用戶密鑰sourceGeometryGeometry必填進(jìn)行緩沖區(qū)分析的幾何要素，見B.9analystParameterrameter必填緩沖區(qū)分析參數(shù)，線對象可設(shè)置左、右側(cè)緩沖距離，點(diǎn)和面對象只能設(shè)置左側(cè)緩沖距離，見表88GB／T39584—2020表88緩沖區(qū)分析參數(shù)名稱類型說明endTypeBufferEndType線對象緩沖區(qū)端點(diǎn)類型，見表89leftDistanceBufferDistance緩沖區(qū)半徑距離單位，見B.15radiusUnitBufferRadiusUnit緩沖區(qū)半徑單位，見表90rightDistanceBufferDistance右側(cè)緩沖距離，見B.15semicircleLineSegmentint圓頭緩沖圓弧處線段個(gè)數(shù)，即用多少個(gè)線段來模擬該圓弧，默認(rèn)值為4表89緩沖區(qū)端點(diǎn)類型枚舉類型說明FLAT平頭緩沖，即線對象緩沖區(qū)分析結(jié)果的端點(diǎn)是平頭ROUND圓頭緩沖，即線對象緩沖區(qū)分析結(jié)果的端點(diǎn)是圓頭表90緩沖區(qū)半徑單位枚舉類型說明MILLIMETER毫米(mm)CENTIMETER厘米(cm)DECIMETER分米(dm)METER米(m)KILOMETER千米(km)INCH英寸(in)FOOT英尺(ft)MILE英里(mi)YARDPOST方式接口響應(yīng)結(jié)構(gòu)響應(yīng)結(jié)構(gòu)見表91。其中，POST請求的結(jié)果類型見表92。POT序號父元素名稱子元素名稱約束類型長度說明1listChildResource* 緩沖分析結(jié)果集合資源列表1.1ChildResource1booleanV分析是否成功1.2ChildResourcen