江西省地名地址地圖表達　服務(wù)與應(yīng)用標準

江西省地名地址地圖表達服務(wù)與應(yīng)用標準范圍本標準規(guī)定了地名地址服務(wù)的類型、訪問方式、訪問接口。本標準適用于江西省地名地址地圖表達中地名地址服務(wù)與應(yīng)用公共服務(wù)平臺建設(shè)。規(guī)范性引用文件下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T23705-2009數(shù)字城市地理信息公共平臺地名/地址編碼規(guī)則IETFRFC2616-1999超文本傳輸協(xié)議-HTTP/1.1（HypertextTransferProtocol--HTTP/1.1）術(shù)語與定義下列術(shù)語和定義適用于本文件。地理編碼geocoding指的是將地址或者地名信息建立空間坐標關(guān)系的過程。正向地理編碼forwardgeocoding正向地理編碼服務(wù)是指將地址或者地名轉(zhuǎn)換成點坐標的過程。單地理編碼singlegeocoding單地理編碼匹配是指一次匹配一條地名/地址數(shù)據(jù)的正向地理編碼。批量地理編碼bulkgeocoding批量地理編碼匹配是指一次匹配多條地名/地址數(shù)據(jù)的正向地理編碼。反向地理編碼reversegeocoding反向地理編碼服務(wù)是指將點坐標轉(zhuǎn)換為一種可讀的地址串的過程。地理編碼服務(wù)概述地理編碼服務(wù)是地名地址信息服務(wù)平臺的核心，將成果地名地址數(shù)據(jù)庫和地址匹配功能包裝成服務(wù)的形式對外發(fā)布，供政府各部門、企事業(yè)單位和社會公眾調(diào)用，是地名地址成果的新型運用方式。服務(wù)類型在線地理編碼服務(wù)系統(tǒng)以地址匹配引擎為核心，提供正向地理編碼、反向地理編碼。正向地理編碼服務(wù)正向地理編碼服務(wù)是指將地址或者地名轉(zhuǎn)換成點坐標的過程。該服務(wù)基于正向地理編碼服務(wù)引擎實現(xiàn)。在進行地址匹配時，支持用戶輸入一個或者批量的地址描述信息，自動匹配分值最高的候選位置，輸入的地址越準確，匹配的分值越高。地名地址數(shù)據(jù)主要分為行政區(qū)劃、街巷（道路）、興趣點、標志物、門牌號等類別；數(shù)據(jù)類型也不一樣，包括點狀、線狀、面狀3種類型；因此在設(shè)計地理編碼服務(wù)引擎時，為了更好的達到地址匹配的效果，采用分引擎設(shè)計模式，針對不同的地名等級開發(fā)不同的地址匹配引擎，以便更好地進行地址匹配，見圖1。正向地理編碼服務(wù)引擎正向地理編碼服務(wù)引擎門址引擎交叉路口引擎街巷（道路）引擎行政區(qū)劃引擎地址引擎圖1正向地理編碼服務(wù)引擎分類正向地理編碼服務(wù)引擎類型如下：地址引擎：主要用于實現(xiàn)興趣點級別的地址匹配和定位功能；行政區(qū)劃引擎：主要用于實現(xiàn)行政區(qū)劃的匹配定位，即當(dāng)用戶輸入行政區(qū)劃的名稱時，獲取該行政區(qū)劃所對應(yīng)的空間范圍圖形信息；街巷（道路）引擎：主要用于實現(xiàn)街巷（道路）的匹配與定位功能；交叉路口引擎：主要用于實現(xiàn)街巷（道路）交叉路口的匹配定位功能，例如用戶輸入“鎢都大道贊賢路”，定位到兩條道路的交叉口；門址引擎：主要用于實現(xiàn)門牌號的匹配定位功能。在實際使用中，用戶只需輸入地址串，無需選擇通過哪個引擎來進行匹配，引擎的判斷過程由系統(tǒng)自動來實現(xiàn)。反向地理編碼服務(wù)通過反向地理編碼，可以方便的從移動終端等設(shè)備上將地理坐標轉(zhuǎn)換為易于理解的地址信息。該服務(wù)基于反向地理編碼服務(wù)引擎實現(xiàn)。反向地理編碼服務(wù)引擎包括3種子引擎：行政區(qū)劃引擎、街巷（道路）引擎和地址引擎，如下：行政區(qū)劃引擎：用戶輸入坐標位置，返回該位置所在的行政區(qū)劃名；街巷（道路）引擎：用戶輸入坐標位置，返回該位置附近的街巷（道路）名；地址引擎：用戶輸入坐標位置，返回離該位置最近的地名的地址。地理編碼服務(wù)接口接口設(shè)計原則中文地理編碼服務(wù)引擎提供了單地理編碼、批量地理編碼，以及反向地理編碼服務(wù)，并且為用戶提供了標準的基于HTTP協(xié)議的REST服務(wù)接口，方便用戶調(diào)用這些高效穩(wěn)定的引擎服務(wù)，從而可以輕松實現(xiàn)跨平臺應(yīng)用地理編碼服務(wù)。對于平臺的WEBServicesAPI設(shè)計，應(yīng)該遵循以下原則：簡單性，由于這是一個對于公共開放的Web服務(wù)，它的API的設(shè)計首先應(yīng)當(dāng)是簡單的，要被大量用戶接受，要獲得比較好的應(yīng)用，那么API必須簡單，沒有哪個復(fù)雜難用的API會得到廣泛接受，所以針對目前的應(yīng)用實況，API必須簡單。可擴展性，作為更新頻率較高，開放性較強的Web服務(wù)，其API應(yīng)當(dāng)具有很好的向后擴展性，當(dāng)應(yīng)內(nèi)部需求的改變或外部需求的改變的需要時，API將根據(jù)新的商業(yè)邏輯發(fā)生變化，此時不應(yīng)當(dāng)將API從根本上推翻重建，而應(yīng)當(dāng)具備增量式的可擴展的能力。高效性，API應(yīng)該在堅持簡單性的前提下，兼顧高效性，當(dāng)某些組合操作應(yīng)用地非常頻繁的時候，我們應(yīng)當(dāng)為這樣的組合操作調(diào)用設(shè)計一個只需一次交互的單一入口調(diào)用，這樣能夠提升外部應(yīng)用的效率，同時減輕Web服務(wù)的負載。完備性，所謂完備性就是說整個API要覆蓋所有需要對外公開的功能，這相對而言是最好實現(xiàn)的目標，只要設(shè)計階段考慮得完備，就能達到完備性的要求。而且萬一發(fā)現(xiàn)不完備的情況，修正起來也是相對容易的。地理編碼服務(wù)接口單地理編碼服務(wù)接口接口說明單個地理編碼指，進行地理編碼時，每次只輸入一個位置描述以得到相對應(yīng)的位置信息。通過單個地理編碼可快速查找到各類位置，每個候選位置將含有匹配分值，輸入地址越準確，匹配分值越高。用戶可輸入各種樣式和格式表示的地址，其中包括行政區(qū)劃，街道名稱，街道交叉口、含有街道名稱的門牌號等。使用協(xié)議單地理編碼REST接口支持基于HTTP協(xié)議的POST和GET方法請求。請求參數(shù)說明請求參數(shù)說明見表1。表1單地理編碼請求參數(shù)說明請求參數(shù)參數(shù)含義是否必須默認值舉例描述queryStr查詢地址是無江西省贛州市章貢區(qū)水南鎮(zhèn)客家大道162號中國銀行單地址查詢參數(shù)score最少的得分否無60查詢結(jié)果地址的匹配度得分，此參數(shù)為一個臨界值，得分值大于此參數(shù)則將查詢結(jié)果返回，否則不返回。citycode城市代碼否無360700國家規(guī)范的行政區(qū)劃代碼f服務(wù)返回結(jié)果格式否xmlxml或json數(shù)據(jù)返回形式，以xml或json格式返回返回參數(shù)說明返回參數(shù)說明見表2。表2單地理編碼返回參數(shù)說明返回參數(shù)參數(shù)含義數(shù)據(jù)類型舉例說明status狀態(tài)信息Booleantrue：正常false：異常查詢數(shù)據(jù)的狀態(tài)標示queryAddress查詢地址String江西省贛州市章貢區(qū)水南鎮(zhèn)客家大道162號中國銀行用戶輸入的查詢信息count返回結(jié)果數(shù)String1resultaddressname名稱String中國銀行score得分Double100idIDLonggeotextWKT格式的幾何數(shù)據(jù)StringPOINT(114.9106200003128625.843050000257335)geoType幾何數(shù)據(jù)類型Int1：點要素2：線要素3：面要素返回數(shù)據(jù)幾何類型fullAddress完整地址String江西省贛州市章貢區(qū)水南鎮(zhèn)客家大道162號中國銀行l(wèi)atitude緯度double114.91062000031286longitude經(jīng)度vince省名稱String江西省city市名稱String贛州市county縣名稱String章貢區(qū)town鄉(xiāng)名稱String水南鎮(zhèn)表2（續(xù)）返回參數(shù)參數(shù)含義數(shù)據(jù)類型舉例說明resultaddressstreet街巷（道路）名稱String客家大道street_suf道路后綴String162號community小區(qū)名稱SmunitySuf小區(qū)后綴Stringlandmark第一地標名稱String中國銀行secondLandmark第二地標名稱String批量地理編碼服務(wù)接口接口說明批量地理編碼是指將一系列位置描述批量轉(zhuǎn)換為地球表面上對應(yīng)的位置的過程。批量地理編碼時，每次傳入多個位置描述。通過批量地理編碼可快速查找到大量的位置，每條描述地址將自動匹配分值最高的候選位置?？伤阉鞯奈恢妙愋团c單一地理編碼相同，用戶可輸入各種樣式和格式表示的地址，其中包括行政區(qū)劃，街道名稱，街道交叉口、含有街道名稱的門牌號等。使用協(xié)議批量地理編碼REST接口支持基于HTTP協(xié)議的POST方法請求。請求參數(shù)說明請求參數(shù)說明見表3。表3批量地理編碼請求參數(shù)說明請求參數(shù)參數(shù)含義是否必須默認值舉例描述queryStrs查詢地址是無贛州市章貢區(qū)水南鎮(zhèn)客家大道162號中國銀行,贛州市章貢區(qū)南外街道辦青年路32號天天便利多個地址用分號隔開score最少的得分否無f服務(wù)返回結(jié)果格式否xmlxmljson數(shù)據(jù)返回形式，默認以xml格式返回返回參數(shù)說明返回參數(shù)說明見表4。表4批量地理編碼返回參數(shù)說明返回參數(shù)參數(shù)含義數(shù)據(jù)類型舉例說明status狀態(tài)信息Booleantrue：正常false：異常查詢數(shù)據(jù)的狀態(tài)標示resultsaddressname名稱String中國銀行score得分Double100idIDLong表4（續(xù)）返回參數(shù)參數(shù)含義數(shù)據(jù)類型舉例說明resultsaddressgeotextWKT格式的幾何數(shù)據(jù)StringPOINT(114.9106200003128625.843050000257335)geoType幾何數(shù)據(jù)類型Int1：點要素2：線要素3：面要素返回數(shù)據(jù)幾何類型fullAddress完整地址String江西省贛州市章貢區(qū)水南鎮(zhèn)客家大道162號中國銀行l(wèi)atitude緯度double114.91062000031286longitude經(jīng)度vince省名稱String江西省city市名稱String贛州市county縣名稱String章貢區(qū)town鄉(xiāng)名稱String水南鎮(zhèn)street道路名稱String客家大道street_suf道路后綴String162號community小區(qū)名稱SmunitySuf小區(qū)后綴Stringlandmark第一地標名稱String中國銀行secondLandmark第二地標String反向地理編碼服務(wù)接口接口說明反向地理編碼是將點坐標轉(zhuǎn)換為一種可讀的地址或者地名的過程。反向地理編碼時，通過給出坐標以確定所給坐標所在行政區(qū)劃名，附近街道名，以及最近地名（興趣點）。用戶可選擇地址精準度到行政區(qū)劃，市或者興趣點。通過反向地理編碼，用戶可從移動端，GPS端等將地理坐標轉(zhuǎn)換為更易于理解的地址信息。使用協(xié)議反向地理編碼REST接口支持基于HTTP協(xié)議的POST和GET方法請求。請求參數(shù)說明請求參數(shù)說明見表5。表5反向地理編碼請求參數(shù)說明請求參數(shù)參數(shù)含義是否必須默認值舉例描述distance最遠距離否500M以用戶輸入的點為圓心，distance為半徑查詢周邊最近的道路或地標，最大范圍5000米。longitude經(jīng)度是用戶輸入點的經(jīng)度latitude緯度是用戶輸入點的緯度表5（續(xù)）請求參數(shù)參數(shù)含義是否必須默認值舉例描述f服務(wù)返回結(jié)果格式否xmlxmljson數(shù)據(jù)返回形式，默認以xml格式返回isGeom道路和區(qū)域是否返回空間幾何字段否truetruefalse反向地理編碼查詢結(jié)果中的行政區(qū)劃和道路是否返回空間坐標信息，結(jié)果較長，默認返回。返回參數(shù)說明返回參數(shù)說明見表6。表6反向地理編碼返回參數(shù)說明返回參數(shù)參數(shù)含義數(shù)據(jù)類型舉例說明status狀態(tài)信息Booleantrue：正常false：異常查詢數(shù)據(jù)的狀態(tài)標示count返回結(jié)果數(shù)String100批量匹配條數(shù)resultregionname名稱String水南鎮(zhèn)fullAddress標準地址String江西省贛州市章貢區(qū)水南鎮(zhèn)province省名稱String江西省city市名稱String贛州市county縣名稱String章貢區(qū)town鄉(xiāng)名稱String水南鎮(zhèn)streetname名稱String客家大道fullAddress標準地址String江西省贛州市章貢區(qū)水南鎮(zhèn)客家大道province省名稱String江西省city市名稱double贛州市county縣名稱double章貢區(qū)town鄉(xiāng)名稱String水南鎮(zhèn)distance請求點至道路最短距離double98.34poiname地物名稱String中國銀行fullAddress標準地址String江西省贛州市章貢區(qū)水南鎮(zhèn)客家大道162號中國銀行province省名稱String江西省city市名稱String贛州市county縣名稱String章貢區(qū)town鄉(xiāng)名稱String水南鎮(zhèn)longitude經(jīng)度double114.91062000031286latitude緯度double25.843050000257335distance請求點至POI最短距離double30.74

（規(guī)范性附錄）

評分標準地理編碼引擎將判定用戶輸入地址與標準地址庫匹配程度，匹配度越高則得分越高。具體的評分標準見表A.1。表A.1評分標準得分地物評分描述街巷（道路）評分描述行政區(qū)評分描述90-100精確到所在小區(qū)、地標或村，且用戶輸入地址所屬縣級行政區(qū)劃無缺失精確到街巷（道路），用戶輸入行政區(qū)劃級別無缺失精確到行政區(qū)劃，用戶輸入行政區(qū)劃級別無缺失門牌號碼相差0-5個精確到街巷（道路），用戶輸入包含市級或縣級行政區(qū)劃匹配市