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