Package google.maps.navconnect.v1

Index

Dienst für NavConnect-Clients zum Erstellen und Abrufen von Fahrten.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Erstellt eine Reise. Diese Methode muss aufgerufen werden, bevor die Fahrt in der mobilen Anwendung gestartet werden kann. Für die zurückgegebene Fahrt ist das Feld auth_token festgelegt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc GetTrip(GetTripRequest) returns (Trip)

Ruft eine Fahrt ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

AuthToken

Ein Authentifizierungstoken.

Felder
token

string

Nur Ausgabe. Das Authentifizierungstoken, das an die mobile App übergeben werden soll.
expire_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem das Authentifizierungstoken abläuft.

CreateTripRequest

Anfragenachricht für NavConnectService.CreateTrip

Felder
parent

string

Erforderlich. Die übergeordnete Ressource, unter der diese Fahrt erstellt wird. Format: projects/{project_number}
trip_id

string

Erforderlich. Die für die Fahrt zu verwendende ID, die als letzte Komponente des Ressourcennamens der Fahrt verwendet wird.

Dieser Wert muss eine gültige RFC-4122-UUID sein.
trip

Trip

Erforderlich. Die zu erstellende Fahrt.

GetTripRequest

Anfragenachricht für NavConnectService.GetTrip

Felder
name

string

Erforderlich. Der Ressourcenname der abzurufenden Fahrt. Format: projects/{project}/trips/{trip_id}

Standort

Ein Standort, der von der mobilen Anwendung gemeldet wird.

Felder
point

LatLng

Nur Ausgabe. Breiten-/Längengrad des Standorts
source_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Standort ermittelt wurde, wie vom Client angegeben.
server_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Server dieses Standort-Update empfangen hat.

Beenden

Ein Stopp auf der Fahrt, an dem eine Aufgabe ausgeführt werden soll.

Felder
point

LatLng

Erforderlich. Der Standort der Haltestelle als Breiten-/Längengrad.

Fahrt

Eine Fahrt.

Felder
name

string

Nur Ausgabe. ID. Der Ressourcenname der Fahrt. Format: projects/{project_number}/trips/{trip_id}.
config

TripConfig

Nicht veränderbar. Die Konfiguration für die Fahrt.
android_app_id

string

Nur Eingabe. Nicht veränderbar. Die Android-App-ID der mobilen App, die die Fahrt nutzen wird. Es muss mindestens android_app_id oder ios_app_id festgelegt werden.
ios_app_id

string

Nur Eingabe. Nicht veränderbar. Die iOS-Paket-ID der mobilen App, die die Fahrt verwenden wird. Es muss mindestens android_app_id oder ios_app_id festgelegt werden.
auth_token

AuthToken

Nur Ausgabe. Ein vertrauliches Token, das den Zugriff zum Starten einer NavConnect-Fahrt in Google Maps oder Waze autorisiert und diesen Anwendungen Zugriff zum Aktualisieren der Fahrt gewährt. Wird nur von CreateTrip zurückgegeben.
state

State

Nur Ausgabe. Der Status der Fahrt.
execution

TripExecution

Nur Ausgabe. Die neuesten Daten zur Ausführung der Fahrt. Dieser Wert kann nicht festgelegt werden, wenn sich die Fahrt in einem Fehlerstatus befindet.
create_time

Timestamp

Nur Ausgabe. Die Uhrzeit, zu der die Fahrt auf dem Server erstellt wurde.
update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Server die letzte Aktualisierung der Fahrt empfangen hat.

Bundesland

Alle möglichen Fahrtstatus.

Enums
STATE_UNSPECIFIED Der Status der Fahrt ist nicht angegeben.
NEW Die Fahrt wurde erstellt, hat aber noch nicht begonnen.
ENROUTE Der Transporteur ist auf dem Weg zum Ziel.
ARRIVED Der Transporteur ist am Zielort angekommen.
SUSPENDED Die Reise wurde unterbrochen.
FAILED Die Fahrt konnte nicht abgeschlossen werden.
CLIENT_ERROR Die Fahrt ist aufgrund eines Clientfehlers fehlgeschlagen.

TripConfig

Konfiguration für die Fahrt.

Felder
enable_high_frequency_updates

bool

Optional. Gibt an, ob häufige Aktualisierungen von Fahrten aktiviert werden sollen.

HINWEIS: Wenn Sie diese Funktion aktivieren, wird die Fahrt unter der Nutzung der Enterprise-Stufe protokolliert und unterliegt den Tarifen der Enterprise-Stufe.
enable_pubsub

bool

Optional. Gibt an, ob Pub/Sub-Benachrichtigungen für die Fahrt aktiviert werden sollen.
pubsub_field_mask

FieldMask

Optional. Wenn diese Option festgelegt ist, wird nur die angegebene Teilmenge der Trip-Felder in die Pub/Sub-Benachrichtigungen aufgenommen.

Wenn nicht festgelegt, werden alle Felder des Typs „Trip“ in die Pub/Sub-Benachrichtigungen aufgenommen (Standardverhalten).

Die folgenden Felder werden nicht unterstützt:

  • android_app_id
  • ios_app_id
  • auth_token
  • config

HINWEIS: Dieses Feld wird ignoriert, wenn enable_pubsub „false“ ist.

TripExecution

Daten zur Ausführung der Fahrt.

Felder
origin

Location

Nur Ausgabe. Der Ausgangspunkt der Fahrt, der in der Regel der Standort des Transportunternehmens zu Beginn der NavConnect-Fahrt ist.
destination

Stop

Nur Ausgabe. Das von der mobilen App gemeldete Ziel der Fahrt.
location

Location

Nur Ausgabe. Das Standortsignal, das den letzten bekannten Standort des Transporteurs darstellt. Dies ist der auf die Straße ausgerichtete Standort, sofern verfügbar.
traveled_duration

Duration

Nur Ausgabe. Bisher zurückgelegte Zeit.
remaining_duration

Duration

Nur Ausgabe. Die von Google geschätzte verbleibende Zeit für diese Fahrt.
traveled_distance_meters

int32

Nur Ausgabe. Zurückgelegte Entfernung vom Ursprung in Metern.
remaining_distance_meters

int32

Nur Ausgabe. Verbleibende Entfernung zum Ziel in Metern.
stop_added_in_route

bool

Nur Ausgabe. Gibt an, ob der Route ein Zwischenstopp hinzugefügt wurde.