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