Package google.maps.navconnect.v1

Индекс

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

CreateTrip

rpc CreateTrip( CreateTripRequest ) returns ( Trip )

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

Области полномочий

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

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

rpc GetTrip( GetTripRequest ) returns ( Trip )

Отправляется в путешествие.

Области полномочий

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

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

AuthToken

Аутентификационный токен.

Поля
token

string

Только для вывода. Токен аутентификации, который должен быть передан в мобильное приложение.

expire_time

Timestamp

Только вывод. Время истечения срока действия токена аутентификации.

CreateTripRequest

Сообщение запроса для NavConnectService.CreateTrip.

Поля
parent

string

Обязательно. Родительский ресурс, под которым будет создана эта поездка. Формат: projects/{project_number}

trip_id

string

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

Это значение должно быть допустимым UUID в соответствии со стандартом RFC-4122.

trip

Trip

Обязательно. Путешествие для творчества.

GetTripRequest

Запрос сообщения для NavConnectService.GetTrip.

Поля
name

string

Обязательно. Название ресурса поездки, которую нужно получить. Формат: projects/{project}/trips/{trip_id}

Расположение

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

Поля
point

LatLng

Только вывод. Координаты (широта/долгота).

source_time

Timestamp

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

server_time

Timestamp

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

Останавливаться

Остановка в пути, где необходимо выполнить какое-либо задание.

Поля
point

LatLng

Обязательно. Местоположение остановки в формате широта/долгота.

Путешествие

Путешествие.

Поля
name

string

Только вывод. Идентификатор. Название ресурса поездки. Формат: projects/{project_number}/trips/{trip_id}.

config

TripConfig

Неизменяемый. Конфигурация для поездки.

android_app_id

string

Только ввод. Неизменяемый. Идентификатор Android-приложения, которое будет использовать данные о поездке. Должен быть задан хотя бы один из параметров: android_app_id или ios_app_id .

ios_app_id

string

Только для ввода. Неизменяемый. Идентификатор пакета iOS мобильного приложения, которое будет использовать поездку. Должен быть задан хотя бы один из параметров: android_app_id или ios_app_id .

auth_token

AuthToken

Только для вывода. Непрозрачный токен, разрешающий доступ к началу поездки NavConnect в Google Maps или Waze и предоставляющий этим приложениям доступ к обновлению поездки. Возвращается только функцией CreateTrip .

state

State

Только вывод. Состояние поездки.

execution

TripExecution

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

create_time

Timestamp

Только вывод. Время по данным сервера на момент создания поездки.

update_time

Timestamp

Только вывод. Время, когда сервер получил последнее обновление информации о поездке.

Состояние

Все возможные состояния поездки.

Перечисления
STATE_UNSPECIFIED Штат, в котором находится поездка, не указан.
NEW Поездка была организована, но еще не началась.
ENROUTE Транспортное средство находится в пути к месту назначения.
ARRIVED Транспортное средство прибыло в пункт назначения.
SUSPENDED Поездка была отменена.
FAILED Поездка не завершилась успешно.
CLIENT_ERROR Поездка сорвалась из-за ошибки клиента.

TripConfig

Настройка поездки.

Поля
enable_high_frequency_updates

bool

Необязательно. Включить ли частое обновление информации о поездках.

ПРИМЕЧАНИЕ: Включение этой функции регистрирует поездку в рамках тарифов корпоративного уровня и оплачивается по тарифам корпоративного уровня.

enable_pubsub

bool

Необязательно. Включить ли уведомления от издателя/подписчика о поездке.

pubsub_field_mask

FieldMask

Необязательно. Если задано, в уведомления pubsub будет включено только указанное подмножество полей Trip.

Если этот параметр не задан, все поля Trip будут включены в уведомления pubsub (поведение по умолчанию).

Следующие поля не поддерживаются:

  • android_app_id
  • ios_app_id
  • auth_token
  • config

Примечание: это поле игнорируется, если enable_pubsub имеет значение false.

TripExecution

Данные о ходе поездки.

Поля
origin

Location

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

destination

Stop

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

location

Location

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

traveled_duration

Duration

Только вывод. Время, пройденное до настоящего момента.

remaining_duration

Duration

Только вывод. Оставшееся время в пути, рассчитанное Google.

traveled_distance_meters

int32

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

remaining_distance_meters

int32

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

stop_added_in_route

bool

Только вывод. Указывает, была ли добавлена ​​остановка на маршруте.