Geocoding API は、住所のジオコーディングとリバース ジオコーディングを提供するサービスです。
ジオコーディングとは、住所（番地など）を地理座標（緯度や経度など）に変換する処理のことをいいます。地理座標を使用して、マーカーを配置したり地図の位置決めを行ったりできます。
リバース ジオコーディングとは、地理座標を人が読める住所に変換するプロセスです。
Geocoding API を使用して、特定のプレイス ID の住所を探すこともできます。
リクエストとレスポンスの例
Geocoding API には HTTP インターフェースを介してアクセスします。以下に、ジオコーディング リクエストとリバース ジオコーディング リクエストの例を示します。
ジオコーディングのリクエストとレスポンス（緯度と経度の検索）
次の例では、「1600 Amphitheatre Parkway, Mountain View, CA」の緯度と経度をリクエストし、出力を JSON 形式にすることを指定しています。
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
ウェブブラウザに URL を入力してテストできます（YOUR_API_KEY は実際の API キーに置き換えてください）。レスポンスには、その住所の緯度と経度が含まれます。
ジオコーディング リクエスト URL の作成、使用可能なパラメータ、 レスポンスの理解の詳細については、デベロッパー ガイドをご覧ください。
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この URL をウェブブラウザに入力してテストできます（「YOUR_API_KEY」は実際の API キーに置き換えてください）。レスポンスには、緯度と経度の位置情報の人間が判読可能な住所が含まれます。
リバース ジオコーディング リクエスト URL の作成、使用可能なパラメータ、 レスポンスの理解の詳細については、デベロッパー ガイドをご覧ください。
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 マップ ウェブサービス API での開発が容易になります。Geocoding API は、Google マップサービス向け Java クライアント、Python クライアント、Go クライアント、Node.js クライアントで使用できます。
認証、割り当て、料金、ポリシー
認証
Geocoding API を使用するには、まず API を有効にして、適切な認証情報を取得する必要があります。詳しくは、Google Maps Platform スタートガイドをご覧ください。
割り当てと料金
Geocoding API に設定されている割り当てと料金の詳細については、使用量と請求額のページをご覧ください。
ポリシー
Geocoding API を使用する際は、API ポリシーに従う必要があります。
その他の情報
Geocoding API には他にも多くの機能があります。その他のデモ、例、使用可能なパラメータ、ステータス コード、エラー メッセージなどの詳細については、 Geocoding API デベロッパー ガイドをご覧ください。
Geocoding API デベロッパー ガイドでは、Geocoding API ウェブサービスについて説明しています。これは、Google Maps Platform API のいずれかによって提供される地図内でジオコーディング データを使用したいウェブサイト デベロッパーとモバイル デベロッパーを対象としています。