開始する

Geocoding API は、ジオコーディングとリバース ジオコーディングを提供するサービスです。 使用できます。

<ph type="x-smartling-placeholder">

ジオコーディング: 住所(番地など)を変換するプロセス 地理座標(緯度と経度など)に変換して、マーカーを配置できます。 地図上に配置することができます

リバース ジオコーディングは、地理座標を変換するプロセスです。 変換する必要があります

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 キーに置き換えます)。 レスポンスには、その住所の緯度と経度が含まれます。

デベロッパー ガイドを見る このモジュールで <ph type="x-smartling-placeholder"></ph> ジオコーディング リクエスト 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 キーに置き換えます)。 レスポンスには、人が読める形式の緯度と経度の住所が含まれます。 あります。

デベロッパー ガイドを見る このモジュールで <ph type="x-smartling-placeholder"></ph> リバース ジオコーディングのリクエスト 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 Maps ウェブサービス API を使った開発が簡単になります。たとえば、 認証、リクエスト / レスポンスなどの一般的なタスクのネイティブ実装 スロットリングと自動再試行ですGeocoding API は Google Cloud の の Java クライアント、 Google マップサービス用の Python クライアント、Go クライアント、Node.js クライアントをご覧ください。

認証、割り当て、料金、ポリシー

認証

Geocoding API を使用するには、まず API を有効にする必要があります 適切な認証情報を取得します。詳細については、次をご覧ください: Google Maps Platform の利用を始める

割り当てと料金

使用量と請求額を確認する ページをご覧ください。

ポリシー

Geocoding API の使用は、 API ポリシー

その他の情報

Geocoding API では、他にもさまざまなことができます。詳しくは、 <ph type="x-smartling-placeholder"></ph> Geocoding API デベロッパー ガイド 例、使用可能なパラメータ、ステータス コード、エラー メッセージ、その他の詳細情報。

<ph type="x-smartling-placeholder"></ph> Geocoding API デベロッパー ガイドで、 Geocoding API ウェブサービス。ウェブサイト デベロッパーとモバイル デベロッパーを対象としています。 Google Maps Platform が提供する地図でジオコーディング データを使用したい方 API