- HTTP-Anfrage
- Anfragetext
- Antworttext
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Route
- RouteLabel
- RouteLeg
- Polylinie
- RouteLegStep
- NavigationInstruction
- Manöver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Viewport
- RouteLocalizedValues
- PolylineDetails
- FlyoverInfo
- RoadFeatureState
- PolylinePointIndex
- NarrowRoadInfo
- GeocodingResults
- GeocodedWaypoint
Gibt die Hauptroute sowie optionale alternative Routen zurück, wenn eine Reihe von End- und Zwischenpunkten angegeben wird.
HINWEIS:Bei dieser Methode müssen Sie in der Eingabe eine Antwortfeldmaske angeben. Sie können die Antwortfeldmaske mit dem URL-Parameter $fields
oder fields
oder mit einem HTTP-/gRPC-Header X-Goog-FieldMask
angeben (siehe Verfügbare URL-Parameter und ‑Header). Der Wert ist eine durch Kommas getrennte Liste von Feldpfaden. Ausführliche Informationen zum Erstellen von Feldpfaden
Beispiel für diese Methode:
- Feldmaske aller verfügbaren Felder (für manuelle Prüfung):
X-Goog-FieldMask: *
- Feldmaske für Dauer, Entfernung und Polylinie auf Routenebene (Beispiel für eine Produktionskonfiguration):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google rät davon ab, die Antwortfeldmaske mit dem Platzhalter (*
) oder die Angabe der Feldmaske auf oberster Ebene (routes
) zu verwenden. Das hat folgende Gründe:
- Wenn Sie nur die benötigten Felder auswählen, kann unser Server Rechenzyklen einsparen. So können wir Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben.
- Wenn Sie nur die Felder auswählen, die Sie in Ihrem Produktionsjob benötigen, ist die Latenzleistung stabil. Wir werden möglicherweise in Zukunft weitere Antwortfelder hinzufügen. Diese neuen Felder erfordern möglicherweise zusätzliche Rechenzeit. Wenn Sie alle Felder oder alle Felder auf oberster Ebene auswählen, kann es zu Leistungseinbußen kommen, da jedes neue Feld, das wir hinzufügen, automatisch in die Antwort aufgenommen wird.
- Wenn Sie nur die benötigten Felder auswählen, ist die Antwort kleiner und der Netzwerkdurchsatz höher.
HTTP-Anfrage
POST https://routes.googleapis.com/directions/v2:computeRoutes
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "origin": { object ( |
Felder | |
---|---|
origin |
Erforderlich. Startpunkt. |
destination |
Erforderlich. Ziel-Wegpunkt |
intermediates[] |
Optional. Eine Reihe von Wegpunkten entlang der Route (ohne Endpunkte), an denen angehalten oder vorbeigefahren werden soll. Es werden bis zu 25 Wegpunkte unterstützt. |
travel |
Optional. Gibt die Mobilitätsform an. |
routing |
Optional. Gibt an, wie die Route berechnet werden soll. Der Server versucht, die Route anhand der ausgewählten Routing-Einstellung zu berechnen. Wenn die Routing-Einstellung zu einem Fehler oder zu einer besonders langen Latenz führt, wird ein Fehler zurückgegeben. Diese Option kann nur angegeben werden, wenn |
polyline |
Optional. Gibt die gewünschte Qualität der Polylinie an. |
polyline |
Optional. Gibt die bevorzugte Codierung für die Polylinie an. |
departure |
Optional. Die Abfahrtszeit. Wenn Sie diesen Wert nicht festlegen, wird standardmäßig die Uhrzeit festgelegt, zu der Sie die Anfrage gesendet haben. HINWEIS: Sie können nur dann ein Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
arrival |
Optional. Die Ankunftszeit. HINWEIS: Kann nur festgelegt werden, wenn Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
compute |
Optional. Gibt an, ob zusätzlich zur Route alternative Routen berechnet werden sollen. Für Anfragen mit Zwischenpunkten werden keine alternativen Routen zurückgegeben. |
route |
Optional. Eine Reihe von Bedingungen, die erfüllt sein müssen und sich auf die Berechnung von Routen auswirken. |
language |
Optional. Der BCP-47-Sprachcode, z. B. "en-US" oder "sr-Latn" Weitere Informationen finden Sie unter Unicode-Sprachkennzeichnung. Eine Liste der unterstützten Sprachen finden Sie unter Sprachunterstützung. Wenn Sie diesen Wert nicht angeben, wird die Anzeigesprache aus dem Standort der Routenanfrage abgeleitet. |
region |
Optional. Der Regionscode, angegeben als zweistelliger Ländercode der Top-Level-Domain (ccTLD). Weitere Informationen finden Sie unter Top-Level-Domains mit Landeskennzeichen. |
units |
Optional. Gibt die Maßeinheiten für die Anzeigefelder an. Dazu gehört das Feld |
optimize |
Optional. Wenn diese Option auf „wahr“ gesetzt ist, versucht der Dienst, die Gesamtkosten der Route zu minimieren, indem die angegebenen Zwischenziele neu angeordnet werden. Die Anfrage schlägt fehl, wenn einer der Zwischenwegpunkte ein |
requested |
Optional. Gibt an, welche Referenzrouten zusätzlich zur Standardroute im Rahmen der Anfrage berechnet werden sollen. Eine Referenzroute ist eine Route mit einem anderen Ziel für die Routenberechnung als die Standardroute. Bei der Berechnung einer |
extra |
Optional. Eine Liste zusätzlicher Berechnungen, die zum Ausführen der Anfrage verwendet werden können. Hinweis: Diese zusätzlichen Berechnungen können zusätzliche Felder in der Antwort zurückgeben. Diese zusätzlichen Felder müssen auch in der Feldmaske angegeben werden, die in der Antwort zurückgegeben werden soll. |
traffic |
Optional. Gibt die Annahmen an, die bei der Berechnung der Reisezeit verwendet werden sollen. Diese Einstellung wirkt sich auf den Wert für die voraussichtliche Reisezeit aus, der in den Antworten in den Feldern |
transit |
Optional. Gibt Einstellungen an, die die für |
Antworttext
v2.computeRoutes die Antwortnachricht.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "routes": [ { object ( |
Felder | |
---|---|
routes[] |
Enthält ein Array mit bis zu drei berechneten Routen, wenn Sie |
fallback |
Wenn der Server die Routenergebnisse nicht mit allen Eingabeeinstellungen berechnen kann, wird möglicherweise eine andere Berechnungsmethode verwendet. Wenn der Fallback-Modus verwendet wird, enthält dieses Feld detaillierte Informationen zur Fallback-Antwort. Andernfalls ist dieses Feld nicht festgelegt. |
geocoding |
Enthält Geocoding-Antwortinformationen für Wegpunkte, die als Adressen angegeben sind. |
PolylineQuality
Eine Reihe von Werten, die die Qualität der Polylinie angeben.
Enums | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Es wurde keine Einstellung für die Polylinienqualität angegeben. Die Standardeinstellung ist OVERVIEW . |
HIGH_QUALITY |
Gibt eine Polylinie mit hoher Qualität an, die aus mehr Punkten als OVERVIEW besteht. Dies führt zu einer größeren Antwortgröße. Verwenden Sie diesen Wert, wenn Sie eine höhere Genauigkeit benötigen. |
OVERVIEW |
Hiermit wird eine Übersichtspolylinie angegeben, die aus einer kleinen Anzahl von Punkten besteht. Verwenden Sie diesen Wert, wenn eine Übersicht der Route angezeigt werden soll. Bei dieser Option ist die Anfragelatenz niedriger als bei der Option HIGH_QUALITY . |
PolylineEncoding
Gibt den bevorzugten Polylinientyp an, der zurückgegeben werden soll.
Enums | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Es wurde keine Einstellung für den Polylinientyp angegeben. Die Standardeinstellung ist ENCODED_POLYLINE . |
ENCODED_POLYLINE |
Gibt eine Polylinie an, die mit dem Algorithmus für codierte Polylinien codiert wurde. |
GEO_JSON_LINESTRING |
Gibt eine Polylinie im GeoJSON-LineString-Format an. |
ReferenceRoute
Eine unterstützte Referenzroute in der ComputeRoutesRequest.
Enums | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Nicht verwendet. Anfragen mit diesem Wert schlagen fehl. |
FUEL_EFFICIENT |
Spritsparende Route. |
SHORTER_DISTANCE |
Route mit kürzerer Fahrstrecke Dies ist eine experimentelle Funktion. Bei Bei Diese Funktion ist nicht mit anderen Verkehrsmitteln, über Zwischenziele oder |
ExtraComputation
Zusätzliche Berechnungen, die beim Ausführen der Anfrage ausgeführt werden.
Enums | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Nicht verwendet. Anfragen mit diesem Wert schlagen fehl. |
TOLLS |
Informationen zu Mautgebühren für die Route(n). |
FUEL_CONSUMPTION |
Geschätzter Kraftstoffverbrauch für die Route(n). |
TRAFFIC_ON_POLYLINE |
Polylinien mit Berücksichtigung der aktuellen Verkehrslage für die Routen. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions als formatierter HTML-Textstring dargestellt. Dieser Inhalt ist so zu lesen, wie er ist. Er dient nur zur Anzeige. Wir raten davon ab, sie programmatisch zu parsen. |
FLYOVER_INFO_ON_POLYLINE |
Informationen zu den Überflügen der Routen. Die Feldmaske routes.polyline_details.flyover_info muss angegeben werden, damit diese Informationen zurückgegeben werden. Diese Daten werden derzeit nur für bestimmte Metropolen in Indien erfasst. Diese Funktion ist experimentell und die SKU/Ladung kann sich ändern. |
NARROW_ROAD_INFO_ON_POLYLINE |
Informationen zu engen Straßen für die Routen. Die Feldmaske routes.polyline_details.narrow_road_info muss angegeben werden, damit diese Informationen zurückgegeben werden. Diese Daten werden derzeit nur für bestimmte Metropolen in Indien erfasst. Diese Funktion ist experimentell und die SKU/Ladung kann sich ändern. |
Route
Enthält eine Route, die aus einer Reihe verbundener Straßensegmente besteht, die Start-, End- und Zwischenwegpunkte verbinden.
JSON-Darstellung |
---|
{ "routeLabels": [ enum ( |
Felder | |
---|---|
route |
Labels für die |
legs[] |
Eine Reihe von Abschnitten (Pfadsegmente zwischen Wegpunkten), die die Route bilden. Jede Etappe entspricht der Fahrt zwischen zwei nicht |
distance |
Die zurückgelegte Strecke der Route in Metern. |
duration |
Die Zeit, die für die Route benötigt wird. Wenn Sie Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
static |
Die Fahrtdauer auf der Route ohne Berücksichtigung der Verkehrslage. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
polyline |
Die Polylinie der gesamten Route. Diese Polylinie ist die kombinierte Polylinie aller |
description |
Eine Beschreibung der Route. |
warnings[] |
Ein Array mit Warnungen, die zusammen mit der Route angezeigt werden müssen. |
viewport |
Der Begrenzungsrahmen des Darstellungsbereichs der Polylinie. |
travel |
Zusätzliche Informationen zur Route. |
optimized |
Wenn Sie |
localized |
Textdarstellungen von Properties der |
route |
Ein undurchsichtiges Token, das an das Navigation SDK übergeben werden kann, um die Route während der Navigation neu zu erstellen und bei einer Umleitung die ursprüngliche Absicht beim Erstellen der Route zu berücksichtigen. Dieses Token als intransparenten Blob behandeln Vergleichen Sie den Wert nicht zwischen Anfragen, da er sich auch dann ändern kann, wenn der Dienst genau dieselbe Route zurückgibt. HINWEIS: |
polyline |
Enthält Informationen zu Details entlang der Polylinie. |
RouteLabel
Labels für die
, mit denen sich bestimmte Eigenschaften der Route identifizieren lassen, um sie mit anderen zu vergleichen.Route
Enums | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Standardeinstellung – nicht verwendet. |
DEFAULT_ROUTE |
Die standardmäßige „beste“ Route, die für die Routenberechnung zurückgegeben wird. |
DEFAULT_ROUTE_ALTERNATE |
Eine Alternative zur Standardroute „Beste Route“. Solche Routen werden zurückgegeben, wenn angegeben wird. |
FUEL_EFFICIENT |
Spritsparende Route. Routen mit diesem Wert sind für umweltfreundliche Parameter wie den Kraftstoffverbrauch optimiert. |
SHORTER_DISTANCE |
Route mit kürzerer zurückgelegter Strecke. Dies ist eine experimentelle Funktion. |
RouteLeg
Enthält ein Segment zwischen Wegpunkten, die keine via
sind.
JSON-Darstellung |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Felder | |
---|---|
distance |
Die zurückgelegte Strecke des Streckenabschnitts in Metern. |
duration |
Die Zeit, die für die Route benötigt wird. Wenn Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
static |
Die Reisedauer für den Abschnitt, berechnet ohne Berücksichtigung der Verkehrsbedingungen. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
polyline |
Der Polylinie für diesen Abschnitt, der den Polylinien aller |
start |
Der Startort dieses Abschnitts. Dieser Standort kann sich von der angegebenen |
end |
Der Endpunkt dieses Abschnitts. Dieser Standort kann sich von der angegebenen |
steps[] |
Ein Array von Schritten, die Segmente innerhalb dieses Abschnitts bezeichnen. Jeder Schritt entspricht einer Navigationsanweisung. |
travel |
Enthält zusätzliche Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen für Verkehrszonen auf einem Streckenabschnitt. |
localized |
Textdarstellungen von Properties der |
steps |
Übersicht über die Schritte in dieser |
Polyline
Kapselt eine codierte Polylinie ein.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld polyline_type . Der Typ des Polyliniens. Standardeinstellung ist „encoded_polyline“. Für polyline_type ist nur einer der folgenden Werte zulässig: |
|
encoded |
Die Stringcodierung der Polylinie mit dem Algorithmus für die Polyliniencodierung |
geo |
Gibt eine Polylinie im GeoJSON-LineString-Format an. |
RouteLegStep
Enthält ein Segment einer
. Ein Schritt entspricht einer einzelnen Navigationsanweisung. Routenabschnitte bestehen aus Schritten.RouteLeg
JSON-Darstellung |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Felder | |
---|---|
distance |
Die zurückgelegte Strecke dieses Schritts in Metern. Unter bestimmten Umständen ist dieses Feld möglicherweise leer. |
static |
Die Fahrtdauer für diesen Schritt ohne Berücksichtigung der Verkehrslage. Unter bestimmten Umständen ist dieses Feld möglicherweise leer. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
polyline |
Die Polylinie, die mit diesem Schritt verknüpft ist. |
start |
Der Startort dieses Schritts. |
end |
Der Endpunkt dieses Schritts. |
navigation |
Navigationsanleitung |
travel |
Enthält zusätzliche Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen für Zonen mit Verkehrsbeschränkungen. |
localized |
Textdarstellungen von Properties der |
transit |
Details zu diesem Schritt, wenn der Reisemodus |
travel |
Der für diesen Schritt verwendete Verkehrsmitteltyp. |
Manöver
Eine Reihe von Werten, die die Navigationsaktion für den aktuellen Schritt angeben (z. B. links abbiegen, einfädeln oder geradeaus fahren).
Enums | |
---|---|
MANEUVER_UNSPECIFIED |
Nicht verwendet. |
TURN_SLIGHT_LEFT |
Drehen Sie sich leicht nach links. |
TURN_SHARP_LEFT |
Abbiegen Sie scharf nach links. |
UTURN_LEFT |
Wenden Sie nach links. |
TURN_LEFT |
Biegen Sie links ab. |
TURN_SLIGHT_RIGHT |
Drehen Sie sich leicht nach rechts. |
TURN_SHARP_RIGHT |
Abbiegen Sie scharf nach rechts. |
UTURN_RIGHT |
Wenden Sie nach rechts. |
TURN_RIGHT |
Biegen Sie rechts ab. |
STRAIGHT |
Fahren Sie geradeaus. |
RAMP_LEFT |
Nehmen Sie die linke Auffahrt. |
RAMP_RIGHT |
Nehmen Sie die rechte Auffahrt. |
MERGE |
Einfädeln. |
FORK_LEFT |
Nehmen Sie die Abzweigung nach links. |
FORK_RIGHT |
Biegen Sie rechts ab. |
FERRY |
Nehmen Sie die Fähre. |
FERRY_TRAIN |
Nehmen Sie den Zug zur Fähre. |
ROUNDABOUT_LEFT |
Biegen Sie am Kreisverkehr links ab. |
ROUNDABOUT_RIGHT |
Biegen Sie am Kreisverkehr rechts ab. |
DEPART |
Erster Fahrmanöver |
NAME_CHANGE |
Wird verwendet, um eine Änderung des Straßennamens anzugeben. |
RouteLegStepTravelAdvisory
Enthält zusätzliche Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen für Verkehrszonen für einen Streckenabschnitt.
JSON-Darstellung |
---|
{
"speedReadingIntervals": [
{
object ( |
Felder | |
---|---|
speed |
HINWEIS: Dieses Feld ist derzeit nicht ausgefüllt. |
RouteLegStepLocalizedValues
Textdarstellungen bestimmter Properties.
JSON-Darstellung |
---|
{ "distance": { object ( |
Felder | |
---|---|
distance |
Die zurückgelegte Strecke in Textform. |
static |
Dauer ohne Berücksichtigung der Verkehrslage, in Textform |
RouteLegStepTransitDetails
Zusätzliche Informationen für die RouteLegStep
im Zusammenhang mit TRANSIT
-Routen.
JSON-Darstellung |
---|
{ "stopDetails": { object ( |
Felder | |
---|---|
stop |
Informationen zu den Ankunfts- und Abfahrtshaltestellen für den Schritt. |
localized |
Textdarstellungen von Properties der |
headsign |
Gibt die Fahrtrichtung dieser Linie an, die auf dem Fahrzeug oder an der Haltestelle ausgewiesen ist. Die Richtung ist oft die Endhaltestelle. |
headway |
Gibt die erwartete Zeit als Dauer zwischen Abfahrten von derselben Haltestelle zu dieser Zeit an. Bei einem Wert von 600 Sekunden für die Vorlaufzeit wäre z. B. mit einer Wartezeit von 10 Minuten zu rechnen, wenn man einen Bus verpasst. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
transit |
Informationen zur in diesem Schritt verwendeten ÖPNV-Linie. |
stop |
Die Anzahl der Haltestellen zwischen der Starthaltestelle und der Zielhaltestelle. Dabei wird die Zielhaltestelle mitgezählt, die Starthaltestelle aber nicht. Wenn Sie z. B. an Haltestelle A abfahren, die Haltestellen B und C durchfahren und bei Haltestelle D aussteigen,
gibt 3 zurück. |
trip |
Der Text, der in Fahrplänen und auf Aushängen erscheint, um Fahrgäste auf eine Fahrt mit öffentlichen Verkehrsmitteln hinzuweisen. Der Text sollte eine Fahrt innerhalb eines Betriebstags eindeutig identifizieren. „538“ ist beispielsweise die |
TransitStopDetails
Details zu den Haltestellen der RouteLegStep
.
JSON-Darstellung |
---|
{ "arrivalStop": { object ( |
Felder | |
---|---|
arrival |
Informationen zur Ankunftshaltestelle für den Schritt. |
arrival |
Die voraussichtliche Ankunftszeit für den Schritt. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
departure |
Informationen zur Abfahrtshaltestelle für den Schritt. |
departure |
Die geschätzte Abfahrtszeit für den Schritt. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
TransitStop
Informationen zu einer Haltestelle.
JSON-Darstellung |
---|
{
"name": string,
"location": {
object ( |
Felder | |
---|---|
name |
Der Name der Haltestelle. |
location |
Der Standort der Haltestelle oder des Bahnhofs in Breiten-/Längengradkoordinaten. |
TransitDetailsLocalizedValues
Lokalisierte Beschreibungen von Werten für RouteTransitDetails
.
JSON-Darstellung |
---|
{ "arrivalTime": { object ( |
Felder | |
---|---|
arrival |
Die Uhrzeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone. |
departure |
Die Uhrzeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone. |
LocalizedTime
Lokalisierte Zeitbeschreibung.
JSON-Darstellung |
---|
{
"time": {
object ( |
Felder | |
---|---|
time |
Die als String angegebene Zeit in einer bestimmten Zeitzone. |
time |
Enthält die Zeitzone. Der Wert entspricht dem Namen der Zeitzone, die in der IANA-Zeitzonendatenbank definiert ist, z. B. "America/New_York". |
TransitLine
Enthält Informationen zur in diesem Schritt verwendeten ÖPNV-Linie.
JSON-Darstellung |
---|
{ "agencies": [ { object ( |
Felder | |
---|---|
agencies[] |
Der Betreiber oder die Betreiber, die diese ÖPNV-Linie betreiben. |
name |
Der vollständige Name der ÖPNV-Linie, z. B. „8 Avenue Local“. |
uri |
den URI für die ÖPNV-Linie, der vom Betreiber bereitgestellt wird. |
color |
Die Farbe, die üblicherweise für die Beschilderung dieser Linie verwendet wird. Hexadezimal dargestellt. |
icon |
Der URI für das Symbol, das dieser Linie zugeordnet ist. |
name |
Der Kurzname dieser ÖPNV-Linie. Das ist normalerweise eine Nummer wie „M7“ oder „355“. |
text |
Die Farbe, die üblicherweise für die Beschilderung dieser Linie verwendet wird. Hexadezimal dargestellt. |
vehicle |
Der Fahrzeugtyp, der auf dieser ÖPNV-Linie eingesetzt wird. |
TransitAgency
Ein Betreiber, der eine ÖPNV-Linie betreibt.
JSON-Darstellung |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
Felder | |
---|---|
name |
Der Name des Betreibers. |
phone |
Die länderspezifische Telefonnummer des Betreibers. |
uri |
Der URI des Betreibers. |
TransitVehicle
Informationen zu einem Fahrzeug, das auf ÖPNV-Routen eingesetzt wird.
JSON-Darstellung |
---|
{ "name": { object ( |
Felder | |
---|---|
name |
Der Name dieses Fahrzeugs, großgeschrieben. |
type |
Der verwendete Fahrzeugtyp. |
icon |
Die URI für ein Symbol, das mit diesem Fahrzeugtyp verknüpft ist. |
local |
Der URI für das Symbol, das diesem Fahrzeugtyp zugeordnet ist, und basiert auf der Beschilderung. |
TransitVehicleType
Der Fahrzeugtyp für ÖPNV-Routen.
Enums | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Nicht verwendet |
BUS |
Bus |
CABLE_CAR |
Ein Fahrzeug, das über Kabel betrieben wird, normalerweise am Boden. Luftseilbahnen haben den Typ GONDOLA_LIFT . |
COMMUTER_TRAIN |
Schnellbahn |
FERRY |
Fähre |
FUNICULAR |
Ein Fahrzeug, das mit einem Kabel eine starke Steigung hinaufgezogen wird. Besteht normalerweise aus zwei Wagen, von denen einer als Gegengewicht zum anderen dient. |
GONDOLA_LIFT |
Eine Luftseilbahn. |
HEAVY_RAIL |
Eisenbahn |
HIGH_SPEED_TRAIN |
Schnellzug |
INTERCITY_BUS |
Fernbus |
LONG_DISTANCE_TRAIN |
Fernzug. |
METRO_RAIL |
Stadtbahn |
MONORAIL |
Einschienenbahn |
OTHER |
Alle anderen Fahrzeuge |
RAIL |
Schienenverkehr |
SHARE_TAXI |
Sammeltaxi |
SUBWAY |
U-Bahn |
TRAM |
Straßenbahn |
TROLLEYBUS |
Oberleitungsbus |
RouteLegTravelAdvisory
Enthält die zusätzlichen Informationen, über die der Nutzer bei einem Streckenabschnitt informiert werden sollte, z. B. mögliche Einschränkungen für Zonen mit Verkehrsbeschränkungen.
JSON-Darstellung |
---|
{ "tollInfo": { object ( |
Felder | |
---|---|
toll |
Enthält Informationen zu Mautgebühren auf der jeweiligen |
speed |
Geschwindigkeitsintervalle mit Angaben zur Verkehrsdichte. Gilt für Beispiel:
|
RouteLegLocalizedValues
Textdarstellungen bestimmter Properties.
JSON-Darstellung |
---|
{ "distance": { object ( |
Felder | |
---|---|
distance |
Die zurückgelegte Strecke in Textform. |
duration |
Dauer, dargestellt in Textform und lokalisiert auf die Region der Suchanfrage. Die Verkehrslage wird berücksichtigt. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, entspricht dieser Wert dem Wert „staticDuration“. |
static |
Dauer ohne Berücksichtigung der Verkehrslage, in Textform |
StepsOverview
Bietet eine Übersicht über eine Liste von RouteLegStep
s.
JSON-Darstellung |
---|
{
"multiModalSegments": [
{
object ( |
Felder | |
---|---|
multi |
Zusammenfassung der Informationen zu den verschiedenen multimodalen Segmenten der |
MultiModalSegment
Bietet zusammengefasste Informationen zu verschiedenen multimodalen Segmenten der RouteLeg.steps
. Ein multimodales Segment wird als ein oder mehrere zusammenhängende RouteLegStep
mit derselben RouteTravelMode
definiert. Dieses Feld wird nicht ausgefüllt, wenn die RouteLeg
in den Schritten keine multimodalen Segmente enthält.
JSON-Darstellung |
---|
{ "navigationInstruction": { object ( |
Felder | |
---|---|
navigation |
Navigationsanleitung für das multimodale Segment. |
travel |
Die Mobilitätsform des multimodalen Abschnitts. |
step |
Der entsprechende |
step |
Der entsprechende |
Darstellungsbereich
Ein Breiten- und Längengrad-Darstellungsbereich, dargestellt als zwei diagonal gegenüberliegende Punkte low
und high
. Ein Darstellungsbereich gilt als geschlossene Region, d.h., er schließt seine Begrenzung ein. Die Breitengradgrenzen müssen zwischen -90 und 90 Grad liegen und die Längengradgrenzen zwischen -180 und 180 Grad. Beispiele für verschiedene Fälle:
Wenn
low
=high
ist, besteht der Darstellungsbereich aus diesem einzelnen Punkt.Wenn
low.longitude
>high.longitude
ist, ist der Längengradbereich umgekehrt (der Darstellungsbereich schneidet den Längengrad 180).Wenn
low.longitude
= -180 Grad undhigh.longitude
= 180 Grad ist, enthält der Darstellungsbereich alle Längengrade.Wenn
low.longitude
= 180 Grad undhigh.longitude
= -180 Grad ist, ist der Längengradbereich leer.Wenn
low.latitude
>high.latitude
ist, ist der Breitengradbereich leer.
Sowohl low
als auch high
müssen ausgefüllt sein und das dargestellte Feld darf nicht leer sein (wie in den Definitionen oben angegeben). Ein leerer Darstellungsbereich führt zu einem Fehler.
Dieser Ansichtsbereich umschließt beispielsweise vollständig New York City:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
JSON-Darstellung |
---|
{ "low": { object ( |
Felder | |
---|---|
low |
Erforderlich. Der tiefste Punkt des Darstellungsbereichs. |
high |
Erforderlich. Der höchste Punkt des Darstellungsbereichs. |
RouteLocalizedValues
Textdarstellungen bestimmter Properties.
JSON-Darstellung |
---|
{ "distance": { object ( |
Felder | |
---|---|
distance |
Die zurückgelegte Strecke in Textform. |
duration |
Dauer, dargestellt in Textform und lokalisiert auf die Region der Suchanfrage. Die Verkehrslage wird berücksichtigt. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, entspricht dieser Wert dem Wert |
static |
Dauer ohne Berücksichtigung der Verkehrslage, in Textform |
transit |
Preis für öffentliche Verkehrsmittel in Textform. |
PolylineDetails
Details, die einem bestimmten Index oder zusammenhängenden Segment einer Polylinie entsprechen. Bei einer Polylinie mit den Punkten P_0, P_1, …, P_N (Index ab null) definiert PolylineDetails
ein Intervall und zugehörige Metadaten.
JSON-Darstellung |
---|
{ "flyoverInfo": [ { object ( |
Felder | |
---|---|
flyover |
Details zur Überflugsstrecke entlang der Polylinie. |
narrow |
Details zu schmalen Straßen entlang der Polylinie. |
FlyoverInfo
Enthält Informationen zu Flyovers entlang der Polylinie.
JSON-Darstellung |
---|
{ "flyoverPresence": enum ( |
Felder | |
---|---|
flyover |
Nur Ausgabe. Gibt an, ob für einen bestimmten Abschnitt der Polylinie eine Flyover-Ansicht vorhanden ist. |
polyline |
Die Position von Informationen zu Überflügen entlang der Polylinie. |
RoadFeatureState
Kapselt die Status von Straßenelementen entlang eines Polylinienabschnitts ein.
Enums | |
---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
Der Status der Straßenelemente wurde nicht berechnet (Standardwert). |
EXISTS |
Die Straßenelemente sind vorhanden. |
DOES_NOT_EXIST |
Die Straßenelemente sind nicht vorhanden. |
PolylinePointIndex
Umschließt die Start- und Endindexe für ein Polyliniendetail. Wenn die Daten einem einzelnen Punkt entsprechen, sind startIndex
und endIndex
gleich.
JSON-Darstellung |
---|
{ "startIndex": integer, "endIndex": integer } |
Felder | |
---|---|
start |
Der Startindex dieses Details in der Polylinie. |
end |
Der Endindex dieses Details in der Polylinie. |
NarrowRoadInfo
Enthält Informationen zu schmalen Straßen entlang der Polylinie.
JSON-Darstellung |
---|
{ "narrowRoadPresence": enum ( |
Felder | |
---|---|
narrow |
Nur Ausgabe. Gibt an, ob für einen bestimmten Abschnitt der Polylinie eine schmale Straße vorhanden ist. |
polyline |
Der Standort von Informationen zu schmalen Straßen entlang der Polylinie. |
GeocodingResults
Enthält
für Start-, Ziel- und Zwischenwegpunkte. Wird nur für Wegpunkte von Adressen ausgefüllt.GeocodedWaypoints
JSON-Darstellung |
---|
{ "origin": { object ( |
Felder | |
---|---|
origin |
Geocodierter Startpunkt. |
destination |
Geocodierter Wegpunkt für das Ziel. |
intermediates[] |
Eine Liste von Zwischen-Wegpunkten, die jeweils ein Indexfeld enthalten, das der Position des Wegpunkts (gezählt ab null) in der Reihenfolge entspricht, in der sie in der Anfrage angegeben wurden. |
GeocodedWaypoint
Details zu den als Wegpunkte verwendeten Standorten. Wird nur für Wegpunkte von Adressen ausgefüllt. Enthält Details zu den Geocoding-Ergebnissen, um zu ermitteln, wo die Adresse geocodiert wurde.
JSON-Darstellung |
---|
{
"geocoderStatus": {
object ( |
Felder | |
---|---|
geocoder |
Gibt den Statuscode des Geocoding-Vorgangs an. |
type[] |
Der Typ oder die Typen des Ergebnisses in Form von null oder mehr Typ-Tags. Unterstützte Typen: Typen von Adressen und Adresskomponenten |
partial |
Gibt an, dass der Geocoder keine genaue Übereinstimmung für die ursprüngliche Anfrage zurückgegeben hat, obwohl ein Teil der angeforderten Adresse zugeordnet werden konnte. Überprüfen Sie ggf. die Anforderung auf Tippfehler und/oder Unvollständigkeit. |
place |
Die Orts-ID für dieses Ergebnis. |
intermediate |
Der Index des entsprechenden Zwischen-Wegpunkts in der Anfrage. Wird nur ausgefüllt, wenn der entsprechende Wegpunkt ein Zwischenwegpunkt ist. |