Введение
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
The string places/ PLACE_ID is also called the place resource name . In the response from a Place Details (New), Nearby Search (New), and Text Search (New) request, this string is contained in the name field of the response. The standalone place ID is contained in the id field of the response.