Package google.maps.places.v1

Индекс

Места

Определение сервиса для API Places. Примечание: для каждого запроса (кроме запросов Autocomplete и GetPhotoMedia) требуется маска поля, заданная вне протокола запроса ( all/* не предполагается). Маску поля можно задать через HTTP-заголовок X-Goog-FieldMask . См.: https://developers.google.com/maps/documentation/places/web-service/choose-fields

Автозаполнение мест

rpc AutocompletePlaces( AutocompletePlacesRequest ) returns ( AutocompletePlacesResponse )

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

Области авторизации

Требуется следующая область OAuth:

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia( GetPhotoMediaRequest ) returns ( PhotoMedia )

Получите фотоноситель со строкой ссылки на фотографию.

Области авторизации

Требуется следующая область OAuth:

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace( GetPlaceRequest ) returns ( Place )

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

Области авторизации

Требуется следующая область OAuth:

  • https://www.googleapis.com/auth/cloud-platform
Поиск рядом

rpc SearchNearby( SearchNearbyRequest ) returns ( SearchNearbyResponse )

Поиск мест вблизи локаций.

Области авторизации

Требуется следующая область OAuth:

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText( SearchTextRequest ) returns ( SearchTextResponse )

Поиск мест на основе текстового запроса.

Области авторизации

Требуется следующая область OAuth:

  • https://www.googleapis.com/auth/cloud-platform

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

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

Поля
landmarks[]

Landmark

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

areas[]

Area

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

Область

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

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

Поля
name

string

Название ресурса области.

place_id

string

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

display_name

LocalizedText

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

containment

Containment

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

Сдерживание

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

Перечисления
CONTAINMENT_UNSPECIFIED Условия сдерживания не определены.
WITHIN Местоположение объекта находится в пределах района, недалеко от центра.
OUTSKIRTS Местоположение цели находится в пределах области, близко к краю.
NEAR Местоположение объекта находится за пределами региона, но поблизости.

Достопримечательность

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

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

Поля
name

string

Название ресурса достопримечательности.

place_id

string

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

display_name

LocalizedText

Отображаемое название достопримечательности.

types[]

string

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

spatial_relationship

SpatialRelationship

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

straight_line_distance_meters

float

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

travel_distance_meters

float

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

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

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

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

Авторство

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

Поля
display_name

string

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

uri

string

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

photo_uri

string

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

AutocompletePlacesRequest

Запросить прототип для AutocompletePlaces.

Поля
input

string

Обязательно. Текстовая строка для поиска.

location_bias

LocationBias

Необязательно. Смещение результатов в указанное место.

Следует задать максимум один из параметров location_bias или location_restriction . Если ни один из них не задан, результаты будут смещены по IP-адресу, то есть IP-адрес будет сопоставлен с неточным местоположением и использован в качестве сигнала смещения.

location_restriction

LocationRestriction

Необязательно. Ограничьте результаты указанным местоположением.

Следует задать максимум один из параметров location_bias или location_restriction . Если ни один из них не задан, результаты будут смещены по IP-адресу, то есть IP-адрес будет сопоставлен с неточным местоположением и использован в качестве сигнала смещения.

included_primary_types[]

string

Необязательно. Включен основной тип места (например, «ресторан» или «заправочная станция») в типы мест ( https://developers.google.com/maps/documentation/places/web-service/place-types) или только (regions) или только (cities) . Место возвращается только в том случае, если его основной тип включен в этот список. Можно указать до 5 значений. Если типы не указаны, возвращаются все типы мест.

included_region_codes[]

string

Необязательно. Включать результаты только в указанных регионах, заданных как до 15 двухсимвольных кодов регионов CLDR. Пустой набор не ограничивает результаты. Если заданы оба location_restriction и included_region_codes , результаты будут расположены в области пересечения.

language_code

string

Необязательно. Язык, на котором возвращаются результаты. По умолчанию — en-US. Результаты могут быть на смешанных языках, если язык, используемый во input , отличается от language_code или если возвращаемое место не имеет перевода с локального языка на language_code .

region_code

string

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

origin

LatLng

Необязательно. Начальная точка, от которой рассчитывается геодезическое расстояние до пункта назначения (возвращается как distance_meters ). Если это значение пропущено, геодезическое расстояние не будет возвращено.

input_offset

int32

Необязательно. Смещение символа Unicode, начинающееся с нуля, указывает позицию курсора в input input Положение курсора может влиять на возвращаемые прогнозы.

Если пусто, по умолчанию используется длина input .

include_query_predictions

bool

Необязательно. Если true, ответ будет включать как прогнозы по месту, так и по запросу. В противном случае ответ будет содержать только прогнозы по месту.

session_token

string

Необязательная строка. Строка, идентифицирующая сеанс автозаполнения для выставления счетов. Должна представлять собой строку в формате base64, безопасную для URL и имени файла, длиной не более 36 символов ASCII. В противном случае возвращается ошибка INVALID_ARGUMENT.

Сеанс начинается с того, что пользователь начинает вводить запрос, и завершается выбором места и вызовом функции проверки сведений о месте или адреса. В каждом сеансе может быть несколько запросов, за которыми следует один запрос на проверку сведений о месте или адреса. Учётные данные, используемые для каждого запроса в рамках сеанса, должны принадлежать одному проекту Google Cloud Console. После завершения сеанса токен становится недействительным; ваше приложение должно генерировать новый токен для каждого сеанса. Если параметр session_token пропущен или вы повторно используете токен сеанса, сеанс тарифицируется так, как если бы токен сеанса не предоставлялся (каждый запрос оплачивается отдельно).

Мы рекомендуем следующие рекомендации:

  • Используйте токены сеанса для всех вызовов Place Autocomplete.
  • Генерируйте новый токен для каждого сеанса. Рекомендуется использовать UUID версии 4.
  • Убедитесь, что учетные данные, используемые для всех запросов Place Autocomplete, Place Details и Address Validation в рамках сеанса, принадлежат одному и тому же проекту Cloud Console.
  • Обязательно передавайте уникальный токен сеанса для каждого нового сеанса. Использование одного и того же токена для нескольких сеансов приведёт к тому, что каждый запрос будет оплачиваться отдельно.
include_pure_service_area_businesses

bool

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

МестоположениеBias

Регион поиска. Результаты могут быть смещены относительно указанного региона.

Поля

type поля «Союз».

type может быть только одним из следующих:

rectangle

Viewport

Область просмотра, определяемая северо-восточным и юго-западным углом.

circle

Circle

Окружность, определяемая центральной точкой и радиусом.

МестоположениеОграничение

Регион поиска. Результаты будут ограничены указанным регионом.

Поля

type поля «Союз».

type может быть только одним из следующих:

rectangle

Viewport

Область просмотра, определяемая северо-восточным и юго-западным углом.

circle

Circle

Окружность, определяемая центральной точкой и радиусом.

AutocompletePlacesResponse

Прототип ответа для AutocompletePlaces.

Поля
suggestions[]

Suggestion

Содержит список предложений, упорядоченных в порядке убывания релевантности.

Предположение

Результат предложения автозаполнения.

Поля

kind поля Союза.

kind может быть только одним из следующих:

place_prediction

PlacePrediction

Прогноз для Места.

query_prediction

QueryPrediction

Прогноз для запроса.

ФорматируемыйТекст

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

Поля
text

string

Текст, который можно использовать как есть или отформатировать с помощью matches .

matches[]

StringRange

Список диапазонов строк, указывающих, где запрос ввода совпал с text . Эти диапазоны можно использовать для форматирования отдельных частей text . Подстроки могут не совпадать с input в точности, если совпадение определялось по критериям, отличным от соответствия строк (например, исправление орфографии или транслитерация).

Эти значения представляют собой смещения символов Unicode в text . Диапазоны гарантированно упорядочены по возрастанию значений смещения.

PlacePrediction

Результаты прогнозирования для функции автозаполнения места.

Поля
place

string

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

place_id

string

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

text

FormattableText

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

Рекомендуется использовать text для разработчиков, желающих отобразить один элемент пользовательского интерфейса. Разработчики, желающие отобразить два отдельных, но связанных элемента пользовательского интерфейса, могут использовать structured_format . Это два разных способа представления прогноза места. Пользователям не следует пытаться преобразовать structured_format в text и наоборот.

Этот текст может отличаться от display_name , возвращаемого GetPlace.

Может быть на смешанных языках, если input данные запроса и language_code указаны на разных языках или если у места нет перевода с местного языка на language_code .

structured_format

StructuredFormat

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

structured_format рекомендуется разработчикам, желающим отобразить два отдельных, но связанных элемента пользовательского интерфейса. Разработчики, желающие отобразить один элемент пользовательского интерфейса, могут использовать text . Это два разных способа представления прогноза места. Пользователям не следует пытаться преобразовать structured_format в text и наоборот.

types[]

string

Список типов, которые применяются к этому месту из таблицы A или таблицы B в https://developers.google.com/maps/documentation/places/web-service/place-types .

Тип — это категоризация места. Места с общими типами будут иметь схожие характеристики.

distance_meters

int32

Длина геодезической линии в метрах от origin если origin указана. Некоторые прогнозы, например, маршруты, могут не содержать это поле.

ЗапросПредсказание

Результаты прогнозирования для прогноза автозаполнения запроса.

Поля
text

FormattableText

Прогнозируемый текст. Этот текст не представляет место, а представляет собой текстовый запрос, который можно использовать в конечной точке поиска (например, текстовый поиск).

Разработчикам, желающим отобразить один элемент пользовательского интерфейса, рекомендуется использовать text . Разработчикам, желающим отобразить два отдельных, но связанных элемента пользовательского интерфейса, рекомендуется использовать structured_format . Это два разных способа представления прогноза запроса. Пользователям не следует пытаться преобразовать structured_format в text и наоборот.

Могут быть на смешанных языках, если input данные запроса и language_code указаны на разных языках или если часть запроса не имеет перевода с локального языка на language_code .

structured_format

StructuredFormat

Разбивка прогноза запроса на основной текст, содержащий запрос, и вторичный текст, содержащий дополнительные неоднозначные признаки (например, город или регион).

structured_format рекомендуется разработчикам, желающим отобразить два отдельных, но связанных элемента пользовательского интерфейса. Разработчики, желающие отобразить один элемент пользовательского интерфейса, могут использовать text . Это два разных способа представления прогноза запроса. Пользователям не следует пытаться преобразовать structured_format в text и наоборот.

StringRange

Определяет подстроку в заданном тексте.

Поля
start_offset

int32

Смещение от нуля первого символа Unicode в строке (включительно).

end_offset

int32

Смещение от нуля последнего символа Unicode (исключая его).

СтруктурированныйФормат

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

Для прогнозов по месту основной текст содержит конкретное название места. Для прогнозов по запросу основной текст содержит сам запрос.

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

Поля
main_text

FormattableText

Представляет название места или запроса.

secondary_text

FormattableText

Представляет дополнительные неоднозначные признаки (например, город или регион) для дальнейшей идентификации места или уточнения запроса.

Круг

Окружность с центром в координатах LatLng и радиусом.

Поля
center

LatLng

Обязательно. Центральная широта и долгота.

Диапазон широты должен быть в пределах [-90,0, 90,0]. Диапазон долготы должен быть в пределах [-180,0, 180,0].

radius

double

Обязательно. Радиус измеряется в метрах. Радиус должен быть в диапазоне [0,0, 50000,0].

ContentBlock

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

Поля
content

LocalizedText

Контент, соответствующий теме.

referenced_places[]

string

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

ContextualContent

Экспериментальный: более подробную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

Контент, соответствующий контексту поиска места.

Поля
reviews[]

Review

Список отзывов об этом месте, соответствующих поисковому запросу.

photos[]

Photo

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

justifications[]

Justification

Экспериментальный: более подробную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

Обоснования места.

Обоснование

Экспериментальный: более подробную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

Обоснования места. Обоснования отвечают на вопрос, почему место может быть интересно конечному пользователю.

Поля

justification поля Союза.

justification может быть только одним из следующих:

review_justification

ReviewJustification

Экспериментальный: более подробную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

Экспериментальный: более подробную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

БизнесДоступностьАтрибутыОбоснование

Экспериментальный: см. https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative для получения более подробной информации. Обоснование BusinessAvailabilityAttributes. Здесь показаны некоторые характеристики компании, которые могут быть интересны конечному пользователю.

Поля
takeout

bool

Если в заведении можно заказать еду на вынос.

delivery

bool

Если место обеспечивает доставку.

dine_in

bool

Если в заведении есть возможность пообедать.

ОбзорОбоснование

Экспериментальный: более подробную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

Обоснование отзывов пользователей. Выделяет раздел отзыва, который может быть интересен конечному пользователю. Например, если поисковый запрос — «пицца на дровах», в обосновании отзыва выделяется текст, релевантный поисковому запросу.

Поля
highlighted_text

HighlightedText

review

Review

Обзор, на основе которого создан выделенный текст.

Выделенный текст

Текст, выделенный в обосновании. Это подмножество самого обзора. Точное слово, которое нужно выделить, отмечено в HighlightedTextRange. В выделенном тексте может быть несколько слов.

Поля
text

string

highlighted_text_ranges[]

HighlightedTextRange

Список диапазонов выделенного текста.

HighlightedTextRange

Диапазон выделенного текста.

Поля
start_index

int32

end_index

int32

EVChargeOptions

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

Поля
connector_count

int32

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

connector_aggregation[]

ConnectorAggregation

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

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

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

Поля
type

EVConnectorType

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

max_charge_rate_kw

double

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

count

int32

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

availability_last_update_time

Timestamp

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

available_count

int32

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

out_of_service_count

int32

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

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.

FuelOptions

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

Поля
fuel_prices[]

FuelPrice

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

FuelPrice

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

Поля
type

FuelType

Тип топлива.

price

Money

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

update_time

Timestamp

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

Тип топлива

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

Перечисления
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 Грузовой дизель.

GetPhotoMediaRequest

Запрос на получение фотографии места с использованием названия фоторесурса.

Поля
name

string

Обязательно. Имя ресурса фотоносителя в формате: places/{place_id}/photos/{photo_reference}/media .

Имя ресурса фотографии, возвращаемое в поле photos.name объекта Place, имеет формат places/{place_id}/photos/{photo_reference} . Чтобы получить имя ресурса медиафайла, необходимо добавить /media в конец имени ресурса фотографии.

max_width_px

int32

Необязательно. Указывает максимальную желаемую ширину изображения в пикселях. Если изображение меньше указанных значений, будет возвращено исходное изображение. Если изображение больше по одному из двух измерений, оно будет масштабировано до меньшего из двух измерений с сохранением исходного соотношения сторон. Свойства max_height_px и max_width_px принимают целые числа от 1 до 4800 включительно. Если значение выходит за пределы допустимого диапазона, будет возвращена ошибка INVALID_ARGUMENT.

Необходимо указать хотя бы один из параметров: max_height_px или max_width_px. Если не указаны ни max_height_px, ни max_width_px, будет возвращена ошибка INVALID_ARGUMENT.

max_height_px

int32

Необязательно. Указывает максимальную желаемую высоту изображения в пикселях. Если изображение меньше указанных значений, будет возвращено исходное изображение. Если изображение больше по одному из двух измерений, оно будет масштабировано до меньшего из двух измерений с сохранением исходного соотношения сторон. Свойства max_height_px и max_width_px принимают целые числа от 1 до 4800 включительно. Если значение выходит за пределы допустимого диапазона, будет возвращена ошибка INVALID_ARGUMENT.

Необходимо указать хотя бы один из параметров: max_height_px или max_width_px. Если не указаны ни max_height_px, ни max_width_px, будет возвращена ошибка INVALID_ARGUMENT.

skip_http_redirect

bool

Необязательно. Если установлено, пропускается HTTP-перенаправление по умолчанию и формируется ответ в текстовом формате (например, в формате JSON для HTTP-запроса). Если не установлено, будет выполнено HTTP-перенаправление для перенаправления вызова к медиафайлу с изображением. Этот параметр игнорируется для запросов, отличных от HTTP.

GetPlaceRequest

Запрос на выборку места на основе имени его ресурса, которое представляет собой строку в формате places/{place_id} .

Поля
name

string

Обязательно. Имя ресурса места в формате places/{place_id} .

language_code

string

Необязательно. Информация о месте будет отображаться на выбранном вами языке (если он доступен).

Текущий список поддерживаемых языков: https://developers.google.com/maps/faq#languagesupport .

region_code

string

Необязательный. Код страны/региона в формате Unicode (CLDR) местоположения, откуда поступил запрос. Этот параметр используется для отображения информации о месте, например, названия региона, если оно доступно. Этот параметр может влиять на результаты в зависимости от действующего законодательства. Подробнее см. https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html .

Обратите внимание, что трехзначные коды регионов в настоящее время не поддерживаются.

session_token

string

Необязательная строка. Строка, идентифицирующая сеанс автозаполнения для выставления счетов. Должна представлять собой строку в формате base64, безопасную для URL и имени файла, длиной не более 36 символов ASCII. В противном случае возвращается ошибка INVALID_ARGUMENT.

Сеанс начинается с того, что пользователь начинает вводить запрос, и завершается выбором места и вызовом функции проверки сведений о месте или адреса. В каждом сеансе может быть несколько запросов, за которыми следует один запрос на проверку сведений о месте или адреса. Учётные данные, используемые для каждого запроса в рамках сеанса, должны принадлежать одному проекту Google Cloud Console. После завершения сеанса токен становится недействительным; ваше приложение должно генерировать новый токен для каждого сеанса. Если параметр session_token пропущен или вы повторно используете токен сеанса, сеанс тарифицируется так, как если бы токен сеанса не предоставлялся (каждый запрос оплачивается отдельно).

Мы рекомендуем следующие рекомендации:

  • Используйте токены сеанса для всех вызовов Place Autocomplete.
  • Генерируйте новый токен для каждого сеанса. Рекомендуется использовать UUID версии 4.
  • Убедитесь, что учетные данные, используемые для всех запросов Place Autocomplete, Place Details и Address Validation в рамках сеанса, принадлежат одному и тому же проекту Cloud Console.
  • Обязательно передавайте уникальный токен сеанса для каждого нового сеанса. Использование одного и того же токена для нескольких сеансов приведёт к тому, что каждый запрос будет оплачиваться отдельно.

Фото

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

Поля
name

string

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

width_px

int32

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

height_px

int32

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

author_attributions[]

AuthorAttribution

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

flag_content_uri

string

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

google_maps_uri

string

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

ФотоМедиа

Фотоматериалы из Places API.

Поля
name

string

Имя ресурса фотоносителя в формате: places/{place_id}/photos/{photo_reference}/media .

photo_uri

string

Краткосрочный URI, который можно использовать для рендеринга фотографии.

Место

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

Поля
name

string

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

id

string

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

display_name

LocalizedText

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

types[]

string

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

primary_type

string

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

primary_type_display_name

LocalizedText

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

national_phone_number

string

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

international_phone_number

string

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

formatted_address

string

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

short_formatted_address

string

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

postal_address

PostalAddress

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

address_components[]

AddressComponent

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

plus_code

PlusCode

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

location

LatLng

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

viewport

Viewport

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

rating

double

Рейтинг от 1,0 до 5,0, основанный на отзывах пользователей об этом месте.

google_maps_uri

string

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

website_uri

string

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

reviews[]

Review

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

regular_opening_hours

OpeningHours

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

time_zone

TimeZone

Часовой пояс базы данных часовых поясов IANA. Например, «America/New_York».

photos[]

Photo

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

adr_format_address

string

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

business_status

BusinessStatus

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

price_level

PriceLevel

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

attributions[]

Attribution

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

icon_mask_base_uri

string

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

icon_background_color

string

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

current_opening_hours

OpeningHours

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

current_secondary_opening_hours[]

OpeningHours

Содержит массив записей на следующие семь дней, включая информацию о дополнительных часах работы предприятия. Дополнительные часы работы отличаются от основных. Например, ресторан может указать часы работы с выездом за рулём или часы доставки в качестве дополнительных часов работы. Это поле заполняет подполе «Тип», которое выбирается из предопределенного списка часов работы (например, «АВТО», «САМОВЫВОЗ» или «НА ВЫНОС») в зависимости от типа заведения. Это поле включает подполе «special_days» для всех часов работы, заданных для дат с особыми часами работы.

regular_secondary_opening_hours[]

OpeningHours

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

editorial_summary

LocalizedText

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

payment_options

PaymentOptions

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

parking_options

ParkingOptions

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

sub_destinations[]

SubDestination

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

fuel_options

FuelOptions

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

ev_charge_options

EVChargeOptions

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

generative_summary

GenerativeSummary

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

containing_places[]

ContainingPlace

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

address_descriptor

AddressDescriptor

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

price_range

PriceRange

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

review_summary

ReviewSummary

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

ev_charge_amenity_summary

EvChargeAmenitySummary

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

neighborhood_summary

NeighborhoodSummary

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

consumer_alert

ConsumerAlert

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

utc_offset_minutes

int32

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

user_rating_count

int32

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

takeout

bool

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

delivery

bool

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

dine_in

bool

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

curbside_pickup

bool

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

reservable

bool

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

serves_breakfast

bool

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

serves_lunch

bool

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

serves_dinner

bool

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

serves_beer

bool

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

serves_wine

bool

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

serves_brunch

bool

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

serves_vegetarian_food

bool

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

outdoor_seating

bool

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

live_music

bool

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

menu_for_children

bool

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

serves_cocktails

bool

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

serves_dessert

bool

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

serves_coffee

bool

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

good_for_children

bool

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

allows_dogs

bool

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

restroom

bool

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

good_for_groups

bool

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

good_for_watching_sports

bool

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

accessibility_options

AccessibilityOptions

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

pure_service_area_business

bool

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

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

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

Поля
wheelchair_accessible_parking

bool

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

wheelchair_accessible_entrance

bool

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

wheelchair_accessible_restroom

bool

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

wheelchair_accessible_seating

bool

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

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

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

Поля
long_text

string

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

short_text

string

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

types[]

string

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

language_code

string

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

Атрибуция

Информация о поставщиках данных этого места.

Поля
provider

string

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

provider_uri

string

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

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

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

Перечисления
BUSINESS_STATUS_UNSPECIFIED Значение по умолчанию. Это значение не используется.
OPERATIONAL Заведение работает, но не обязательно открыто сейчас.
CLOSED_TEMPORARILY Заведение временно закрыто.
CLOSED_PERMANENTLY Заведение закрыто навсегда.

ConsumerAlert

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

Поля
overview

string

Обзор предупреждающего сообщения для потребителей.

details

Details

Подробности предупреждающего сообщения для потребителей.ƒ

language_code

string

Языковой код предупреждающего сообщения для потребителя. Это языковой код BCP 47.

Подробности

Подробности предупреждающего сообщения для потребителей.

Поля
title

string

Название, которое будет отображаться вместе с описанием.

description

string

Описание предупреждающего сообщения для потребителя.

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

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

Поля
name

string

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

id

string

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

EvChargeУдобстваСводка

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

Поля
overview

ContentBlock

Обзор имеющихся удобств. Это гарантированно будет обеспечено.

coffee

ContentBlock

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

restaurant

ContentBlock

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

store

ContentBlock

Краткое описание ближайших магазинов.

flag_content_uri

string

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

disclosure_text

LocalizedText

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

ГенеративныйСводка

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

Поля
overview

LocalizedText

Обзор места.

overview_flag_content_uri

string

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

disclosure_text

LocalizedText

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

NeighborhoodСводка

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

Поля
overview

ContentBlock

Обзорный обзор района.

description

ContentBlock

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

flag_content_uri

string

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

disclosure_text

LocalizedText

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

Часы работы

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

Поля
periods[]

Period

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

День начала periods НЕ фиксирован, и его не следует считать воскресеньем. API определяет день начала на основе множества факторов. Например, для бизнеса, работающего круглосуточно и без выходных, первый период может начаться в день запроса. Для других предприятий это может быть первый день недели, когда они открыты.

ПРИМЕЧАНИЕ. Порядок массива periods не зависит от порядка массива weekday_descriptions . Не думайте, что они начнутся в один и тот же день.

weekday_descriptions[]

string

Локализованные строки, описывающие часы работы этого заведения, по одной строке на каждый день недели.

ПРИМЕЧАНИЕ. Порядок дней и начало недели определяются языковыми стандартами (языком и регионом). Порядок массива periods не зависит от порядка массива weekday_descriptions . Не думайте, что они начнутся в один и тот же день.

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

secondary_hours_type

SecondaryHoursType

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

special_days[]

SpecialDay

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

next_open_time

Timestamp

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

next_close_time

Timestamp

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

open_now

bool

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

Период

Период, в течение которого место остается в статусе open_now.

Поля
open

Point

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

close

Point

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

Точка

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

Поля
date

Date

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

truncated

bool

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

day

int32

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

hour

int32

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

minute

int32

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

Тип вторичных часов

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

Перечисления
SECONDARY_HOURS_TYPE_UNSPECIFIED Значение по умолчанию, если не указан дополнительный тип часа.
DRIVE_THROUGH Час проезда для банков, ресторанов или аптек.
HAPPY_HOUR Счастливый час.
DELIVERY Час доставки.
TAKEOUT Час на вынос.
KITCHEN Кухонный час.
BREAKFAST Час завтрака.
LUNCH Обеденный час.
DINNER Час ужина.
BRUNCH Час бранча.
PICKUP Час самовывоза.
ACCESS Время доступа к местам хранения.
SENIOR_HOURS Специальные часы для пожилых людей.
ONLINE_SERVICE_HOURS График работы онлайн-сервиса.

Специальный день

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

Поля
date

Date

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

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

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

Поля
free_parking_lot

bool

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

paid_parking_lot

bool

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

free_street_parking

bool

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

paid_street_parking

bool

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

valet_parking

bool

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

free_garage_parking

bool

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

paid_garage_parking

bool

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

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

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

Поля
accepts_credit_cards

bool

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

accepts_debit_cards

bool

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

accepts_cash_only

bool

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

accepts_nfc

bool

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

ПлюсКод

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

Поля
global_code

string

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

compound_code

string

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

ОбзорСводка

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

Поля
text

LocalizedText

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

flag_content_uri

string

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

disclosure_text

LocalizedText

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

reviews_uri

string

Ссылка для просмотра отзывов об этом месте на Картах Google.

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

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

Поля
name

string

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

id

string

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

Полилиния

Полилиния маршрута. Поддерживается только закодированная полилиния , которую можно передать как строку и которая включает сжатие с минимальными потерями. Это вывод API Routes по умолчанию.

Поля
Поле объединения polyline_type . Инкапсулирует тип полилинии. Выходные данные Routes API по умолчанию имеют значение encoded_polyline . polyline_type может быть только одним из следующих:
encoded_polyline

string

Закодированная ломаная линия , возвращаемая API маршрутов по умолчанию . См. инструменты кодирования и декодера .

PriceLevel

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

Перечисления
PRICE_LEVEL_UNSPECIFIED Уровень цен на место не указан или неизвестен.
PRICE_LEVEL_FREE Место предоставляет бесплатные услуги.
PRICE_LEVEL_INEXPENSIVE Место предоставляет недорогие услуги.
PRICE_LEVEL_MODERATE Место предоставляет услуги по умеренным ценам.
PRICE_LEVEL_EXPENSIVE Место предоставляет дорогие услуги.
PRICE_LEVEL_VERY_EXPENSIVE Место предоставляет очень дорогие услуги.

Диапазон цен

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

Поля
start_price

Money

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

end_price

Money

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

Обзор

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

Поля
name

string

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

relative_publish_time_description

string

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

text

LocalizedText

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

original_text

LocalizedText

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

rating

double

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

author_attribution

AuthorAttribution

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

publish_time

Timestamp

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

flag_content_uri

string

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

google_maps_uri

string

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

visit_date

Date

Дата, когда автор посетил это место. Это сокращено до месяца.

Модификаторы маршрута

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

Поля
avoid_tolls

bool

Необязательно. Если установлено значение true, платные дороги избегаются, где это возможно, отдавая предпочтение маршрутам, не содержащим платных дорог. Применяется только к DRIVE и TWO_WHEELER TravelMode .

avoid_highways

bool

Необязательно. Если установлено значение true, избегает шоссе, где это возможно, отдавая предпочтение маршрутам, не содержащим шоссе. Применяется только к DRIVE и TWO_WHEELER TravelMode .

avoid_ferries

bool

Необязательно. Если установлено значение true, паромы избегаются, где это возможно, отдавая предпочтение маршрутам, не содержащим паромов. Применяется только к режимам DRIVE и TWO_WHEELER TravelMode .

avoid_indoor

bool

Необязательно. Если установлено значение true, навигация в помещении избегается, где это возможно, отдавая предпочтение маршрутам, не содержащим навигацию в помещении. Применяется только к режиму WALK TravelMode .

Параметры маршрутизации

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

Поля
origin

LatLng

Необязательно. Явное начало маршрута, которое переопределяет начало координат, определенное в полилинии. По умолчанию используется начало полилинии.

travel_mode

TravelMode

Необязательно. Режим путешествия.

route_modifiers

RouteModifiers

Необязательно. Модификаторы маршрута.

routing_preference

RoutingPreference

Необязательно. Указывает, как вычислять сводки маршрутизации. Сервер пытается использовать выбранную настройку маршрутизации для расчета маршрута. Предпочтение маршрутизации с учетом трафика доступно только для DRIVE или TWO_WHEELER travelMode .

Настройки маршрутизации

Набор значений, которые определяют факторы, которые следует учитывать при расчете маршрута.

Перечисления
ROUTING_PREFERENCE_UNSPECIFIED Настройки маршрутизации не указаны. По умолчанию — TRAFFIC_UNAWARE .
TRAFFIC_UNAWARE Рассчитывает маршруты без учета условий движения в реальном времени. Подходит, когда условия дорожного движения не имеют значения или неприменимы. Использование этого значения обеспечивает минимальную задержку. Примечание. Для TravelMode DRIVE и TWO_WHEELER выбранный маршрут и продолжительность основаны на дорожной сети и средних условиях дорожного движения, не зависящих от времени, а не на текущих дорожных условиях. Следовательно, маршруты могут включать дороги, которые временно закрыты. Результаты для данного запроса могут меняться со временем из-за изменений в дорожной сети, обновленных средних условий дорожного движения и распределенного характера услуги. Результаты также могут различаться между почти эквивалентными маршрутами в любое время и частоту.
TRAFFIC_AWARE Рассчитывает маршруты с учетом условий движения в реальном времени. В отличие от TRAFFIC_AWARE_OPTIMAL , применяются некоторые оптимизации, позволяющие значительно сократить задержку.
TRAFFIC_AWARE_OPTIMAL Рассчитывает маршруты с учётом текущей дорожной ситуации, не применяя большинство оптимизаций производительности. Использование этого значения приводит к наибольшей задержке.

RoutingСводка

Продолжительность и расстояние от источника маршрутизации до места в ответе и второго участка от этого места до пункта назначения, если это запрошено. Примечание. Добавление routingSummaries в маску поля без включения в запрос параметра routingParameters.origin или searchAlongRouteParameters.polyline.encodedPolyline приводит к ошибке.

Поля
legs[]

Leg

Ноги путешествия.

Когда вы рассчитываете продолжительность путешествия и расстояние от заданного источника, legs содержат один этап, содержащий продолжительность и расстояние от источника до пункта назначения. Когда вы выполняете поиск по маршруту, legs содержат два участка: один от источника до места, а другой от места до пункта назначения.

directions_uri

string

Ссылка для отображения маршрутов на Картах Google с использованием путевых точек из данной сводки маршрутов. Маршрут, созданный по этой ссылке, не обязательно будет таким же, как маршрут, используемый для создания сводки маршрутизации. Ссылка использует информацию, предоставленную в запросе, из полей, включая routingParameters и searchAlongRouteParameters , когда это применимо, для создания ссылки направления.

Нога

Этап — это отдельная часть пути из одного места в другое.

Поля
duration

Duration

Время, необходимое для прохождения этого участка пути.

distance_meters

int32

Расстояние этого участка пути.

ПоискРядомЗапрос

Запросите прототип для поиска поблизости.

Поля
language_code

string

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

Текущий список поддерживаемых языков: https://developers.google.com/maps/faq#languagesupport .

region_code

string

Код страны/региона Unicode (CLDR) места, откуда поступает запрос. Этот параметр используется для отображения сведений о месте, например названия места для конкретного региона, если оно доступно. Параметр может повлиять на результаты в соответствии с действующим законодательством.

Для получения дополнительной информации см. https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html .

Обратите внимание, что трехзначные коды регионов в настоящее время не поддерживаются.

included_types[]

string

Включен тип места (например, «ресторан» или «заправочная станция») из https://developers.google.com/maps/documentation/places/web-service/place-types .

Можно указать до 50 типов из Таблицы А.

Если есть какие-либо конфликтующие типы, т. е. тип появляется как в включенных_типах, так и в исключенных_типах, возвращается ошибка INVALID_ARGUMENT.

Если тип места указан с несколькими ограничениями типа, возвращаются только места, удовлетворяющие всем ограничениям. Например, если у нас есть {included_types = ["restaurant"], Excluded_primary_types = ["restaurant"]}, возвращаемые места предоставляют услуги, связанные с "рестораном", но не работают в основном как "рестораны".

excluded_types[]

string

Исключен тип места (например, «ресторан» или «заправочная станция») из https://developers.google.com/maps/documentation/places/web-service/place-types .

Можно указать до 50 типов из Таблицы А.

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

Если есть какие-либо конфликтующие типы, т. е. тип появляется как в включенных_типах, так и в исключенных_типах, возвращается ошибка INVALID_ARGUMENT.

Если тип места указан с несколькими ограничениями типа, возвращаются только места, удовлетворяющие всем ограничениям. Например, если у нас есть {included_types = ["restaurant"], Excluded_primary_types = ["restaurant"]}, возвращаемые места предоставляют услуги, связанные с "рестораном", но не работают в основном как "рестораны".

included_primary_types[]

string

Включен основной тип места (например, «ресторан» или «заправочная станция») из https://developers.google.com/maps/documentation/places/web-service/place-types . Место может иметь только один основной тип из связанной с ним таблицы поддерживаемых типов.

Можно указать до 50 типов из Таблицы А.

Если существуют какие-либо конфликтующие первичные типы, т. е. тип появляется как в включенных_первичных_типах, так и в исключенных_первичных_типах, возвращается ошибка INVALID_ARGUMENT.

Если тип места указан с несколькими ограничениями типа, возвращаются только места, удовлетворяющие всем ограничениям. Например, если у нас есть {included_types = ["restaurant"], Excluded_primary_types = ["restaurant"]}, возвращаемые места предоставляют услуги, связанные с "рестораном", но не работают в основном как "рестораны".

excluded_primary_types[]

string

Исключен основной тип места (например, «ресторан» или «заправочная станция») из https://developers.google.com/maps/documentation/places/web-service/place-types .

Можно указать до 50 типов из Таблицы А.

Если существуют какие-либо конфликтующие первичные типы, т. е. тип появляется как в включенных_первичных_типах, так и в исключенных_первичных_типах, возвращается ошибка INVALID_ARGUMENT.

Если тип места указан с несколькими ограничениями типа, возвращаются только места, удовлетворяющие всем ограничениям. Например, если у нас есть {included_types = ["restaurant"], Excluded_primary_types = ["restaurant"]}, возвращаемые места предоставляют услуги, связанные с "рестораном", но не работают в основном как "рестораны".

max_result_count

int32

Максимальное количество возвращаемых результатов. Оно должно быть от 1 до 20 (по умолчанию) включительно. Если число не установлено, оно возвращается к верхнему пределу. Если число установлено отрицательным или превышает верхний предел, возвращается ошибка INVALID_ARGUMENT.

location_restriction

LocationRestriction

Обязательно. Регион для поиска.

rank_preference

RankPreference

Как результаты будут ранжироваться в ответе.

routing_parameters

RoutingParameters

Необязательно. Параметры, влияющие на маршрутизацию к результатам поиска.

Ограничение местоположения

Регион для поиска.

Поля

type поля объединения.

type может быть только одним из следующих:

circle

Circle

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

РангПредпочтение

Как результаты будут ранжироваться в ответе.

Перечисления
RANK_PREFERENCE_UNSPECIFIED Значение RankPreference не установлено. По умолчанию будет использоваться рейтинг по ПОПУЛЯРНОСТИ.
DISTANCE Ранжирует результаты по расстоянию.
POPULARITY Ранжирует результаты по популярности.

ПоискРядомОтвет

Прототип ответа на запрос «Поиск поблизости».

Поля
places[]

Place

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

routing_summaries[]

RoutingSummary

Список сводок маршрутизации, в котором каждая запись связана с соответствующим местом в том же индексе в поле places . Если сводка маршрутизации недоступна для одного из мест, она будет содержать пустую запись. В этом списке должно быть столько же записей, сколько и в списке мест, если это необходимо.

ПоискТекстЗапрос

Запросить прототип для SearchText.

Поля
text_query

string

Обязательно. Текстовый запрос для текстового поиска.

language_code

string

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

Текущий список поддерживаемых языков: https://developers.google.com/maps/faq#languagesupport .

region_code

string

Код страны/региона Unicode (CLDR) места, откуда поступает запрос. Этот параметр используется для отображения сведений о месте, например названия места для конкретного региона, если оно доступно. Параметр может повлиять на результаты в соответствии с действующим законодательством.

Для получения дополнительной информации см. https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html .

Обратите внимание, что трехзначные коды регионов в настоящее время не поддерживаются.

rank_preference

RankPreference

Как результаты будут ранжироваться в ответе.

included_type

string

Запрошенный тип места. Полный список поддерживаемых типов: https://developers.google.com/maps/documentation/places/web-service/place-types . Поддерживается только один включенный тип.

open_now

bool

Используется для ограничения поиска местами, которые в данный момент открыты. По умолчанию — ложь.

min_rating

double

Отфильтровывайте результаты, средний рейтинг пользователей которых строго меньше этого предела. Допустимое значение должно быть числом с плавающей запятой от 0 до 5 (включительно) с частотой 0,5, т. е. [0, 0,5, 1,0, ..., 5,0] включительно. Входной рейтинг округляется до ближайших 0,5 (потолок). Например, рейтинг 0,6 исключит все результаты с рейтингом менее 1,0.

max_result_count
(deprecated)

int32

Устарело: вместо этого используйте page_size .

Максимальное количество результатов на странице, которое может быть возвращено. Если количество доступных результатов превышает max_result_count , возвращается next_page_token , который можно передать в page_token для получения следующей страницы результатов в последующих запросах. Если указано 0 или значение отсутствует, используется значение по умолчанию 20. Максимальное значение — 20; значения выше 20 будут приведены к 20. Отрицательные значения вернут ошибку INVALID_ARGUMENT.

Если указаны и max_result_count , и page_size , max_result_count будет игнорироваться.

page_size

int32

Необязательно. Максимальное количество результатов на странице, которое может быть возвращено. Если количество доступных результатов больше, чем page_size , возвращается next_page_token , который можно передать в page_token , чтобы получить следующую страницу результатов в последующих запросах. Если указано 0 или значение отсутствует, используется значение по умолчанию 20. Максимальное значение — 20; значения выше 20 будут установлены на 20. Отрицательные значения вернут ошибку INVALID_ARGUMENT.

Если указаны и max_result_count , и page_size , max_result_count будет игнорироваться.

page_token

string

Необязательно. Токен страницы, полученный в результате предыдущего вызова TextSearch. Предоставьте это, чтобы получить следующую страницу.

При разбиении на страницы все параметры, кроме page_token , page_size и max_result_count , предоставленные TextSearch, должны соответствовать начальному вызову, который предоставил токен страницы. В противном случае возвращается ошибка INVALID_ARGUMENT.

price_levels[]

PriceLevel

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

strict_type_filtering

bool

Используется для установки строгой фильтрации типов для включенного_типа. Если установлено значение true, будут возвращены только результаты одного типа. По умолчанию — ложь.

location_bias

LocationBias

Регион для поиска. Это местоположение служит предвзятостью, что означает, что могут быть возвращены результаты вокруг данного местоположения. Невозможно установить вместе с location_restriction.

location_restriction

LocationRestriction

Регион для поиска. Это местоположение служит ограничением, которое означает, что результаты за пределами данного местоположения не будут возвращены. Невозможно установить вместе с location_bias.

ev_options

EVOptions

Необязательно. Установите доступные для поиска параметры EV запроса на поиск места.

routing_parameters

RoutingParameters

Необязательно. Дополнительные параметры для маршрутизации к результатам.

search_along_route_parameters

SearchAlongRouteParameters

Необязательно. Прото дополнительных параметров для поиска по маршруту.

include_pure_service_area_businesses

bool

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

EVOptions

Доступные для поиска параметры EV запроса на поиск места.

Поля
minimum_charging_rate_kw

double

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

connector_types[]

EVConnectorType

Необязательно. Список предпочтительных типов разъемов EV. Место, не поддерживающее ни один из перечисленных типов разъемов, отфильтровывается.

Предвзятость местоположения

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

Поля

type поля объединения.

type может быть только одним из следующих:

rectangle

Viewport

Прямоугольный блок, определяемый северо-восточным и юго-западным углами. rectangle.high() должен быть северо-восточной точкой области просмотра прямоугольника. rectangle.low() должен быть юго-западной точкой области просмотра прямоугольника. rectangle.low().latitude() не может быть больше rectangle.high().latitude() . Это приведет к появлению пустого диапазона широт. Прямоугольное окно просмотра не может быть шире 180 градусов.

circle

Circle

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

Ограничение местоположения

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

Поля

type поля объединения.

type может быть только одним из следующих:

rectangle

Viewport

Прямоугольный блок, определяемый северо-восточным и юго-западным углами. rectangle.high() должен быть северо-восточной точкой области просмотра прямоугольника. rectangle.low() должен быть юго-западной точкой области просмотра прямоугольника. rectangle.low().latitude() не может быть больше rectangle.high().latitude() . Это приведет к появлению пустого диапазона широт. Прямоугольное окно просмотра не может быть шире 180 градусов.

РангПредпочтение

Как результаты будут ранжироваться в ответе.

Перечисления
RANK_PREFERENCE_UNSPECIFIED Для категориального запроса, такого как «Рестораны в Нью-Йорке», значением по умолчанию является РЕЛЕВАНТНОСТЬ. Для некатегорийных запросов, таких как «Маунтин-Вью, Калифорния», мы рекомендуем оставить RankPreference неустановленным.
DISTANCE Ранжирует результаты по расстоянию.
RELEVANCE Ранжирует результаты по релевантности. Порядок сортировки определяется обычным стеком ранжирования.

Параметры поиска вдоль маршрута

Указывает предварительно рассчитанную полилинию из API маршрутов, определяющую маршрут для поиска. Поиск по маршруту аналогичен использованию параметра запроса locationBias или locationRestriction для смещения результатов поиска. Однако, хотя параметры locationBias и locationRestriction позволяют указать регион для смещения результатов поиска, этот параметр позволяет смещать результаты по маршруту поездки.

Результаты не гарантированно находятся вдоль предоставленного маршрута, а скорее ранжируются в области поиска, определенной ломаной линией и, при необходимости, locationBias или locationRestriction на основе минимального времени объезда от источника до пункта назначения. Результаты могут быть по альтернативному маршруту, особенно если предоставленная ломаная линия не определяет оптимальный маршрут от источника к пункту назначения.

Поля
polyline

Polyline

Обязательно. Полилиния маршрута.

Поисктекстовый ответ

Прототип ответа для SearchText.

Поля
places[]

Place

Список мест, соответствующих критериям текстового поиска пользователя.

routing_summaries[]

RoutingSummary

Список сводок маршрутизации, в котором каждая запись связана с соответствующим местом в том же индексе в поле places . Если сводка маршрутизации недоступна для одного из мест, она будет содержать пустую запись. По запросу этот список будет содержать столько же записей, сколько и список мест.

contextual_contents[]

ContextualContent

Экспериментальный вариант: дополнительную информацию см. на странице https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative .

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

next_page_token

string

Токен, который можно отправить как page_token для получения следующей страницы. Если это поле опущено или пусто, последующие страницы отсутствуют.

search_uri

string

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

Режим путешествия

Параметры режима путешествия. Эти параметры соответствуют возможностям Routes API .

Перечисления
TRAVEL_MODE_UNSPECIFIED Не указан режим движения. По умолчанию DRIVE .
DRIVE Путешествие на легковом автомобиле.
BICYCLE Путешествие на велосипеде. Не поддерживается с помощью search_along_route_parameters .
WALK Путешествуйте пешком. Не поддерживается с помощью search_along_route_parameters .
TWO_WHEELER Motorized two wheeled vehicles of all kinds such as scooters and motorcycles. Note that this is distinct from the BICYCLE travel mode which covers human-powered transport. Not supported with search_along_route_parameters . Only supported in those countries listed at Countries and regions supported for two-wheeled vehicles .