Как перенести ответ Places API (прежней версии)

Разработчики из Европейской экономической зоны (ЕЭЗ)

Введение

Формат ответа для API информация о местах (новое), поиск поблизости (новое) и текстовый поиск (новое) отличается от формата ответа для устаревших версий API. Основное отличие заключается в формате объекта Place, возвращаемого каждым методом, как описано в разделе Изменения в объекте места.

Кроме того, для каждого API изменились поля верхнего уровня объекта ответа. См. также:

Изменения в объекте места в ответе

В таблице ниже показаны изменения в новом объекте Place в ответах на запросы информация о местах (New), поиск поблизости (New) и текстовый поиск (New) по сравнению с устаревшим объектом Place.

В новом объекте ответа названия полей написаны в верблюжьем регистре, добавлены новые поля и переименованы некоторые устаревшие поля.

Поле Объект Places API (прежней версии) Объект Places API (новый) Примечания
Компонент адреса address_components addressComponents
Микроформат адреса места adr_address adrFormatAddress
Юридическое лицо business_status businessStatus
Часы работы на следующей неделе current_opening_hours currentOpeningHours
Сводные данные editorial_summary editorialSummary
Форматированный адрес formatted_address formattedAddress
Национальный номер телефона formatted_phone_number nationalPhoneNumber
Местоположение geometry.location location
Область просмотра geometry.viewport viewport
Атрибуция мест html_attributions attributions Поле верхнего уровня в ответе устаревших API
URL значка icon Удалено. В таком случае используйте элементы iconMaskBaseUri и iconBackgroundColor. Подробнее о значках мест…
Icon background color (Цвет фона значка) icon_background_color iconBackgroundColor
URL маски значка icon_mask_base_uri iconMaskBaseUri
Номер телефона в международном формате international_phone_number internationalPhoneNumber
Название места в виде текста name displayName Название места теперь доступно как displayName.text, а language – как displayName.languageCode.
Часы работы opening_hours regularOpeningHours
Фото photos photos Формат photos изменился в новом объекте Place. Подробнее об изменении ссылок на фотографии…
Идентификатор места place_id id
Код Plus Code plus_code plusCode
Уровень цен price_level priceLevel
Оценка rating rating
Отзывы reviews reviews
Дополнительные часы работы на следующую неделю, начиная с сегодняшнего дня, с исключениями и всеми остальными данными. secondary_opening_hours currentSecondaryOpeningHours
Типы мест types types
URL места на Google Картах url googleMapsUri
Количество оценок пользователей user_ratings_total userRatingCount
Разница с UTC utc_offset utcOffsetMinutes
Краткая форма адреса, включающая название улицы и город. vicinity shortFormattedAddress
Сайт места website websiteUri
Информация о доступности для инвалидов-колясочников wheelchair_accessible_entrance accessibilityOptions wheelchair_accessible_entrance теперь стоит accessibilityOptions.wheelchairAccessibleEntrance
Атрибуты мест takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood
Название ресурса Поле name в форме places/PLACE_ID В устаревшем API поле name содержало название места в виде текстовой строки. В новом API эта информация находится в displayName.
Основной тип места primaryTypeName Новое
Укажите основной тип в виде текстовой строки. primaryTypeDisplayName Новое
Обычные еженедельные дополнительные часы работы с исключениями и всеми другими данными. regularSecondaryOpeningHours Новое
Способы оплаты, которые принимает заведение paymentOptions Новое
Варианты парковки parkingOptions Новое
Список дополнительных пунктов назначения, связанных с местом subDestinations Новое
Самая свежая информация о видах топлива на заправке fuelOptions Новое
Информация о зарядке электромобилей в определенном месте evChargeOptions Новое
Атрибуты мест outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports Новое

Изменения в ответе на запрос текстового поиска

В таблице ниже показаны изменения в полях верхнего уровня объекта ответа для текстового поиска (Legacy) и объекта ответа для Text Search (New). В новом API единственным полем верхнего уровня в ответе является массив places.

Поле Текстовый поиск (устаревшая версия) Новая версия текстового поиска Примечания
Атрибуция мест html_attributions Перемещено в новый объект Place для каждого места как place.attributions.
Массив мест Массив results устаревшего объекта Place Массив places нового объекта Place
Статус запроса. status Перемещено в стандартный ответ HTTP (код и сообщение ответа HTTP)
Сообщения об ошибках error_message Перемещено в стандартный ответ HTTP (код и сообщение ответа HTTP)
любые информационные сообщения; info_messages Удалено
Токен страницы next_page_token Удалено

Изменения в ответах на запросы поиска поблизости

В таблице ниже показаны изменения в полях верхнего уровня объекта ответа для устаревшей версии поиска поблизости и объекта ответа для новой версии поиска поблизости. В новом API единственное поле верхнего уровня в ответе – это массив places.

Поле Поиск поблизости (устаревшая версия) Поиск поблизости (новая версия) Примечания
Указание авторства для мест html_attributions Перенесено в новый объект Place для каждого места как place.attributions.
Массив мест Массив results устаревшего объекта Place Массив places нового объекта Place
Статус запроса. status Перемещено в стандартный ответ HTTP (код и сообщение ответа HTTP)
Сообщения об ошибках error_message Перемещено в стандартный ответ HTTP (код и сообщение ответа HTTP)
любые информационные сообщения; info_messages Удалено
Токен страницы next_page_token Удалено

Изменения в ответах на запросы информации о местах (новая версия)

В таблице ниже показаны изменения полей верхнего уровня в объекте ответа для информации о местах (устаревшая версия) и объекте ответа для информации о местах (новая версия). В новом API единственное поле верхнего уровня в ответе – это массив places.

Поле Place Details (Legacy) Place Details (New) Примечания
Указание авторства для мест html_attributions Перенесено в новый объект Place как attributions.
Place Details (New) result, содержащий устаревший объект Place Новый объект Place
Статус запроса. status Перенесено в стандартный HTTP-ответ (код ответа и сообщение)
любые информационные сообщения; info_messages Перемещено в стандартный ответ HTTP (код и сообщение ответа HTTP)