REST Resource: selection.v1.projects.selectedRoutes

Ressource: SelectedRoute

Eine SelectedRoute stellt eine bestimmte Route dar, für die ein Kunde regelmäßig Informationen (z.B. Dauer) für vertraglich vereinbarte Anwendungsfälle abrufen möchte.

JSON-Darstellung 
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "state": enum (State),
  "routeAttributes": {
    string: string,
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dynamicRoute": {
    object (DynamicRoute)
  }
  // End of mutually exclusive fields.
  "validationError": enum (ValidationError),
  "dynamicRouting": boolean
}
Felder
name

string

ID. Ressourcenname von SelectedRoute.

Format: projects/{project}/selectedRoutes/{selectedRoute}
displayName

string

Optional. Anzeigename der Route. Dies ist ein optionales Feld, das vom Kunden verwendet werden kann. Er muss nicht eindeutig sein. Die Länge ist auf 100 Zeichen beschränkt (gezählt in Unicode-Codepunkten).
createTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem die ausgewählte Route 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"
state

enum (State)

Nur Ausgabe. Der Status der ausgewählten Route.
routeAttributes

map (key: string, value: string)

Optional. Die benutzerdefinierten Attribute für die ausgewählte Route. Wenn Sie sie hinzufügen, können Sie die Routen filtern oder gruppieren, wenn Sie Verlaufs- und Echtzeitinformationen zu Routen abrufen. Pro Route werden bis zu 25 Attribute unterstützt. Jeder Schlüssel und jeder Wert muss ein nicht leerer String sein und kann bis zu 100 Zeichen (gezählt in Unicode-Codepunkten) enthalten. Die Schlüssel dürfen nicht mit goog beginnen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Nur DynamicRoute wird unterstützt. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
dynamicRoute

object (DynamicRoute)

SelectedRoute ist eine dynamische Route.
Ende der sich gegenseitig ausschließenden Felder.
validationError

enum (ValidationError)

Nur Ausgabe. Der Validierungsfehler für die ausgewählte Route, wenn der Status STATE_INVALID ist.
dynamicRouting

boolean

Optional. Wenn der Wert auf true gesetzt ist, kann die ausgewählte Route basierend auf der aktuellen Verkehrslage und den eingegebenen Wegpunkten dynamisch neu berechnet werden. Wenn der Wert auf false gesetzt ist, ist die ausgewählte Route eine feste Route, die die aktuelle Verkehrslage nicht berücksichtigt und dem bei der Erstellung berechneten Pfad folgt, der die Verkehrslage nicht berücksichtigt. Wenn der Wert weggelassen wird, wird standardmäßig false verwendet, was bedeutet, dass es sich um eine feste Route handelt.

DynamicRoute

Dies stellt eine Route mit Wegpunkten (Start, Ziel und Zwischenstopps) dar. Die tatsächliche Route führt garantiert über alle Wegpunkte. Wenn dynamicRouting auf false gesetzt ist, bleibt die tatsächliche Route unabhängig von der Verkehrslage unverändert. Wenn dynamicRouting auf true festgelegt ist, kann sich die tatsächliche Route je nach Verkehrslage ändern.

JSON-Darstellung 
{
  "origin": {
    object (LatLng)
  },
  "destination": {
    object (LatLng)
  },
  "intermediates": [
    {
      object (LatLng)
    }
  ]
}
Felder
origin

object (LatLng)

Erforderlich. Ausgangsort der Route.
destination

object (LatLng)

Erforderlich. Zielort der Route.
intermediates[]

object (LatLng)

Optional. Eine Reihe von Zwischenwegpunkten entlang der Route (ohne Endpunkte). Sie sind immer Zwischenstopps. Es werden bis zu 25 Zwischenwegpunkte unterstützt. Wenn Sie sie richtig hinzufügen, kann die Abweichung der tatsächlichen Route gelegentlich verringert werden.

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 es dem World Geodetic System 1984 (WGS 84) 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.

Bundesland

Der Status der ausgewählten Route.

Enums
STATE_UNSPECIFIED Der Status dieser Route ist nicht festgelegt.
STATE_SCHEDULING Die Route wurde erstellt und wird geplant.
STATE_RUNNING Die Route wurde erstellt und hat einen aktiven Zeitplan.
STATE_DELETING Die Route wurde zum Löschen markiert.
STATE_VALIDATING Die Route wird gerade validiert.
STATE_INVALID Die Route ist aufgrund eines der Validierungskriterien ungültig.

ValidationError

Der Validierungsfehler für die ausgewählte Route.

Enums
VALIDATION_ERROR_UNSPECIFIED Der Validierungsfehler dieser Route ist nicht festgelegt.
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION Die Route liegt außerhalb der Zuständigkeit des Projekts.
VALIDATION_ERROR_LOW_ROAD_USAGE Die Route wird wenig genutzt (es fahren nur sehr wenige Personen dort entlang).

Methoden

batchCreate

 Erstellt mehrere SelectedRoute-Ressourcen und startet einen Zeitplan, um regelmäßig Cache-Informationen für jede der Routen abzurufen.

batchDelete

 Löscht mehrere SelectedRoute-Ressourcen für das angegebene Projekt.

batchUpdate

 Aktualisiert mehrere SelectedRoute-Ressourcen, die durch ihre Namen angegeben werden.

create

 Erstellt eine SelectedRoute und startet einen Zeitplan, um regelmäßig Cache-Informationen für die Route abzurufen.

delete

 Löscht die angegebene SelectedRoute für das angegebene Projekt.

get

 Ruft eine SelectedRoute anhand ihres Namens ab.

list

 Listet alle SelectedRoute-Ressourcen für das angegebene Projekt mit Paginierung auf.

patch

 Aktualisiert eine SelectedRoute, wie durch ihren Namen angegeben.