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 フィールド。