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
IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource parent:

  • navigationconnect.trips.create

Weitere Informationen finden Sie in der IAM-Dokumentation.
GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Ruft eine Fahrt ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • navigationconnect.trips.get

Weitere Informationen finden Sie in der IAM-Dokumentation.

AuthToken

Ein Authentifizierungstoken.

Felder
token

string

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

Timestamp

Nur Ausgabe. 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}
route_polyline_format

RoutePolylineFormat

Optional. Das Format des zurückzugebenden Routenlinienzugs. Wenn nicht festgelegt, wird die SIMPLE-Routenpolylinie zurückgegeben.

RoutePolylineFormat

Gibt das Format der Routen-Polylinie an.

Enums
ROUTE_POLYLINE_FORMAT_UNSPECIFIED Das Format der Routen-Polylinie ist nicht angegeben.
SIMPLE Die Routen-Polylinie wird als einfaches Array von Punkten zurückgegeben, die als google.type.LatLng dargestellt werden.
ENCODED Die Routenpolylinie wird als codierter String zurückgegeben. Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/utilities/polylinealgorithm.
S2ENCODED Die Routenpolylinie ist als S2Polyline codiert. Weitere Informationen finden Sie unter https://s2geometry.io/devguide/basic_types.html.
GEO_JSON Die Routen-Polylinie wird als GeoJSON-LineString zurückgegeben. Weitere Informationen finden Sie unter https://tools.ietf.org/html/rfc7946#section-3.1.4.

Standort

Ein Standort, wie er 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 vom Client abgerufen wurde.
server_time

Timestamp

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

Route

Eine Routenpolylinie.

Felder
traffic_information[]

SpeedReadingInterval

Nur Ausgabe. Verkehrsinformationen auf der Polylinie, die als Geschwindigkeitsleseintervalle beschrieben werden.

ANMERKUNGEN:

  • Die Intervalle überschneiden sich nicht.
  • Die Intervalle sind zusammenhängend.
  • Die Intervalle decken den gesamten Linienzug ab.
  • Die Intervalle sind nach aufsteigendem Index sortiert.
  • Die Geschwindigkeit wird für jedes Intervall angegeben.

Union-Feld format. Das Format der Route.

Das Format wird durch den Parameter route_polyline_format gesteuert. Wenn nichts angegeben ist, wird standardmäßig eine einfache Polylinie verwendet. Für format ist nur einer der folgenden Werte zulässig:
simple_polyline

SimplePolyline

Nur Ausgabe. Die Route als einfache Liste von Breiten- und Längengraden.
encoded_polyline

string

Nur Ausgabe. Die Route als codierte Polylinie. Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/utilities/polylinealgorithm.
s2_polyline

bytes

Nur Ausgabe. Die Route als codierte S2Polyline. Weitere Informationen finden Sie unter https://s2geometry.io/devguide/basic_types.html.
geo_json

Struct

Nur Ausgabe. Die Route als GeoJSON-LineString. Weitere Informationen finden Sie unter https://tools.ietf.org/html/rfc7946#section-3.1.4.

SimplePolyline

Stellt eine Polylinie mit einer einfachen Liste von Punkten dar.

Felder
points[]

LatLng

Nur Ausgabe. Eine sortierte Liste von Punkten, die die Polylinie darstellen.

SpeedReadingInterval

Indikator für die Verkehrsdichte auf einem zusammenhängenden Segment eines Pfads. Bei einem Pfad mit den Punkten P_0, P_1, ... , P_N (nullbasierter Index) wird mit SpeedReadingInterval ein Intervall definiert und der Verkehr darin mit den Speed-Kategorien beschrieben.

Felder
speed

Speed

Nur Ausgabe. Verkehrsgeschwindigkeit in diesem Intervall.
start_polyline_point_index

int32

Nur Ausgabe. Der Startindex dieses Intervalls im Pfad.
end_polyline_point_index

int32

Nur Ausgabe. Der Endindex dieses Intervalls im Pfad.

Geschwindigkeit

Die Klassifizierung der Polylinien-Geschwindigkeit auf Grundlage von Verkehrsdaten.

Enums
SPEED_UNSPECIFIED Die Geschwindigkeit ist nicht angegeben.
NORMAL Normale Geschwindigkeit, keine Verkehrsbehinderungen.
SLOW Verlangsamung erkannt, geringes bis mittleres Verkehrsaufkommen.
TRAFFIC_JAM Verkehrsbehinderungen, einschließlich Verkehr im Stillstand

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-Anwendungs-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 Reise.
execution

TripExecution

Nur Ausgabe. Die neuesten Daten zur Ausführung der Fahrt. Dieser Wert darf 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.
CANCELED Die Fahrt wurde explizit vom Entwickler storniert.

TripConfig

Konfiguration für die Fahrt.

Felder
enable_high_frequency_updates

bool

Optional. Gibt an, ob häufige Fahrt-Updates 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 festgelegt, wird in die Pub/Sub-Benachrichtigungen nur die angegebene Teilmenge der Trip-Felder 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.
enable_remaining_route_reporting

bool

Optional. Gibt an, ob die Berichterstellung für die verbleibende Route für die Fahrt aktiviert werden soll.

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

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.
remaining_route

Route

Nur Ausgabe. Stellt die Polylinie für den verbleibenden Teil der Route bereit.
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.