術語“位址解析”通常是指將人類可讀的地址轉換成地圖上的位置。反之,將地圖上的位置轉換成人類可讀的地址這一過程則稱為“反向位址解析”。
Google Geocoding API 支援直接使用 latlng 參數進行反向位址解析。例如,下列查詢包含了布魯克林某一位置的緯度/經度值:
http://maps.google.com/maps/api/geocode/json?latlng=40.714224,-73.961452&sensor=true_or_false
請注意:在傳入 latlng 參數時,請確保緯度值與經度值之間沒有空格。
該查詢返回下列結果:
{ "status": "OK", "results": [ { "types": [ "street_address" ], "formatted_address": "275-291 Bedford Ave, Brooklyn, NY 11211, USA", "address_components": [ { "long_name": "275-291", "short_name": "275-291", "types": [ "street_number" ] }, { "long_name": "Bedford Ave", "short_name": "Bedford Ave", "types": [ "route" ] }, { "long_name": "New York", "short_name": "New York", "types": [ "locality", "political" ] }, { "long_name": "Brooklyn", "short_name": "Brooklyn", "types": [ "administrative_area_level_3", "political" ] }, { "long_name": "Kings", "short_name": "Kings", "types": [ "administrative_area_level_2", "political" ] }, { "long_name": "New York", "short_name": "NY", "types": [ "administrative_area_level_1", "political" ] }, { "long_name": "United States", "short_name": "US", "types": [ "country", "political" ] }, { "long_name": "11211", "short_name": "11211", "types": [ "postal_code" ] } ], "geometry": { "location": { "lat": 40.7142298, "lng": -73.9614669 }, "location_type": "RANGE_INTERPOLATED", "viewport": { "southwest": { "lat": 40.7110822, "lng": -73.9646145 }, "northeast": { "lat": 40.7173774, "lng": -73.9583193 } } } }, ... Additional results[] ...
請注意,反向位址解析器傳回了多個結果。結果的 "formatted_addresses" 不僅是指通訊地址,還包含對位置進行地理命名的所有方式。例如,當對芝加哥市中的一個點進行位址解析時,位址解析的點可標註為其街道地址、城市(芝加哥)、州(伊利諾斯)或國家(美國)。這些對位址解析器來說都是“地址”。反向位址解析器可將任何這些類型的地址作為有效結果傳回。
反向位址解析器將匹配政治實體(省/地區、省、市和鄰近地區)、街道地址和郵遞區號。
前一查詢所傳回的 formatted_address 值的完整列表如下所示。
"formatted_address": "275-291 Bedford Ave, Brooklyn, NY 11211, USA", "formatted_address": "Williamsburg, NY, USA", "formatted_address": "New York 11211, USA", "formatted_address": "Kings, New York, USA", "formatted_address": "Brooklyn, NY, USA", "formatted_address": "New York, NY, USA", "formatted_address": "New York, USA", "formatted_address": "United States"
通常,地址將按照具體程度由高到低的順序傳回;最確切的地址將作為最顯著的結果傳回,本例就是如此。請注意,我們傳回了各種不同的地址,從十分具體的街道地址到比較籠統的政治實體,如鄰近地區、市、縣、州/省等。如果您希望匹配更廣泛的地址,可能要檢查傳回的
Placemark 的 "types" 欄位(請參見上文的地址組成部分類型)。
注意:反向位址解析給出的是估計結果。位址解析器會試圖在一定的偏差範圍內尋找最接近的可定址位置;如果找不到匹配項,位址解析器通常不會傳回結果。