Формат ответа для новых 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 и сообщение). |