谷歌地圖 API 開發(fā)之 Geocoding API

rose 發(fā)布于2019-08-22 10:35 / 4308人閱讀

摘要：地理編碼響應(yīng)地理編碼響應(yīng)以請(qǐng)求路徑中標(biāo)志指示的格式返回。表示地理編碼成功，但未返回任何結(jié)果。通常，這種類型表示某個(gè)民政管理部門的多邊形表示國(guó)家政治實(shí)體，通常是由地理編碼器返回的最高級(jí)別類型表示國(guó)家地區(qū)級(jí)別以下的一級(jí)行政實(shí)體。

大部分項(xiàng)目還是都有要獲取當(dāng)前點(diǎn)擊的坐標(biāo)經(jīng)緯度或者獲取當(dāng)前街道的信息的，然而谷歌API 的文檔也并不是很直觀。
官網(wǎng)地理編碼服務(wù)地址：https://developers.google.com...
在服務(wù)欄里的地理編碼里，為什么說是服務(wù)呢，用谷歌翻譯了下，發(fā)現(xiàn)想獲取坐標(biāo)以及街道詳情，需要調(diào)用谷歌的地理編碼接口(不是完全免費(fèi)的哦)，所以，算是谷歌的接口服務(wù)吧。然后人家就來(lái)了個(gè)限制政策，如下：

使用地理編碼服務(wù)的標(biāo)準(zhǔn)

每天2500免費(fèi)請(qǐng)求，客戶端和的總和來(lái)計(jì)算服務(wù)器端的查詢; 啟用結(jié)算進(jìn)入更高的每日配額，以$ 0.50計(jì)費(fèi)美元/ 1000其他要求，達(dá)10萬(wàn)每天的請(qǐng)求。

每秒50個(gè)請(qǐng)求，作為客戶端和的總和來(lái)計(jì)算服務(wù)器端的查詢。

然而這個(gè)服務(wù)看了好久，也沒看出怎么請(qǐng)求，于是乎，又不停的找谷歌api，找了好久，終于不負(fù)有心人，讓勞資給找到了這個(gè)Google Maps Geocoding API 地址：https://developers.google.com...

下面進(jìn)入正文。其實(shí)下面的都是從谷歌API copy 過來(lái)的,不要吐槽我，一點(diǎn)一點(diǎn)的粘貼復(fù)制整理也好累的 >_<

什么是地理編碼？

地理編碼是將地址（如“1600 Amphitheatre Parkway, Mountain View, CA”）轉(zhuǎn)換為地理坐標(biāo)（如緯度 37.423021 和經(jīng)度 -122.083739）的過程，您可以借此在地圖上放置標(biāo)記，或在地圖上定位。

反向地理編碼是將地理坐標(biāo)轉(zhuǎn)換為可人工讀取的地址的過程。Google Maps Geocoding API 的反向地理編碼服務(wù)還可讓您找到對(duì)應(yīng)于給定的地點(diǎn) ID 的地址。

Google Maps Geocoding API 請(qǐng)求格式

Google Maps Geocoding API 請(qǐng)求必須采用以下形式：

https://maps.googleapis.com/maps/api/geocode/output?parameters

其中，output 可以是以下值之一：

json（推薦）指示以 JavaScript 對(duì)象標(biāo)記 (JSON) 輸出

xml 指示以 XML 格式輸出

如需通過 HTTP 訪問 Google Maps Geocoding API，請(qǐng)使用：http://maps.googleapis.com/maps/api/geocode/output?parameters

對(duì)于請(qǐng)求中包含敏感用戶數(shù)據(jù)（例如用戶的位置）的應(yīng)用，不建議使用 HTTP。
有些參數(shù)是必填的，而有些是可選的。依照 URL 的標(biāo)準(zhǔn)，參數(shù)都使用“與”字符 (&) 分隔。
因?yàn)槊糠N請(qǐng)求類型使用的參數(shù)不同，所以本頁(yè)面的其余部分分別介紹了地理編碼和反向地理編碼。

地理編碼（緯度/經(jīng)度查詢）

地理編碼請(qǐng)求中的必填參數(shù)：

address- 要進(jìn)行地理編碼的街道地址，采用相關(guān)國(guó)家/地區(qū)的全國(guó)郵政服務(wù)所使用的格式。應(yīng)避免其他地址元素，例如企業(yè)名稱以及單元號(hào)、套房號(hào)或樓層。
或
components - 您希望獲得其地理編碼的組成部分過濾器。如果提供了 address，還將接受組成部分過濾器作為可選參數(shù)。

key – 您的應(yīng)用的 API 密鑰。此密鑰可以標(biāo)識(shí)您的應(yīng)用，以便進(jìn)行配額管理。

地理編碼請(qǐng)求中的可選參數(shù)：

bounds – 視口的邊框，在其中可以使地理編碼結(jié)果更顯著地發(fā)生偏向。此參數(shù)只會(huì)影響，而不會(huì)完全限制地理編碼器中的結(jié)果。

language – 返回結(jié)果時(shí)使用的語(yǔ)言。請(qǐng)注意，我們會(huì)經(jīng)常更新支持的語(yǔ)言，因此，此列表可能并不全面。如果未提供 language，地理編碼器將盡可能嘗試使用發(fā)送請(qǐng)求區(qū)域的當(dāng)?shù)卣Z(yǔ)言。

region – 地區(qū)代碼，指定為一個(gè) ccTLD（“頂級(jí)域名”）雙字符值。此參數(shù)只會(huì)影響，而不會(huì)完全限制地理編碼器中的結(jié)果。

components – 組成部分過濾器，用管道符號(hào) (|) 分隔。每個(gè)組成部分過濾器由一個(gè) component:value 對(duì)組成，將完全限制地理編碼器中的結(jié)果。

地理編碼響應(yīng)

地理編碼響應(yīng)以 URL 請(qǐng)求路徑中 output 標(biāo)志指示的格式返回。

在此示例中，Google Maps Geocoding API 請(qǐng)求針對(duì)“1600 Amphitheatre Parkway, Mountain View, CA”查詢的 json 響應(yīng)。

此請(qǐng)求演示了如何使用 JSON output 標(biāo)志：

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

此請(qǐng)求演示了如何使用 XML output 標(biāo)志：

https://maps.googleapis.com/maps/api/geocode/xml?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

在此只演示下Json響應(yīng)結(jié)果實(shí)例：

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "1600",
               "short_name" : "1600",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Amphitheatre Pkwy",
               "short_name" : "Amphitheatre Pkwy",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Mountain View",
               "short_name" : "Mountain View",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "Santa Clara County",
               "short_name" : "Santa Clara County",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "California",
               "short_name" : "CA",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "94043",
               "short_name" : "94043",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "1600 Amphitheatre Parkway, Mountain View, CA 94043, USA",
         "geometry" : {
            "location" : {
               "lat" : 37.4224764,
               "lng" : -122.0842499
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 37.4238253802915,
                  "lng" : -122.0829009197085
               },
               "southwest" : {
                  "lat" : 37.4211274197085,
                  "lng" : -122.0855988802915
               }
            }
         },
         "place_id" : "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
         "types" : [ "street_address" ]
      }
   ],
   "status" : "OK"
}

請(qǐng)注意，JSON 響應(yīng)包含兩個(gè)根元素：

"status" 包含請(qǐng)求的元數(shù)據(jù)。請(qǐng)參閱下面的狀態(tài)代碼。

"results" 包含一個(gè)有關(guān)地理編碼地址信息和幾何信息的數(shù)組。

狀態(tài)代碼

地理編碼響應(yīng)對(duì)象中的 "status" 字段包含了請(qǐng)求的狀態(tài)，還可能包含調(diào)試信息，以幫助您查明地理編碼不工作的原因。"status" 字段可以包含以下值：

"OK" 表示未出現(xiàn)任何錯(cuò)誤；已成功解析地址，并且至少返回了一個(gè)地理編碼。

"ZERO_RESULTS" 表示地理編碼成功，但未返回任何結(jié)果。如果向地理編碼器傳遞了一個(gè)不存在 address，就可能會(huì)發(fā)生這種情況。

"OVER_QUERY_LIMIT" 表示您已超出配額。

"REQUEST_DENIED" 表示系統(tǒng)已拒絕您的請(qǐng)求。

"INVALID_REQUEST" 一般表示缺少查詢（address、components 或 latlng）。

"UNKNOWN_ERROR" 表示由于服務(wù)器發(fā)生錯(cuò)誤，因此無(wú)法處理該請(qǐng)求。如果您重試一次，請(qǐng)求可能會(huì)成功

結(jié)果

當(dāng)?shù)乩砭幋a器返回結(jié)果時(shí)，會(huì)將這些結(jié)果放在一個(gè) (JSON) results 數(shù)組中。即使地理編碼器沒有返回任何結(jié)果（例如，如果地址不存在），它仍然會(huì)返回一個(gè)空的 results 數(shù)組。（XML 響應(yīng)包含零個(gè)或更多個(gè) 元素。）

典型的結(jié)果由以下字段組成：

types[]數(shù)組表示返回結(jié)果的類型。此數(shù)組包含一組標(biāo)記（可能為零個(gè)或多個(gè)），用于標(biāo)識(shí)結(jié)果中所返回特征的類型。例如，“芝加哥”的地理編碼返回“l(fā)ocality”，這表明“芝加哥”是一個(gè)城市，并且還返回“political”，這表明它是一個(gè)政治實(shí)體。

formatted_address：是一個(gè)包含此位置可人工讀取的地址的字符串。通常此地址相當(dāng)于“郵政地址”，有時(shí)會(huì)因國(guó)家/地區(qū)而異。（請(qǐng)注意，由于許可限制，某些國(guó)家（如英國(guó)）不允許發(fā)布真實(shí)的郵政地址。）此地址通常由一個(gè)或多個(gè)地址組成部分組成。例如，地址“111 8th Avenue, New York, NY”包含以下地址組成部分：“111”（街道號(hào)）、“8th Avenue”（道路）、“New York”（城市）和“NY”（美國(guó)的一個(gè)州）。這些地址組成部分包含如下所述的附加信息。

address_components[] 是包含獨(dú)立的地址組成部分的數(shù)組，如上所述。通常，每個(gè) address_component均包含：

`types[]`，一個(gè)表示地址組成部分類型的數(shù)組。
`long_name` 是地理編碼器返回的地址組成部分的完整文本說明或名稱。
`short_name` 是地址組成部分的文本名稱縮寫（如有）。例如，Alaska 州的地址組成部分可以有 long_name“Alaska”和 short_name“AK”（使用雙字母郵政縮寫表示）。

請(qǐng)注意，address_components[] 中包含的地址組成部分可能比 formatted_address 中記錄的更多。

postcode_localities[] 是一個(gè)數(shù)組，表示一個(gè)郵政編碼中包含的所有地方。只有當(dāng)結(jié)果是一個(gè)包含多個(gè)地方的郵政編碼時(shí)，才會(huì)有此數(shù)組。

geometry 包含以下信息：

location：其中包含地理編碼經(jīng)度、緯度值。對(duì)于普通的地址查找，此字段通常是最重要的。

location_type 存儲(chǔ)有關(guān)指定位置的附加數(shù)據(jù)。目前支持以下值：

"ROOFTOP" 表示返回的結(jié)果是一個(gè)精確的地理編碼，我們使其位置信息精確到街道地址的精度。
"RANGE_INTERPOLATED" 表示返回的結(jié)果反映了兩個(gè)精確點(diǎn)（例如交叉路口）之間用內(nèi)插法計(jì)算得到的近似值（通常在道路上）。當(dāng)某個(gè)街道地址的 rooftop 地理編碼不可用時(shí)，通常會(huì)返回內(nèi)插值結(jié)果。
"GEOMETRIC_CENTER" 表示返回的結(jié)果是某個(gè)位置（如多段線（例如街道）或多邊形（地區(qū)））的幾何中心。
"APPROXIMATE" 表示返回的結(jié)果是近似值。

viewport 包含用于顯示返回結(jié)果的推薦視口，指定為兩個(gè)緯度、經(jīng)度值，分別定義視口邊框的 southwest 和 northeast 角。視口通常用來(lái)在向用戶顯示結(jié)果時(shí)為該結(jié)果加邊框。

bounds（可選返回）存儲(chǔ)可完全包含返回結(jié)果的邊框。請(qǐng)注意，這些邊界可能與推薦的視口不一致。（例如，舊金山包含費(fèi)拉隆島，理論上它是這個(gè)城市的一部分，但可能不應(yīng)該在視口中返回。）

partial_match 表示雖然地理編碼器能夠匹配所請(qǐng)求的地址的一部分，但它未能返回原始請(qǐng)求的精確匹配項(xiàng)。您不妨檢查一下原始請(qǐng)求中是否有拼寫錯(cuò)誤和/或地址不完整的情況。
對(duì)于請(qǐng)求中所傳遞的行政區(qū)劃內(nèi)不存在的街道地址，最常發(fā)生部分匹配的情況。當(dāng)請(qǐng)求與同一行政區(qū)劃中的兩個(gè)或更多位置相匹配時(shí)，也可能會(huì)返回部分匹配。例如，“21 Henr St, Bristol, UK”將返回 Henry Street 和 Henrietta Street 這兩項(xiàng)部分匹配結(jié)果。請(qǐng)注意，如果請(qǐng)求中包含拼寫錯(cuò)誤的地址組成部分，地理編碼服務(wù)可能會(huì)建議一個(gè)備選地址。以這種方式觸發(fā)的建議也將標(biāo)記為部分匹配。

place_id 是唯一一個(gè)可以與其他 Google API 結(jié)合使用的標(biāo)識(shí)符。例如，您可以在 Google Places API 請(qǐng)求中使用 place_id 獲取當(dāng)?shù)仄髽I(yè)的詳情，如電話號(hào)碼、營(yíng)業(yè)時(shí)間、用戶評(píng)論等。

地址類型和地址組成部分類型

結(jié)果中的 types[] 數(shù)組表示地址類型。地址類型的示例包括街道地址、國(guó)家/地區(qū)或政治實(shí)體。在 address_components[] 中也有一個(gè) types[] 數(shù)組，用來(lái)表示地址各個(gè)部分的類型。示例包括門牌號(hào)碼或國(guó)家/地區(qū)。（以下是類型的完整列表。）地址可能有多種類型。這些類型可能會(huì)被視為“標(biāo)記”。例如，許多城市都標(biāo)有 political 和 locality 類型。

地理編碼器以地址類型和地址組成部分類型數(shù)組這兩種形式支持并返回以下類型：

street_address 表示精確的街道地址。
route：表示已命名的路線（例如“US 101”）
intersection：表示主要交叉路口，通常是兩條主要道路的交叉路口
political：表示政治實(shí)體。通常，這種類型表示某個(gè)民政管理部門的多邊形
country：表示國(guó)家政治實(shí)體，通常是由地理編碼器返回的最高級(jí)別類型
administrative_area_level_1：表示國(guó)家/地區(qū)級(jí)別以下的一級(jí)行政實(shí)體。在美國(guó)，這種行政級(jí)別就是州。并非所有國(guó)家都設(shè)有這類行政級(jí)別
administrative_area_level_2：表示國(guó)家/地區(qū)級(jí)別以下的二級(jí)行政實(shí)體。在美國(guó)，這種行政級(jí)別就是縣。并非所有國(guó)家都設(shè)有這類行政級(jí)別
administrative_area_level_3：表示國(guó)家/地區(qū)級(jí)別以下的三級(jí)行政實(shí)體。此類型表示較小的行政區(qū)劃單位。并非所有國(guó)家都設(shè)有這類行政級(jí)別
administrative_area_level_4：表示國(guó)家/地區(qū)級(jí)別以下的四級(jí)行政實(shí)體。此類型表示較小的行政區(qū)劃單位。并非所有國(guó)家都設(shè)有這類行政級(jí)別
administrative_area_level_5：表示國(guó)家/地區(qū)級(jí)別以下的五級(jí)行政實(shí)體。此類型表示較小的行政區(qū)劃單位。并非所有國(guó)家都設(shè)有這類行政級(jí)別
colloquial_area：表示實(shí)體的常用替代名稱
locality 表示合并的城市或城鎮(zhèn)政治實(shí)體。
ward 表示一種特定的日本行政區(qū)劃類型，以便于區(qū)分某個(gè)日本地址中的多個(gè)行政區(qū)劃組成部分。
sublocality：表示 locality 以下的一級(jí)行政實(shí)體。某些位置可能會(huì)收到其他類型之一：從 sublocality_level_1 到 sublocality_level_5。每個(gè) sublocality 級(jí)別都是一個(gè)行政實(shí)體。數(shù)字越大，表示的地理區(qū)域越小
neighborhood 表示已命名的街區(qū)
premise 表示已命名的位置，通常是具有常見名稱的一棟或一群建筑物
subpremise 表示指定位置以下的一級(jí)實(shí)體，通常是同名建筑群中的單個(gè)建筑物
postal_code 表示郵政編碼，用于國(guó)內(nèi)的地址郵寄。
natural_feature：表示著名的自然景觀
airport：表示機(jī)場(chǎng)
park：表示已命名的公園。
point_of_interest 表示已命名的景點(diǎn)。通常，這些“景點(diǎn)”是不容易歸入其他類別的著名地方實(shí)體，如“帝國(guó)大廈”或“自由女神像”。

除了上述類型之外，地址組成部分還可能包括下列類型。

floor：表示某個(gè)建筑物地址的樓層
establishment 通常表示某個(gè)尚未歸類的地方。
point_of_interest 表示已命名的景點(diǎn)。
parking 表示停車場(chǎng)或停車設(shè)施。
post_box 表示特定的郵政信箱。
postal_town 表示地理區(qū)域的分組，如 locality 和 sublocality，在某些國(guó)家/地區(qū)用于郵寄地址。
room 表示某個(gè)建筑物地址的房間。
street_number 表示確切的門牌號(hào)碼。
bus_station、train_station 和 transit_station 表示巴士、火車或公交車站的位置。

反向地理編碼（地址查找）

術(shù)語(yǔ)地理編碼一般是指將可人工讀取的地址轉(zhuǎn)換為地圖上的某個(gè)位置。與之相反，將地圖上的某個(gè)位置轉(zhuǎn)換為可人工讀取的地址的過程，就稱為反向地理編碼。

必填參數(shù)：您必須在反向地理編碼請(qǐng)求中提供下列參數(shù)之一，但不可同時(shí)提供這兩個(gè)參數(shù)：

要么：latlng – 經(jīng)緯度值，用于指定希望獲得其最接近的、可人工讀取的地址的位置。

或者：place_id – 您希望獲得其可人工讀取的地址的地方的地點(diǎn) ID。地點(diǎn) ID 是唯一一個(gè)可以與其他 Google API 結(jié)合使用的標(biāo)識(shí)符。例如，您可以使用由 Google Maps Roads API 返回的 placeID 來(lái)獲取某個(gè)拍攝點(diǎn)的地址。

反向地理編碼請(qǐng)求中的可選參數(shù)：

key – 您的應(yīng)用的 API 密鑰，可從 Google API Console 獲得。此密鑰可以標(biāo)識(shí)您的應(yīng)用，以便進(jìn)行配額管理。

language – 返回結(jié)果時(shí)使用的語(yǔ)言。請(qǐng)參閱支持的區(qū)域語(yǔ)言列表。請(qǐng)注意，我們會(huì)經(jīng)常更新支持的語(yǔ)言，因此，此列表可能并不全面。如果未提供 language，地理編碼器將盡可能嘗試使用發(fā)送請(qǐng)求區(qū)域的當(dāng)?shù)卣Z(yǔ)言。

result_type – 一個(gè)或多個(gè)地址類型，用管道符號(hào) (|) 分隔。地址類型的示例：country、street_address、postal_code。如需查看允許值的完整列表，請(qǐng)參閱此頁(yè)面上的地址類型。如果指定了一種類型，會(huì)將結(jié)果限制于這種類型。如果指定了多種類型，該 API 將返回匹配其中任何類型的所有地址。注：此參數(shù)僅適用于包括 API 密鑰或客戶端 ID 的請(qǐng)求。

location_type – 一個(gè)或多個(gè)位置類型，用管道符號(hào) (|) 分隔。如果指定了一種類型，會(huì)將結(jié)果限制于這種類型。如果指定了多種類型，該 API 將返回匹配其中任何類型的所有地址。注：此參數(shù)僅適用于包括 API 密鑰或客戶端 ID 的請(qǐng)求?？芍С忠韵轮担?/p>

"ROOFTOP" 將結(jié)果限制為我們使其位置信息精確到街道地址精度的地址。
"RANGE_INTERPOLATED" 將結(jié)果限制為反映了兩個(gè)精確點(diǎn)（例如交叉路口）之間用內(nèi)插法計(jì)算得到的近似值（通常在道路上）的地址。內(nèi)插的范圍通常表示某個(gè)街道地址的 rooftop 地理編碼不可用。
"GEOMETRIC_CENTER" 將結(jié)果限制為某個(gè)位置（如多段線（例如街道）或多邊形（地區(qū)））的幾何中心。
"APPROXIMATE" 將結(jié)果限制為是近似值的地址。

如果 result_type 和 location_type 限制同時(shí)存在，那么該 API 將只返回同時(shí)匹配 result_type 和 location_type 限制的結(jié)果。

經(jīng)緯度反向地理編碼

以下查詢包含了布魯克林某個(gè)位置的緯度/經(jīng)度值：

https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY

注：確保在將緯度和經(jīng)度值傳入 latlng 參數(shù)時(shí)，兩者之間沒有空格。

上述查詢返回以下結(jié)果：

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "277",
               "short_name" : "277",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Bedford Avenue",
               "short_name" : "Bedford Ave",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Williamsburg",
               "short_name" : "Williamsburg",
               "types" : [ "neighborhood", "political" ]
            },
            {
               "long_name" : "Brooklyn",
               "short_name" : "Brooklyn",
               "types" : [ "sublocality", "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" ]
            }
         ],
         "formatted_address" : "277 Bedford Avenue, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.714232,
               "lng" : -73.9612889
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.7155809802915,
                  "lng" : -73.9599399197085
               },
               "southwest" : {
                  "lat" : 40.7128830197085,
                  "lng" : -73.96263788029151
               }
            }
         },
         "place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
         "types" : [ "street_address" ]
      },

  ... Additional results[] ...

請(qǐng)注意，反向地理編碼器返回了多個(gè)結(jié)果。"formatted_address" 的結(jié)果不僅有郵政地址，還包括對(duì)某個(gè)位置的任何地理命名方式。例如，對(duì)芝加哥市的某個(gè)點(diǎn)進(jìn)行地理編碼時(shí)，地理編碼的點(diǎn)可以表示為街道地址、城市（芝加哥）、所在州（伊利諾伊州）或國(guó)家/地區(qū)（美國(guó)）。所有這些都是地理編碼器的“地址”。反向地理編碼器返回這些類型中的任何一種作為有效結(jié)果。

反向地理編碼器會(huì)匹配政治實(shí)體（國(guó)家/地區(qū)、省、市和街區(qū)）、街道地址及郵政編碼。

由以前的查詢返回的 formatted_address 值的完整列表如下所示。

"formatted_address" : "277 Bedford Avenue, Brooklyn, NY 11211, USA",
"formatted_address" : "Grand St/Bedford Av, Brooklyn, NY 11211, USA",
"formatted_address" : "Grand St/Bedford Av, Brooklyn, NY 11249, USA",
"formatted_address" : "Bedford Av/Grand St, Brooklyn, NY 11211, USA",
"formatted_address" : "Brooklyn, NY 11211, USA",
"formatted_address" : "Williamsburg, Brooklyn, NY, USA",
"formatted_address" : "Brooklyn, NY, USA",
"formatted_address" : "New York, NY, USA",
"formatted_address" : "New York, USA",
"formatted_address" : "United States",

通常，返回的地址按精確度從最具體到最不具體的順序排列；正如本例中所示，最準(zhǔn)確的地址在結(jié)果中擺在最突出的位置。請(qǐng)注意，我們會(huì)返回不同類型的地址，從最具體的街道地址到不那么具體的政治實(shí)體，如街區(qū)、市、縣、州等。

地點(diǎn) ID 的反向地理編碼

以下查詢包含了布魯克林某個(gè)位置的地點(diǎn) ID：

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJd8BlQ2BZwokRAFUEcm_qrcA&key=YOUR_API_KEY

接口返回值就不多羅列了，都差不多。

受類型限制的反向地理編碼

以下示例將返回的地址限制為位置類型是 ROOFTOP 且地址類型是 street_address 的地址。

https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&location_type=ROOFTOP&result_type=street_address&key=YOUR_API_KEY

反向地理編碼響應(yīng)

反向地理編碼響應(yīng)的格式與地理編碼響應(yīng)相同。請(qǐng)參閱地理編碼響應(yīng)。下面是反向地理編碼響應(yīng)中可能出現(xiàn)的狀態(tài)代碼。
地理編碼響應(yīng)對(duì)象中的 "status" 字段包含了請(qǐng)求的狀態(tài)，還可能包含調(diào)試信息，以幫助您查明反向地理編碼不工作的原因。"status" 字段可以包含以下值：

"OK" 表示未出現(xiàn)任何錯(cuò)誤，并且至少返回了一個(gè)地址。
"ZERO_RESULTS" 表示反向地理編碼成功，但未返回任何結(jié)果。如果向地理編碼器傳遞了某個(gè)偏遠(yuǎn)位置的 latlng 參數(shù)，就可能會(huì)發(fā)生這種情況。
"OVER_QUERY_LIMIT" 表示您已超出配額。
"REQUEST_DENIED" 表示系統(tǒng)已拒絕該請(qǐng)求。這可能是因?yàn)樵撜?qǐng)求包含了 result_type 或 location_type 參數(shù)，但未包含 API 密鑰或客戶端 ID。
"INVALID_REQUEST" 通常表示下列情況之一：
缺少查詢（address、components 或 latlng）。
提供的 result_type 或 location_type 無(wú)效。
"UNKNOWN_ERROR" 表示由于服務(wù)器發(fā)生錯(cuò)誤，因此無(wú)法處理該請(qǐng)求。如果您重試一次，請(qǐng)求可能會(huì)成功

sensor 參數(shù)

Google Maps API 之前要求您將 sensor 參數(shù)包括在內(nèi)，以指示您的應(yīng)用是否使用傳感器來(lái)確定用戶的位置。但該參數(shù)現(xiàn)在不再是必填項(xiàng)。

GPU云服務(wù)器云服務(wù)器谷歌地圖api 谷歌地圖api接口地圖api api 地圖定位

文章版權(quán)歸作者所有，未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請(qǐng)注明本文地址：http://systransis.cn/yun/90891.html

發(fā)表評(píng)論

登陸后可評(píng)論

0條評(píng)論

rose

男|高級(jí)講師

我要關(guān)注我要私信

TA的文章

多個(gè)新頂級(jí)域名被爆交易，CO.link以10000美元易主！

閱讀 2231·2021-11-22 11:56
女程序員的逆襲

閱讀 2669·2021-10-08 10:05
最大主機(jī)地址怎么算-主機(jī)地址數(shù)如何計(jì)算？

閱讀 7896·2021-09-22 15:53
什么是云虛擬主機(jī)-云虛擬主機(jī)有什么優(yōu)勢(shì)嗎？

閱讀 1945·2021-09-22 15:29
??【軟件測(cè)試】關(guān)于軟件測(cè)試的5個(gè)誤傳??

閱讀 2263·2021-09-08 09:35
TOB主題2.7版本更新：重做文章主列表、新增菜單圖標(biāo)支持、面包屑、彩色標(biāo)簽、縮略圖圓角

閱讀 3398·2021-09-07 10:12
CSS3 animation 基礎(chǔ)

閱讀 1406·2019-08-30 13:11
使用wireshark進(jìn)行數(shù)據(jù)鏈接層的抓包分析——流量分析（一）

閱讀 2009·2019-08-28 17:54

成人国产在线小视频_日韩寡妇人妻调教在线播放_色成人www永久在线观看_2018国产精品久久_亚洲欧美高清在线30p_亚洲少妇综合一区_黄色在线播放国产_亚洲另类技巧小说校园_国产主播xx日韩_a级毛片在线免费

資訊專欄INFORMATION COLUMN

上云采購(gòu)季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺(tái)、長(zhǎng)期優(yōu)惠，快來(lái)選購(gòu)！

谷歌地圖 API 開發(fā)之 Geocoding API

相關(guān)文章

**關(guān)于谷歌Google Maps JavaScript API 的學(xué)習(xí)與分享**

**關(guān)于谷歌Google Maps JavaScript API 的學(xué)習(xí)與分享**

發(fā)表評(píng)論

0條評(píng)論

rose

男|高級(jí)講師

TA的文章

多個(gè)新頂級(jí)域名被爆交易，CO.link以10000美元易主！

女程序員的逆襲

最大主機(jī)地址怎么算-主機(jī)地址數(shù)如何計(jì)算？

什么是云虛擬主機(jī)-云虛擬主機(jī)有什么優(yōu)勢(shì)嗎？

??【軟件測(cè)試】關(guān)于軟件測(cè)試的5個(gè)誤傳??

TOB主題2.7版本更新：重做文章主列表、新增菜單圖標(biāo)支持、面包屑、彩色標(biāo)簽、縮略圖圓角

CSS3 animation 基礎(chǔ)

使用wireshark進(jìn)行數(shù)據(jù)鏈接層的抓包分析——流量分析（一）

最新活動(dòng)

資訊專欄INFORMATION COLUMN

上云采購(gòu)季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺(tái)、長(zhǎng)期優(yōu)惠，快來(lái)選購(gòu)！

谷歌地圖 API 開發(fā)之 Geocoding API

相關(guān)文章

發(fā)表評(píng)論

0條評(píng)論

男|高級(jí)講師

TA的文章

最新活動(dòng)

上云采購(gòu)季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺(tái)、長(zhǎng)期優(yōu)惠，快來(lái)選購(gòu)！