- Ресурс: Место
- ЛокализованныйТекст
- ПочтовыйАдрес
- АдресКомпонент
- PlusCode
- Широта и долгота
- Видовой порт
- Обзор
- АвторАтрибуция
- Часы работы
- Период
- Точка
- Дата
- ВторичныйТипЧасов
- СпециальныйДень
- Часовой пояс
- Фото
- BusinessStatus
- ЦенаУровень
- Атрибуция
- Варианты оплаты
- Варианты парковки
- Подпункт назначения
- ДоступностьПараметры
- FuelOptions
- Цена топлива
- Тип топлива
- Деньги
- EVChargeOptions
- Агрегация коннектора
- EVConnectorType
- ГенеративныйРезюме
- СодержащееМесто
- АдресДескриптор
- Достопримечательность
- ПространственныеОтношения
- Область
- Сдерживание
- GoogleMapsСсылки
- Диапазон цен
- ОбзорРезюме
- EvChargeAmenityРезюме
- ContentBlock
- NeighborhoodSummary
- Методы
Ресурс: Место
Вся информация, представляющая Место.
JSON-представление |
---|
{ "name": string, "id": string, "displayName": { object ( |
Поля | |
---|---|
name | Имя ресурса этого места в формате |
id | Уникальный идентификатор места. |
displayName | Локализованное название места, подходящее в качестве краткого описания, понятного человеку. Например, «Google Sydney», «Starbucks», «Pyrmont» и т. д. |
types[] | Набор тегов типа для этого результата. Например, "политический" и "местность". Полный список возможных значений см. в таблице A и таблице B по адресу https://developers.google.com/maps/documentation/places/web-service/place-types |
primaryType | Основной тип данного результата. Этот тип должен быть одним из поддерживаемых API Places типов. Например, "ресторан", "кафе", "аэропорт" и т. д. Место может иметь только один основной тип. Полный список возможных значений см. в таблице A и таблице B по адресу https://developers.google.com/maps/documentation/places/web-service/place-types |
primaryTypeDisplayName | Отображаемое имя основного типа, локализованное на языке запроса, если применимо. Полный список возможных значений см. в таблицах A и B по адресу https://developers.google.com/maps/documentation/places/web-service/place-types |
nationalPhoneNumber | Удобочитаемый номер телефона этого места в национальном формате. |
internationalPhoneNumber | Удобочитаемый номер телефона этого места в международном формате. |
formattedAddress | Полный, понятный человеку адрес этого места. |
shortFormattedAddress | Короткий, понятный человеку адрес этого места. |
postalAddress | Адрес в формате почтового адреса. |
addressComponents[] | Повторяющиеся компоненты для каждого уровня населенного пункта. Обратите внимание на следующие факты о массиве addressComponents[]: - Массив компонентов адреса может содержать больше компонентов, чем formattedAddress. - Массив не обязательно включает все политические образования, содержащие адрес, за исключением тех, которые включены в formattedAddress. Чтобы получить все политические образования, содержащие определенный адрес, следует использовать обратное геокодирование, передавая широту/долготу адреса в качестве параметра запроса. - Формат ответа не гарантирует, что останется неизменным между запросами. В частности, количество addressComponents зависит от запрошенного адреса и может меняться со временем для одного и того же адреса. Компонент может изменить положение в массиве. Тип компонента может измениться. Определенный компонент может отсутствовать в более позднем ответе. |
plusCode | Плюс код местоположения места широта/долгота. |
location | Положение этого места. |
viewport | Область просмотра, подходящая для отображения места на карте среднего размера. Эта область просмотра не должна использоваться в качестве физической границы или зоны обслуживания бизнеса. |
rating | Рейтинг от 1,0 до 5,0, основанный на отзывах пользователей об этом месте. |
googleMapsUri | URL-адрес, предоставляющий дополнительную информацию об этом месте. |
websiteUri | Авторитетный веб-сайт для этого места, например, домашняя страница компании. Обратите внимание, что для мест, которые являются частью сети (например, магазин IKEA), это обычно будет веб-сайт отдельного магазина, а не всей сети. |
reviews[] | Список отзывов об этом месте, отсортированный по релевантности. Можно вернуть максимум 5 отзывов. |
regularOpeningHours | Обычные часы работы. Обратите внимание, что если место всегда открыто (24 часа), поле |
timeZone | Часовой пояс базы данных часовых поясов IANA. Например, "America/New_York". |
photos[] | Информация (включая ссылки) о фотографиях этого места. Максимально можно вернуть 10 фотографий. |
adrFormatAddress | Адрес места в микроформате adr: http://microformats.org/wiki/adr . |
businessStatus | Бизнес-статус места. |
priceLevel | Уровень цен в этом месте. |
attributions[] | Набор поставщиков данных, которые должны быть показаны вместе с этим результатом. |
iconMaskBaseUri | Усеченный URL-адрес маски значка. Пользователь может получить доступ к другому типу значка, добавив суффикс типа в конец (например, ".svg" или ".png"). |
iconBackgroundColor | Цвет фона для icon_mask в шестнадцатеричном формате, например #909CE1. |
currentOpeningHours | Часы работы на следующие семь дней (включая сегодняшний). Период времени начинается в полночь в день запроса и заканчивается в 23:59 через шесть дней. Это поле включает подполе specialDays всех часов, установленных для дат с исключительными часами. |
currentSecondaryOpeningHours[] | Содержит массив записей на следующие семь дней, включая информацию о дополнительных часах работы предприятия. Дополнительные часы отличаются от основных часов работы предприятия. Например, ресторан может указать часы работы с выездом на место или часы работы с доставкой в качестве дополнительных часов. Это поле заполняет подполе типа, которое берется из предопределенного списка типов часов работы (например, DRIVE_THROUGH, PICKUP или TAKEOUT) на основе типов места. Это поле включает подполе specialDays всех часов, установленных для дат с исключительными часами. |
regularSecondaryOpeningHours[] | Содержит массив записей для информации о регулярных дополнительных часах работы предприятия. Дополнительные часы отличаются от основных часов работы предприятия. Например, ресторан может указать часы работы с выездом или часы доставки в качестве дополнительных часов. Это поле заполняет подполе типа, которое берется из предопределенного списка типов часов работы (например, DRIVE_THROUGH, PICKUP или TAKEOUT) на основе типов места. |
editorialSummary | Содержит краткое изложение места. Краткое изложение состоит из текстового обзора, а также включает код языка для них, если применимо. Текст краткого изложения должен быть представлен как есть и не может быть изменен или изменен. |
paymentOptions | Варианты оплаты, которые принимает место. Если данные о варианте оплаты недоступны, поле варианта оплаты будет не заполнено. |
parkingOptions | На территории предусмотрены варианты парковки. |
subDestinations[] | Список дополнительных пунктов назначения, связанных с данным местом. |
fuelOptions | Самая последняя информация о вариантах топлива на АЗС. Эта информация регулярно обновляется. |
evChargeOptions | Информация о вариантах зарядки электромобилей. |
generativeSummary | Сводка места, созданная искусственным интеллектом. |
containingPlaces[] | Список мест, в которых находится текущее место. |
addressDescriptor | Описатель адреса места. Описатели адреса включают дополнительную информацию, которая помогает описать местоположение с использованием ориентиров и областей. Смотрите региональное покрытие дескриптора адреса в https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage . |
googleMapsLinks | Ссылки для запуска различных действий в Картах Google. |
priceRange | Диапазон цен, связанный с местом. |
reviewSummary | Сводка о месте, созданная искусственным интеллектом на основе отзывов пользователей. |
evChargeAmenitySummary | Обзор удобств возле станции зарядки электромобилей. |
neighborhoodSummary | Краткое описание интересных мест поблизости. |
utcOffsetMinutes | Количество минут, на которое часовой пояс этого места в настоящее время смещен относительно UTC. Это выражается в минутах для поддержки часовых поясов, которые смещены на доли часа, например X часов и 15 минут. |
userRatingCount | Общее количество отзывов (с текстом или без) для этого места. |
takeout | Указывает, поддерживает ли предприятие услугу доставки еды на вынос. |
delivery | Указывает, поддерживает ли компания доставку. |
dineIn | Указывает, предлагает ли предприятие возможность размещения посетителей в помещении или на открытом воздухе. |
curbsidePickup | Указывает, поддерживает ли компания возможность самовывоза. |
reservable | Указывает, поддерживает ли место бронирование. |
servesBreakfast | Указывает, подают ли в заведении завтрак. |
servesLunch | Указывает, подают ли в заведении обед. |
servesDinner | Указывает, подают ли в заведении ужин. |
servesBeer | Указывает, подают ли в заведении пиво. |
servesWine | Указывает, подают ли в заведении вино. |
servesBrunch | Указывает, подают ли в заведении бранч. |
servesVegetarianFood | Указывает, подают ли в заведении вегетарианскую еду. |
outdoorSeating | Место располагает местами для сидения на открытом воздухе. |
liveMusic | Здесь играет живая музыка. |
menuForChildren | В заведении есть детское меню. |
servesCocktails | Здесь подают коктейли. |
servesDessert | Здесь подают десерт. |
servesCoffee | Здесь подают кофе. |
goodForChildren | Место хорошо подходит для детей. |
allowsDogs | Место допускает собак. |
restroom | В этом месте есть туалет. |
goodForGroups | Место рассчитано на группы. |
goodForWatchingSports | Место подходит для просмотра спортивных состязаний. |
accessibilityOptions | Информация о возможностях обеспечения доступности, которые предлагает то или иное место. |
pureServiceAreaBusiness | Указывает, является ли место предприятием, работающим только в сфере обслуживания. Предприятие, работающее только в сфере обслуживания, — это предприятие, которое посещает клиентов или доставляет им товары напрямую, но не обслуживает клиентов по адресу их деятельности. Например, предприятия, занимающиеся клининговыми услугами или сантехникой. У таких предприятий может не быть физического адреса или местоположения на Картах Google. |
ЛокализованныйТекст
Локализованный вариант текста на определенном языке.
JSON-представление |
---|
{ "text": string, "languageCode": string } |
Поля | |
---|---|
text | Локализованная строка на языке, соответствующем |
languageCode | Код языка текста BCP-47, например «en-US» или «sr-Latn». Более подробную информацию можно найти на сайте http://www.unicode.org/reports/tr35/#Unicode_locale_identifier . |
ПочтовыйАдрес
Представляет почтовый адрес (например, для адресов почтовой доставки или платежей). При наличии почтового адреса почтовая служба может доставлять товары на территорию, в почтовый ящик или т. п. Он не предназначен для моделирования географических местоположений (дорог, городов, гор).
При типичном использовании адрес создается путем ввода данных пользователем или путем импорта существующих данных, в зависимости от типа процесса.
Советы по вводу или редактированию адреса:
Используйте готовый к интернационализации виджет адреса, например https://github.com/google/libaddressinput .
Пользователям не должны предоставляться элементы пользовательского интерфейса для ввода или редактирования полей за пределами стран, где это поле используется.
Дополнительные инструкции по использованию этой схемы см. по адресу: https://support.google.com/business/answer/6397478 .
JSON-представление |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
Поля | |
---|---|
revision | Ревизия схемы Все новые версии должны быть обратно совместимы со старыми версиями. |
regionCode | Обязательно. Код региона CLDR страны/региона адреса. Он никогда не выводится, и пользователь должен сам убедиться, что значение верно. Подробности см. на сайтах https://cldr.unicode.org/ и https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html . Пример: «CH» для Швейцарии. |
languageCode | Необязательно. Код языка BCP-47 содержимого этого адреса (если известен). Часто это язык пользовательского интерфейса формы ввода или, как ожидается, он будет соответствовать одному из языков, используемых в стране/регионе адреса, или их транслитерированным эквивалентам. Это может повлиять на форматирование в некоторых странах, но не имеет решающего значения для правильности данных и никогда не повлияет на какие-либо проверки или другие операции, не связанные с форматированием. Если это значение неизвестно, его следует опустить (вместо указания возможно неверного значения по умолчанию). Примеры: «ж-Хант», «джа», «джа-Латн», «эн». |
postalCode | Необязательно. Почтовый индекс адреса. Не все страны используют или требуют указания почтовых индексов, но там, где они используются, они могут вызывать дополнительную проверку с другими частями адреса (например, проверку штата или почтового индекса в Соединенных Штатах). |
sortingCode | Необязательно. Дополнительный, специфичный для страны, код сортировки. Он не используется в большинстве регионов. Там, где он используется, значение представляет собой либо строку типа «CEDEX», за которой может следовать число (например, «CEDEX 7»), либо просто число, представляющее «код сектора» (Ямайка), «индикатор зоны доставки» (Малави) или «индикатор почтового отделения» (Кот-д'Ивуар). |
administrativeArea | Необязательно. Высшая административная единица, которая используется для почтовых адресов страны или региона. Например, это может быть штат, провинция, область или префектура. Для Испании это провинция, а не автономное сообщество (например, «Барселона», а не «Каталония»). Во многих странах административная область в почтовых адресах не используется. Например, в Швейцарии ее следует оставить незаселенной. |
locality | Необязательно. Обычно относится к части адреса, обозначающей город или населенный пункт. Примеры: город в США, коммуна в IT, почтовый город в Великобритании. В регионах мира, где населенные пункты не определены четко или не вписываются в эту структуру, оставьте |
sublocality | Необязательно. Подрайон адреса. Например, это может быть район, округ или район. |
addressLines[] | Неструктурированные адресные строки, описывающие нижние уровни адреса. Поскольку значения в Минимально допустимое структурное представление адреса состоит из Создание адреса, содержащего только |
recipients[] | Необязательно. Получатель по адресу. Это поле может при определенных обстоятельствах содержать многострочную информацию. Например, оно может содержать информацию «care of». |
organization | Необязательно. Название организации по адресу. |
АдресКомпонент
Структурированные компоненты, формирующие форматированный адрес, если такая информация доступна.
JSON-представление |
---|
{ "longText": string, "shortText": string, "types": [ string ], "languageCode": string } |
Поля | |
---|---|
longText | Полное текстовое описание или имя компонента адреса. Например, компонент адреса для страны Австралия может иметь длинное_имя "Австралия". |
shortText | Сокращенное текстовое имя компонента адреса, если доступно. Например, компонент адреса для страны Австралия может иметь short_name "AU". |
types[] | Массив, указывающий тип(ы) компонента адреса. |
languageCode | Язык, используемый для форматирования этих компонентов, в нотации CLDR. |
PlusCode
Плюс-код ( http://plus.codes ) — это ссылка на местоположение в двух форматах: глобальный код, определяющий прямоугольник размером 14x14 м (1/8000 градуса) или меньше, и составной код, заменяющий префикс на ссылку на местоположение.
JSON-представление |
---|
{ "globalCode": string, "compoundCode": string } |
Поля | |
---|---|
globalCode | Глобальный (полный) код места, например «9FWM33GV+HQ», представляющий область размером 1/8000 на 1/8000 градуса (~14 на 14 метров). |
compoundCode | Составной код места, например «33GV+HQ, Ramberg, Norway», содержащий суффикс глобального кода и заменяющий префикс на отформатированное имя ссылочной сущности. |
Широта и долгота
Объект, представляющий пару широта/долгота. Выражается как пара чисел двойной точности для представления градусов широты и градусов долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в нормализованных диапазонах.
JSON-представление |
---|
{ "latitude": number, "longitude": number } |
Поля | |
---|---|
latitude | Широта в градусах. Она должна быть в диапазоне [-90.0, +90.0]. |
longitude | Долгота в градусах. Она должна быть в диапазоне [-180.0, +180.0]. |
Видовой порт
Широта-долгота области просмотра, представленной как две диагонально противоположные low
и high
точки. Область просмотра считается замкнутой областью, т. е. включает ее границу. Границы широты должны находиться в диапазоне от -90 до 90 градусов включительно, а границы долготы должны находиться в диапазоне от -180 до 180 градусов включительно. Различные случаи включают:
Если
low
=high
, область просмотра состоит из этой единственной точки.Если
low.longitude
>high.longitude
, диапазон долготы инвертируется (область просмотра пересекает линию долготы 180 градусов).Если
low.longitude
= -180 градусов, аhigh.longitude
= 180 градусов, область просмотра включает все долготы.Если
low.longitude
= 180 градусов, аhigh.longitude
= -180 градусов, то диапазон долготы пуст.Если
low.latitude
>high.latitude
, диапазон широт пуст.
Оба low
и high
должны быть заполнены, а представленное поле не может быть пустым (как указано в определениях выше). Пустая область просмотра приведет к ошибке.
Например, эта область просмотра полностью охватывает Нью-Йорк:
{ "низкая": { "широта": 40.477398, "долгота": -74.259087 }, "высокая": { "широта": 40.91618, "долгота": -73.70018 } }
JSON-представление |
---|
{ "low": { object ( |
Поля | |
---|---|
low | Обязательно. Нижняя точка области просмотра. |
high | Обязательно. Верхняя точка области просмотра. |
Обзор
Информация об обзоре места.
JSON-представление |
---|
{ "name": string, "relativePublishTimeDescription": string, "text": { object ( |
Поля | |
---|---|
name | Ссылка, представляющая этот обзор места, которая может быть использована для повторного поиска этого обзора места (также называется именем «ресурса» API: |
relativePublishTimeDescription | Строка отформатированного недавнего времени, выражающая время обзора относительно текущего времени в форме, подходящей для языка и страны. |
text | Локализованный текст обзора. |
originalText | Текст обзора на языке оригинала. |
rating | Число от 1,0 до 5,0, также называемое числом звезд. |
authorAttribution | Автор этого обзора. |
publishTime | Временная метка обзора. Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: |
flagContentUri | Ссылка, по которой пользователи могут сообщить о проблеме с отзывом. |
googleMapsUri | Ссылка для отображения отзыва на Google Maps. |
АвторАтрибуция
Информация об авторе данных UGC. Используется в Photo
и Review
.
JSON-представление |
---|
{ "displayName": string, "uri": string, "photoUri": string } |
Поля | |
---|---|
displayName | |
uri | |
photoUri | |
Часы работы
Информация о часах работы заведения.
JSON-представление |
---|
{ "periods": [ { object ( |
Поля | |
---|---|
periods[] | ПРИМЕЧАНИЕ: Порядок массива |
weekdayDescriptions[] | Локализованные строки, описывающие часы работы этого места, по одной строке на каждый день недели. ПРИМЕЧАНИЕ: Порядок дней и начало недели определяются локалью (языком и регионом). Порядок массива Будет пустым, если часы неизвестны или не могут быть преобразованы в локализованный текст. Пример: "Sun: 18:00–06:00" |
secondaryHoursType | Строка типа, используемая для идентификации типа дополнительных часов. |
specialDays[] | Структурированная информация для особых дней, которые попадают в период, который покрывают возвращенные часы работы. Особые дни — это дни, которые могут повлиять на часы работы места, например, Рождество. Установите для currentOpeningHours и currentSecondaryOpeningHours, если есть исключительные часы. |
nextOpenTime | Следующий раз, когда текущий период часов работы начнется через 7 дней в будущем. Это поле заполняется только в том случае, если период часов работы не активен на момент обслуживания запроса. Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: |
nextCloseTime | Следующий раз, когда текущий период часов работы заканчивается в течение 7 дней в будущем. Это поле заполняется только в том случае, если период часов работы активен на момент обслуживания запроса. Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: |
openNow | Активен ли в данный момент период часов работы. Для обычных часов работы и текущих часов работы это поле означает, открыто ли место. Для дополнительных часов работы и текущих дополнительных часов работы это поле означает, активны ли дополнительные часы работы этого места. |
Период
Период, в течение которого место остается в статусе openNow.
JSON-представление |
---|
{ "open": { object ( |
Поля | |
---|---|
open | Время, когда заведение начинает открываться. |
close | Время, когда заведение начинает закрываться. |
Точка
Точки изменения статуса.
JSON-представление |
---|
{
"date": {
object ( |
Поля | |
---|---|
date | Дата по местному часовому поясу места. |
truncated | Была ли эта конечная точка усечена или нет. Усечение происходит, когда реальные часы выходят за пределы времени, между которыми мы хотим вернуть часы, поэтому мы усекаем часы обратно до этих границ. Это гарантирует, что будет возвращено не более 24 * 7 часов с полуночи дня запроса. |
day | День недели, как целое число в диапазоне от 0 до 6. 0 — воскресенье, 1 — понедельник и т. д. |
hour | Час в 24-часовом формате. Диапазон от 0 до 23. |
minute | Минута. Диапазон от 0 до 59. |
Дата
Представляет собой полную или частичную календарную дату, например день рождения. Время суток и часовой пояс либо указаны в другом месте, либо не имеют значения. Дата относится к григорианскому календарю. Может представлять одно из следующего:
- Полная дата с ненулевыми значениями года, месяца и дня.
- Месяц и день с нулевым годом (например, годовщина).
- Год сам по себе, с нулевым месяцем и нулевым днем.
- Год и месяц с нулевым днем (например, дата окончания срока действия кредитной карты).
Похожие типы:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
JSON-представление |
---|
{ "year": integer, "month": integer, "day": integer } |
Поля | |
---|---|
year | Год даты. Должен быть от 1 до 9999 или 0, чтобы указать дату без года. |
month | Месяц года. Должен быть от 1 до 12 или 0, чтобы указать год без месяца и дня. |
day | День месяца. Должен быть от 1 до 31 и действителен для года и месяца, или 0, чтобы указать год отдельно или год и месяц, где день не имеет значения. |
ВторичныйТипЧасов
Тип, используемый для определения типа дополнительных часов.
Перечисления | |
---|---|
SECONDARY_HOURS_TYPE_UNSPECIFIED | Значение по умолчанию, если не указан вторичный тип часа. |
DRIVE_THROUGH | Час работы банков, ресторанов и аптек. |
HAPPY_HOUR | Счастливый час. |
DELIVERY | Час доставки. |
TAKEOUT | Час еды на вынос. |
KITCHEN | Кухонный час. |
BREAKFAST | Час завтрака. |
LUNCH | Обеденный перерыв. |
DINNER | Час ужина. |
BRUNCH | Время обеда. |
PICKUP | Час отправления. |
ACCESS | Часы доступа к местам хранения. |
SENIOR_HOURS | Специальные часы для пожилых людей. |
ONLINE_SERVICE_HOURS | Часы работы онлайн-сервиса. |
СпециальныйДень
Структурированная информация для особых дней, которые попадают в период, который покрывают возвращенные часы работы. Особые дни — это дни, которые могут повлиять на часы работы места, например, Рождество.
JSON-представление |
---|
{
"date": {
object ( |
Поля | |
---|---|
date | Дата этого особенного дня. |
Часовой пояс
Представляет часовой пояс из базы данных часовых поясов IANA .
JSON-представление |
---|
{ "id": string, "version": string } |
Поля | |
---|---|
id | Часовой пояс базы данных часовых поясов IANA. Например, "America/New_York". |
version | Необязательно. Номер версии базы данных часовых поясов IANA. Например, "2019a". |
Фото
Информация о фотографии места.
JSON-представление |
---|
{
"name": string,
"widthPx": integer,
"heightPx": integer,
"authorAttributions": [
{
object ( |
Поля | |
---|---|
name | Идентификатор. Ссылка, представляющая эту фотографию места, которая может быть использована для повторного поиска этой фотографии места (также называется именем «ресурса» API: |
widthPx | Максимально доступная ширина в пикселях. |
heightPx | Максимально доступная высота в пикселях. |
authorAttributions[] | Авторы этой фотографии. |
flagContentUri | Ссылка, по которой пользователи могут сообщить о проблеме с фотографией. |
googleMapsUri | Ссылка для показа фотографии на Google Maps. |
BusinessStatus
Бизнес-статус этого места.
Перечисления | |
---|---|
BUSINESS_STATUS_UNSPECIFIED | Значение по умолчанию. Это значение не используется. |
OPERATIONAL | Заведение функционирует, но не обязательно открыто в данный момент. |
CLOSED_TEMPORARILY | Заведение временно закрыто. |
CLOSED_PERMANENTLY | Заведение закрыто навсегда. |
ЦенаУровень
Уровень цен в этом месте.
Перечисления | |
---|---|
PRICE_LEVEL_UNSPECIFIED | Уровень цен места не указан или неизвестен. |
PRICE_LEVEL_FREE | Место предоставляет бесплатные услуги. |
PRICE_LEVEL_INEXPENSIVE | Место предоставляет недорогие услуги. |
PRICE_LEVEL_MODERATE | Место предоставляет услуги по умеренным ценам. |
PRICE_LEVEL_EXPENSIVE | Место предоставляет дорогие услуги. |
PRICE_LEVEL_VERY_EXPENSIVE | Место предоставляет очень дорогие услуги. |
Атрибуция
Информация о поставщиках данных этого места.
JSON-представление |
---|
{ "provider": string, "providerUri": string } |
Поля | |
---|---|
provider | Название поставщика данных места. |
providerUri | URI поставщика данных места. |
Варианты оплаты
Возможные варианты оплаты.
JSON-представление |
---|
{ "acceptsCreditCards": boolean, "acceptsDebitCards": boolean, "acceptsCashOnly": boolean, "acceptsNfc": boolean } |
Поля | |
---|---|
acceptsCreditCards | Место принимает к оплате кредитные карты. |
acceptsDebitCards | К оплате принимаются дебетовые карты. |
acceptsCashOnly | Место принимает только наличные в качестве оплаты. Места с этим атрибутом могут по-прежнему принимать другие способы оплаты. |
acceptsNfc | Место принимает платежи NFC. |
Варианты парковки
Информация о вариантах парковки для этого места. Парковка может поддерживать более одного варианта одновременно.
JSON-представление |
---|
{ "freeParkingLot": boolean, "paidParkingLot": boolean, "freeStreetParking": boolean, "paidStreetParking": boolean, "valetParking": boolean, "freeGarageParking": boolean, "paidGarageParking": boolean } |
Поля | |
---|---|
freeParkingLot | На территории имеются бесплатные парковочные места. |
paidParkingLot | Место предлагает платные парковочные места. |
freeStreetParking | На территории отеля имеется бесплатная уличная парковка. |
paidStreetParking | Предлагается платная уличная парковка. |
valetParking | Предоставляются услуги парковщика. |
freeGarageParking | В отеле есть бесплатная парковка в гараже. |
paidGarageParking | Предлагается платная парковка в гараже. |
Подпункт назначения
Подпункты назначения — это конкретные места, связанные с основным местом. Они предоставляют более конкретные пункты назначения для пользователей, которые ищут в большом или сложном месте, например, в аэропорту, национальном парке, университете или на стадионе. Например, подпункты назначения в аэропорту могут включать связанные терминалы и парковки. Подпункты назначения возвращают идентификатор места и имя ресурса места, которые можно использовать в последующих запросах Place Details (New) для получения более подробных сведений, включая отображаемое имя и местоположение подпункта назначения.
JSON-представление |
---|
{ "name": string, "id": string } |
Поля | |
---|---|
name | Имя ресурса подпункта назначения. |
id | Идентификатор места дополнительного пункта назначения. |
ДоступностьПараметры
Информация о возможностях обеспечения доступности, которые предлагает то или иное место.
JSON-представление |
---|
{ "wheelchairAccessibleParking": boolean, "wheelchairAccessibleEntrance": boolean, "wheelchairAccessibleRestroom": boolean, "wheelchairAccessibleSeating": boolean } |
Поля | |
---|---|
wheelchairAccessibleParking | На территории имеется парковка, доступная для инвалидных колясок. |
wheelchairAccessibleEntrance | В здании есть вход, доступный для инвалидных колясок. |
wheelchairAccessibleRestroom | В помещении имеется туалет, доступный для инвалидных колясок. |
wheelchairAccessibleSeating | В помещении имеются места для сидения людей на инвалидных колясках. |
FuelOptions
Самая последняя информация о вариантах топлива на АЗС. Эта информация регулярно обновляется.
JSON-представление |
---|
{
"fuelPrices": [
{
object ( |
Поля | |
---|---|
fuelPrices[] | Последняя известная цена на топливо для каждого типа топлива, имеющегося на этой станции. Для каждого типа топлива, имеющегося на этой станции, существует одна запись. Порядок не важен. |
Цена топлива
Информация о ценах на топливо определенного типа.
JSON-представление |
---|
{ "type": enum ( |
Поля | |
---|---|
type | Тип топлива. |
price | Цена на топливо. |
updateTime | Время последнего обновления цены на топливо. Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: |
Тип топлива
Виды топлива.
Перечисления | |
---|---|
FUEL_TYPE_UNSPECIFIED | Тип топлива не указан. |
DIESEL | Дизельное топливо. |
DIESEL_PLUS | Дизельное топливо плюс топливо. |
REGULAR_UNLEADED | Обычный неэтилированный. |
MIDGRADE | Средний класс. |
PREMIUM | Премиум. |
SP91 | СП 91. |
SP91_E10 | СП 91 Е10. |
SP92 | СП 92. |
SP95 | СП 95. |
SP95_E10 | СП95 Е10. |
SP98 | СП 98. |
SP99 | СП 99. |
SP100 | СП 100. |
LPG | Сжиженный нефтяной газ. |
E80 | Е 80. |
E85 | Е 85. |
E100 | Е 100. |
METHANE | Метан. |
BIO_DIESEL | Биодизель. |
TRUCK_DIESEL | Грузовой дизель. |
Деньги
Представляет собой сумму денег с указанным типом валюты.
JSON-представление |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Поля | |
---|---|
currencyCode | Трехбуквенный код валюты, определенный в ISO 4217. |
units | Целые единицы суммы. Например, если |
nanos | Количество единиц нано (10^-9) суммы. Значение должно быть в диапазоне от -999 999 999 до +999 999 999 включительно. Если |
EVChargeOptions
Информация о станции зарядки электромобилей, размещенной в Place. Терминология: https://afdc.energy.gov/fuels/electricity_infrastructure.html Один порт может заряжать один автомобиль одновременно. Один порт имеет один или несколько разъемов. Одна станция имеет один или несколько портов.
JSON-представление |
---|
{
"connectorCount": integer,
"connectorAggregation": [
{
object ( |
Поля | |
---|---|
connectorCount | Количество разъемов на этой станции. Однако, поскольку некоторые порты могут иметь несколько разъемов, но могут заряжать только одну машину за раз (например), количество разъемов может превышать общее количество автомобилей, которые могут заряжаться одновременно. |
connectorAggregation[] | Список агрегатов разъемов для зарядки электромобилей, содержащих разъемы одного типа и с одинаковой скоростью заряда. |
Агрегация коннектора
Информация о зарядке электромобиля, сгруппированная по [type, maxChargeRateKw]. Показывает агрегацию заряда электромобиля через разъемы, имеющие одинаковый тип и максимальную скорость зарядки в кВт.
JSON-представление |
---|
{
"type": enum ( |
Поля | |
---|---|
type | Тип коннектора данной агрегации. |
maxChargeRateKw | Максимальная мощность статической зарядки в кВт для каждого разъема в агрегации. |
count | Количество коннекторов в этой агрегации. |
availabilityLastUpdateTime | Временная метка последнего обновления информации о доступности коннектора в этой агрегации. Использует RFC 3339, где сгенерированный вывод всегда будет Z-нормализованным и использует 0, 3, 6 или 9 дробных цифр. Смещения, отличные от "Z", также принимаются. Примеры: |
availableCount | Количество коннекторов в этой агрегации, которые в данный момент доступны. |
outOfServiceCount | Количество коннекторов в этой агрегации, которые в настоящее время не обслуживаются. |
EVConnectorType
Дополнительную информацию/контекст о типах разъемов для зарядки электромобилей см. на сайте http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 .
Перечисления | |
---|---|
EV_CONNECTOR_TYPE_UNSPECIFIED | Неуказанный соединитель. |
EV_CONNECTOR_TYPE_OTHER | Другие типы разъемов. |
EV_CONNECTOR_TYPE_J1772 | Разъем J1772 тип 1. |
EV_CONNECTOR_TYPE_TYPE_2 | Разъем IEC 62196 типа 2. Часто называется MENNEKES. |
EV_CONNECTOR_TYPE_CHADEMO | Разъем типа CHAdeMO. |
EV_CONNECTOR_TYPE_CCS_COMBO_1 | Комбинированная система зарядки (переменный и постоянный ток). На основе SAE. Разъем Type-1 J-1772 |
EV_CONNECTOR_TYPE_CCS_COMBO_2 | Комбинированная система зарядки (переменного и постоянного тока). На основе разъема Mennekes Type-2 |
EV_CONNECTOR_TYPE_TESLA | Универсальный разъем TESLA. Это NACS в Северной Америке, но может быть не-NACS в других частях света (например, CCS Combo 2 (CCS2) или GB/T). Это значение в меньшей степени отражает фактический тип разъема и в большей степени отражает возможность зарядки автомобиля марки Tesla на зарядной станции, принадлежащей Tesla. |
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T | Тип GB/T соответствует стандарту GB/T в Китае. Этот тип охватывает все типы GB_T. |
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET | Неуказанная настенная розетка. |
EV_CONNECTOR_TYPE_NACS | Североамериканская система зарядки (NACS), стандартизированная как SAE J3400. |
ГенеративныйРезюме
Сводка места, созданная искусственным интеллектом.
JSON-представление |
---|
{ "overview": { object ( |
Поля | |
---|---|
overview | Обзор места. |
overviewFlagContentUri | Ссылка, с помощью которой пользователи могут сообщить о проблеме с обзором. |
disclosureText | Сообщение AI-раскрытия «Summarized with Gemini» (и его локализованные варианты). Оно будет на языке, указанном в запросе, если оно доступно. |
СодержащееМесто
Информация о месте, в котором находится это место.
JSON-представление |
---|
{ "name": string, "id": string } |
Поля | |
---|---|
name | Название ресурса места, в котором находится это место. |
id | Идентификатор места, в котором находится это место. |
АдресДескриптор
Относительное описание местоположения. Включает ранжированный набор близлежащих ориентиров и точные охватывающие области и их связь с целевым местоположением.
JSON-представление |
---|
{ "landmarks": [ { object ( |
Поля | |
---|---|
landmarks[] | Ранжированный список близлежащих достопримечательностей. Самые узнаваемые и близлежащие достопримечательности ранжируются первыми. |
areas[] | Ранжированный список содержащих или смежных областей. Наиболее узнаваемые и точные области ранжируются первыми. |
Достопримечательность
Основная информация об ориентире и его взаимосвязь с целевым местоположением.
Достопримечательности — это заметные места, которые можно использовать для описания местоположения.
JSON-представление |
---|
{ "name": string, "placeId": string, "displayName": { object ( |
Поля | |
---|---|
name | Название ресурса достопримечательности. |
placeId | Идентификатор места расположения достопримечательности. |
displayName | Отображаемое название достопримечательности. |
types[] | Набор тегов типа для этой достопримечательности. Полный список возможных значений см. по адресу https://developers.google.com/maps/documentation/places/web-service/place-types . |
spatialRelationship | Определяет пространственное соотношение между целевым местоположением и ориентиром. |
straightLineDistanceMeters | Расстояние по прямой линии в метрах между центральной точкой цели и центральной точкой ориентира. В некоторых ситуациях это значение может быть больше, чем |
travelDistanceMeters | Расстояние перемещения в метрах по дорожной сети от цели до ориентира, если известно. Это значение не учитывает способ передвижения, например, ходьба, вождение или езда на велосипеде. |
ПространственныеОтношения
Определяет пространственное соотношение между целевым местоположением и ориентиром.
Перечисления | |
---|---|
NEAR | Это отношение применяется по умолчанию, когда не применяется ничего более конкретного, изложенного ниже. |
WITHIN | Ориентир имеет пространственную геометрию, и цель находится в его пределах. |
BESIDE | Цель находится непосредственно рядом с ориентиром. |
ACROSS_THE_ROAD | Цель находится прямо напротив ориентира на другой стороне дороги. |
DOWN_THE_ROAD | На том же маршруте, что и ориентир, но не рядом или поперек. |
AROUND_THE_CORNER | Не на том же маршруте, что и достопримечательность, а на один поворот в сторону. |
BEHIND | Рядом с строением достопримечательности, но дальше от ее уличных входов. |
Область
Информация о местности и ее взаимосвязь с целевым местоположением.
Области включают точные микрорайоны, кварталы и крупные комплексы, которые полезны для описания местоположения.
JSON-представление |
---|
{ "name": string, "placeId": string, "displayName": { object ( |
Поля | |
---|---|
name | Название ресурса области. |
placeId | Идентификатор места в этом районе. |
displayName | Отображаемое название области. |
containment | Определяет пространственное соотношение между целевым местоположением и областью. |
Сдерживание
Определяет пространственное соотношение между целевым местоположением и областью.
Перечисления | |
---|---|
CONTAINMENT_UNSPECIFIED | Условия содержания не уточняются. |
WITHIN | Местоположение цели находится в пределах региона, близко к центру. |
OUTSKIRTS | Местоположение цели находится в пределах области, близко к краю. |
NEAR | Местоположение цели находится за пределами региона, но недалеко от него. |
GoogleMapsСсылки
Ссылки для запуска различных действий в Картах Google.
JSON-представление |
---|
{ "directionsUri": string, "placeUri": string, "writeAReviewUri": string, "reviewsUri": string, "photosUri": string } |
Поля | |
---|---|
directionsUri | Ссылка для отображения маршрута к месту. Ссылка заполняет только место назначения и использует режим путешествия по умолчанию |
placeUri | Ссылка для показа этого места. |
writeAReviewUri | Ссылка для написания отзыва об этом месте на Google Maps. |
reviewsUri | Ссылка для просмотра отзывов об этом месте на Google Maps. |
photosUri | Ссылка для просмотра отзывов об этом месте на Google Maps. |
Диапазон цен
Диапазон цен, связанный с Place. endPrice
может быть не установлен, что указывает на диапазон без верхней границы (например, «Более 100 долларов США»).
JSON-представление |
---|
{ "startPrice": { object ( |
Поля | |
---|---|
startPrice | Низкий конец ценового диапазона (включительно). Цена должна быть на этой сумме или выше. |
endPrice | Высокий конец ценового диапазона (эксклюзивный). Цена должна быть ниже этой суммы. |
ОбзорРезюме
АИ-сгенерированная сводка места с использованием обзоров пользователей.
JSON-представление |
---|
{ "text": { object ( |
Поля | |
---|---|
text | Сводка обзоров пользователей. |
flagContentUri | Ссылка, где пользователи могут пометить проблему с резюме. |
disclosureText | Сообщение раскрытия ИИ «суммировано с Близнецами» (и его локализованные варианты). Это будет на языке, указанном в запросе, если будет доступно. |
reviewsUri | Ссылка, чтобы показать обзоры этого места на Google Maps. |
Evargeamenitysummary
Краткое изложение удобств возле зарядной станции EV. Это относится только к местам с типом electric_vehicle_charging_station
. Поле overview
гарантированно будет предоставлено, в то время как другие поля являются необязательными.
JSON-представление |
---|
{ "overview": { object ( |
Поля | |
---|---|
overview | Обзор доступных удобств. Это гарантированно будет предоставлено. |
coffee | Краткое изложение ближайших вариантов кофе. |
restaurant | Краткое изложение близлежащих ресторанов. |
store | Краткое изложение близлежащих заправочных станций. |
flagContentUri | Ссылка, где пользователи могут пометить проблему с резюме. |
disclosureText | Сообщение раскрытия ИИ «суммировано с Близнецами» (и его локализованные варианты). Это будет на языке, указанном в запросе, если будет доступно. |
ContentBlock
Блок контента, который можно подавать индивидуально.
JSON-представление |
---|
{
"content": {
object ( |
Поля | |
---|---|
content | Контент, связанный с темой. |
referencedPlaces[] | Список названий ресурсов указанных мест. Это имя можно использовать в других API, которые принимают имена ресурсов места. |
Соседство
Краткое изложение интересующих точек возле места.
JSON-представление |
---|
{ "overview": { object ( |
Поля | |
---|---|
overview | Обзор резюме района. |
description | Подробное описание района. |
flagContentUri | Ссылка, где пользователи могут пометить проблему с резюме. |
disclosureText | Сообщение раскрытия ИИ «суммировано с Близнецами» (и его локализованные варианты). Это будет на языке, указанном в запросе, если будет доступно. |
Методы | |
---|---|
| Возвращает прогнозы для данного ввода. |
| Получите детали места на основе его имени ресурса, которое является строкой в формате places/{place_id} . |
| Ищите места рядом с местами. |
| Поиск на основе текстовых запросов. |