Geocoding API v4 には、2 つの主要な機能ファミリーが用意されています。1 つは、豊富な地域密着型の属性を検索する目的地検索、もう 1 つは、基本的なジオコーディング（座標と住所の変換）です。どの方法を使用すればよいかわからない場合は、ジオコーディング方法を選択するをご覧ください。
- 目的地の検索（
SearchDestinations）: 目的地の詳細な到着情報（建物の入り口、ルート設定可能なナビゲーション ポイント、建物や敷地の輪郭、サブ目的地、近くのランドマークなど）を取得します。 - ジオコーディング（
GeocodeAddress）: 番地を緯度と経度の座標に変換して、基本的なマーカーを配置したり、地図の中心に設定したりします。 - リバース ジオコーディング（
GeocodeLocation）: 地理座標を人が読める番地に変換します。 - プレイス ジオコーディング（
GeocodePlace）: 既知のプレイス ID のフォーマット済み住所と座標を検索します。
リクエストとレスポンスのサンプル
Geocoding API には HTTP インターフェースを介してアクセスします。以下に、目的地の検索、フォワード ジオコーディング、リバース ジオコーディングのクイックスタートの例を示します。
目的地の検索リクエストとレスポンス（地域ごとの到着データ）
次の例では、「1600 Amphitheatre Parkway, Mountain View, CA」の HTTP POST リクエストを SearchDestinations に送信します。SearchDestinations には、返すフィールドを指定する X-Goog-FieldMask ヘッダーが必要です。
curl -X POST -d '{ "addressQuery": { "addressQuery": "1600 Amphitheatre Parkway, Mountain View, CA" } }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-FieldMask: destinations.primary.displayName,destinations.primary.formattedAddress,destinations.primary.location,destinations.primary.displayPolygon,destinations.entrances,destinations.navigationPoints,destinations.landmarks' \ -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4/geocode/destinations"
以下は、建物のフットプリント ポリゴン、優先エントランス、ルート設定可能なナビゲーション ポイント、近くのランドマークを示す SearchDestinations レスポンスの例です。
{ "destinations": [ { "primary": { "displayName": { "text": "Googleplex", "languageCode": "en" }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "location": { "latitude": 37.4220656, "longitude": -122.0840897 }, "displayPolygon": { "type": "Polygon", "coordinates": [ [ [-122.084958, 37.422145], [-122.084112, 37.422610], [-122.083510, 37.421980], [-122.084958, 37.422145] ] ] } }, "entrances": [ { "location": { "latitude": 37.422189, "longitude": -122.084215 }, "tags": ["PREFERRED"] } ], "navigationPoints": [ { "navigationPointToken": "Eg...", "displayName": { "text": "Amphitheatre Pkwy Dropoff", "languageCode": "en" }, "location": { "latitude": 37.421912, "longitude": -122.084301 }, "travelModes": ["DRIVE"], "usages": ["DROPOFF", "PICKUP"] } ], "landmarks": [ { "place": { "displayName": { "text": "Charleston Park", "languageCode": "en" } }, "relationalDescription": { "text": "Adjacent to Charleston Park", "languageCode": "en" }, "straightLineDistanceMeters": 85.4 } ] } ] }
ジオコーディングのリクエストとレスポンス（緯度と経度の検索）
次の例では、「1600 Amphitheatre Parkway, Mountain View, CA」の緯度と経度をリクエストし、出力形式を JSON に指定しています。
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
これをテストするには、ウェブブラウザに URL を入力します（YOUR_API_KEY は実際の API キーに置き換えてください）。レスポンスには、その住所の緯度と経度が含まれます。
ジオコーディング リクエスト URL の作成、使用可能なパラメータ、 レスポンスの解釈について詳しくは、デベロッパー ガイドをご覧ください。
JSON 形式のジオコーディングのレスポンス例を次に示します。
{ "results": [ { "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ", "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ", "location": { "latitude": 37.4438238, "longitude": -122.0869895 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4424748197085, "longitude": -122.0883384802915 }, "high": { "latitude": 37.445172780291493, "longitude": -122.08564051970852 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043-1351", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] }, { "longText": "1351", "shortText": "1351", "types": [ "postal_code_suffix" ] } ], "types": [ "premise", "street_address" ] } ] }
リバース ジオコーディングのリクエストとレスポンス（住所の検索）
次の例では、米国ニューヨーク州ブルックリンの特定の緯度 / 経度に対応する住所をリクエストしています。このリクエストでは、出力が JSON 形式になるように指定しています。
https://geocode.googleapis.com/v4/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEYこの URL をウェブブラウザに入力してテストできます（「YOUR_API_KEY」は実際の API キーに置き換えてください）。 レスポンスには、緯度と経度の位置に対応する、人が読める形式の住所が含まれます。
リバース ジオコーディング リクエスト URL の作成、使用可能なパラメータ、 レスポンスの解釈について詳しくは、デベロッパー ガイドをご覧ください。
JSON 形式のリバース ジオコーディングのレスポンス例を次に示します。
{ "results": [ { "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "location": { "latitude": 37.4225657, "longitude": -122.08465439999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.421214719708509, "longitude": -122.08603273029148 }, "high": { "latitude": 37.423912680291508, "longitude": -122.0833347697085 } }, "bounds": { "low": { "latitude": 37.4225178, "longitude": -122.08484599999998 }, "high": { "latitude": 37.422609600000008, "longitude": -122.0845215 } }, "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "Google Building 40", "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "Google Building 40", "shortText": "Google Building 40", "types": [ "premise" ], "languageCode": "en" }, { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] } ], "types": [ "street_address", "subpremise" ] }, ... Additional results truncated in this example[] ... }
認証、割り当て、料金、ポリシー
認証
Geocoding API を使用するには、まず API を有効にして、適切な認証情報を取得する必要があります。詳しくは、Google Maps Platform を使ってみるをご覧ください。
割り当てと料金
Geocoding API に設定されている割り当てと料金の詳細については、使用量と請求額のページをご覧ください。
ポリシー
Geocoding API は、API ポリシーに従って使用する必要があります。