REST Resource: places

Ресурс: Место

Вся информация, представляющая место.

JSON-представление 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  },
  "pureServiceAreaBusiness": boolean
}
Поля
name

string

Имя ресурса этого места в формате places/{placeId} . Может использоваться для поиска места.

id

string

Уникальный идентификатор места.

displayName

object ( LocalizedText )

Локализованное название места, подходящее в качестве краткого удобочитаемого описания. Например, «Google Сидней», «Старбакс», «Пирмонт» и т. д.

types[]

string

Набор тегов типа для этого результата. Например, «политический» и «локальность». Полный список возможных значений см. в таблицах A и B по адресу https://developers.google.com/maps/documentation/places/web-service/place-types .

primaryType

string

Основной тип данного результата. Этот тип должен быть одним из типов, поддерживаемых Places API. Например, «ресторан», «кафе», «аэропорт» и т. д. Место может иметь только один основной тип. Полный список возможных значений см. в таблицах A и B по адресу https://developers.google.com/maps/documentation/places/web-service/place-types .

primaryTypeDisplayName

object ( LocalizedText )

Отображаемое имя основного типа, локализованное на язык запроса, если применимо. Полный список возможных значений см. в таблицах A и B по адресу https://developers.google.com/maps/documentation/places/web-service/place-types .

nationalPhoneNumber

string

Удобочитаемый номер телефона места в национальном формате.

internationalPhoneNumber

string

Удобочитаемый номер телефона места в международном формате.

formattedAddress

string

Полный, удобочитаемый адрес этого места.

shortFormattedAddress

string

Короткий, понятный человеку адрес этого места.

postalAddress

object ( PostalAddress )

Адрес в формате почтового адреса.

addressComponents[]

object ( AddressComponent )

Повторяющиеся компоненты для каждого уровня местности. Обратите внимание на следующие факты о массиве AddressComponents[]: - Массив компонентов адреса может содержать больше компонентов, чем форматированный адрес. — Массив не обязательно включает в себя все политические объекты, содержащие адрес, кроме включенных в форматированный адрес. Чтобы получить все политические объекты, содержащие определенный адрес, вам следует использовать обратное геокодирование, передавая широту/долготу адреса в качестве параметра запроса. - Формат ответа не может быть неизменным между запросами. В частности, количество адресных компонентов варьируется в зависимости от запрошенного адреса и может меняться со временем для одного и того же адреса. Компонент может менять положение в массиве. Тип компонента может измениться. В более позднем ответе может отсутствовать определенный компонент.

plusCode

object ( PlusCode )

Плюс код местоположения места по широте/долготе.

location

object ( LatLng )

Положение этого места.

viewport

object ( Viewport )

Окно просмотра, подходящее для отображения места на карте среднего размера. Это окно просмотра не следует использовать в качестве физической границы или зоны обслуживания компании.

rating

number

Оценка от 1,0 до 5,0 на основе отзывов пользователей об этом месте.

googleMapsUri

string

URL-адрес, предоставляющий дополнительную информацию об этом месте.

websiteUri

string

Авторитетный веб-сайт этого места, например домашняя страница компании. Обратите внимание, что для мест, входящих в сеть (например, магазина IKEA), обычно это веб-сайт отдельного магазина, а не всей сети.

reviews[]

object ( Review )

Список отзывов об этом месте, отсортированный по актуальности. Можно вернуть не более 5 отзывов.

regularOpeningHours

object ( OpeningHours )

Обычные часы работы. Обратите внимание: если место открыто всегда (24 часа), поле close не будет установлено. Клиенты могут рассчитывать на то, что всегда открыт (24 часа), представленный как open период, содержащий day со значением 0 , hour со значением 0 и minute со значением 0 .

timeZone

object ( TimeZone )

Часовой пояс IANA Часовой пояс базы данных. Например, «Америка/Нью_Йорк».

photos[]

object ( Photo )

Информация (включая ссылки) о фотографиях этого места. Вернуть можно максимум 10 фотографий.

adrFormatAddress

string

Адрес места в микроформате adr: http://microformats.org/wiki/adr .

businessStatus

enum ( BusinessStatus )

Деловой статус места.

priceLevel

enum ( PriceLevel )

Уровень цен места.

attributions[]

object ( Attribution )

Набор поставщиков данных, который должен отображаться с этим результатом.

iconMaskBaseUri

string

Усеченный URL-адрес маски значка. Пользователь может получить доступ к другому типу значков, добавив суффикс типа в конец (например, «.svg» или «.png»).

iconBackgroundColor

string

Цвет фона для icon_mask в шестнадцатеричном формате, например #909CE1.

currentOpeningHours

object ( OpeningHours )

Часы работы на ближайшие семь дней (включая сегодня). Период времени начинается в полночь даты запроса и заканчивается в 23:59 шесть дней спустя. Это поле включает подполе SpecialDays для всех часов, заданное для дат с исключительными часами.

currentSecondaryOpeningHours[]

object ( OpeningHours )

Содержит массив записей на следующие семь дней, включая информацию о дополнительных часах работы. Второстепенные часы отличаются от основных часов работы предприятия. Например, ресторан может указать часы работы в пути или часы доставки в качестве второстепенных часов. Это поле заполняет подполе типа, которое извлекается из заранее определенного списка типов часов работы (например, DRIVE_THROUGH, PICKUP или TAKEOUT) в зависимости от типа места. Это поле включает подполе SpecialDays для всех часов, заданное для дат с исключительными часами.

regularSecondaryOpeningHours[]

object ( OpeningHours )

Содержит массив записей для информации об обычных дополнительных часах работы компании. Второстепенные часы отличаются от основных часов работы предприятия. Например, ресторан может указать часы работы в пути или часы доставки в качестве второстепенных часов. Это поле заполняет подполе типа, которое извлекается из заранее определенного списка типов часов работы (например, DRIVE_THROUGH, PICKUP или TAKEOUT) в зависимости от типа места.

editorialSummary

object ( LocalizedText )

Содержит краткую информацию о месте. Резюме состоит из текстового обзора, а также включает код языка для него, если применимо. Текст резюме должен быть представлен «как есть» и не может быть изменен или изменен.

paymentOptions

object ( PaymentOptions )

Варианты оплаты, которые принимает место. Если данные о способе оплаты недоступны, поле варианта оплаты будет не заполнено.

parkingOptions

object ( ParkingOptions )

Варианты парковки предусмотрены местом.

subDestinations[]

object ( SubDestination )

Список подпунктов назначения, связанных с этим местом.

fuelOptions

object ( FuelOptions )

Самая свежая информация о вариантах топлива на АЗС. Эта информация регулярно обновляется.

evChargeOptions

object ( EVChargeOptions )

Информация о вариантах зарядки электромобилей.

generativeSummary

object ( GenerativeSummary )

Краткое описание места, созданное искусственным интеллектом.

containingPlaces[]

object ( ContainingPlace )

Список мест, в которых находится текущее место.

addressDescriptor

object ( AddressDescriptor )

Адресный дескриптор места. Дескрипторы адресов включают дополнительную информацию, которая помогает описать местоположение с помощью ориентиров и территорий. См. региональный охват дескриптора адреса в https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage .

priceRange

object ( PriceRange )

Диапазон цен, связанный с местом.

reviewSummary

object ( ReviewSummary )

Краткое описание места, созданное искусственным интеллектом на основе отзывов пользователей.

evChargeAmenitySummary

object ( EvChargeAmenitySummary )

Краткое описание удобств рядом с зарядной станцией для электромобилей.

neighborhoodSummary

object ( NeighborhoodSummary )

Краткое описание достопримечательностей рядом с местом.

utcOffsetMinutes

integer

На количество минут часовой пояс этого места смещен от UTC. Это выражается в минутах для поддержки часовых поясов, смещенных на доли часа, например X часов и 15 минут.

userRatingCount

integer

Общее количество отзывов (с текстом или без) для этого места.

takeout

boolean

Указывает, поддерживает ли компания доставку еды на вынос.

delivery

boolean

Указывает, поддерживает ли компания доставку.

dineIn

boolean

Указывает, поддерживает ли компания варианты сидения в помещении или на открытом воздухе.

curbsidePickup

boolean

Указывает, поддерживает ли компания самовывоз.

reservable

boolean

Указывает, поддерживает ли место резервирование.

servesBreakfast

boolean

Указывает, подают ли в заведении завтрак.

servesLunch

boolean

Указывает, подают ли в заведении обед.

servesDinner

boolean

Указывает, подают ли в заведении ужин.

servesBeer

boolean

Указывает, подают ли в заведении пиво.

servesWine

boolean

Указывает, подают ли в заведении вино.

servesBrunch

boolean

Указывает, подают ли в заведении поздние завтраки.

servesVegetarianFood

boolean

Указывает, подают ли в заведении вегетарианскую еду.

outdoorSeating

boolean

Место обеспечивает размещение на открытом воздухе.

liveMusic

boolean

Место обеспечивает живую музыку.

menuForChildren

boolean

В заведении есть детское меню.

servesCocktails

boolean

Место предлагает коктейли.

servesDessert

boolean

Место предлагает десерт.

servesCoffee

boolean

Место подают кофе.

goodForChildren

boolean

Место хорошее для детей.

allowsDogs

boolean

Место позволяет собакам.

restroom

boolean

Место имеет туалет.

goodForGroups

boolean

Место подходит для групп.

goodForWatchingSports

boolean

Место подходит для просмотра спортивных состязаний.

accessibilityOptions

object ( AccessibilityOptions )

Информация о возможностях доступности, предлагаемых местом.

pureServiceAreaBusiness

boolean

Указывает, является ли это место исключительно сферой обслуживания. Бизнес с чистой зоной обслуживания — это бизнес, который посещает клиентов или доставляет их напрямую, но не обслуживает клиентов по их служебному адресу. Например, такие предприятия, как клининговые услуги или сантехника. У этих компаний может не быть физического адреса или местоположения на Картах Google.

Локализованныйтекст

Локализованный вариант текста на определенном языке.

JSON-представление 
{
  "text": string,
  "languageCode": string
}
Поля
text

string

Локализованная строка на языке, соответствующем languageCode ниже.

languageCode

string

Языковой код текста 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

integer

Версия схемы PostalAddress . Это значение должно быть установлено на 0, что соответствует последней версии.

Все новые версии должны быть обратно совместимы со старыми версиями.

regionCode

string

Необходимый. CLDR-код региона страны/региона адреса. Это никогда не предполагается, и пользователь должен убедиться в правильности значения. Подробности см. на https://cldr.unicode.org/ и https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html . Пример: «CH» для Швейцарии.

languageCode

string

Необязательный. Код языка BCP-47 содержимого этого адреса (если известен). Часто это язык пользовательского интерфейса формы ввода или ожидается, что он будет соответствовать одному из языков, используемых в стране/регионе адреса, или их транслитерированным эквивалентам. Это может повлиять на форматирование в некоторых странах, но не имеет решающего значения для правильности данных и никогда не повлияет на проверку или другие операции, не связанные с форматированием.

Если это значение неизвестно, его следует опустить (вместо указания возможно неправильного значения по умолчанию).

Примеры: «ж-Хант», «джа», «джа-Латн», «ен».

postalCode

string

Необязательный. Почтовый индекс адреса. Не все страны используют или требуют наличия почтовых индексов, но там, где они используются, они могут вызвать дополнительную проверку других частей адреса (например, проверку штата или почтового индекса в США).

sortingCode

string

Необязательный. Дополнительный код сортировки для конкретной страны. В большинстве регионов это не используется. Там, где оно используется, значение представляет собой либо строку типа «CEDEX», за которой необязательно следует число (например, «CEDEX 7»), либо просто число, представляющее «код сектора» (Ямайка), «индикатор зоны доставки» (Малави) или «индикатор почтового отделения» (Кот-д'Ивуар).

administrativeArea

string

Необязательный. Высшее административное подразделение, используемое для почтовых адресов страны или региона. Например, это может быть штат, провинция, область или префектура. Для Испании это провинция, а не автономное сообщество (например, «Барселона», а не «Каталония»). Многие страны не используют административную зону в почтовых адресах. Например, в Швейцарии это место следует оставить незаселенным.

locality

string

Необязательный. Обычно относится к части адреса, посвященной городу или населенному пункту. Примеры: город в США, ИТ-коммуна, почтовый город Великобритании. В регионах мира, где населенные пункты не определены четко или не вписываются в эту структуру, оставьте locality пустым и используйте addressLines .

sublocality

string

Необязательный. Сублокальность адреса. Например, это может быть район, район или район.

addressLines[]

string

Неструктурированные адресные строки, описывающие нижние уровни адреса.

Поскольку значения в addressLines не содержат информации о типе и иногда могут содержать несколько значений в одном поле (например, «Остин, Техас»), важно, чтобы порядок строк был ясен. Порядок адресных строк должен быть «порядком конверта» для страны или региона адреса. В местах, где это может варьироваться (например, в Японии), address_language используется, чтобы сделать его явным (например, «ja» для упорядочения от большого к меньшему и «ja-Latn» или «en» для малого к большому). Таким образом, в зависимости от языка можно выбрать наиболее конкретную строку адреса.

Минимально допустимое структурное представление адреса состоит из regionCode со всей остальной информацией, помещенной в addressLines . Можно было бы очень приблизительно отформатировать такой адрес без геокодирования, но никакие семантические рассуждения не могли быть сделаны ни о каком из компонентов адреса, пока он не был хотя бы частично решен.

Создание адреса, содержащего только regionCode и addressLines , а затем геокодирование — рекомендуемый способ обработки полностью неструктурированных адресов (в отличие от угадывания, какие части адреса должны быть населенными пунктами или административными областями).

recipients[]

string

Необязательный. Получатель по адресу. Это поле может при определенных обстоятельствах содержать многострочную информацию. Например, он может содержать информацию об уходе.

organization

string

Необязательный. Название организации по адресу.

Адресный компонент

Структурированные компоненты, формирующие форматированный адрес, если эта информация доступна.

JSON-представление 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Поля
longText

string

Полное текстовое описание или имя компонента адреса. Например, компонент адреса для страны Австралия может иметь длинное_имя «Австралия».

shortText

string

Сокращенное текстовое имя компонента адреса, если оно доступно. Например, компонент адреса для страны Австралия может иметь короткое_имя «AU».

types[]

string

Массив, указывающий тип(ы) компонента адреса.

languageCode

string

Язык, используемый для форматирования этих компонентов, в нотации CLDR.

ПлюсКод

Плюс-код ( http://plus.codes ) — это ссылка на местоположение в двух форматах: глобальный код, определяющий прямоугольник размером 14 x 14 м (1/8000 градуса) или меньше, и составной код, заменяющий префикс на ссылку на местоположение.

JSON-представление 
{
  "globalCode": string,
  "compoundCode": string
}
Поля
globalCode

string

Глобальный (полный) код места, например «9FWM33GV+HQ», представляющий площадь 1/8000 на 1/8000 градусов (~ 14 на 14 метров).

compoundCode

string

Составной код места, например «33GV+HQ, Рамберг, Норвегия», содержащий суффикс глобального кода и заменяющий префикс форматированным именем ссылочного объекта.

ШиротаДлительность

Объект, представляющий пару широты и долготы. Это выражается в виде пары двойных чисел, обозначающих градусы широты и градусы долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в пределах нормализованных диапазонов.

JSON-представление 
{
  "latitude": number,
  "longitude": number
}
Поля
latitude

number

Широта в градусах. Оно должно находиться в диапазоне [-90,0, +90,0].

longitude

number

Долгота в градусах. Оно должно находиться в диапазоне [-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 (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Поля
low

object ( LatLng )

Необходимый. Нижняя точка смотрового окна.

high

object ( LatLng )

Необходимый. Самая высокая точка смотрового окна.

Обзор

Информация об отзыве о месте.

JSON-представление 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string,
  "flagContentUri": string,
  "googleMapsUri": string
}
Поля
name

string

Ссылка, представляющая этот обзор места, которую можно использовать для повторного поиска этого обзора места (также называемая именем «ресурса» API: places/{placeId}/reviews/{review} ).

relativePublishTimeDescription

string

Строка форматированного недавнего времени, выражающая время просмотра относительно текущего времени в форме, соответствующей языку и стране.

text

object ( LocalizedText )

Локализованный текст обзора.

originalText

object ( LocalizedText )

Текст обзора на языке оригинала.

rating

number

Число от 1,0 до 5,0, также называемое количеством звезд.

authorAttribution

object ( AuthorAttribution )

Автор этого обзора.

publishTime

string ( Timestamp format)

Временная метка проверки.

Использует RFC 3339, где генерируемые выходные данные всегда будут Z-нормализованы и используют 0, 3, 6 или 9 дробных цифр. Также принимаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

flagContentUri

string

Ссылка, по которой пользователи могут сообщить о проблеме с обзором.

googleMapsUri

string

Ссылка для показа обзора на Google Maps.

Автор Атрибуция

Информация об авторе данных пользовательского контента. Используется в Photo и Review .

JSON-представление 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
Поля
displayName

string

Имя автора Photo или Review .

uri

string

URI автора Photo или Review .

photoUri

string

URI фотографии профиля автора Photo или Review .

Часы работы

Информация о времени работы места.

JSON-представление 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
Поля
periods[]

object ( Period )

Периоды, когда это место открыто в течение недели. Периоды расположены в хронологическом порядке, начиная с воскресенья в местном часовом поясе. Пустое (но не отсутствующее) значение указывает на место, которое никогда не открыто, например, потому что оно временно закрыто на ремонт.

weekdayDescriptions[]

string

Локализованные строки, описывающие часы работы этого заведения, по одной строке на каждый день недели. Будет пустым, если часы неизвестны или их невозможно преобразовать в локализованный текст. Пример: «Вс: 18:00–06:00».

secondaryHoursType

enum ( SecondaryHoursType )

Строка типа, используемая для определения типа дополнительных часов.

specialDays[]

object ( SpecialDay )

Структурированная информация для особых дней, попадающих в период, охватываемый возвращенными часами работы. Особые дни — это дни, которые могут повлиять на часы работы заведения, например Рождество. Установите значения currentOpeningHours и currentSecondaryOpeningHours, если есть исключительные часы.

nextOpenTime

string ( Timestamp format)

В следующий раз текущий период работы начнется через 7 дней в будущем. Это поле заполняется только в том случае, если период часов работы не активен на момент обслуживания запроса.

Использует RFC 3339, где генерируемые выходные данные всегда будут Z-нормализованы и используют 0, 3, 6 или 9 дробных цифр. Также принимаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

nextCloseTime

string ( Timestamp format)

В следующий раз текущий период работы закончится через 7 дней в будущем. Это поле заполняется только в том случае, если период часов работы активен на момент обслуживания запроса.

Использует RFC 3339, где генерируемые выходные данные всегда будут нормализованы по Z и используют 0, 3, 6 или 9 дробных цифр. Также принимаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

openNow

boolean

Активен ли период часов работы в данный момент. Для обычных часов работы и текущих часов работы это поле означает, открыто ли заведение. Для дополнительных часов работы и текущих дополнительных часов работы это поле означает, активны ли дополнительные часы этого места.

Период

Некоторое время место остается в статусе openNow.

JSON-представление 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
Поля
open

object ( Point )

Время, когда место начинает открываться.

close

object ( Point )

Время, когда место начинает закрываться.

Точка

Точки изменения статуса.

JSON-представление 
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
Поля
date

object ( Date )

Дата в местном часовом поясе места.

truncated

boolean

Была ли эта конечная точка усечена или нет. Усечение происходит, когда реальные часы выходят за рамки времени, между которым мы готовы вернуть часы, поэтому мы усекаем часы обратно до этих границ. Это гарантирует возврат не более 24*7 часов с полуночи дня запроса.

day

integer

День недели в виде целого числа в диапазоне 0–6. 0 — воскресенье, 1 — понедельник и т. д.

hour

integer

Час в 24-часовом формате. Диапазон от 0 до 23.

minute

integer

Минута. Диапазон от 0 до 59.

Дата

Представляет полную или частичную календарную дату, например день рождения. Время суток и часовой пояс либо указаны в другом месте, либо не имеют значения. Дата указана по григорианскому календарю. Это может представлять собой одно из следующих действий:

  • Полная дата с ненулевыми значениями года, месяца и дня.
  • Месяц и день с нулевым годом (например, годовщина).
  • Год сам по себе, с нулевым месяцем и нулевым днем.
  • Год и месяц с нулевым днем ​​(например, дата истечения срока действия кредитной карты).

Связанные типы:

JSON-представление 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Поля
year

integer

Год даты. Должно быть от 1 до 9999 или 0, чтобы указать дату без года.

month

integer

Месяц года. Должно быть от 1 до 12 или 0, чтобы указать год без месяца и дня.

day

integer

День месяца. Должно быть от 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)
  }
}
Поля
date

object ( Date )

Дата этого особенного дня.

Часовой пояс

Представляет часовой пояс из базы данных часовых поясов IANA .

JSON-представление 
{
  "id": string,
  "version": string
}
Поля
id

string

Часовой пояс IANA Часовой пояс базы данных. Например, «Америка/Нью_Йорк».

version

string

Необязательный. Номер версии базы данных часовых поясов IANA. Например «2019а».

Фото

Информация о фотографии места.

JSON-представление 
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ],
  "flagContentUri": string,
  "googleMapsUri": string
}
Поля
name

string

Идентификатор. Ссылка, представляющая фотографию этого места, которую можно использовать для повторного поиска этой фотографии (также называемой именем «ресурса» API: places/{placeId}/photos/{photo} ).

widthPx

integer

Максимально доступная ширина в пикселях.

heightPx

integer

Максимально доступная высота в пикселях.

authorAttributions[]

object ( AuthorAttribution )

Авторы этой фотографии.

flagContentUri

string

Ссылка, по которой пользователи могут сообщить о проблеме с фотографией.

googleMapsUri

string

Ссылка для показа фотографии на Google Maps.

Бизнес-статус

Деловой статус места.

Перечисления
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

string

Имя поставщика данных места.

providerUri

string

URI поставщика данных места.

Варианты оплаты

Варианты оплаты, которые принимает место.

JSON-представление 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
Поля
acceptsCreditCards

boolean

Place принимает к оплате кредитные карты.

acceptsDebitCards

boolean

Place принимает к оплате дебетовые карты.

acceptsCashOnly

boolean

Место принимает к оплате только наличные. Места с этим атрибутом по-прежнему могут принимать другие способы оплаты.

acceptsNfc

boolean

Место принимает платежи NFC.

Варианты парковки

Информация о вариантах парковки на месте. Парковка может поддерживать более одного варианта одновременно.

JSON-представление 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Поля
freeParkingLot

boolean

Место предлагает бесплатные парковки.

paidParkingLot

boolean

Место предлагает платные парковки.

freeStreetParking

boolean

В отеле Place имеется бесплатная уличная парковка.

paidStreetParking

boolean

Place предлагает платную уличную парковку.

valetParking

boolean

Место предлагает услуги парковщика.

freeGarageParking

boolean

В отеле Place имеется бесплатная парковка в гараже.

paidGarageParking

boolean

Место предлагает платную парковку в гараже.

Подпункт назначения

Подпункты назначения — это конкретные места, связанные с основным местом. Они предоставляют более конкретные пункты назначения для пользователей, которые выполняют поиск в большом или сложном месте, например в аэропорту, национальном парке, университете или стадионе. Например, подпункты назначения в аэропорту могут включать соответствующие терминалы и парковки. Подпункты назначения возвращают идентификатор места и имя ресурса места, которые можно использовать в последующих запросах сведений о месте (новое) для получения более подробной информации, включая отображаемое имя и местоположение подпункта назначения.

JSON-представление 
{
  "name": string,
  "id": string
}
Поля
name

string

Имя ресурса подпункта назначения.

id

string

Идентификатор места подпункта назначения.

Параметры доступности

Информация о возможностях доступности, предлагаемых местом.

JSON-представление 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
Поля
wheelchairAccessibleParking

boolean

В отеле Place есть парковка, оборудованная для гостей на инвалидных креслах.

wheelchairAccessibleEntrance

boolean

Места имеют вход для инвалидов-колясочников.

wheelchairAccessibleRestroom

boolean

Здесь есть туалет, оборудованный для гостей на инвалидных креслах.

wheelchairAccessibleSeating

boolean

Место имеет места для гостей на инвалидных креслах.

Варианты топлива

Самая свежая информация о вариантах топлива на АЗС. Эта информация регулярно обновляется.

JSON-представление 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
Поля
fuelPrices[]

object ( FuelPrice )

Последняя известная цена на топливо для каждого вида топлива, которое есть на этой заправке. Для каждого типа топлива на этой заправке имеется одна запись. Порядок не важен.

ТопливоЦена

Информация о ценах на топливо для данного типа.

JSON-представление 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
Поля
type

enum ( FuelType )

Тип топлива.

price

object ( Money )

Цена топлива.

updateTime

string ( Timestamp format)

Время последнего обновления цены на топливо.

Использует RFC 3339, где генерируемые выходные данные всегда будут Z-нормализованы и используют 0, 3, 6 или 9 дробных цифр. Также принимаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

Тип топлива

Виды топлива.

Перечисления
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

string

Трехбуквенный код валюты, определенный в ISO 4217.

units

string ( int64 format)

Целые единицы суммы. Например, если currencyCode равен "USD" , то 1 единица равна одному доллару США.

nanos

integer

Количество нано (10^-9) единиц суммы. Значение должно находиться в диапазоне от -999 999 999 до +999 999 999 включительно. Если units положительны, nanos должен быть положительным или нулевым. Если units равны нулю, nanos может быть положительным, нулевым или отрицательным. Если units измерения отрицательные, nanos должно быть отрицательным или нулевым. Например, -1,75 доллара США представлены как units = -1 и nanos = -750 000 000.

EVChargeOptions

Информация о станции зарядки электромобилей, размещенной на месте. Терминология соответствует https://afdc.energy.gov/fuels/electricity_infrastructure.html Один порт может заряжать один автомобиль за раз. Один порт имеет один или несколько разъемов. Одна станция имеет один или несколько портов.

JSON-представление 
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
Поля
connectorCount

integer

Количество разъемов на этой станции. Однако, поскольку некоторые порты могут иметь несколько разъемов, но одновременно могут заряжать только одну машину (например), количество разъемов может превышать общее количество автомобилей, которые могут заряжаться одновременно.

connectorAggregation[]

object ( ConnectorAggregation )

Список совокупностей разъемов для зарядки электромобилей, которые содержат разъемы одного типа и с одинаковой скоростью зарядки.

КоннекторАгрегация

Информация о зарядке электромобилей сгруппирована по [type, maxChargeRateKw]. Показывает совокупный заряд электромобилей для разъемов одного типа и максимальной скорости зарядки в кВт.

JSON-представление 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
Поля
type

enum ( EVConnectorType )

Тип соединителя этого агрегата.

maxChargeRateKw

number

Статическая максимальная скорость зарядки в кВт для каждого разъема в совокупности.

count

integer

Количество соединителей в этом агрегировании.

availabilityLastUpdateTime

string ( Timestamp format)

Отметка времени последнего обновления информации о доступности соединителя в этом агрегировании.

Использует RFC 3339, где генерируемые выходные данные всегда будут Z-нормализованы и используют 0, 3, 6 или 9 дробных цифр. Также принимаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

availableCount

integer

Количество соединителей в этом агрегировании, доступных на данный момент.

outOfServiceCount

integer

Количество соединителей в этом агрегировании, которые в настоящее время не обслуживаются.

Тип 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. Часто называют МЕННЕКЕС.
EV_CONNECTOR_TYPE_CHADEMO Разъем типа CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Комбинированная система зарядки (переменный и постоянный ток). На основе SAE. Разъем типа 1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 Комбинированная система зарядки (переменный и постоянный ток). На основе разъема Mennekes типа 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 (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Поля
overview

object ( LocalizedText )

Обзор места.

overviewFlagContentUri

string

Ссылка, по которой пользователи могут сообщить о проблеме в обзорной сводке.

disclosureText

object ( LocalizedText )

Сообщение о раскрытии информации ИИ «Обобщено с Близнецами» (и его локализованные варианты). Это будет на языке, указанном в запросе, если он доступен.

СодержащееМесто

Информация о месте, в котором это место находится.

JSON-представление 
{
  "name": string,
  "id": string
}
Поля
name

string

Ресурсное имя места, в котором находится это место.

id

string

Идентификатор места, в котором находится это место.

Адресдескриптор

Реляционное описание местоположения. Включает ранжированный набор близлежащих ориентиров, а также точные области сдерживания и их взаимосвязь с целевым местоположением.

JSON-представление 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
Поля
landmarks[]

object ( Landmark )

Ранжированный список близлежащих достопримечательностей. Самые узнаваемые и близлежащие достопримечательности занимают первое место.

areas[]

object ( Area )

Ранжированный список содержащих или прилегающих территорий. Наиболее узнаваемые и точные области занимают первое место.

Ориентир

Основная информация об ориентире и его связь с целевым местоположением.

Ориентиры — это заметные места, которые можно использовать для описания местоположения.

JSON-представление 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
Поля
name

string

Имя ресурса ориентира.

placeId

string

Идентификатор места достопримечательности.

displayName

object ( LocalizedText )

Отображаемое название ориентира.

types[]

string

Набор тегов типа для этого ориентира. Полный список возможных значений см. на странице https://developers.google.com/maps/documentation/places/web-service/place-types .

spatialRelationship

enum ( SpatialRelationship )

Определяет пространственное соотношение между целевым местоположением и ориентиром.

straightLineDistanceMeters

number

Расстояние по прямой линии в метрах между центральной точкой цели и центральной точкой ориентира. В некоторых ситуациях это значение может быть длиннее, чем travelDistanceMeters .

travelDistanceMeters

number

Расстояние перемещения по дорожной сети в метрах от цели до ориентира, если оно известно. Это значение не учитывает способ передвижения, например ходьба, вождение автомобиля или езда на велосипеде.

ПространственныеОтношения

Определяет пространственное соотношение между целевым местоположением и ориентиром.

Перечисления
NEAR Это отношение по умолчанию, когда не применимо ничего более конкретного, указанного ниже.
WITHIN Ориентир имеет пространственную геометрию и цель находится в его пределах.
BESIDE Цель находится непосредственно рядом с ориентиром.
ACROSS_THE_ROAD Цель находится прямо напротив ориентира на другой стороне дороги.
DOWN_THE_ROAD На том же маршруте, что и ориентир, но не сбоку и не поперек.
AROUND_THE_CORNER Не по тому же маршруту, что и достопримечательность, а в одном повороте.
BEHIND Рядом со структурой достопримечательности, но дальше от входов с улицы.

Область

Информация о районе и его связь с целевым местоположением.

Районы включают в себя точные сублокации, кварталы и крупные соединения, которые полезны для описания местоположения.

JSON-представление 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
Поля
name

string

Имя ресурса области.

placeId

string

Идентификатор места в этом районе.

displayName

object ( LocalizedText )

Отображаемое имя области.

containment

enum ( Containment )

Определяет пространственное отношение между целевым местоположением и областью.

Сдерживание

Определяет пространственное отношение между целевым местоположением и областью.

Перечисления
CONTAINMENT_UNSPECIFIED Содержание не указано.
WITHIN Целевое местоположение находится в пределах области, недалеко от центра.
OUTSKIRTS Целевое местоположение находится внутри области области, близко к краю.
NEAR Целевое местоположение находится за пределами данного региона, но близко.

Диапазон цен

Диапазон цен, связанный с местом. endPrice может быть не установлен, что указывает на диапазон без верхней границы (например, «Более 100 долларов США»).

JSON-представление 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
Поля
startPrice

object ( Money )

Нижний предел ценового диапазона (включительно). Цена должна быть равна этой сумме или превышать ее.

endPrice

object ( Money )

Высший ценовой диапазон (эксклюзив). Цена должна быть ниже этой суммы.

ОБЗОР

АИ-сгенерированная сводка места с использованием обзоров пользователей.

JSON-представление 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Поля
text

object ( LocalizedText )

Сводка обзоров пользователей.

flagContentUri

string

Ссылка, где пользователи могут пометить проблему с резюме.

disclosureText

object ( LocalizedText )

Сообщение раскрытия ИИ «суммировано с Близнецами» (и его локализованные варианты). Это будет на языке, указанном в запросе, если будет доступно.

Evargeamenitysummary

Краткое изложение удобств возле зарядной станции EV. Это относится только к местам с типом electric_vehicle_charging_station . Поле overview гарантированно будет предоставлено, в то время как другие поля являются необязательными.

JSON-представление 
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Поля
overview

object ( ContentBlock )

Обзор доступных удобств. Это гарантированно будет предоставлено.

coffee

object ( ContentBlock )

Краткое изложение ближайших вариантов кофе.

restaurant

object ( ContentBlock )

Краткое изложение близлежащих ресторанов.

store

object ( ContentBlock )

Краткое изложение близлежащих заправочных станций.

flagContentUri

string

Ссылка, где пользователи могут пометить проблему с резюме.

disclosureText

object ( LocalizedText )

Сообщение раскрытия ИИ «суммировано с Близнецами» (и его локализованные варианты). Это будет на языке, указанном в запросе, если будет доступно.

ContentBlock

Блок контента, который можно подавать индивидуально.

JSON-представление 
{
  "content": {
    object (LocalizedText)
  },
  "referencedPlaces": [
    string
  ]
}
Поля
content

object ( LocalizedText )

Контент, связанный с темой.

referencedPlaces[]

string

Список названий ресурсов указанных мест. Это имя можно использовать в других API, которые принимают имена ресурсов места.

Соседство

Краткое изложение интересующих точек возле места.

JSON-представление 
{
  "overview": {
    object (ContentBlock)
  },
  "description": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Поля
overview

object ( ContentBlock )

Обзор резюме района.

description

object ( ContentBlock )

Подробное описание района.

flagContentUri

string

Ссылка, где пользователи могут пометить проблему с резюме.

disclosureText

object ( LocalizedText )

Сообщение раскрытия ИИ «суммировано с Близнецами» (и его локализованные варианты). Это будет на языке, указанном в запросе, если будет доступно.

Методы

autocomplete

 Возвращает прогнозы для данного ввода.

get

 Получите детали места на основе его имени ресурса, которое является строкой в ​​формате places/{place_id} .

searchNearby

 Ищите места рядом с местами.

searchText

 Поиск на основе текстовых запросов.