Place Details への移行（新規）

欧州経済領域（EEA）のデベロッパー

はじめに

Places API は Place Details（Legacy）をサポートしています。Places API（Legacy）をご利用の場合、Place Details（New）では次の変更が行われます。

  • フィールドのマスキングが必要です。レスポンスで返すフィールドを指定する必要があります。返されるフィールドのデフォルトのリストはありません。このリストを省略すると、メソッドはエラーを返します。詳細については、FieldMask をご覧ください。
  • Place Details（新版）では、認証メカニズムとして API キーと OAuth トークンの両方がサポートされています。
  • Place Details（New）では、レスポンス形式として JSON のみがサポートされています。
  • Places API（新版）の JSON レスポンス形式は、以前の API の形式から変更されています。詳しくは、Places API レスポンスを移行するをご覧ください。

次の表に、プレイス詳細（新しい）で名前が変更または修正されたプレイス詳細（以前の）のパラメータ、またはサポートされなくなったパラメータを示します。

現在のパラメータ 新しいパラメータ メモ
place_id places/PLACE_ID 文字列 places/PLACE_ID は、プレイス リソース名とも呼ばれます。Place Details（新版）、Nearby Search（新版）、テキスト検索（新版）のリクエストからのレスポンスでは、この文字列はレスポンスの name フィールドに含まれます。スタンドアロンのプレイス ID は、レスポンスの id フィールドに含まれています。
language languageCode
region regionCode

リクエスト例

次の GET リクエストの例では、Place Details（レガシー）を使用しています。この例では、プレイス ID に関する情報を含む JSON レスポンスをリクエストし、すべてのパラメータを URL パラメータとして渡します。この例では fields も使用しているため、レスポンスには場所の表示名と書式設定された住所のみが含まれます。

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'

Place Details（新版）では、GET リクエストを作成し、リクエストの一部として URL パラメータとヘッダーですべてのパラメータを渡します。この例では、フィールド マスクも使用しているため、レスポンスには場所の表示名と書式設定された住所のみが含まれます。

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,formattedAddress" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

文字列 places/PLACE_ID は、プレイス リソース名とも呼ばれます。Place Details（新版）、Nearby Search（新版）、テキスト検索（新版）のリクエストからのレスポンスでは、この文字列はレスポンスの name フィールドに含まれています。スタンドアロンのプレイス ID は、レスポンスの id フィールドに含まれています。