REST Resource: projects.trips

Ressource: Fahrt

Eine Fahrt.

JSON-Darstellung 
{
  "name": string,
  "config": {
    object (TripConfig)
  },
  "androidAppId": string,
  "iosAppId": string,
  "authToken": {
    object (AuthToken)
  },
  "state": enum (State),
  "execution": {
    object (TripExecution)
  },
  "createTime": string,
  "updateTime": string
}
Felder
name

string

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

object (TripConfig)

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

string

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

string

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

object (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 trips.create zurückgegeben.
state

enum (State)

Nur Ausgabe. Der Status der Reise.
execution

object (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.
createTime

string (Timestamp format)

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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

TripConfig

Konfiguration für die Fahrt.

JSON-Darstellung 
{
  "enableHighFrequencyUpdates": boolean,
  "enablePubsub": boolean,
  "pubsubFieldMask": string,
  "enableRemainingRouteReporting": boolean
}
Felder
enableHighFrequencyUpdates

boolean

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

boolean

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

string (FieldMask format)

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:

  • androidAppId
  • iosAppId
  • authToken
  • config

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

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
enableRemainingRouteReporting

boolean

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.

AuthToken

Ein Authentifizierungstoken.

JSON-Darstellung 
{
  "token": string,
  "expireTime": string
}
Felder
token

string

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

string (Timestamp format)

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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

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.

TripExecution

Daten zur Ausführung der Fahrt.

JSON-Darstellung 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Stop)
  },
  "location": {
    object (Location)
  },
  "remainingRoute": {
    object (Route)
  },
  "traveledDuration": string,
  "remainingDuration": string,
  "traveledDistanceMeters": integer,
  "remainingDistanceMeters": integer,
  "stopAddedInRoute": boolean
}
Felder
origin

object (Location)

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

object (Stop)

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

object (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.
remainingRoute

object (Route)

Nur Ausgabe. Stellt die Polylinie für den verbleibenden Teil der Route bereit.
traveledDuration

string (Duration format)

Nur Ausgabe. Bisher zurückgelegte Zeit.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".
remainingDuration

string (Duration format)

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

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".
traveledDistanceMeters

integer

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

integer

Nur Ausgabe. Verbleibende Entfernung zum Ziel in Metern.
stopAddedInRoute

boolean

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

Standort

Ein Standort, wie er von der mobilen Anwendung gemeldet wird.

JSON-Darstellung 
{
  "point": {
    object (LatLng)
  },
  "sourceTime": string,
  "serverTime": string
}
Felder
point

object (LatLng)

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

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Standort vom Client abgerufen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
serverTime

string (Timestamp format)

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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Es wird als Paar aus Werten vom Typ „Double“ (Breiten- und Längengrad) ausgedrückt. Sofern nicht anders angegeben, muss dieses Objekt dem WGS84-Standard entsprechen. Die Werte müssen innerhalb normalisierter Bereiche liegen.

JSON-Darstellung 
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.
longitude

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

Beenden

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

JSON-Darstellung 
{
  "point": {
    object (LatLng)
  }
}
Felder
point

object (LatLng)

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

Route

Eine Routenpolylinie.

JSON-Darstellung 
{
  "trafficInformation": [
    {
      object (SpeedReadingInterval)
    }
  ],

  // Union field format can be only one of the following:
  "simplePolyline": {
    object (SimplePolyline)
  },
  "encodedPolyline": string,
  "s2Polyline": string,
  "geoJson": {
    object
  }
  // End of list of possible types for union field format.
}
Felder
trafficInformation[]

object (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:
simplePolyline

object (SimplePolyline)

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

string

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

string (bytes format)

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

Ein base64-codierter String.
geoJson

object (Struct format)

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.

JSON-Darstellung 
{
  "points": [
    {
      object (LatLng)
    }
  ]
}
Felder
points[]

object (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.

JSON-Darstellung 
{
  "speed": enum (Speed),
  "startPolylinePointIndex": integer,
  "endPolylinePointIndex": integer
}
Felder
speed

enum (Speed)

Nur Ausgabe. Verkehrsgeschwindigkeit in diesem Intervall.
startPolylinePointIndex

integer

Nur Ausgabe. Der Startindex dieses Intervalls im Pfad.
endPolylinePointIndex

integer

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

Methoden

create

 Erstellt eine Reise.

get

 Ruft eine Fahrt ab.