場所のジオコーディングのリクエストとレスポンス

このページでは、プレイス ID の住所を取得するためのリクエストとレスポンスについて説明します。

必須パラメータ

  • place_id - 人が読める形式の住所を取得する場所のプレイス ID。プレイス ID は一意の ID です。 他の Google API で使用できる識別子が用意されています。たとえば、Roads API から返される placeID を使用して、スナップ ポイントの住所を取得できます。場所の詳細と、場所に関する ID については、プレイス ID の概要をご覧ください。
  • key - アプリケーションの API キー。このキーは クォータ管理を目的としています。手順 キーを取得します。

省略可能なパラメータは、 リバース ジオコーディング

次の紹介には、「Brooklyn」にあるプレイスのプレイス ID を照会しています。

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

上記の照会を行うと、次の結果が返されます。

{
   "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" : [ "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" : "277 Bedford Ave, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.7142205,
               "lng" : -73.9612903
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.71556948029149,
                  "lng" : -73.95994131970849
               },
               "southwest" : {
                  "lat" : 40.7128715197085,
                  "lng" : -73.9626392802915
               }
            }
         },
         "place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
         "types" : [ "street_address" ]
      }
   ],
   "status" : "OK"
}

レスポンスのフィールドの説明については、以下をご覧ください。 ジオコーディングのレスポンス