Geocoding API 服務提供地理編碼和反向地理編碼 位址。
「地理編碼」是指轉換地址 (例如街道地址) 的程序 轉換成地理座標 (例如經緯度)，您就可以用來放置標記 或設定地圖的位置。
「反向地理編碼」是指進行地理座標的轉換程序 轉換為清楚易懂的地址
您也可以使用 Geocoding API 找出 給定的地點 ID。
要求和回應範例
您可以透過 HTTP 介面存取 Geocoding API。追蹤中 以及地理編碼和反向地理編碼要求的範例。
地理編碼要求和回應 (經緯度查詢)
以下範例會要求經緯度為「1600 Amphitheatre」 Parkway, Mountain View, CA"，並指定輸出格式。
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
您可以在網路瀏覽器中輸入網址來進行測試 (請務必將
以您實際的 API 金鑰執行 YOUR_API_KEY)。
回應會包含地址的經緯度。
查看開發人員指南 深入瞭解 「建立地理編碼要求網址」和 可用參數 和 瞭解回覆內容
以下是使用 JSON 格式的地理編碼回應範例：
{
"results" : [
{
"address_components" : [
{
"long_name" : "1600",
"short_name" : "1600",
"types" : [ "street_number" ]
},
{
"long_name" : "Amphitheatre Parkway",
"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 Pkwy, Mountain View, CA 94043, USA",
"geometry" : {
"location" : {
"lat" : 37.4267861,
"lng" : -122.0806032
},
"location_type" : "ROOFTOP",
"viewport" : {
"northeast" : {
"lat" : 37.4281350802915,
"lng" : -122.0792542197085
},
"southwest" : {
"lat" : 37.4254371197085,
"lng" : -122.0819521802915
}
}
},
"place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE",
"plus_code" : {
"compound_code" : "CWC8+R3 Mountain View, California, United States",
"global_code" : "849VCWC8+R3"
},
"types" : [ "street_address" ]
}
],
"status" : "OK"
}
反向地理編碼要求和回應 (地址查詢)
下方範例會要求與特定經緯度相對應的地址 在美國紐約州布魯克林區它會指定輸出內容必須採用 JSON 格式。
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY
您可以在網路瀏覽器中輸入網址來進行測試 (請務必將 將「YOUR_API_KEY」換成您實際的 API 金鑰)。 回應包含經緯度的人類可讀地址 或 HTTP/HTTPS 位置
查看開發人員指南 深入瞭解 建立反向地理編碼要求網址和 可用參數 和 瞭解回覆內容
以下是反向地理編碼回應的範例 (JSON 格式)：
{
"plus_code" : {
"compound_code" : "P27Q+MC New York, NY, USA",
"global_code" : "87G8P27Q+MC"
},
"results" : [
{
"address_components" : [
{
"long_name" : "279",
"short_name" : "279",
"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" : [ "political", "sublocality", "sublocality_level_1" ]
},
{
"long_name" : "Kings County",
"short_name" : "Kings County",
"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" : "279 Bedford Ave, Brooklyn, NY 11211, USA",
"geometry" : {
"location" : {
"lat" : 40.7142484,
"lng" : -73.9614103
},
"location_type" : "ROOFTOP",
"viewport" : {
"northeast" : {
"lat" : 40.71559738029149,
"lng" : -73.9600613197085
},
"southwest" : {
"lat" : 40.71289941970849,
"lng" : -73.96275928029151
}
}
},
"place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE",
"plus_code" : {
"compound_code" : "P27Q+MC Brooklyn, New York, United States",
"global_code" : "87G8P27Q+MC"
},
"types" : [
"bakery",
"cafe",
"establishment",
"food",
"point_of_interest",
"store"
]
},
... Additional results truncated in this example[] ...
],
"status" : "OK"
}
開始運用 Google 用戶端程式庫編寫程式碼
用戶端程式庫 Google Maps Web 服務 API 提供簡易 常見工作的實作方式，例如驗證、要求 調節和自動重試。Geocoding API 現已可供使用 的 Java 用戶端 Google 地圖服務適用的 Python 用戶端、Go Client 和 Node.js 用戶端。
驗證、配額、定價和政策
驗證
如要使用 Geocoding API，您必須先啟用 API 並取得適當的驗證憑證若需更多資訊，請參閲 開始使用 Google 地圖平台。
配額與定價
查看用量和帳單 頁面，詳細瞭解 Geocoding API 的配額與計費方式。
政策
使用 Geocoding API 時必須遵循 API 政策。
瞭解詳情
Geocoding API 還有更多功能等您發掘。詳情請參閱 Geocoding API 開發人員指南的其他示範。 範例、可用參數、狀態碼和錯誤訊息等等。
Geocoding API 開發人員指南說明瞭 Geocoding API 網路服務。適用於網站和行動開發人員 想在 Google 地圖平台提供的地圖中使用地理編碼資料 相互整合