Формат ответа для новых API-интерфейсов Place Details , Nearby Search и Text Search изменился по сравнению с форматом существующих API. Основное различие заключается в формате объекта Place
, возвращаемого каждым методом, как описано в разделе «Изменения объекта Place ответа» .
Кроме того, для каждого API изменились поля верхнего уровня объекта ответа. Видеть:
- Изменения ответа текстового поиска
- Изменения в ответе Поиска поблизости
- Изменения в ответе на информацию о месте
Изменения в ответе Разместить объект
В этой таблице показаны изменения нового объекта Place
в ответе на запросы «Сведения о месте» (новое), «Поиск поблизости» (новое) и «Текстовый поиск (новое)» по сравнению с существующим объектом Place
.
Новый объект ответа использует верблюжий регистр для имен полей, содержит новые поля и переименовывает некоторые из существующих полей.
Поле | Существующий объект Place | Объект «Новое место» | Примечания |
---|---|---|---|
Адресный компонент | 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 | 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 | Удаленный |
Изменения в ответе на информацию о месте
В следующей таблице показаны изменения в полях верхнего уровня объекта ответа для существующих сведений о месте и объекта ответа для сведений о месте (новое). Для нового API единственным полем верхнего уровня в ответе является массив places
.
Поле | Детали места (существующие) | Детали места (новое) | Примечания |
---|---|---|---|
Место атрибуции | html_attributions | Перемещено в новый объект Place в качестве attributions | |
Детали места | result , содержащий существующий объект Place | Новый объект Place | |
Статус запроса | status | Перемещен к стандартному HTTP-ответу (код ответа HTTP и сообщение). | |
Любые информационные сообщения | info_messages | Перемещен к стандартному HTTP-ответу (код ответа HTTP и сообщение). |