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