- HTTP-Anfrage
- Anfragetext
- Antworttext
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Route
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- RouteLabel
- RouteLeg
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Polyline
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- RouteLegStep
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- NavigationInstruction
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Maneuver
- RouteLegStepTravelAdvisory
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- RouteLegStepLocalizedValues
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- RouteLegStepTransitDetails
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TransitStopDetails
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TransitStop
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TransitDetailsLocalizedValues
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- LocalizedTime
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TransitLine
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TransitAgency
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TransitVehicle
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TransitVehicleType
- RouteLegTravelAdvisory
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- RouteLegLocalizedValues
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- StepsOverview
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- MultiModalSegment
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Darstellungsbereich
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- RouteLocalizedValues
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- GeocodingResults
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- GeocodedWaypoint
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
Gibt die primäre Route zusammen mit optionalen alternativen Routen zurück, wobei eine Reihe von Terminal- und Zwischenwegpunkten angegeben wird.
HINWEIS:Bei dieser Methode müssen Sie in der Eingabe eine Antwortfeldmaske angeben. Sie können die Antwortfeldmaske mithilfe des URL-Parameters $fields
oder fields
oder mit dem HTTP/gRPC-Header X-Goog-FieldMask
bereitstellen. Weitere Informationen zu verfügbaren URL-Parametern und -Headern Der Wert ist eine durch Kommas getrennte Liste von Feldpfaden. Ausführliche Informationen finden Sie unter Feldpfade erstellen.
Zum Beispiel in dieser Methode:
- Feldmaske aller verfügbaren Felder (für die manuelle Prüfung):
X-Goog-FieldMask: *
- Feldmaske mit 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 Platzhalter-Antwortfeldmaske (*
) zu verwenden oder die Feldmaske auf oberster Ebene (routes
) anzugeben, weil:
- Indem Sie nur die Felder auswählen, die Sie benötigen, spart unser Server Berechnungszyklen, sodass wir das Ergebnis mit einer geringeren Latenz an Sie zurückgeben können.
- Wenn Sie nur die Felder auswählen, die Sie für Ihren Produktionsjob benötigen, wird eine stabile Latenzleistung sichergestellt. Möglicherweise fügen wir in Zukunft weitere Antwortfelder hinzu und diese neuen Felder erfordern möglicherweise zusätzliche Rechenzeit. Wenn Sie alle Felder oder alle Felder auf der obersten Ebene auswählen, kann es zu Leistungseinbußen kommen, da jedes neu hinzugefügte Feld automatisch in die Antwort aufgenommen wird.
- Wenn Sie nur die Felder auswählen, die Sie benötigen, führt dies zu einer kleineren Antwortgröße und damit zu einem höheren Netzwerkdurchsatz.
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. Ursprungswegpunkt. |
destination |
Erforderlich. Zielwegpunkt. |
intermediates[] |
Optional. Eine Gruppe von Wegpunkten entlang der Route (mit Ausnahme von Endpunkten), die an einem Zwischenstopp stehen oder an einem vorbeigehen. Es werden bis zu 25 Wegpunkte unterstützt. |
travelMode |
Optional. Gibt die Mobilitätsform an. |
routingPreference |
Optional. Gibt an, wie die Route berechnet wird. Der Server versucht, die Route anhand der ausgewählten Routingeinstellung zu berechnen. Wenn die Routingeinstellung zu einem Fehler oder zu einer sehr langen Latenz führt, wird ein Fehler zurückgegeben. Sie können diese Option nur angeben, wenn |
polylineQuality |
Optional. Gibt die Qualität der Polylinie an. |
polylineEncoding |
Optional. Gibt die bevorzugte Codierung für die Polylinie an. |
departureTime |
Optional. Die Abfahrtszeit. Wenn Sie diesen Wert nicht festlegen, wird standardmäßig der Zeitpunkt der Anfrage verwendet. HINWEIS: Sie können nur einen Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
arrivalTime |
Optional. 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: |
computeAlternativeRoutes |
Optional. Gibt an, ob neben der Route alternative Routen berechnet werden sollen. Bei Anfragen mit Wegpunkten werden keine alternativen Routen zurückgegeben. |
routeModifiers |
Optional. Eine Reihe von Bedingungen, die erfüllt sein müssen und sich auf die Berechnung der Routen auswirken. |
languageCode |
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 Ort der Routenanfrage abgeleitet. |
regionCode |
Optional. Der Regionscode, angegeben als zweistelliger ccTLD-Wert ("top-level domain"). Weitere Informationen finden Sie unter Ländercode-Top-Level-Domains. |
units |
Optional. Gibt die Maßeinheiten für die Anzeigefelder an. Zu diesen Feldern gehört das Feld |
optimizeWaypointOrder |
Optional. Wenn dieser Wert auf „true“ gesetzt ist, versucht der Dienst, die Gesamtkosten der Route durch eine Neuanordnung der angegebenen Zwischenwegpunkte zu minimieren. Die Anfrage schlägt fehl, wenn einer der Wegzwischenpunkte ein |
requestedReferenceRoutes[] |
Optional. Gibt an, welche Referenzrouten zusätzlich zur Standardroute als Teil der Anfrage berechnet werden sollen. Eine Referenzroute ist eine Route, deren Berechnungsziel von der Standardroute abweicht. Bei der Berechnung einer |
extraComputations[] |
Optional. Eine Liste zusätzlicher Berechnungen, die zur Vervollständigung der Anfrage verwendet werden können. Hinweis: Durch diese zusätzlichen Berechnungen können in der Antwort zusätzliche Felder zurückgegeben werden. Diese zusätzlichen Felder müssen auch in der Feldmaske angegeben werden, damit sie in der Antwort zurückgegeben werden. |
trafficModel |
Optional. Gibt die Annahmen an, die bei der Berechnung der Reisezeit verwendet werden sollen. Diese Einstellung wirkt sich auf den Wert aus, der im Feld „Dauer“ in |
transitPreferences |
Optional. Gibt Einstellungen an, die sich auf die für |
Antworttext
v2.computeRoute leitet die Antwortnachricht weiter.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "routes": [ { object ( |
Felder | |
---|---|
routes[] |
Enthält ein Array von berechneten Routen (bis zu drei), wenn Sie |
fallbackInfo |
Wenn der Server die Routenergebnisse nicht mit allen Eingabepräferenzen berechnen kann, greift er unter Umständen auf eine andere Berechnungsmethode zurück. Wenn der Fallback-Modus verwendet wird, enthält dieses Feld detaillierte Informationen zur Fallback-Antwort. Andernfalls ist dieses Feld nicht festgelegt. |
geocodingResults |
Enthält Geocoding-Antwortinformationen für als Adressen angegebene Wegpunkte. |
PolylineQuality
Eine Reihe von Werten, die die Qualität der Polylinie angeben.
Enums | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Keine Einstellung für die Polylinienqualität angegeben. Die Standardeinstellung ist OVERVIEW . |
HIGH_QUALITY |
Gibt eine Polylinie von hoher Qualität an, die aus mehr Punkten als OVERVIEW zusammengesetzt ist, allerdings zulasten einer größeren Antwortgröße. Verwenden Sie diesen Wert, wenn Sie mehr Genauigkeit benötigen. |
OVERVIEW |
Gibt eine Übersichtspolygone an, die sich aus einer kleinen Anzahl von Punkten zusammensetzt. Verwenden Sie diesen Wert, wenn Sie eine Übersicht der Route anzeigen lassen. Diese Option hat eine niedrigere Anfragelatenz als die Option HIGH_QUALITY . |
PolylineEncoding
Gibt den bevorzugten Typ der Polylinie an, die zurückgegeben werden soll.
Enums | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Keine Einstellung für Polylinientyp angegeben. Die Standardeinstellung ist ENCODED_POLYLINE . |
ENCODED_POLYLINE |
Gibt eine Polylinie an, die mithilfe des Codierungsalgorithmus für Polylinien codiert wurde. |
GEO_JSON_LINESTRING |
Gibt eine Polylinie im GeoJSON-LineString-Format an |
ReferenceRoute
Eine unterstützte Referenzroute in ComputeRoutesRequest.
Enums | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Nicht verwendet. Anfragen, die diesen Wert enthalten, schlagen fehl. |
FUEL_EFFICIENT |
Spritsparende Route. Routen, die mit diesem Wert gekennzeichnet sind, sind für Parameter wie den Kraftstoffverbrauch optimiert. |
ExtraComputation
Zusätzliche Berechnungen, die während der Anfrage ausgeführt werden müssen.
Enums | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Nicht verwendet. Anfragen, die diesen Wert enthalten, schlagen fehl. |
TOLLS |
Mautinformationen für die Route(n). |
FUEL_CONSUMPTION |
Geschätzter Kraftstoffverbrauch für die Route(n). |
TRAFFIC_ON_POLYLINE |
Polylinien für die Verkehrslage der Route(n). |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions wird als formatierter HTML-Textstring dargestellt. Dieser Inhalt ist so zu lesen, wie er ist. Dieser Inhalt dient nur der Anzeige. Parsen Sie ihn nicht programmatisch. |
Route
Enthält eine Route, die aus einer Reihe verbundener Straßenabschnitte besteht, die Wegpunkte am Anfang, Ende und in der Mitte verbinden.
JSON-Darstellung |
---|
{ "routeLabels": [ enum ( |
Felder | |
---|---|
routeLabels[] |
Labels für die |
legs[] |
Eine Sammlung von Streckenabschnitten zwischen Wegpunkten, aus denen die Route besteht. Jeder Abschnitt entspricht der Fahrt zwischen zwei Nicht- |
distanceMeters |
Die Entfernung der Route in Metern. |
duration |
Die für die Navigation der Route erforderliche Zeit. Wenn Sie Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
staticDuration |
Die Dauer der Fahrt auf der Route ohne Berücksichtigung der Verkehrslage. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
polyline |
Die gesamte Polylinie der Route. Diese Polylinie ist die kombinierte Polylinie aller |
description |
Eine Beschreibung der Route. |
warnings[] |
Ein Array mit Warnungen, die beim Anzeigen der Route angezeigt werden sollen. |
viewport |
Der Markierungsrahmen des Darstellungsbereichs der Polylinie. |
travelAdvisory |
Zusätzliche Informationen zur Route. |
optimizedIntermediateWaypointIndex[] |
Wenn Sie |
localizedValues |
Textdarstellungen von Attributen von |
routeToken |
Ein websicheres, base64-codiertes Routentoken, das an das Navigation SDK übergeben werden kann, mit dem das Navigation SDK die Route während der Navigation rekonstruieren kann und im Fall einer Neuberechnung der Route durch Aufrufen von v2.computeRoutes die ursprüngliche Absicht berücksichtigt. Kunden sollten dieses Token als intransparentes Blob behandeln. Vergleichen Sie seinen Wert nicht über verschiedene Anfragen. Dieses Token kann sich ändern, auch wenn genau die gleiche Route zurückgegeben wurde. HINWEIS: |
RouteLabel
Labels für die
, mit denen bestimmte Eigenschaften der Route angegeben werden können, um sie mit anderen zu vergleichen.Route
Enums | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Standardeinstellung: nicht verwendet. |
DEFAULT_ROUTE |
Die Standardeinstellung „Am besten“ für die Routenberechnung zurückgegebene Route. |
DEFAULT_ROUTE_ALTERNATE |
Eine Alternative zur Standardeinstellung „Am besten“ Route. Solche Routen werden zurückgegeben, wenn angegeben ist. |
FUEL_EFFICIENT |
Spritsparende Route. Routen, die mit diesem Wert gekennzeichnet sind, sind für Eco-Parameter wie den Kraftstoffverbrauch optimiert. |
RouteLeg
Enthält ein Segment zwischen Wegpunkten, die nicht zu via
gehören.
JSON-Darstellung |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Felder | |
---|---|
distanceMeters |
Die Strecke des Streckenabschnitts in Metern. |
duration |
Die Zeit, die zum Navigieren im Bein benötigt wird. Wenn Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
staticDuration |
Die Dauer der Fahrt durch einen Abschnitt, die ohne Berücksichtigung der Verkehrslage berechnet wird. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
polyline |
Die gesamte Polylinie für diesen Abschnitt, die die Polylinie jeder |
startLocation |
Die Startposition dieses Streckenabschnitts. Dieser Standort kann sich vom angegebenen |
endLocation |
Der Endstandort dieses Abschnitts. Dieser Standort kann sich vom angegebenen |
steps[] |
Ein Array von Schritten, die Segmente innerhalb dieses Abschnitts angeben. Jeder Schritt stellt eine Navigationsanweisung dar. |
travelAdvisory |
Enthält die zusätzlichen Informationen, über die der Nutzer auf einem Streckenabschnitt informiert werden sollte, z. B. mögliche Einschränkungen einer Verkehrszone. |
localizedValues |
Textdarstellungen von Attributen von |
stepsOverview |
Übersicht über die Schritte in diesem |
Polyline
Kapselt eine codierte Polylinie ein.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld polyline_type . Kapselt den Typ der Polylinie ein. Die Standardeinstellung ist encoded_polyline. Für polyline_type ist nur einer der folgenden Werte zulässig: |
|
encodedPolyline |
Die Stringcodierung der Polylinie unter Verwendung des Algorithmus für die Polyliniencodierung. |
geoJsonLinestring |
Gibt eine Polylinie im GeoJSON-LineString-Format an. |
RouteLegStep
Enthält ein Segment eines
. Ein Schritt entspricht einer einzelnen Navigationsanweisung. Streckenabschnitte bestehen aus Schritten.RouteLeg
JSON-Darstellung |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Felder | |
---|---|
distanceMeters |
Die zurückgelegte Strecke dieses Schrittes in Metern. Unter bestimmten Umständen enthält dieses Feld keinen Wert. |
staticDuration |
Die Dauer der Reise für diesen Schritt ohne Berücksichtigung der Verkehrslage. Unter bestimmten Umständen enthält dieses Feld keinen Wert. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
polyline |
Die mit diesem Schritt verknüpfte Polylinie. |
startLocation |
Die Startposition dieses Schritts. |
endLocation |
Der Endstandort dieses Schritts. |
navigationInstruction |
Navigationsanweisungen |
travelAdvisory |
Enthält die zusätzlichen Informationen, über die der Nutzer bei einem Etappenschritt informiert werden muss, z. B. mögliche Einschränkungen in einer Verkehrszone. |
localizedValues |
Textdarstellungen von Attributen von |
transitDetails |
Details zu diesem Schritt, wenn die Mobilitätsform |
travelMode |
Die für diesen Schritt verwendete Mobilitätsform. |
Manöver
Eine Reihe von Werten, die die Navigationsaktion angeben, die für den aktuellen Schritt ausgeführt werden soll (z. B. links abbiegen, verbinden oder gerade).
Enums | |
---|---|
MANEUVER_UNSPECIFIED |
Nicht verwendet. |
TURN_SLIGHT_LEFT |
Leicht nach links abbiegen. |
TURN_SHARP_LEFT |
Scharf nach links abbiegen. |
UTURN_LEFT |
Wenden. |
TURN_LEFT |
Links abbiegen. |
TURN_SLIGHT_RIGHT |
Leicht nach rechts abbiegen. |
TURN_SHARP_RIGHT |
Scharf nach rechts abbiegen. |
UTURN_RIGHT |
Wenden. |
TURN_RIGHT |
Rechts abbiegen. |
STRAIGHT |
Fahren Sie geradeaus. |
RAMP_LEFT |
Nimm die linke Auffahrt. |
RAMP_RIGHT |
Dann nehmen Sie die rechte Auffahrt. |
MERGE |
Zusammenführen in Traffic. |
FORK_LEFT |
Nimm die linke Gabelung. |
FORK_RIGHT |
Nimm die rechte Gabel. |
FERRY |
Nimm die Fähre. |
FERRY_TRAIN |
Nehmen Sie den Zug, der zur Fähre führt. |
ROUNDABOUT_LEFT |
Biegen Sie am Kreisverkehr links ab. |
ROUNDABOUT_RIGHT |
Im Kreisverkehr rechts abbiegen. |
DEPART |
Anfängliche Manöver. |
NAME_CHANGE |
Wird verwendet, um eine Änderung des Straßennamens anzugeben. |
RouteLegStepTravelAdvisory
Enthält die zusätzlichen Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen in einer Verkehrszone bei einem Beinschritt.
JSON-Darstellung |
---|
{
"speedReadingIntervals": [
{
object ( |
Felder | |
---|---|
speedReadingIntervals[] |
HINWEIS: Dieses Feld ist derzeit nicht ausgefüllt. |
RouteLegStepLocalizedValues
Textdarstellungen bestimmter Eigenschaften.
JSON-Darstellung |
---|
{ "distance": { object ( |
Felder | |
---|---|
distance |
In Textform dargestellte Reisestrecke. |
staticDuration |
Dauer ohne Berücksichtigung der Verkehrslage, dargestellt in Textform. |
RouteLegStepTransitDetails
Zusätzliche Informationen für RouteLegStep
in Bezug auf TRANSIT
-Routen.
JSON-Darstellung |
---|
{ "stopDetails": { object ( |
Felder | |
---|---|
stopDetails |
Informationen zu den Ankunfts- und Abfahrtsorten für den Schritt. |
localizedValues |
Textdarstellungen von Attributen von |
headsign |
Gibt die Fahrtrichtung auf dieser Linie an, die auf dem Fahrzeug oder an der Abfahrtshaltestelle angegeben ist. Die Richtung entspricht oft der Endhaltestelle. |
headway |
Gibt die erwartete Zeit als Dauer zwischen Abfahrten von derselben Haltestelle zu diesem Zeitpunkt an. Bei einem Taktsekundenwert von 600 wäre beispielsweise mit einer Wartezeit von zehn Minuten zu rechnen, wenn Sie Ihren Bus verpassen sollten. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
transitLine |
Informationen zu der ÖPNV-Linie, die in diesem Schritt verwendet wird. |
stopCount |
Die Anzahl der Haltestellen von der Abfahrt bis zur Ankunftshaltestelle. Die Anzahl umfasst die Ankunftshaltestelle, die Starthaltestelle aber nicht. Wenn Ihre Route beispielsweise an Haltestelle A abfährt, über die Haltestellen B und C führt und an Haltestelle D ankommt, gibt stopCount 3 zurück. |
tripShortText |
Der Text, der in Fahrplänen und Schildern angezeigt wird, um Fahrgästen eine Fahrt mit öffentlichen Verkehrsmitteln zu kennzeichnen. Mit dem Text sollte eine Fahrt innerhalb eines Betriebstages eindeutig gekennzeichnet werden. Beispiel: „538“ ist die |
TransitStopDetails
Details zu den Haltestellen für die RouteLegStep
.
JSON-Darstellung |
---|
{ "arrivalStop": { object ( |
Felder | |
---|---|
arrivalStop |
Informationen zur Ankunftshaltestelle für den Schritt. |
arrivalTime |
Die geschätzte Ankunftszeit für den Schritt. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
departureStop |
Informationen zur Abfahrtshaltestelle für den Schritt. |
departureTime |
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 |
Die Position der Haltestelle in Breiten- und Längengraden. |
TransitDetailsLocalizedValues
Lokalisierte Beschreibungen der Werte für RouteTransitDetails
.
JSON-Darstellung |
---|
{ "arrivalTime": { object ( |
Felder | |
---|---|
arrivalTime |
Zeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone. |
departureTime |
Zeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone. |
LocalizedTime
Lokalisierte Beschreibung der Zeit.
JSON-Darstellung |
---|
{
"time": {
object ( |
Felder | |
---|---|
time |
Die als String in einer bestimmten Zeitzone angegebene Zeit. |
timeZone |
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 zu der ÖPNV-Linie, die in diesem Schritt verwendet wird.
JSON-Darstellung |
---|
{ "agencies": [ { object ( |
Felder | |
---|---|
agencies[] |
Der oder die Betreiber der ÖPNV-Linie. |
name |
Der vollständige Name dieser ÖPNV-Linie, z. B. „Hauptbahnhof“. |
uri |
URI für diese ÖPNV-Linie, wie sie vom Betreiber bereitgestellt wurde. |
color |
Die Farbe, die üblicherweise für die Beschilderung dieser Linie verwendet wird. Wird hexadezimal dargestellt. |
iconUri |
URI für das Symbol, das dieser Linie zugeordnet ist. |
nameShort |
Der Kurzname dieser ÖPNV-Linie. Dieser Name ist normalerweise eine Nummer wie „M7“ oder „355“. |
textColor |
Die übliche Farbe, die im Text auf Beschilderungen dieser Linie verwendet wird. 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. |
phoneNumber |
Die länderspezifische formatierte Telefonnummer des Verkehrsverbunds. |
uri |
Der URI des Verkehrsverbunds. |
TransitVehicle
Informationen zu einem Fahrzeug, das auf Routen mit öffentlichen Verkehrsmitteln verwendet wird.
JSON-Darstellung |
---|
{ "name": { object ( |
Felder | |
---|---|
name |
Der Name dieses Fahrzeugs in Großbuchstaben. |
type |
Der Typ des verwendeten Fahrzeugs. |
iconUri |
URI für ein Symbol, das diesem Fahrzeugtyp zugeordnet ist. |
localIconUri |
Der URI für das Symbol, das diesem Fahrzeugtyp zugeordnet ist, basierend auf der Beschilderung für lokale Verkehrsmittel. |
TransitVehicleType
Der Fahrzeugtyp für Routen mit öffentlichen Verkehrsmitteln.
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 Etappenschritt informiert werden sollte, z. B. mögliche Einschränkungen in einer Verkehrszone.
JSON-Darstellung |
---|
{ "tollInfo": { object ( |
Felder | |
---|---|
tollInfo |
Enthält Informationen zu Mautgebühren für die jeweilige |
speedReadingIntervals[] |
Geschwindigkeitsleseintervalle zur detaillierten Verkehrsdichte. Anwendbar bei den Routingeinstellungen Beispiel:
|
RouteLegLocalizedValues
Textdarstellungen bestimmter Eigenschaften.
JSON-Darstellung |
---|
{ "distance": { object ( |
Felder | |
---|---|
distance |
In Textform dargestellte Reisestrecke. |
duration |
In Textform dargestellte Dauer unter Berücksichtigung der Verkehrsbedingungen. Hinweis: Wenn Sie keine Traffic-Informationen angefordert haben, entspricht dieser Wert dem Wert von „staticDuration“. |
staticDuration |
Dauer ohne Berücksichtigung der Verkehrslage, dargestellt in Textform. |
StepsOverview
Bietet eine Übersicht über eine Liste von RouteLegStep
s.
JSON-Darstellung |
---|
{
"multiModalSegments": [
{
object ( |
Felder | |
---|---|
multiModalSegments[] |
Zusammengefasste Informationen zu verschiedenen multimodalen Segmenten des |
MultiModalSegment
Bietet zusammengefasste Informationen zu verschiedenen multimodalen Segmenten des RouteLeg.steps
. Ein multimodales Segment wird als eine oder mehrere zusammenhängende RouteLegStep
mit demselben RouteTravelMode
definiert. Dieses Feld wird nicht ausgefüllt, wenn RouteLeg
keine multimodalen Segmente in den Schritten enthält.
JSON-Darstellung |
---|
{ "navigationInstruction": { object ( |
Felder | |
---|---|
navigationInstruction |
NavigationInstruction für das multimodale Segment. |
travelMode |
Die Mobilitätsform des multimodalen Segments. |
stepStartIndex |
Der entsprechende |
stepEndIndex |
Der entsprechende |
Darstellungsbereich
Ein Darstellungsbereich für Breiten- und Längengrad, dargestellt als zwei diagonal gegenüberliegende low
- und high
-Punkte Ein Darstellungsbereich gilt als geschlossener Bereich, d.h. er enthält seine Begrenzung. Die Breitengradgrenzen müssen zwischen -90 und einschließlich 90 Grad und die Längengradgrenzen zwischen -180 und 180 Grad liegen. Es gibt verschiedene Fälle:
Wenn
low
=high
, besteht der Darstellungsbereich aus diesem einzelnen Punkt.Wenn
low.longitude
>high.longitude
wird der Längengradbereich umgekehrt (der Darstellungsbereich kreuzt die 180-Grad-Längenlinie).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
, der Breitengradbereich ist leer.
Sowohl low
als auch high
müssen ausgefüllt werden und das dargestellte Feld darf nicht leer sein (wie in den Definitionen oben angegeben). Ein leerer Darstellungsbereich führt zu einem Fehler.
Dieser Darstellungsbereich schließt beispielsweise New York City vollständig ein:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
JSON-Darstellung |
---|
{ "low": { object ( |
Felder | |
---|---|
low |
Erforderlich. Der Tiefstpunkt des Darstellungsbereichs. |
high |
Erforderlich. Der höchste Punkt des Darstellungsbereichs. |
RouteLocalizedValues
Textdarstellungen bestimmter Eigenschaften.
JSON-Darstellung |
---|
{ "distance": { object ( |
Felder | |
---|---|
distance |
In Textform dargestellte Reisestrecke. |
duration |
In Textform dargestellte Dauer unter Berücksichtigung der Verkehrsbedingungen. Hinweis: Wenn Sie keine Traffic-Informationen angefordert haben, entspricht dieser Wert dem Wert |
staticDuration |
Dauer ohne Berücksichtigung der Verkehrslage, dargestellt in Textform. |
transitFare |
Fahrpreis in Textform |
GeocodingResults
Enthält
für Start- und Zielort sowie Wegpunkte. Wird nur für Wegpunkte der Adresse ausgefüllt.GeocodedWaypoints
JSON-Darstellung |
---|
{ "origin": { object ( |
Felder | |
---|---|
origin |
Geocodierter Startwegpunkt. |
destination |
Geocodierter Wegpunkt für das Ziel. |
intermediates[] |
Eine Liste mit geocodierten Zwischenpunkten, die jeweils ein Indexfeld enthalten, das der nullbasierten Position des Wegpunkts in der Reihenfolge entspricht, in der sie in der Anfrage angegeben wurden. |
GeocodedWaypoint
Details zu den Standorten, die als Wegpunkte verwendet werden Wird nur für Wegpunkte der Adresse ausgefüllt. Enthält Details über die Geocoding-Ergebnisse, um zu bestimmen, für welche Adresse die Adresse geocodiert wurde.
JSON-Darstellung |
---|
{
"geocoderStatus": {
object ( |
Felder | |
---|---|
geocoderStatus |
Gibt den Statuscode des Geocoding-Vorgangs an. |
type[] |
Die Art(en) des Ergebnisses in Form von null oder mehr Typ-Tags. Unterstützte Typen: Adresstypen und Adresskomponententypen. |
partialMatch |
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. |
placeId |
Die Orts-ID für dieses Ergebnis. |
intermediateWaypointRequestIndex |
Der Index des entsprechenden Wegpunkts in der Anfrage. Wird nur gefüllt, wenn der entsprechende Wegpunkt ein Zwischenwegpunkt ist. |