Package google.maps.places.v1

Индекс

Места

Определение службы для Places API. Примечание. Для каждого запроса (кроме запросов автозаполнения) требуется маска поля, установленная вне протокола запроса ( 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
Поиск текста

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 .

Автозаполнение PlacesRequest

Запросите прототип для 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

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

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

include_query_predictions

bool

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

session_token

string

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

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

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

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

bool

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

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

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

Поля

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

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

rectangle

Viewport

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

circle

Circle

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

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

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

Поля

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

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

rectangle

Viewport

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

circle

Circle

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

АвтозаполнениеPlacesResponse

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

Поля
suggestions[]

Suggestion

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

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

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

Поля

kind поля Союза.

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

place_prediction

PlacePrediction

Предсказание для места.

query_prediction

QueryPrediction

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

Форматтаблетекст

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

Поля
text

string

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

matches[]

StringRange

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

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

МестоПредсказание

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

Поля
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

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

end_offset

int32

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

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

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

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

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

Поля
main_text

FormattableText

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

secondary_text

FormattableText

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

Круг

Круг с LatLng в качестве центра и радиуса.

Поля
center

LatLng

Необходимый. Центральная широта и долгота.

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

radius

double

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

КонтентБлок

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

Поля
topic

string

Тема контента, например «обзор» или «ресторан».

content

LocalizedText

Содержимое, связанное с темой.

references

References

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

Ссылки, относящиеся к данному блоку контента.

Контекстное содержание

Экспериментальный вариант: дополнительную информацию см. на странице 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

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

Выделенныйтекстовыйдиапазон

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

Поля
start_index

int32

end_index

int32

EVChargeOptions

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

Поля
connector_count

int32

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

connector_aggregation[]

ConnectorAggregation

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

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

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

Поля
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. Часто называют МЕННЕКЕС.
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.

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

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

Поля
fuel_prices[]

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

ПолучитьФотоМедиаЗапрос

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

Поля
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.

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

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

  • Используйте токены сеанса для всех вызовов Place Autocomplete.
  • Генерируйте новый токен для каждого сеанса. Рекомендуется использовать UUID версии 4.
  • Убедитесь, что учетные данные, используемые для всех запросов автозаполнения места, сведений о месте и проверки адреса в рамках сеанса, принадлежат одному и тому же проекту 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 Сидней», «Старбакс», «Пирмонт» и т. д.

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 .

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

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

address_components[]

AddressComponent

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

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

Обычные часы работы. Обратите внимание: если место открыто всегда (24 часа), поле close не будет установлено. Клиенты могут полагаться на то, что всегда открыт (24 часа), представленный как период [open][google.maps.places.v1.Place.OpeningHours.Period.open] содержащий [day][Point.day] со значением 0 , [hour][Point.hour] со значением 0 и [minute][Point.minute] со значением 0 .

time_zone

TimeZone

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

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

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

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

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

area_summary

AreaSummary

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

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

containing_places[]

ContainingPlace

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

address_descriptor

AddressDescriptor

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

price_range

PriceRange

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

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.

РайонСводка

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

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

Поля
content_blocks[]

ContentBlock

Блоки контента, составляющие сводку области. В каждом блоке есть отдельная тема о местности.

flag_content_uri

string

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

Атрибуция

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

Поля
provider

string

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

provider_uri

string

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

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

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

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

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

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

Поля
name

string

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

id

string

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

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

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

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

Поля
overview

LocalizedText

Обзор места.

overview_flag_content_uri

string

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

description

LocalizedText

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

description_flag_content_uri

string

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

references

References

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

Часы работы

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

Поля
periods[]

Period

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

weekday_descriptions[]

string

Локализованные строки, описывающие часы работы этого заведения, по одной строке на каждый день недели. Будет пустым, если часы неизвестны или их невозможно преобразовать в локализованный текст. Пример: «Вс: 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, Рамберг, Норвегия», содержащий суффикс глобального кода и заменяющий префикс форматированным именем ссылочного объекта.

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

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

Поля
name

string

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

id

string

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

Полилиния

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

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

string

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

Уровень цены

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

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

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

Ссылки

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

Ссылка, к которой относится генеративный контент.

Поля
reviews[]

Review

Обзоры, которые служат ссылками.

places[]

string

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

Обзор

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

Поля
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.

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

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

Поля
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

Используется для установки строгой фильтрации типов для include_type. Если установлено значение 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 Моторизованные двухколесные транспортные средства всех видов, такие как скутеры и мотоциклы. Обратите внимание, что это отличается от режима движения BICYCLE , который охватывает транспорт, приводимый в движение человеком. Не поддерживается с помощью search_along_route_parameters . Поддерживается только в странах, перечисленных в разделе «Страны и регионы, поддерживающие двухколесные транспортные средства» .