Place Details への移行(新規)

Places API は既存の Place Details。 既存の Places API を使い慣れている場合は、 新バージョンの Place Details 次の変更を行います。

  • フィールド マスキングは必須です。返されるフィールドを指定する必要があります。 返されます。返されるフィールドのデフォルト リストはありません。省略した場合 メソッドはエラーを返します。詳細については、次をご覧ください: FieldMask
  • 新しい Place Details は、 API キー および OAuth 使用することをおすすめします。
  • 新しい API では、レスポンス形式として JSON のみがサポートされています。 Place Details。
  • Place Details(新版)の JSON レスポンス形式 API が既存の API の形式から変更されました。詳しくは、 Places API のレスポンスを移行します。

次の表に、既存の 名前が変更された、または変更された Place Details 新しい Place Details、またはパラメータで サポートされません。

現在のパラメータ 新しいパラメータ メモ
place_id places/PLACE_ID 文字列 places/PLACE_ID は、 リソース名を配置します。Place Details(New)からのレスポンスで、 Nearby Search(新版)、テキスト検索(新版) この文字列はレスポンスの name フィールドに格納されます。 単独のプレイス ID はレスポンスの id フィールドに含まれます。
language languageCode
region regionCode

リクエスト例

次の GET リクエストの例では、既存の Place Details。この例では、Cloud Storage バケットの プレイス ID に関する情報を含むレスポンスを返し、すべてのパラメータを 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 フィールド。