江西省地名地址地圖表達(dá)　服務(wù)與應(yīng)用標(biāo)準(zhǔn)

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

（規(guī)范性附錄）

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