常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范

1、常熟市地方標(biāo)準(zhǔn) 常熟市地理信息共享平臺常熟市地理信息共享平臺 地理信息發(fā)布接口規(guī)范地理信息發(fā)布接口規(guī)范 (初稿初稿) 2008-發(fā)布 2008- 實(shí)施 常 熟 市 城 鄉(xiāng) 規(guī) 劃 局 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 2 - 目目 錄錄 1引言.3 1.1編寫目的.3 1.2定義.3 1.2.1http 協(xié)議簡介.3 1.2.2ogc 簡介.6 2系統(tǒng)權(quán)限設(shè)計(jì).8 2.1權(quán)限架構(gòu).8 2.2用戶狀態(tài)維護(hù).10 3服務(wù)接口規(guī)范.12 3.1請求參數(shù)規(guī)則.12 3.1.1參數(shù)順序和大小寫.12 3.1.2參數(shù)列表.12 3.2登錄服務(wù).12 3.3wms 服務(wù).13 3.3.1wms

2、 getcapabilities.13 3.3.2wms getmap.27 3.3.3wms getfeatureinfo.31 3.4wfs 服務(wù) .36 3.4.1wms getcapabilities.36 3.4.2wfs getfeature 接口.50 3.5tile 服務(wù).72 3.5.1瓦片服務(wù)與傳統(tǒng) webgis 的區(qū)別.72 3.5.2服務(wù)約定.73 3.5.3請求 url.73 3.5.4請求參數(shù)說明.74 3.5.5請求參考.74 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 3 - 1引言引言 1.1 編寫目的編寫目的 本文檔旨在詳細(xì)介紹服務(wù)子系統(tǒng)的二次開發(fā)使用方

3、法。本文檔的讀者對象 有客戶、項(xiàng)目經(jīng)理、開發(fā)人員、測試人員、軟件維護(hù)人員。 1.2 定義定義 1.2.1http 協(xié)議簡介協(xié)議簡介 http 是一個屬于應(yīng)用層的面向?qū)ο蟮膮f(xié)議，由于其簡捷、快速的方式， 適用于分布式超媒體信息系統(tǒng)。它于 1990 年提出，經(jīng)過幾年的使用與發(fā)展，得 到不斷地完善和擴(kuò)展。目前在 www 中使用的是 http/1.0 的第六版， http/1.1 的規(guī)范化工作正在進(jìn)行之中，而且 http-ng(next generation of http)的 建議已經(jīng)提出。 （一）（一）http 協(xié)議的主要特點(diǎn)協(xié)議的主要特點(diǎn) http 協(xié)議的主要特點(diǎn)可概括如下： 1. 支持客戶/服

4、務(wù)器模式。 2. 簡單快速：客戶向服務(wù)器請求服務(wù)時，只需傳送請求方法和路徑。請求方 法常用的有 get、head、post。每種方法規(guī)定了客戶與服務(wù)器聯(lián)系的 類型不同。由于 http 協(xié)議簡單，使得 http 服務(wù)器的程序規(guī)模小，因而 通信速度很快。 3. 靈活：http 允許傳輸任意類型的數(shù)據(jù)對象。正在傳輸?shù)念愋陀?content- type 加以標(biāo)記。 4. 無連接：無連接的含義是限制每次連接只處理一個請求。服務(wù)器處理完客 戶的請求，并收到客戶的應(yīng)答后，即斷開連接。采用這種方式可以節(jié)省傳 輸時間。 5. 無狀態(tài)：http 協(xié)議是無狀態(tài)協(xié)議。無狀態(tài)是指協(xié)議對于事務(wù)處理沒有記 憶能力。缺少狀態(tài)

5、意味著如果后續(xù)處理需要前面的信息，則它必須重傳， 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 4 - 這樣可能導(dǎo)致每次連接傳送的數(shù)據(jù)量增大。另一方面，在服務(wù)器不需要先 前信息時它的應(yīng)答就較快。 （二）（二）http 協(xié)議的幾個重要概念協(xié)議的幾個重要概念 1. 連接(connection)：一個傳輸層的實(shí)際環(huán)流，它是建立在兩個相互通訊的應(yīng) 用程序之間。 2. 消息(message)：http 通訊的基本單位，包括一個結(jié)構(gòu)化的八元組序列并 通過連接傳輸。 3. 請求(request)：一個從客戶端到服務(wù)器的請求信息包括應(yīng)用于資源的方法、 資源的標(biāo)識符和協(xié)議的版本號 4. 響應(yīng)(response

6、)：一個從服務(wù)器返回的信息包括 http 協(xié)議的版本號、請 求的狀態(tài)(例如“成功”或“沒找到”)和文檔的 mime 類型。 5. 資源(resource)：由 uri 標(biāo)識的網(wǎng)絡(luò)數(shù)據(jù)對象或服務(wù)。 6. 實(shí)體(entity)：數(shù)據(jù)資源或來自服務(wù)資源的回映的一種特殊表示方法，它可 能被包圍在一個請求或響應(yīng)信息中。一個實(shí)體包括實(shí)體頭信息和實(shí)體的本 身內(nèi)容。 7. 客戶機(jī)(client)：一個為發(fā)送請求目的而建立連接的應(yīng)用程序。 8. 用戶代理(user agent)：初始化一個請求的客戶機(jī)。它們是瀏覽器、編輯器 或其它用戶工具。 9. 服務(wù)器(server)：一個接受連接并對請求返回信息的應(yīng)用程序。

7、 10. 源服務(wù)器(origin server)：是一個給定資源可以在其上駐留或被創(chuàng)建的服務(wù) 器。 11. 代理(proxy)：一個中間程序，它可以充當(dāng)一個服務(wù)器，也可以充當(dāng)一個客 戶機(jī)，為其它客戶機(jī)建立請求。請求是通過可能的翻譯在內(nèi)部或經(jīng)過傳遞 到其它的服務(wù)器中。一個代理在發(fā)送請求信息之前，必須解釋并且如果可 能重寫它。代理經(jīng)常作為通過防火墻的客戶機(jī)端的門戶，代理還可以作為 一個幫助應(yīng)用來通過協(xié)議處理沒有被用戶代理完成的請求。 12. 網(wǎng)關(guān)(gateway)：一個作為其它服務(wù)器中間媒介的服務(wù)器。與代理不同的是， 網(wǎng)關(guān)接受請求就好象對被請求的資源來說它就是源服務(wù)器；發(fā)出請求的客 常熟市地理信息

8、共享平臺地理信息發(fā)布接口規(guī)范 - 5 - 戶機(jī)并沒有意識到它在同網(wǎng)關(guān)打交道。網(wǎng)關(guān)經(jīng)常作為通過防火墻的服務(wù)器 端的門戶，網(wǎng)關(guān)還可以作為一個協(xié)議翻譯器以便存取那些存儲在非 http 系統(tǒng)中的資源。 13. 通道(tunnel)：是作為兩個連接中繼的中介程序。一旦激活，通道便被認(rèn) 為不屬于 http 通訊，盡管通道可能是被一個 http 請求初始化的。當(dāng)被 中繼的連接兩端關(guān)閉時，通道便消失。當(dāng)一個門戶(portal)必須存在或中介 (intermediary)不能解釋中繼的通訊時通道被經(jīng)常使用。 14. 緩存(cache)：反應(yīng)信息的局域存儲。 （三）（三）http 協(xié)議的運(yùn)作方式協(xié)議的運(yùn)作方式 h

9、ttp 協(xié)議是基于請求響應(yīng)范式的。一個客戶機(jī)與服務(wù)器建立連接后， 發(fā)送一個請求給服務(wù)器，請求方式的格式為，統(tǒng)一資源標(biāo)識符、協(xié)議版本號， 后邊是 mime 信息包括請求修飾符、客戶機(jī)信息和可能的內(nèi)容。服務(wù)器接到請 求后，給予相應(yīng)的響應(yīng)信息，其格式為一個狀態(tài)行包括信息的協(xié)議版本號、一 個成功或錯誤的代碼，后邊是 mime 信息包括服務(wù)器信息、實(shí)體信息和可能的 內(nèi)容。 許多 http 通訊是由一個用戶代理初始化的并且包括一個申請?jiān)谠捶?wù)器 上資源的請求。最簡單的情況可能是在用戶代理(ua)和源服務(wù)器(o)之間通過一 個單獨(dú)的連接來完成。 當(dāng)一個或多個中介出現(xiàn)在請求響應(yīng)鏈中時，情況就變得復(fù)雜一些。中介

10、 有三種：代理(proxy)、網(wǎng)關(guān)(gateway)和通道(tunnel)。一個代理根據(jù) uri 的絕 對格式來接受請求，重寫全部或部分消息，通過 uri 的標(biāo)識把已格式化過的請 求發(fā)送到服務(wù)器。網(wǎng)關(guān)是一個接收代理，作為一些其它服務(wù)器的上層，并且如 果必須的話，可以把請求翻譯給下層的服務(wù)器協(xié)議。一個通道作為不改變消息 的兩個連接之間的中繼點(diǎn)。當(dāng)通訊需要通過一個中介(例如：防火墻等)或者是 中介不能識別消息的內(nèi)容時，通道經(jīng)常被使用。 在用戶代理(ua)和源服務(wù)器(o)之間有三個中介(a,b 和 c)。一個通過整個 鏈的請求或響應(yīng)消息必須經(jīng)過四個連接段。這個區(qū)別是重要的，因?yàn)橐恍?http 通訊選

11、擇可能應(yīng)用于最近的連接、沒有通道的鄰居，應(yīng)用于鏈的終點(diǎn)或 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 6 - 應(yīng)用于沿鏈的所有連接。以上是線性的，每個參與者都可能從事多重的、并發(fā) 的通訊。例如，b 可能從許多客戶機(jī)接收請求而不通過 a，并且或者不通過 c 把請求送到 a，在同時它還可能處理 a 的請求。 任何針對不作為通道的匯聚可能為處理請求啟用一個內(nèi)部緩存。緩存的效 果是請求響應(yīng)鏈被縮短，條件是沿鏈的參與者之一具有一個緩存的響應(yīng)作用 于那個請求。下圖說明結(jié)果鏈，其條件是針對一個未被 ua 或 a 加緩存的請求， b 有一個經(jīng)過 c 來自 o 的一個前期響應(yīng)的緩存拷貝。 在 interne

12、t 上，http 通訊通常發(fā)生在 tcp/ip 連接之上。缺省端口是 tcp 80，但其它的端口也是可用的。但這并不預(yù)示著 http 協(xié)議在 internet 或其它網(wǎng) 絡(luò)的其它協(xié)議之上才能完成。http 只預(yù)示著一個可靠的傳輸。 以上簡要介紹了 http 協(xié)議的宏觀運(yùn)作方式，下面介紹一下 http 協(xié)議的 內(nèi)部操作過程。 首先，簡單介紹基于 http 協(xié)議的客戶/服務(wù)器模式的信息交換過程，它分 四個過程，建立連接、發(fā)送請求信息、發(fā)送響應(yīng)信息、關(guān)閉連接。 在 www 中， “客戶”與“服務(wù)器”是一個相對的概念，只存在于一個特 定的連接期間，即在某個連接中的客戶在另一個連接中可能作為服務(wù)器。 w

13、ww 服務(wù)器運(yùn)行時，一直在 tcp80 端口(www 的缺省端口)監(jiān)聽，等待連接 的出現(xiàn)。 1.2.2ogc 簡介簡介 ogcopen geospatial consortium開放地理信息聯(lián)盟，是一個非盈 利的志愿的國際標(biāo)準(zhǔn)化組織，引領(lǐng)著空間地理信息標(biāo)準(zhǔn)及定位基本服務(wù)的發(fā)展 目前在空間數(shù)據(jù)互操作領(lǐng)域，基于公共接口訪問模式的互操作方法是一種基本 的操作方法。通過國際標(biāo)準(zhǔn)化組織（iso/tc211）或技術(shù)聯(lián)盟（如 ogc）制定 空間數(shù)據(jù)互操作的接口規(guī)范，gis 軟件商開發(fā)遵循這一接口規(guī)范的空間數(shù)據(jù)的 讀寫函數(shù)，可以實(shí)現(xiàn)異構(gòu)空間數(shù)據(jù)庫的互操作?；?http（web）xml 的空間 數(shù)據(jù)互操作是一

14、個很熱門的研究方向，主要涉及 web service 的相關(guān)技術(shù)。 ogc 和 iso/tc211 共同推出了基于 web 服務(wù)（xml）的空間數(shù)據(jù)互操作實(shí)現(xiàn) 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 7 - 規(guī)范 web map service，web feature service，web coverage service 以及用于空 間數(shù)據(jù)傳輸與轉(zhuǎn)換的地理信息標(biāo)記語言 gml。 （一）（一）web 地圖服務(wù)地圖服務(wù) web 地圖服務(wù)（wms）利用具有地理空間位置信息的數(shù)據(jù)制作地圖。其中 將地圖定義為地理數(shù)據(jù)可視的表現(xiàn)。這個規(guī)范定義了三個操作：getcapabitities 返回服務(wù)

15、級元數(shù)據(jù)，它是對服務(wù)信息內(nèi)容和要求參數(shù)的一種描述； getmap 返 回一個地圖影像，其地理空間參考和大小參數(shù)是明確定義了的； getfeatureinfo（可選）返回顯示在地圖上的某些特殊要素的信息 （二）（二）web 要素服務(wù)要素服務(wù) web 地圖服務(wù)返回的是圖層級的地圖影像，web 要素服務(wù)（wfs）返回的 是要素級的 gml 編碼，并提供對要素的增加、修改、刪除等事務(wù)操作，是對 web 地圖服務(wù)的進(jìn)一步深入。ogc web 要素服務(wù)允許客戶端從多個 web 要素 服務(wù)中取得使用地理標(biāo)記語言（gml）編碼的地理空間數(shù)據(jù)，這個遠(yuǎn)東定義了 五個操作：getcapabilites 返回 web

16、 要素服務(wù)性能描述文檔（用 xml 描述） ； describefeaturetype 返回描述可以提供服務(wù)的任何要素結(jié)構(gòu)的 xml 文檔； getfeature 為一個獲取要素實(shí)例的請求提供服務(wù)；transaction 為事務(wù)請求提供 服務(wù)；lockfeature 處理在一個事務(wù)期間對一個或多個要素類型實(shí)例上鎖的請求。 （三）（三）web 覆蓋服務(wù)覆蓋服務(wù) web 覆蓋服務(wù)（wcs）面向空間影像數(shù)據(jù)，它將包含地理位置值的地理空 間數(shù)據(jù)作為“覆蓋（coverage） ”在網(wǎng)上相互交換。網(wǎng)絡(luò)覆蓋服務(wù)由三種操作組 成：getcapabilities，getcoverage 和 describeco

17、veragetype。getcapabilities 操 作返回描述服務(wù)和數(shù)據(jù)集的 xml 文檔。網(wǎng)絡(luò)覆蓋服務(wù)中的 getcoverage 操作是 在 getcapabilities 確定什么樣的查詢可以執(zhí)行、什么樣的數(shù)據(jù)能夠獲取之后執(zhí) 行的，它使用通用的覆蓋格式返回地理位置的值或?qū)傩?。describecoveragetype 操作允許客戶端請求由具體的 wcs 服務(wù)器提供的任一覆蓋層的完全描述。 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 8 - 2系統(tǒng)權(quán)限設(shè)計(jì)系統(tǒng)權(quán)限設(shè)計(jì) 2.1 權(quán)限架構(gòu)權(quán)限架構(gòu) 系統(tǒng)服務(wù)結(jié)合了權(quán)限進(jìn)行設(shè)計(jì)，數(shù)據(jù)中心管理員可以分配給用戶不同的數(shù) 據(jù)權(quán)限來限制用戶的訪問

18、能力： 權(quán)限配置是在應(yīng)用層上進(jìn)行擴(kuò)展，用于控制用戶對數(shù)據(jù)的訪問能力。他主 要包含如下幾個方面的權(quán)限： a.用戶功能權(quán)限： 設(shè)置角色可以使用 gis 系統(tǒng)提供的工具集合，控制不同用戶的界面布局。 用戶功能包括兩類，一類為工具型：包括放大、縮小、面積測量、長度測量、 查詢、鷹眼、圖層控制等。一類為數(shù)據(jù)型:包括導(dǎo)出、編輯等。當(dāng)賦予不同用戶 權(quán)限后，系統(tǒng)登錄時不同用戶可以看見相應(yīng)權(quán)限的 gis 應(yīng)用界面。 b.專題圖權(quán)限： 一個專題圖可以包含多個層組或者層，一個層組可以包含多個圖層。在系 統(tǒng)中多個地圖分類、多個地圖、多個層組和多個圖層可以疊加顯示。設(shè)定此權(quán) 限后，用戶將只能在擁有權(quán)限的專題圖中切換，用

19、此權(quán)限系統(tǒng)來對用戶進(jìn)行粗 粒度的圖層訪問控制。 gis 服務(wù)（wms wfs tile） 用戶（二次開發(fā)者） 系統(tǒng)權(quán)限控制 gis 應(yīng)用層 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 9 - c.圖層權(quán)限： 用于控制用戶可訪問的數(shù)據(jù)源中的圖層，數(shù)據(jù)較細(xì)級別的控制。使用此控 制方式可以使同一個專題圖在不同用戶中有不同的呈現(xiàn)方式。 d.數(shù)據(jù)范圍權(quán)限： 用于控制用戶對于某個圖層中相應(yīng)數(shù)據(jù)范圍的控制。設(shè)置此權(quán)限可以使同 一圖層對不同用戶呈現(xiàn)不同范圍的數(shù)據(jù)。 e.數(shù)據(jù)字段權(quán)限： 用于控制用戶訪問圖層時的字段權(quán)限。用戶查詢某個圖層后將返回他所擁 有查看權(quán)限的字段列表，當(dāng)用戶進(jìn)行編輯時，將判斷用戶時候有

20、對某個控件圖 層字段的編輯權(quán)限。 f.服務(wù)訪問權(quán)限 用于限定用戶可以訪問的后端 web 服務(wù)方法。整個系統(tǒng)是基于 soa 架構(gòu) 搭建而成，所有的 gis 操作都封裝為了 web services。使用此權(quán)限可以限定某些 用戶所擁有的對服務(wù)操作權(quán)限。主要用戶各個水利局的系統(tǒng)集成時進(jìn)行安全限 定。 g.查詢權(quán)限： 用于控制用戶可以獲得的查詢，系統(tǒng)內(nèi)部預(yù)配置一些常用的查詢，使用此 配置可以限定用戶對查詢的訪問。 權(quán)限系統(tǒng)工作流程如下： 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 10 - 2.2 用戶狀態(tài)維護(hù)用戶狀態(tài)維護(hù) 因?yàn)橄到y(tǒng)使用了授權(quán)體系來控制發(fā)布的數(shù)據(jù)，二次開發(fā)者必須在程序中登 錄并維護(hù)

21、當(dāng)前登錄的狀態(tài)以便于后續(xù)請求。 互聯(lián)網(wǎng)上大部分應(yīng)用都不涉及到狀態(tài)的保存，http 協(xié)議標(biāo)準(zhǔn)制定的初衷 主要面向無狀態(tài)連接，每次連接只能傳輸一個文件。但是對于本系統(tǒng) gis 服務(wù) 來說，必須維護(hù)當(dāng)前用戶的狀態(tài)便于對用戶進(jìn)行校驗(yàn)，防止非法是數(shù)據(jù)訪問， 當(dāng)這給使用 http 協(xié)議進(jìn)行 gis 服務(wù)的應(yīng)用帶來了相當(dāng)大的困難。實(shí)際上，狀 態(tài)維護(hù)策略是本系統(tǒng)的關(guān)鍵技術(shù)之一。 用.net 發(fā)起 web 請求時維持 session 的方法 ： 一般使用.net c# 發(fā)起一個 web 請求是用 webclient 類，應(yīng)為使用很簡 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 11 - 單，但是每調(diào)用一次

22、openread 就會在服務(wù)器啟用一個新 session。使用 httpwebrequest、cookiecontainer 就可以讓多個 web 請求只有一個 session 為 httpwebrequest 指定一個 cookiecontainer，使用同一個 cookiecontainer 的 request 就是一個 session。代碼如下： cookiecontainer cc = new cookiecontainer(); /登錄 httpwebrequest myreq = (httpwebrequest)webrequest.create(http:/localhost/h

23、andler/login.ashx?username=test /設(shè)置當(dāng)前cookie myreq.cookiecontainer = cc; httpwebresponse resp = myreq.getresponse() as httpwebresponse; /開始使用wms服務(wù) httpwebrequest myreq2 = (httpwebrequest)webrequest.create(http:/localhost/handler/wms.ashx?request=getcapabili ties); /保持會話狀態(tài) myreq.cookiecontainer = cc;

24、httpwebresponse resp2 = myreq.getresponse() as httpwebresponse; 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 12 - 3服務(wù)服務(wù)接口規(guī)范接口規(guī)范 請求以標(biāo)注的 url 的形式進(jìn)行，所需參數(shù)附加在 url 地址后面。 3.1 請求參數(shù)規(guī)則請求參數(shù)規(guī)則 3.1.1參數(shù)順序和大小寫參數(shù)順序和大小寫 參數(shù)名稱不為大小寫敏感,而是參數(shù)值則是大小寫區(qū)分.在該文檔標(biāo)準(zhǔn)中,為 了排版上的清晰,參數(shù)名稱通常為大寫形式，但這個不是必須的。請求中的參數(shù) 可以以任意順序排列. 當(dāng)請求的參數(shù)多次出現(xiàn)并相互沖突時,服務(wù)器可能響應(yīng)未 知值。 3.1.2參數(shù)

25、列表參數(shù)列表 參數(shù)由一個列表組成(比如,bbox,layers,styles),該列表應(yīng)該使用逗號(“,”) 作為表項(xiàng)的分隔符,而期間不應(yīng)該有多余的空格符.如果在一個列表中存在空格 符或者逗號,按照 url 編碼規(guī)則,它們將被忽略. 有時候,一個列表項(xiàng)的內(nèi)容可能為空,所以應(yīng)該用一個空的字符串表示,(如” ” )。這樣,兩個連續(xù)的逗號就表示一個空項(xiàng),該空項(xiàng)由一個逗號引領(lǐng)并且由一個逗 號結(jié)尾。一個空項(xiàng)可能被翻譯為一個不包含任何表項(xiàng)的列表，也可能是作為一 個單獨(dú)的空項(xiàng)目，這取決于其內(nèi)容。 3.2 登錄服務(wù)登錄服務(wù) 登錄請求 url： 返回值為“yes”表示登錄成功，否則登錄失敗。 注銷請求 url：

26、 http:/:/handler/ login.ashx?username=testrrggbb 大小寫都是允許的.而”0 x”必須為小 寫的”x”,如果該參數(shù)在請求中缺失,則默認(rèn)的值為 oxffffff(對應(yīng)的值為白色). 當(dāng) format 值為圖像格式時,服務(wù)器應(yīng)該設(shè)置背景像素值為 bgcolor 值 當(dāng) format 的值為圖形元素格式(它們沒有顯式的背景),或者圖像格式時,wms 應(yīng)該 避免為前景元素使用 bgcolor 值,因?yàn)檫@樣在該背景顏色下,它們將不可見. 當(dāng) 圖層已經(jīng)什么了為不透明時,地圖上的重要點(diǎn),實(shí)體將不顯式任何背景. 請求參考請求參考 請求 url 請求響

27、應(yīng)： 返回圖片流信息： http:/ :/handler/wms.ashx?service=huizhouwms&request=getmap&mapid=201&bbox=52 5000,2542000,555500,2570125&width=500&height=500 http:/ :/handler/wms.ashx?service=huizhouwms&request=getmap&mapname= 環(huán)境保護(hù)地圖&bbox=525000,2542000,555500,2570125&width=500&height=500 http:/ :/handler/wms.ashx?ser

28、vice=huizhouwms&request=getmap&layers= sde.dfgr,sde.twe,sde.fghr &bbox=525000,2542000,555500,2570125&width=500&height=500 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 31 - 3.3.3wms getfeatureinfo 此服務(wù)在 ogc 規(guī)范里面為可選服務(wù)。 該服務(wù)接口執(zhí)行 opengis wms 執(zhí)行規(guī)范中的 getmap 操作，用于生成影像圖片，為 用戶創(chuàng)建標(biāo)準(zhǔn)方法請求遙感影像圖片。 請求請求 url 請求參數(shù)說明請求參數(shù)說明 參數(shù)是

29、否必須說明 request=getmap是必須為 getmap http:/:/handler/ wms.ashx?servicename=huizhouwms&request=getfeatureinfo&mapid=201&bbox=525000,2542000,5555 00,2570125&width=838&height=483&queryid=104 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 32 - servicename是表示 wms 的服務(wù)名稱，在一個站點(diǎn)可以 發(fā)布多個服務(wù)，此方式可以用于負(fù)載均衡 部署 mapid否地圖 id。 mapname否地圖名稱。 layers

30、否圖層名，使用，分隔圖層（可以使用 mapid 參數(shù)簡化此參數(shù)結(jié)構(gòu)） bbox是空間坐標(biāo)系邊界。 width是影像寬度，以像素為單位的影像寬度 height是影像寬度，以像素為單位的影像寬度 format否圖片類型。例如： png24 ,gif,jpg,pdf,svg,tif 等。 bgcolor否背景顏色，十六進(jìn)制的 rgb 值，默認(rèn)為 0 xffffff。此參數(shù)在影像中無效，只是 為兼容 wms 規(guī)范，影像服務(wù)請求時該參 數(shù)為空。 version否請求版本。 transparent否地圖背景透明度，默認(rèn)為 false。此參 數(shù)在影像中無效。 querylayers否查詢圖層的名稱 quer

31、yid否查詢 id wkt否查詢疊加的空間條件。 whereinfo否為查詢對應(yīng)的屬性條件。不傳入查詢將不 疊加屬性條件。 buffer否幾何實(shí)體查詢的 buffer 距離（單位為地圖 默認(rèn)單位） 。 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 33 - 1. wkt 幾何對象都可以用 wkt 的方式加以描述: 點(diǎn)對象的 wkt 格式：point(x y)，實(shí)例：point(5.2 9.3) 多點(diǎn)的 wkt，格式 multipoint(x y,x y .) ,實(shí)例：mulitpoint(22 53,51 53,87 1)。 線對象的 wkt 格式：linestring(x y,x y,x

32、y.)，實(shí)例：linestring(12 2.4,16.98 15.3)。 多線對象的 wkt 格式：multilinestring(x y,x y,x y.),(x y,x y,x y.) ，實(shí)例：multilinestring(41.8 2.5,32 51.6),(31.1 34.12,12.9 4.6),(3.2 65.7,14.2 32.4)。 環(huán)對象的 wkt 格式：ring(x y,x y,x y.)，具體的實(shí)例：ring(31 2,51 16,110 13,31 2)。 面的 wkt，格式 polygon(x y,x y ,x y ,x y,x y .) ,實(shí)例：polygon(

33、5 12,6 17,314 15,12 33)。 多面的 wkt，格式 multipolygon(x y,x y ,x y ,x y,x y .),() , 實(shí)例：multipolygon(23 4,22 28,39 22,31 2)。 矩形對象的 wkt 格式：rectangle(x y,x y)，實(shí)例：rectangle(3.2 2.3,11.2 4.91)。 文字格式：simpletext(x y,textcontent),一個實(shí)際的例子為 simpletext(23 45.7,測試內(nèi)容)。 圓對象的 wkt 格式：circle(x y,length)，實(shí)例：circle(21.2 5.

34、7,2.3)。 2. queryid querylayers 查詢對應(yīng)的數(shù)據(jù)?？蛇x傳入其中之一，如果沒有傳入，默認(rèn)將查詢高亮可見層。 請求參考請求參考 .1 高亮所有政府單位 請求 url http:/ :/handler/ wms.ashx?servicename=huizhouwms&request=getfeatureinfo&mapid=201&bbox=525000,25420 00,555500,2570125&width=838&height=483&queryid=104 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 34 - 請求響應(yīng)（返回圖片

35、流信息）： .2高亮名稱包含“辦”的所有政府單位 請求 url 請求響應(yīng)（返回圖片流信息）： http:/ :/handler/ wms.ashx?servicename=huizhouwms&request=getfeatureinfo&mapid=201&bbox=525000,25420 00,555500,2570125&width=838&height=483&queryid=104 &whereinfo=fname like %辦% 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 35 - .3高亮某個矩形以及周邊 800 米的政府單位 請求 url 請

36、求響應(yīng)（返回圖片流信息）： .4高亮某個矩形以及周邊 800 米并且名稱里包含“橋“的政府單位 請求 url 請求響應(yīng)（返回圖片流信息）： http:/ :/handler/ wms.ashx?servicename=huizhouwms&request=getfeatureinfo&mapid=201&bbox=525000,25420 00,555500,2570125&width=838&height=483&queryid=104&wkt=rectangle(540000 2552000,545500 2556125)&buffer=800 http:/ :/handle

37、r/ wms.ashx?servicename=huizhouwms&request=getfeatureinfo&mapid=201&bbox=525000,25420 00,555500,2570125&width=838&height=483&queryid=104&wkt=rectangle(540000 2552000,545500 2556125)&buffer=800&whereinfo=fname like %橋% 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 36 - 3.4 wfs 服務(wù)服務(wù) 3.4.1wms getcapabilities 該服務(wù)接口執(zhí)行 opengis

38、 wms 執(zhí)行規(guī)范中的 getcapabilities 操作，返回服務(wù)元數(shù)據(jù)。 請求請求 url 請求參數(shù)說明請求參數(shù)說明 參數(shù)是否必須說明 request= getcapabilities 是必須為 getcapabilities servicename否表示需要獲取 wfs 元數(shù)據(jù)的服務(wù)名稱. mapid否地圖 id。 mapname否地圖名稱。 http:/:/handler/wfs.ashx?servicename=huizhouwms&request=getcapabilities 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 37 - 請

39、求參考請求參考 .1請求當(dāng)前站點(diǎn)所有服務(wù)概要信息 請求 url： 請求應(yīng)答： .2請求某個服務(wù)概要信息： 請求 url： http:/:/handler/wfs.ashx?request=getcapabilities 本機(jī)wms服務(wù) true huizhouwms 1.3 true wms 本機(jī)wfs服務(wù) true huizhouwfs 1.3 true wfs http:/:/handler/wfs.ashx?request=getcapabilities 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 38 - 請求應(yīng)答： 0 業(yè)務(wù)圖層 1 hzsy注記 0

40、3000 3000 false text true 3 hzsy鎮(zhèn)（辦事處）政府 0 3000 30000 false point true 4 sy一般單位 0 3000 10000 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 39 - false point true 6 hzsy縣區(qū)政府 0 3000 30000 false point true 7 hzsy主要地名 0 3000 30000 false point true meter 555253.459 2574125.797 530078.376 2538792.639 1 201 規(guī)劃局圖層 常熟市地理信息共享平臺地理信息

41、發(fā)布接口規(guī)范 - 40 - 1303 索引圖層 4 sy一般單位 0 3000 10000 false point true 13 sy公園綠地 0 20000 40000 false polygon true 16 sy水域 0 3000 0 false polygon true 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 41 - 17 sy政府辦事處 0 3001 0 false point true 18 sy索引圖注記 0 0 3000 false polygon true 21 sy一級路網(wǎng) 0 3000 0 false line true 22 sy二級路網(wǎng) 0 常熟市地理信

42、息共享平臺地理信息發(fā)布接口規(guī)范 - 42 - 3001 50000 false line true 23 sy三級路網(wǎng) 0 3000 20000 false line true 60 街道 0 30000 0 false polygon true 3696 影像圖 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 43 - meter 555500 2570125 525000 2542000 1 501 鷹眼地圖 4 sy一般單位 0 3000 10000 false point true 13 sy公園綠地 0 20000 40000 false polygon true 16 sy水域 常

43、熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 44 - 0 3000 0 false polygon true 17 sy政府辦事處 0 3001 0 false point true 18 sy索引圖注記 0 0 3000 false polygon true 22 sy二級路網(wǎng) 0 3001 50000 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 45 - false line true 23 sy三級路網(wǎng) 0 3000 20000 false line true 60 街道 0 30000 0 false polygon true meter 560500 2574125 52000

44、0 2538000 -1 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 46 - 104 政府單位查詢 0 -1 fname fname 單位名稱 -1 string false meter fname ftype geoobjnum 單位名稱 單位類型 單位編碼 0 -1 .3請求某個地圖概要信息： 請求 url： http:/:/handler/wfs.ashx? servicename=huizhouwms&request=getcapabilities&mapid=201 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 47 - 請求應(yīng)答： 201 業(yè)務(wù)管理 1303

45、索引圖層 4 sy一般單位 0 3000 10000 false point true 17 sy政府辦事處 0 3001 0 false point true 21 sy一級路網(wǎng) 0 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 48 - 3000 0 false line true 60 街道 0 30000 0 false polygon true 2315 業(yè)務(wù)圖層 38 制圖面 0 0 3000 false polygon true 48 商業(yè)基準(zhǔn)地價(jià) 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 49 - 0 0 3000 false polygon true 8219 行政區(qū)

46、劃 61 行政區(qū) 0 0 3000 false polygon true 62 街坊 0 9000000 9000001 false polygon true 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 50 - 3696 影像圖 meter 555500 2570125 525000 2542000 1 3.4.2wfs getfeature 接口接口 請求請求 url 請求參數(shù)說明請求參數(shù)說明 參數(shù)是否必須說明 request=getfeature是必須為 getfeature servicename是表示 wfs 的服務(wù)名稱，在一個站點(diǎn)可以 發(fā)布多個服務(wù)，

47、此方式可以用于負(fù)載均衡 部署 version否請求版本。 querylayers否查詢圖層的名稱 queryid否查詢 id http:/:/handler/ wfs.ashx?servicename=huizhouwms&request=getfeatureinfo&mapid=201&bbox=525000,2542000,5555 00,2570125&width=838&height=483&queryid=104 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 51 - wkt否查詢疊加的空間條件。 whereinfo否為查詢對應(yīng)的屬性條件。不傳入查詢將不 疊加屬性條件。 buffe

48、r否幾何實(shí)體查詢的 buffer 距離（單位為地圖 默認(rèn)單位） 。 當(dāng)查詢需要返回圖片時，可以設(shè)置以下參數(shù)（hasimage 為 true） hasimage否請求返回?cái)?shù)據(jù)是否包含圖片。 mapid否地圖 id。 mapname否地圖名稱。 layers否圖層名，使用，分隔圖層（可以使用 mapid 參數(shù)簡化此參數(shù)結(jié)構(gòu)） bbox是圖片空間坐標(biāo)系邊界。 width是影像寬度，以像素為單位的影像寬度 height是影像寬度，以像素為單位的影像寬度 format否圖片類型。例如： png24 ,gif,jpg,pdf,svg,tif 等。 bgcolor否背景顏色，十六進(jìn)制的 rgb 值，默認(rèn)為

49、0 xffffff。此參數(shù)在影像中無效，只是 為兼容 wms 規(guī)范，影像服務(wù)請求時該參 數(shù)為空。 transparent否地圖背景透明度，默認(rèn)為 false。此參 數(shù)在影像中無效。 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 52 - 請求參考請求參考 .1查詢某個矩形范圍內(nèi)部的政府單位： 請求應(yīng)答： 3 140 50 1 geoobjnum string ftype string fname string 022700 主要企業(yè)、事業(yè)單位 惠州市自來水總公司 http:/:/handler/ wfs.ashx?servicename=huizhouwfs&re

50、quest=getfeature&wkt=rectangle(532625 2549031.25,547875 2563093.75)&queryid=104 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 53 - 542416.42899999954 2556837.6180000007 542416.42899999954 2556837.6180000007 rectangle rectangle(542416.429 2556837.618,542416.429 2556837.618) 0 1 4 point point(542416.429 2556837.618) 0 0227

51、00 學(xué)校文教 技工學(xué)校 541303.7070000004 2558138.6620000005 541303.7070000004 2558138.6620000005 rectangle rectangle(541303.707 2558138.662,541303.707 2558138.662) 0 2 4 point point(541303.707 2558138.662) 0 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 54 - 022700 學(xué)校文教 糧食學(xué)校 541422.47200000007 2557820.8440000005 541422.47200000007

52、 2557820.8440000005 rectangle rectangle(541422.472 2557820.844,541422.472 2557820.844) 0 3 4 point point(541422.472 2557820.844) 0 022700 學(xué)校文教 惠州市一小 541419.03100000042 2556421.3589999992 541419.03100000042 2556421.3589999992 rectangle rectangle(541419.031 2556421.359,541419.031 2556421.359) 0 4 4 po

53、int point(541419.031 2556421.359) 0 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 55 - 022700 主要企業(yè)、事業(yè)單位 tcl國際電工 541463.62200000044 2552805.0549999997 541463.62200000044 2552805.0549999997 rectangle rectangle(541463.622 2552805.055,541463.622 2552805.055) 0 5 4 point point(541463.622 2552805.055) 0 022700 行政辦公地 市廣播電視局 539

54、793.86400000006 2553265.8690000009 539793.86400000006 2553265.8690000009 rectangle rectangle(539793.864 2553265.869,539793.864 2553265.869) 0 6 4 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 56 - point point(539793.864 2553265.869) 0 022700 行政辦公地 惠城區(qū)計(jì)劃生育服務(wù)站 541079.46800000034 2552655.9910000004 541079.46800000034 255265

55、5.9910000004 rectangle rectangle(541079.468 2552655.991,541079.468 2552655.991) 0 7 4 point point(541079.468 2552655.991) 0 022700 行政辦公地 市農(nóng)業(yè)局 541419.40099999961 2554171.2860000003 541419.40099999961 2554171.2860000003 rectangle rectangle(541419.401 2554171.286,541419.401 2554171.286) 常熟市地理信息共享平臺地理信息

56、發(fā)布接口規(guī)范 - 57 - 0 8 4 point point(541419.401 2554171.286) 0 022700 主要企業(yè)、事業(yè)單位 市口腔醫(yī)院 541063.16299999971 2555151.385 541063.16299999971 2555151.385 rectangle rectangle(541063.163 2555151.385,541063.163 2555151.385) 0 9 4 point point(541063.163 2555151.385) 0 022700 學(xué)校文教 市四中 541100.35699999984 2555507.687

57、9999992 541100.35699999984 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 58 - 2555507.6879999992 rectangle rectangle(541100.357 2555507.688,541100.357 2555507.688) 0 10 4 point point(541100.357 2555507.688) 0 022700 行政辦公地 市中級法院 540539.608 2554188.17 540539.608 2554188.17 rectangle rectangle(540539.608 2554188.17,540539.6

58、08 2554188.17) 0 11 4 point point(540539.608 2554188.17) 0 50 sy一般單位 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 59 - 1 11 50 1 ftype string fname string geoobjnum string 辦事處、鎮(zhèn) 橋西辦事處 022630 541216.93400000036 2552779.8920000009 541216.93400000036 2552779.8920000009 rectangle rectangle(541216.934 2552779.892,541216.934

59、2552779.892) 0 2 17 point point(541216.934 2552779.892) 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 60 - 0 辦事處、鎮(zhèn) 橋東辦事處 022630 542662.591 2554190.5700000003 542662.591 2554190.5700000003 rectangle rectangle(542662.591 2554190.57,542662.591 2554190.57) 0 3 17 point point(542662.591 2554190.57) 0 辦事處、鎮(zhèn) 江南辦事處 022630 539389

60、.46100000013 2556508.635 539389.46100000013 2556508.635 rectangle rectangle(539389.461 2556508.635,539389.461 2556508.635) 0 4 常熟市地理信息共享平臺地理信息發(fā)布接口規(guī)范 - 61 - 17 point point(539389.461 2556508.635) 0 11 sy政府辦事處 .2查詢名稱包含“辦”的所有政府單位 請求 url 請求響應(yīng)： 1 7 50 1 ftype string fname string http:/ :/handler/