「地理編碼」一詞通常是指將清楚易懂的地址轉譯成地圖上的某個位置。而反向操作 (將地圖上的某個位置轉譯成清楚易懂的地址),就稱為「反向地理編碼」。
- :經緯度座標,指出距離最近且人類可讀地址的地點。
- :應用程式的 API 金鑰。這個金鑰可識別您的應用程式,以便進行配額管理。瞭解如何取得金鑰。
以下是您可以在反向地理編碼要求中加入的選用參數:
- :傳回結果的語言。
- 請參閱支援語言清單。Google 經常更新支援的語言,因此這份清單可能會有差異。
- 如果未提供 ,地理編碼器會嘗試使用 標頭中指定的偏好語言,或傳送要求的網域的原生語言。
- 地理編碼器會盡力提供使用者和當地人都看得懂的街道地址。為達成這個目標,系統會以當地語言傳回街道地址,並視需要將其轉寫為使用者可讀的文字,以便遵循慣用語言。系統會以偏好語言傳回所有其他地址。系統傳回地址元件時,一律會使用同一種語言傳回,而該語言是從第一個元件選擇。
- 如果偏好語言中沒有名稱,地理編碼器會使用最接近的名稱。
- :區碼,指定為 ccTLD (「頂層網域」) 的兩位字元值。這個參數也可能會影響根據適用法律產生的結果。
- :一或多個地址類型的篩選器,以直立線 () 分隔。如果參數包含多個位址類型,API 會傳回符合任一類型地址的所有地址。處理程序注意事項: 參數不會「限制」搜尋指定的地址類型。而是將 當做搜尋後篩選器:API 會擷取指定 的所有結果,然後捨棄與指定地址類型不符的結果。系統支援下列值:
- 表示精確的街道地址。
- 表示具名道路 (例如「國道一號」)。
- 表示主要的十字路口,通常有兩條主要道路交會。
- 表示政治實體。這個類型通常表示某些行政管理區的多邊形區域。
- 表示國家政治實體,且通常是地理編碼器所傳回的最高順位類型。
- 表示國家/地區層級底下的第一順位行政實體。在美國境內,這類行政層級是指州。部分國家沒有這類行政層級。在大多數情況下,administrative_area_level_1 簡稱會與 ISO 3166-2 子行政區以及其他廣泛流通的清單密切相符。然而,地理編碼結果是根據多種信號和位置資料計算得出,因此我們對於結果無法做出保證。
- 表示國家/地區層級底下的第二順位行政實體。在美國境內,這類行政層級是指郡。部分國家沒有這類行政層級。
- 表示國家/地區層級底下的第三順位行政實體。這個類型表示小型行政單位。部分國家沒有這類行政層級。
- 表示國家/地區層級底下的第四順位行政實體。這個類型表示小型行政單位。部分國家沒有這類行政層級。
- 表示國家/地區層級底下的第五順位行政實體。這個類型表示小型行政單位。部分國家沒有這類行政層級。
- 表示國家/地區層級底下的第六順位行政實體。這個類型表示小型行政單位。部分國家沒有這類行政層級。
- 表示國家/地區層級底下的第七順位行政實體。這個類型表示小型行政單位。部分國家沒有這類行政層級。
- 表示實體的常用替代名稱。
- 表示自治城市或鄉鎮的政治實體。
- 表示縣市底下的第一順位行政實體。某些地點可能會收到以下其中一種額外類型: 到 。每個鄉鎮市區層級都是一個行政實體。數字越大表示地理區域越小。
- 表示具名社區。
- 表示具名地點,通常是建築物或具有共同名稱的建築物群。
- 表示場所層級底下的可定址實體,例如公寓、住房或套房。
- 表示經過編碼的位置參照,衍生自經緯度。對於沒有詳細地址的地點,Plus Codes 可用於取代街道地址,例如無編號的建築物或無名街道。詳情請參閱 。
- 表示國家/地區郵政地址所使用的郵遞區號。
- 表示明顯的自然地貌。
- 表示機場。
- 表示具名公園。
- 表示具名搜尋點。一般來說,這些「搜尋點」是當地著名的實體,無法輕易歸入其他類別,例如「帝國大廈」或「艾菲爾鐵塔」。
- :一或多個地點類型的篩選器,以管道符號 () 分隔。如果參數包含多個地點類型,API 會傳回符合任一類型的所有地址。處理相關注意事項: 參數不會將搜尋範圍限制為指定的位置類型。而是將 當做搜尋後篩選器:API 會擷取指定 的所有結果,然後捨棄與指定位置類型不符的結果。支援下列值:
- 只會傳回 Google 擁有街道地址精確度位置資訊的地址。
- 只會傳回插入在兩個精確點之間 (例如十字路口) 的約略地址 (通常在道路上)。插補範圍通常表示街道地址沒有精準的地理編碼。
- 只會傳回地點的幾何圖形中心,例如折線 (例如街道) 或多邊形 (區域)。
- 只會傳回屬於近似地址的地址。
- :使用這個參數,在回應中指定下列額外功能:
- :詳情請參閱地址描述符。
- :詳情請參閱入口和建築物輪廓。
如果同時提供 和 篩選器,API 只會傳回符合 和 值的結果。如果沒有任何可接受的篩選器值,API 會傳回 。
以下查詢包含 Brooklyn 某個地點的經緯度值:
上述查詢會傳回下列結果:
請注意,反向 Geocoder 會傳回一個以上的結果。 結果不僅是郵寄地址,也可以使用任何表述地理的方式為地點命名。舉例來說,針對芝加哥市的某個定點進行地理編碼時,這個地理編碼定點可以採用街道地址、城市 (芝加哥)、州名 (伊利諾州) 或國家/地區 (美國)。對 Geocoder 而言,這些都是「地址」。反向地理編碼器會將任一類型傳回為有效結果。
反向地理編碼器會比對政治實體 (國家/地區、州/省、城市和社區)、街道地址和郵遞區號。
以下為先前查詢傳回的 值完整清單。
這個 API 會傳回不同類型的地址,從最具體的街道地址到較籠統的政治實體,例如社區、城市、郡/縣和州。一般來說,最相符的地址是最顯眼的結果,如本例所示。如果您想比對特定類型的地址,請參閱下文的依類型限制結果一節。因此,結果相對於彼此的位置可能會有所不同。
以下範例會篩選傳回的地址,僅包含地點類型為 且地址類型為 的地址。
反向地理編碼回應的格式與地理編碼回應相同。請參閱「地理編碼回應」。以下是反向地理編碼回應可能出現的狀態碼。
地理編碼回應物件中的 欄位包含要求的狀態,並可能包含偵錯資訊,以協助您追蹤反向地理編碼無法運作的原因。 欄位可能包含下列值:
- 表示未發生任何錯誤,且系統至少傳回一個地址。
- 表示反向地理編碼成功,但未傳回任何結果。如果地理編碼器收到遠端位置的 ,就有可能發生這種情況。
- 表示您已超過配額。
- 表示要求遭拒。可能是因為要求包含 或 參數,但不含 API 金鑰。
- 通常表示下列其中一種情況:
- 缺少查詢 (、 或 )。
- 提供的 或 無效。
- 表示伺服器發生錯誤,因此無法處理要求。如果再試一次,要求可能會成功。
地理編碼回應中的 欄位包含最接近查詢經緯度的 Plus Code。此外,在大多數情況下,JSON 結果陣列會包含完整的地址代碼結果,其中包含 類型和含有加號代碼的地址。已解碼的 Plus Code 與要求點之間的距離保證小於 10 公尺。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。
如需转载请保留出处:https://bianchenghao.cn/bian-cheng-ri-ji/33592.html