- Ресурс: Место
- Локализованный текст
- Почтовый адрес
- АдресКомпонент
- PlusCode
- Широта и долгота
- Видовой порт
- Обзор
- Авторство
- Часы работы
- Период
- Точка
- Дата
- ВторичныйТипЧасов
- ОсобенныйДень
- Часовой пояс
- Фото
- BusinessStatus
- PriceLevel
- Атрибуция
- Варианты оплаты
- Варианты парковки
- Подпункт назначения
- ДоступностьПараметры
- FuelOptions
- FuelPrice
- Тип топлива
- Деньги
- EVChargeOptions
- Агрегация коннекторов
- EVConnectorType
- GenerativeSummary
- ContainingPlace
- АдресДескриптор
- Достопримечательность
- Пространственные отношения
- Область
- Сдерживание
- GoogleMapsLinks
- Диапазон цен
- ОбзорРезюме
- EvChargeAmenitySummary
- ContentBlock
- Краткое описание района
- Методы
Ресурс: Место
Вся информация, представляющая место.
JSON-представление |
---|
{ "name": string, "id": string, "displayName": { object ( |
Поля | |
---|---|
name | Название ресурса этого места в формате |
id | Уникальный идентификатор места. |
displayName | Локализованное название места, подходящее для краткого и понятного описания. Например, «Google Сидней», «Starbucks», «Pyrmont» и т. д. |
types[] | Набор тегов типа для этого результата. Например, «политический» и «местность». Полный список возможных значений см. в таблицах A и B по адресу https://developers.google.com/maps/documentation/places/web-service/place-types . |
primaryType | Основной тип результата. Этот тип должен быть одним из поддерживаемых Places API. Например, «ресторан», «кафе», «аэропорт» и т. д. У места может быть только один основной тип. Полный список возможных значений см. в таблицах 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 | Обычные часы работы. Обратите внимание: если место открыто круглосуточно, поле |
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[] | Содержит массив записей на следующие семь дней, включая информацию о дополнительных часах работы предприятия. Дополнительные часы работы отличаются от основных. Например, ресторан может указать часы работы с выездом за рулём или часы доставки в качестве дополнительных часов работы. Это поле заполняет подполе «Тип», которое выбирается из предопределенного списка часов работы (например, «АВТО», «САМОВЫВОЗ» или «НА ВЫНОС») в зависимости от типа заведения. Это поле включает подполе «specialDays» для всех часов работы, заданных для дат с особыми часами работы. |
regularSecondaryOpeningHours[] | Содержит массив записей с информацией о дополнительных часах работы предприятия. Дополнительные часы работы отличаются от основных. Например, ресторан может указать часы работы с выездом за рулём или часы доставки в качестве дополнительных часов работы. Это поле заполняет подполе «Тип», которое выбирается из предопределённого списка часов работы (например, «АВТО», «САМОВЫВОЗ» или «НА ВЫНОС») в зависимости от типа заведения. |
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 | Необязательно. Обычно относится к части адреса, указывающей город. Примеры: город в США, коммуна в США, почтовый город в Великобритании. В регионах мира, где населённые пункты нечётко определены или плохо вписываются в эту структуру, оставьте |
sublocality | Необязательно. Укажите район (подрайон) адреса. Например, это может быть район, округ или район. |
addressLines[] | Неструктурированные адресные строки, описывающие нижние уровни адреса. Поскольку значения в Минимально допустимое структурное представление адреса состоит из Для обработки полностью неструктурированных адресов рекомендуется создать адрес, содержащий только |
recipients[] | Необязательно. Получатель по адресу. В некоторых случаях это поле может содержать многострочную информацию. Например, оно может содержать информацию о получателе. |
organization | Необязательно. Название организации по адресу. |
АдресКомпонент
Структурированные компоненты, формирующие форматированный адрес, если эта информация доступна.
JSON-представление |
---|
{ "longText": string, "shortText": string, "types": [ string ], "languageCode": string } |
Поля | |
---|---|
longText | Полное текстовое описание или название компонента адреса. Например, компонент адреса для страны Австралия может иметь длинное имя «Австралия». |
shortText | Сокращённое текстовое название компонента адреса, если доступно. Например, компонент адреса для страны Австралия может иметь сокращенное название «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. |
Авторство
Информация об авторе данных пользовательского контента. Используется в разделе Photo
и Review
.
JSON-представление |
---|
{ "displayName": string, "uri": string, "photoUri": string } |
Поля | |
---|---|
displayName | |
uri | |
photoUri | |
Часы работы
Информация о часах работы заведения.
JSON-представление |
---|
{ "periods": [ { object ( |
Поля | |
---|---|
periods[] | Периоды, в которые это место открыто в течение недели. Периоды указаны в хронологическом порядке в соответствии с часовым поясом. Пустое (но не отсутствующее) значение указывает на место, которое никогда не работает, например, временно закрыто на ремонт. День начала ПРИМЕЧАНИЕ: Порядок элементов массива |
weekdayDescriptions[] | Локализованные строки, описывающие часы работы этого места, по одной строке на каждый день недели. ПРИМЕЧАНИЕ: Порядок дней недели и начало недели определяются локалью (языком и регионом). Порядок элементов массива Будет пустым, если время неизвестно или не удалось преобразовать в локализованный текст. Пример: «Вс: 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 | Заведение закрыто навсегда. |
PriceLevel
Уровень цен в данном месте.
Перечисления | |
---|---|
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[] | Последняя известная цена на топливо каждого типа, доступного на этой заправке. Для каждого типа топлива, доступного на этой заправке, существует одна запись. Порядок не важен. |
FuelPrice
Информация о ценах на топливо определенного типа.
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. Разъём J-1772 Тип 1. |
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. |
GenerativeSummary
Сводка по месту, созданная искусственным интеллектом.
JSON-представление |
---|
{ "overview": { object ( |
Поля | |
---|---|
overview | Обзор места. |
overviewFlagContentUri | Ссылка, с помощью которой пользователи могут сообщить о проблеме в обзоре. |
disclosureText | Сообщение AI о раскрытии информации «Summarized with Gemini» (и его локализованные варианты). Оно будет представлено на языке, указанном в запросе, если он доступен. |
ContainingPlace
Информация о месте, в котором находится это место.
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 | Целевое местоположение находится за пределами области, но рядом. |
GOOGLEMAPSLINKS
Ссылки, чтобы запустить различные действия Google Maps.
Представление JSON |
---|
{ "directionsUri": string, "placeUri": string, "writeAReviewUri": string, "reviewsUri": string, "photosUri": string } |
Поля | |
---|---|
directionsUri | Ссылка, чтобы показать указания на место. Ссылка только заполняет место назначения и использует |
placeUri | Ссылка, чтобы показать это место. |
writeAReviewUri | Ссылка для написания обзора для этого места на картах Google. |
reviewsUri | Ссылка, чтобы показать обзоры этого места на Google Maps. |
photosUri | Ссылка, чтобы показать обзоры этого места на Google Maps. |
Приход
Ценовой диапазон, связанный с местом. 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} . |
| Ищите места рядом с местами. |
| Поиск на основе текстовых запросов. |