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

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

Введение

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

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

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

В таблице ниже показаны изменения в новом объекте Place в ответе на запросы Place Details (New), Nearby Search (New) и Text Search (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-ответ (код ответа и сообщение)
сообщения об ошибках; error_message Перенесено в стандартный HTTP-ответ (код ответа и сообщение)
Любые информационные сообщения info_messages Удалено
Токен страницы next_page_token Удалено

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

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

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

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

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

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