はじめに
Places API は Place Details（Legacy）をサポートしています。 Places API（Legacy）に慣れている場合は、Place Details（New） で次の変更が行われます。
- フィールド マスクは必須です。レスポンスで返されるフィールドを指定する必要があります。 返されるフィールドのデフォルト リストはありません。このリストを省略すると、メソッドからエラーが返されます。詳しくは、 FieldMask をご覧ください。
- Place Details（New）では、認証メカニズムとして API キー と OAuth トークンの両方がサポートされています。
- Place Details（New）では、レスポンス形式として JSON のみがサポートされています。
- Places API（New）の JSON レスポンス形式は、従来の API の形式から変更されています。詳しくは、 Places API レスポンスを移行するをご覧ください。
次の表に、Place Details（Legacy）のパラメータのうち、Place Details（New）で名前が変更されたパラメータ、変更されたパラメータ、サポートされなくなったパラメータを示します。
| 現在のパラメータ | 新しいパラメータ | メモ |
|---|---|---|
place_id |
places/PLACE_ID |
文字列 places/PLACE_ID は、場所の
リソース名とも呼ばれます。Place Details（New）、Nearby Search（New）、Text Search（New）のリクエストからのレスポンスでは、この文字列はレスポンスの name フィールドに含まれています。スタンドアロンの場所 ID は、レスポンスの id フィールドに含まれています。 |
language |
languageCode |
|
region |
regionCode |
リクエスト例
次の GET リクエストの例では、Place Details（Legacy）を使用しています。この例では、場所 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（New）では、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（New）、Nearby Search（New）、テキスト検索（New）のリクエストからのレスポンスでは、この文字列はレスポンスの name フィールドに含まれています。スタンドアロンの場所 ID は、レスポンスの id フィールドに含まれています。