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