Введение
API Places поддерживает Place Details (Legacy) . Если вы знакомы с Places API (Legacy), то в Place Details (New) внесены следующие изменения:
- Требуется маскирование полей. Необходимо указать, какие поля вы хотите получить в ответе. По умолчанию список возвращаемых полей отсутствует. Если вы опустите этот список, методы вернут ошибку. Для получения дополнительной информации см. FieldMask .
- Функция «Подробная информация о месте» (новая функция) поддерживает как ключи API , так и токены OAuth в качестве механизма аутентификации.
- В разделе «Подробная информация о месте» (новая функция) в качестве формата ответа поддерживается только JSON.
- Формат JSON-ответа для Places 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'
В функции «Подробная информация о месте» (новая функция) вы отправляете 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 ответа.