Перенос ответа API Адресов

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

Введение

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

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

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

В этой таблице показаны изменения в новом объекте Place в ответах на запросы «Подробная информация о месте» (новое), «Поиск поблизости» (новое) и «Текстовый поиск» (новое) по сравнению с устаревшим объектом 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 iconBackgroundColor
URL маски значка icon_mask_base_uri iconMaskBaseUri
Международный номер телефона international_phone_number internationalPhoneNumber
Текст названия места name displayName Теперь название текстового места доступно как displayName.text , а language — как displayName.languageCode
Часы работы opening_hours regularOpeningHours
Фотографии photos photos В новом объекте Place изменился формат photos . Дополнительную информацию см. в разделе «Изменение формата на ссылки на фотографии» .
Идентификатор места place_id id
Плюс код plus_code plusCode
Уровень цен price_level priceLevel
Рейтинг rating rating
Отзывы reviews reviews
Дополнительные часы работы на следующей неделе, начиная с сегодняшнего дня, с учетом исключений и всех остальных данных. secondary_opening_hours currentSecondaryOpeningHours
Типы мест types types
URL-адрес места на Google Maps 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 Новый

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

В следующей таблице показаны изменения в полях верхнего уровня объекта ответа для текстового поиска (устаревшая версия) и объекта ответа для текстового поиска (новая версия). Для нового 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 Удаленный

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

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

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