API Places поддерживает существующие сведения о месте . Если вы знакомы с существующим API-интерфейсом Places, новая версия Place Details вносит следующие изменения:
- Требуется маскировка полей. Вы должны указать, какие поля вы хотите вернуть в ответе. Не существует списка возвращаемых полей по умолчанию. Если вы опустите этот список, методы вернут ошибку. Для получения дополнительной информации см. FieldMask .
- Новые сведения о месте поддерживают как ключи API , так и токены OAuth в качестве механизма аутентификации.
- В новой информации о месте в качестве формата ответа поддерживается только JSON.
- Формат ответа JSON для API сведений о месте (новый) изменился по сравнению с форматом существующих API. Дополнительные сведения см. в разделе Миграция ответа Places API .
В следующей таблице перечислены параметры существующих сведений о месте, которые были переименованы или изменены для новых сведений о месте, а также параметры, которые больше не поддерживаются.
| Текущий параметр | Новый параметр | Примечания |
|---|---|---|
place_id | places/ PLACE_ID | Строка places/ PLACE_ID также называется именем ресурса места. В ответе на запрос сведений о месте (новое), поиска поблизости (новое) и текстового поиска (новое) эта строка содержится в поле name ответа. Идентификатор отдельного места содержится в поле id ответа. |
language | languageCode | |
region | regionCode |
Пример запроса
В следующем примере запроса GET используются существующие сведения о месте. В этом примере вы запрашиваете ответ 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 также называется именем ресурса места. В ответе на запрос сведений о месте (новое), поиска поблизости (новое) и текстового поиска (новое) эта строка содержится в поле name ответа. Идентификатор отдельного места содержится в поле id ответа.