ICS 07.040A 79DB 36江 西 省 地 方 標(biāo) 準(zhǔn)DB 36/ T XXXXXXX江西省地名地址地圖表達(dá) 服務(wù)與應(yīng)用標(biāo)準(zhǔn)Standards for service and application for map expression of names and address in Jiangxi Province（送審稿）XXXX - XX - XX 發(fā)布 XXXX - XX - XX 實(shí)施江 西 省 市 場 監(jiān) 督 管 理 局 發(fā) 布DB36/T XXXXXXXI目 次前 言 .II1 范圍 .12 規(guī)范性引用文件 .13 術(shù)語與定義 .14 地理編碼服務(wù) .24.1 概述 .24.2 服務(wù)類型 .25 地理編碼服務(wù)接口 .35.1 接口設(shè)計(jì)原則 .35.2 地理編碼服務(wù)接口 .3附錄 A （規(guī)范性附錄） 評分標(biāo)準(zhǔn) 8DB36/T XXXXXXXII前 言本規(guī)范按照GB/T 1.1-2009給出的規(guī)則起草。本規(guī)范由江西省測繪地理信息局提出并歸口。本規(guī)范起草單位：江西省基礎(chǔ)地理信息中心。本規(guī)范主要起草人：甘田紅、廖明偉、廖明、萬冉冉、曾丹、李婷、萬敏、夏淑芳、王川、徐珂、熊寧薇、虞麗青、唐遂、趙青芳、劉馨、萬佩璇、陳娟、顧華奇、楊樹平、韓飛、黃建忠、袁武彬、林林。DB36/T XXXXXXX1江西省地名地址地圖表達(dá) 服務(wù)與應(yīng)用標(biāo)準(zhǔn)1 范圍本標(biāo)準(zhǔn)規(guī)定了地名地址服務(wù)的類型、訪問方式、訪問接口。本標(biāo)準(zhǔn)適用于江西省地名地址地圖表達(dá)中地名地址服務(wù)與應(yīng)用公共服務(wù)平臺(tái)建設(shè)。2 規(guī)范性引用文件下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T 23705-2009 數(shù)字城市地理信息公共平臺(tái)地名/地址編碼規(guī)則 IETF RFC 2616-1999 超文本傳輸協(xié)議-HTTP/1.1（Hypertext Transfer Protocol - HTTP/1.1） 3 術(shù)語與定義下列術(shù)語和定義適用于本文件。3.1 地理編碼 geocoding指的是將地址或者地名信息建立空間坐標(biāo)關(guān)系的過程。3.2 正向地理編碼 forward geocoding正向地理編碼服務(wù)是指將地址或者地名轉(zhuǎn)換成點(diǎn)坐標(biāo)的過程。3.3 單地理編碼 single geocoding單地理編碼匹配是指一次匹配一條地名/地址數(shù)據(jù)的正向地理編碼。3.4 批量地理編碼 bulk geocoding批量地理編碼匹配是指一次匹配多條地名/地址數(shù)據(jù)的正向地理編碼。3.5 反向地理編碼 reverse geocoding反向地理編碼服務(wù)是指將點(diǎn)坐標(biāo)轉(zhuǎn)換為一種可讀的地址串的過程。DB36/T XXXXXXX24 地理編碼服務(wù)4.1 概述地理編碼服務(wù)是地名地址信息服務(wù)平臺(tái)的核心，將成果地名地址數(shù)據(jù)庫和地址匹配功能包裝成服務(wù)的形式對外發(fā)布，供政府各部門、企事業(yè)單位和社會(huì)公眾調(diào)用，是地名地址成果的新型運(yùn)用方式。4.2 服務(wù)類型在線地理編碼服務(wù)系統(tǒng)以地址匹配引擎為核心，提供正向地理編碼、反向地理編碼。4.2.1 正向地理編碼服務(wù)正向地理編碼服務(wù)是指將地址或者地名轉(zhuǎn)換成點(diǎn)坐標(biāo)的過程。該服務(wù)基于正向地理編碼服務(wù)引擎實(shí)現(xiàn)。在進(jìn)行地址匹配時(shí)，支持用戶輸入一個(gè)或者批量的地址描述信息，自動(dòng)匹配分值最高的候選位置，輸入的地址越準(zhǔn)確，匹配的分值越高。地名地址數(shù)據(jù)主要分為行政區(qū)劃、街巷（道路）、興趣點(diǎn)、標(biāo)志物、門牌號等類別；數(shù)據(jù)類型也不一樣，包括點(diǎn)狀、線狀、面狀3種類型；因此在設(shè)計(jì)地理編碼服務(wù)引擎時(shí)，為了更好的達(dá)到地址匹配的效果，采用分引擎設(shè)計(jì)模式，針對不同的地名等級開發(fā)不同的地址匹配引擎，以便更好地進(jìn)行地址匹配，見圖1。圖1 正向地理編碼服務(wù)引擎分類正向地理編碼服務(wù)引擎類型如下：地址引擎：主要用于實(shí)現(xiàn)興趣點(diǎn)級別的地址匹配和定位功能；行政區(qū)劃引擎：主要用于實(shí)現(xiàn)行政區(qū)劃的匹配定位，即當(dāng)用戶輸入行政區(qū)劃的名稱時(shí)，獲取該行政區(qū)劃所對應(yīng)的空間范圍圖形信息；街巷（道路）引擎：主要用于實(shí)現(xiàn)街巷（道路）的匹配與定位功能；交叉路口引擎：主要用于實(shí)現(xiàn)街巷（道路）交叉路口的匹配定位功能，例如用戶輸入“鎢都大道贊賢路” ，定位到兩條道路的交叉口；門址引擎：主要用于實(shí)現(xiàn)門牌號的匹配定位功能。正向地理編碼服務(wù)引擎門址引擎 交叉路口引擎街巷（道路）引擎行政區(qū)劃引擎地址引擎DB36/T XXXXXXX3在實(shí)際使用中，用戶只需輸入地址串，無需選擇通過哪個(gè)引擎來進(jìn)行匹配，引擎的判斷過程由系統(tǒng)自動(dòng)來實(shí)現(xiàn)。4.2.2 反向地理編碼服務(wù)通過反向地理編碼，可以方便的從移動(dòng)終端等設(shè)備上將地理坐標(biāo)轉(zhuǎn)換為易于理解的地址信息。該服務(wù)基于反向地理編碼服務(wù)引擎實(shí)現(xiàn)。反向地理編碼服務(wù)引擎包括3種子引擎：行政區(qū)劃引擎、街巷（道路）引擎和地址引擎，如下：行政區(qū)劃引擎：用戶輸入坐標(biāo)位置，返回該位置所在的行政區(qū)劃名；街巷（道路）引擎：用戶輸入坐標(biāo)位置，返回該位置附近的街巷（道路）名；地址引擎：用戶輸入坐標(biāo)位置，返回離該位置最近的地名的地址。5 地理編碼服務(wù)接口5.1 接口設(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ù)。對于平臺(tái)的WEB Services API設(shè)計(jì)，應(yīng)該遵循以下原則：簡單性，由于這是一個(gè)對于公共開放的Web服務(wù)，它的API的設(shè)計(jì)首先應(yīng)當(dāng)是簡單的，要被大量用戶接受，要獲得比較好的應(yīng)用，那么API必須簡單，沒有哪個(gè)復(fù)雜難用的API會(huì)得到廣泛接受，所以針對目前的應(yīng)用實(shí)況，API必須簡單。 可擴(kuò)展性，作為更新頻率較高，開放性較強(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)持簡單性的前提下，兼顧高效性，當(dāng)某些組合操作應(yīng)用地非常頻繁的時(shí)候，我們應(yīng)當(dāng)為這樣的組合操作調(diào)用設(shè)計(jì)一個(gè)只需一次交互的單一入口調(diào)用，這樣能夠提升外部應(yīng)用的效率，同時(shí)減輕Web服務(wù)的負(fù)載。 完備性，所謂完備性就是說整個(gè)API要覆蓋所有需要對外公開的功能，這相對而言是最好實(shí)現(xiàn)的目標(biāo)，只要設(shè)計(jì)階段考慮得完備，就能達(dá)到完備性的要求。而且萬一發(fā)現(xiàn)不完備的情況，修正起來也是相對容易的。5.2 地理編碼服務(wù)接口5.2.1 單地理編碼服務(wù)接口5.2.1.1 接口說明單個(gè)地理編碼指，進(jìn)行地理編碼時(shí)，每次只輸入一個(gè)位置描述以得到相對應(yīng)的位置信息。通過單個(gè)地理編碼可快速查找到各類位置，每個(gè)候選位置將含有匹配分值，輸入地址越準(zhǔn)確，匹配分值越高。用戶可輸入各種樣式和格式表示的地址，其中包括行政區(qū)劃，街道名稱，街道交叉口、含有街道名稱的門牌號等。5.2.1.2 使用協(xié)議單地理編碼REST接口支持基于HTTP協(xié)議的POST和GET方法請求。DB36/T XXXXXXX45.2.1.3 請求參數(shù)說明請求參數(shù)說明見表1。表1 單地理編碼請求參數(shù)說明請求參數(shù) 參數(shù)含義 是否必須 默認(rèn)值 舉例 描述queryStr 查詢地址 是 無江西省贛州市章貢區(qū)水南鎮(zhèn)客家大道162號中國銀行單地址查詢參數(shù)score 最少的得分 否 無 60查詢結(jié)果地址的匹配度得分，此參數(shù)為一個(gè)臨界值，得分值大于此參數(shù)則將查詢結(jié)果返回，否則不返回。citycode 城市代碼 否 無 360700 國家規(guī)范的行政區(qū)劃代碼f 服務(wù)返回結(jié)果格式 否 xml xml或 json數(shù)據(jù)返回形式，以 xml或 json格式返回5.2.1.4 返回參數(shù)說明返回參數(shù)說明見表2。表2 單地理編碼返回參數(shù)說明返回參數(shù) 參數(shù)含義 數(shù)據(jù)類型 舉例 說明status 狀態(tài)信息 Booleantrue：正常false：異常查詢數(shù)據(jù)的狀態(tài)標(biāo)示queryAddress 查詢地址 String江西省贛州市章貢區(qū)水南鎮(zhèn)客家大道 162號中國銀行用戶輸入的查詢信息count 返回結(jié)果數(shù) String 1 name 名稱 String 中國銀行 score 得分 Double 100 id ID Long geotext WKT格式的幾何數(shù)據(jù) StringPOINT(114.91062000031286 25.843050000257335)geoType 幾何數(shù)據(jù)類型 Int1：點(diǎn)要素2：線要素3：面要素返回?cái)?shù)據(jù)幾何類型fullAddress 完整地址 String江西省贛州市章貢區(qū)水南鎮(zhèn)客家大道 162號中國銀行l(wèi)atitude 緯度 double 114.91062000031286 longitude 經(jīng)度 double 25.843050000257335 province 省名稱 String 江西省 city 市名稱 String 贛州市 result addresscounty 縣名稱 String 章貢區(qū) DB36/T XXXXXXX5town 鄉(xiāng)名稱 String 水南鎮(zhèn) 表2 （續(xù)）返回參數(shù) 參數(shù)含義 數(shù)據(jù)類型 舉例 說明street 街巷（道路）名稱 String 客家大道 street_suf 道路后綴 String 162號 community 小區(qū)名稱 String communitySuf 小區(qū)后綴 String landmark 第一地標(biāo)名稱 String 中國銀行 result addresssecondLandmark 第二地標(biāo)名稱 String 5.2.2 批量地理編碼服務(wù)接口5.2.2.1 接口說明批量地理編碼是指將一系列位置描述批量轉(zhuǎn)換為地球表面上對應(yīng)的位置的過程。批量地理編碼時(shí)，每次傳入多個(gè)位置描述。通過批量地理編碼可快速查找到大量的位置，每條描述地址將自動(dòng)匹配分值最高的候選位置。可搜索的位置類型與單一地理編碼相同，用戶可輸入各種樣式和格式表示的地址，其中包括行政區(qū)劃，街道名稱，街道交叉口、含有街道名稱的門牌號等。5.2.2.2 使用協(xié)議批量地理編碼REST接口支持基于HTTP協(xié)議的POST方法請求。5.2.2.3 請求參數(shù)說明請求參數(shù)說明見表3。表3 批量地理編碼請求參數(shù)說明請求參數(shù) 參數(shù)含義 是否必須 默認(rèn)值 舉例 描述queryStrs 查詢地址 是 無贛州市章貢區(qū)水南鎮(zhèn)客家大道 162號中國銀行, 贛州市章貢區(qū)南外街道辦青年路 32號天天便利多個(gè)地址用分號隔開score 最少的得分 否 無f服務(wù)返回結(jié)果格式 否 xmlxmljson數(shù)據(jù)返回形式，默認(rèn)以 xml格式返回5.2.2.4 返回參數(shù)說明返回參數(shù)說明見表4。表4 批量地理編碼返回參數(shù)說明返回參數(shù) 參數(shù)含義 數(shù)據(jù)類型 舉例 說明status 狀態(tài)信息 Booleantrue：正常false：異常查詢數(shù)據(jù)的狀態(tài)標(biāo)示name 名稱 String 中國銀行 results addressscore 得分 Double 100 DB36/T XXXXXXX6id ID Long 表4 （續(xù)）返回參數(shù) 參數(shù)含義 數(shù)據(jù)類型 舉例 說明geotextWKT格式的幾何數(shù)據(jù) StringPOINT(114.91062000031286 25.843050000257335) geoType 幾何數(shù)據(jù)類型 Int1：點(diǎn)要素2：線要素3：面要素返回?cái)?shù)據(jù)幾何類型fullAddress 完整地址 String江西省贛州市章貢區(qū)水南鎮(zhèn)客家大道 162號中國銀行l(wèi)atitude 緯度 double 114.91062000031286 longitude 經(jīng)度 double 25.843050000257335 province 省名稱 String 江西省 city 市名稱 String 贛州市 county 縣名稱 String 章貢區(qū) town 鄉(xiāng)名稱 String 水南鎮(zhèn) street 道路名稱 String 客家大道 street_suf 道路后綴 String 162號 community 小區(qū)名稱 String communitySuf 小區(qū)后綴 String landmark 第一地標(biāo)名稱 String 中國銀行 results addresssecondLandmark 第二地標(biāo) String 5.2.3 反向地理編碼服務(wù)接口5.2.3.1 接口說明反向地理編碼是將點(diǎn)坐標(biāo)轉(zhuǎn)換為一種可讀的地址或者地名的過程。反向地理編碼時(shí)，通過給出坐標(biāo)以確定所給坐標(biāo)所在行政區(qū)劃名，附近街道名，以及最近地名（興趣點(diǎn)）。用戶可選擇地址精準(zhǔn)度到行政區(qū)劃，市或者興趣點(diǎn)。通過反向地理編碼，用戶可從移動(dòng)端，GPS端等將地理坐標(biāo)轉(zhuǎn)換為更易于理解的地址信息。5.2.3.2 使用協(xié)議反向地理編碼REST接口支持基于HTTP協(xié)議的POST和GET方法請求。5.2.3.3 請求參數(shù)說明請求參數(shù)說明見表5。表5 反向地理編碼請求參數(shù)說明請求參數(shù) 參數(shù)含義 是否必須 默認(rèn)值 舉例 描述distance 最遠(yuǎn)距離 否 500M以用戶輸入的點(diǎn)為圓心，distance 為半徑查詢周邊最近的道路或地標(biāo)，最大范圍 5000米。longitude 經(jīng)度 是 用戶輸入點(diǎn)的經(jīng)度DB36/T XXXXXXX7latitude 緯度 是 用戶輸入點(diǎn)的緯度表5 （續(xù)）請求參數(shù) 參數(shù)含義 是否必須 默認(rèn)值 舉例 描述f服務(wù)返回結(jié)果格式 否 xmlxmljson數(shù)據(jù)返回形式，默認(rèn)以 xml格式返回isGeom道路和區(qū)域是否返回空間幾何字段否 true truefalse反向地理編碼查詢結(jié)果中的行政區(qū)劃和道路是否返回空間坐標(biāo)信息，結(jié)果較長，默認(rèn)返回。5.2.3.4 返回參數(shù)說明返回參數(shù)說明見表6。表6 反向地理編碼返回參數(shù)說明返回參數(shù) 參數(shù)含義 數(shù)據(jù)類型 舉例 說明status 狀態(tài)信息 Booleantrue：正常false：異常查詢數(shù)據(jù)的狀態(tài)標(biāo)示count 返回結(jié)果數(shù) String 100 批量匹配條數(shù)name 名稱 String 水南鎮(zhèn)fullAddress 標(biāo)準(zhǔn)地址 String江西省贛州市章貢區(qū)水南鎮(zhèn)province 省名稱 String 江西省city 市名稱 String 贛州市county 縣名稱 String 章貢區(qū)regiontown 鄉(xiāng)名稱 String 水南鎮(zhèn)name 名稱 String 客家大道fullAddress 標(biāo)準(zhǔn)地址 String江西省贛州市章貢區(qū)水南鎮(zhèn)客家大道province 省名稱 String 江西省city 市名稱 double 贛州市county 縣名稱 double 章貢區(qū)town 鄉(xiāng)名稱 String 水南鎮(zhèn)streetdistance 請求點(diǎn)至道路最短距離 double 98.34name 地物名稱 String 中國銀行fullAddress 標(biāo)準(zhǔn)地址 String江西省贛州市章貢區(qū)水南鎮(zhèn)客家大道 162號中國銀行province 省名稱 String 江西省city 市名稱 String 贛州市county 縣名稱 String 章貢區(qū)town 鄉(xiāng)名稱 String 水南鎮(zhèn)resultpoilongitude 經(jīng)度 double 114.91062000031286DB36/T XXXXXXX8latitude 緯度 double 25.843050000257335distance 請求點(diǎn)至 POI最短距離 double 30.74DB36/T XXXXXXX9A A附 錄 A（規(guī)范性附錄）評分標(biāo)準(zhǔn)地理編碼引擎將判定用戶輸入地址與標(biāo)準(zhǔn)地址庫匹配程度，匹配度越高則得分越高。具體的評分標(biāo)準(zhǔn)見表A.1。表A.1 評分標(biāo)準(zhǔn)得分 地物評分描述 街巷（道路）評分描述 行政區(qū)評分描述精確到所在小區(qū)、地標(biāo)或村，且用戶輸入地址所屬縣級行政區(qū)劃無缺失精確到街巷（道路），用戶輸入行政區(qū)劃級別無缺失精確到行政區(qū)劃，用戶輸入行政區(qū)劃級別無缺失90-100門牌號碼相差 0-5個(gè) 精確到街巷（道路），用戶輸入包含市級或縣級行政區(qū)劃 匹配市級或縣級行政區(qū)劃精確到所在小區(qū)、地標(biāo)或村，且用戶輸入的地址所屬行政區(qū)劃，如縣、鄉(xiāng)有缺失精確到街巷（道路），用戶輸入包含鄉(xiāng)級行政區(qū)劃精確到行政區(qū)劃，用戶輸入行政區(qū)劃級別缺失市級或縣級行政區(qū)劃80-90門牌號碼相差 5-10個(gè)門牌號碼相差 10-15個(gè) 精確到街巷（道路），用戶輸入只包含街巷（道路）名稱 精確到鄉(xiāng)級行政區(qū)劃，用戶輸入只包含鄉(xiāng)級行政區(qū)劃70-80所屬行政區(qū)劃存在或部分缺失精確到道路 無 精確到村或社區(qū)，用戶輸入只包含村或社區(qū)60-70所屬行政區(qū)劃存在或部分缺失精確到鄉(xiāng)級行政區(qū)劃 無 無50-60 所屬行政區(qū)劃存在或部分缺失35 精確到縣級行政區(qū)劃 無 無20 精確到市級行政區(qū)劃 無 無_