- HTTP-Anfrage
- Anfragetext
- Antworttext
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Route
- RouteLabel
- RouteLeg
- Polyline
- RouteLegStep
- NavigationInstruction
- Maneuver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Viewport
- RouteLocalizedValues
- PolylineDetails
- TunnelInfo
- RoadFeatureState
- PolylinePointIndex
- RestrictionInfo
- FlyoverInfo
- NarrowRoadInfo
- BridgeInfo
- SkywayInfo
- GeocodingResults
- GeocodedWaypoint
Gibt die primäre Route zusammen mit optionalen alternativen Routen zurück, wenn eine Reihe von End- und Zwischenwegpunkten angegeben wird.
HINWEIS:Bei dieser Methode müssen Sie im Input eine Maske für das Antwortfeld angeben. Sie können die Maske für das Antwortfeld mit dem URL-Parameter $fields oder fields oder mit dem 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 der Feldpfade
Beispiel:
- Feldmaske aller verfügbaren Felder (zur manuellen Überprüfung):
X-Goog-FieldMask: * - Feldmaske für Dauer, Entfernung und Polylinie auf Routenebene (Beispiel für die Produktionseinrichtung):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google rät von der Verwendung der Platzhalter-Feldmaske (*) oder der Angabe der Feldmaske auf oberster Ebene (routes) ab, da:
- Wenn Sie nur die benötigten Felder auswählen, kann unser Server Rechenzyklen sparen und wir können Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben.
- Wenn Sie nur die Felder auswählen, die Sie für Ihren Produktionsjob benötigen, wird eine stabile Latenzleistung gewährleistet. Möglicherweise werden in Zukunft weitere Antwortfelder hinzugefügt, die zusätzliche Rechenzeit erfordern. Wenn Sie alle Felder oder alle Felder auf der obersten 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 Felder auswählen, die Sie benötigen, ist die Antwortgröße 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. Ausgangspunkt. |
destination |
Erforderlich. Ziel-Wegpunkt. |
intermediates[] |
Optional. Eine Reihe von Wegpunkten entlang der Route (mit Ausnahme der Endpunkte), an denen entweder angehalten oder vorbeigefahren wird. Es werden bis zu 25 Wegpunkte unterstützt. |
travelMode |
Optional. Gibt die Mobilitätsform an. |
routingPreference |
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 einer besonders langen Latenz führt, wird ein Fehler zurückgegeben. Sie können diese Option nur angeben, wenn |
polylineQuality |
Optional. Gibt Ihre Einstellung für 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 die Uhrzeit verwendet, zu der Sie die Anfrage gestellt haben. HINWEIS: Sie können nur dann ein 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: |
arrivalTime |
Optional. Die Ankunftszeit. HINWEIS: Dieses Feld wird ignoriert, wenn in Anfragen ein anderer 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: |
computeAlternativeRoutes |
Optional. Gibt an, ob zusätzlich zur Route alternative Routen berechnet werden sollen. Für Anfragen mit Wegpunkten werden keine alternativen Routen zurückgegeben. |
routeModifiers |
Optional. Eine Reihe von Bedingungen, die sich auf die Berechnung von 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 Standort der Routenanfrage abgeleitet. |
regionCode |
Optional. Der Regionscode, angegeben als zweistelliger Ländercode der Top-Level-Domain (ccTLD). Weitere Informationen finden Sie unter Länderspezifische Top-Level-Domains. |
units |
Optional. Gibt die Maßeinheiten für die Anzeigefelder an. Zu diesen Feldern gehört das Feld |
optimizeWaypointOrder |
Optional. Wenn auf „true“ gesetzt, versucht der Dienst, die Gesamtkosten der Route zu minimieren, indem er die angegebenen Zwischenziele neu anordnet. Die Anfrage schlägt fehl, wenn einer der Zwischenwegpunkte ein |
requestedReferenceRoutes[] |
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 |
extraComputations[] |
Optional. Eine Liste zusätzlicher Berechnungen, die zur Bearbeitung der Anfrage verwendet werden können. Hinweis: Bei diesen zusätzlichen Berechnungen werden möglicherweise zusätzliche Felder in der Antwort zurückgegeben. 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 Duration-Feld in |
transitPreferences |
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 berechneten Routen (bis zu drei), wenn Sie |
fallbackInfo |
In einigen Fällen, in denen der Server die Routenergebnisse nicht mit allen Eingabeeinstellungen berechnen kann, wird möglicherweise auf eine andere Berechnungsmethode zurückgegriffen. Wenn der Fallback-Modus verwendet wird, enthält dieses Feld detaillierte Informationen zur Fallback-Antwort. Andernfalls ist dieses Feld nicht festgelegt. |
geocodingResults |
Enthält Informationen zur Geocoding-Antwort für Wegpunkte, die als Adressen angegeben sind. |
PolylineQuality
Eine Reihe von Werten, die die Qualität der Polylinie angeben.
| Enums | |
|---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Keine Einstellung für die Qualität von Polylinien angegeben. Die Standardeinstellung ist OVERVIEW. |
HIGH_QUALITY |
Gibt eine hochwertige Polylinie an, die aus mehr Punkten als OVERVIEW besteht. Dies führt zu einer größeren Antwort. Verwenden Sie diesen Wert, wenn Sie mehr Präzision benötigen. |
OVERVIEW |
Gibt eine Übersichtspolylinie an, die aus einer kleinen Anzahl von Punkten besteht. Verwenden Sie diesen Wert, wenn Sie eine Übersicht der Route anzeigen. Die Verwendung dieser Option führt zu einer geringeren Anfragelatenz als die Verwendung der Option HIGH_QUALITY. |
PolylineEncoding
Gibt den bevorzugten Typ der zurückzugebenden Polylinie an.
| Enums | |
|---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Es wurde keine Einstellung für den Polylinien-Typ 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-Format „LineString“ an. |
ReferenceRoute
Eine unterstützte Referenzroute im 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 Mobilitätsformen, Zwischenwegpunkten oder |
ExtraComputation
Zusätzliche Berechnungen, die bei der Bearbeitung der Anfrage durchgeführt werden sollen. In Zukunft werden möglicherweise weitere Werte hinzugefügt.
| Enums | |
|---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Nicht verwendet. Anfragen mit diesem Wert 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 Route(n), die die aktuelle Verkehrslage berücksichtigen. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstruction wird als formatierter HTML-Textstring dargestellt. Der 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 Überführungen für die Route(n). Die routes.polyline_details.flyover_info-Feldmaske muss angegeben werden, damit diese Informationen zurückgegeben werden. Diese Daten werden derzeit nur für bestimmte Großräume in Indien erfasst. Diese Funktion ist experimentell und die SKU/Gebühr kann sich ändern. |
NARROW_ROAD_INFO_ON_POLYLINE |
Informationen zu schmalen Straßen für die Route(n). Die routes.polyline_details.narrow_road_info-Feldmaske muss angegeben werden, damit diese Informationen zurückgegeben werden. Diese Daten werden derzeit nur für bestimmte Großräume in Indien erfasst. Diese Funktion ist experimentell und die SKU/Gebühr kann sich ändern. |
TUNNEL_INFO_ON_POLYLINE |
Tunnelinformationen für die Route(n). Die routes.polyline_details.tunnel_info-Feldmaske muss angegeben werden, damit diese Informationen zurückgegeben werden. |
BRIDGE_INFO_ON_POLYLINE |
Brückeninformationen für die Route(n). Die routes.polyline_details.bridge_info-Feldmaske muss angegeben werden, damit diese Informationen zurückgegeben werden. |
SKYWAY_INFO_ON_POLYLINE |
Informationen zu Skyways für die Route(n). Die routes.polyline_details.skyway_info-Feldmaske muss angegeben werden, damit diese Informationen zurückgegeben werden. |
Route
Enthält eine Route, die aus einer Reihe verbundener Straßenabschnitte besteht, die Start-, End- und Zwischenwegpunkte verbinden.
| JSON-Darstellung |
|---|
{ "routeLabels": [ enum ( |
| Felder | |
|---|---|
routeLabels[] |
Labels für die |
legs[] |
Eine Sammlung von Abschnitten (Pfadsegmente zwischen Wegpunkten), aus denen die Route besteht. Jede Etappe entspricht der Fahrt zwischen zwei nicht |
distanceMeters |
Die Entfernung der Route in Metern. |
duration |
Die Zeit, die für die Navigation auf der Route benötigt wird. 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 Polylinie der Gesamtroute. Diese Polylinie ist die kombinierte Polylinie aller |
description |
Eine Beschreibung der Route. |
warnings[] |
Ein Array mit Warnungen, die beim Anzeigen der Route präsentiert werden sollen. |
viewport |
Der Begrenzungsrahmen des Darstellungsbereichs der Polylinie. |
travelAdvisory |
Zusätzliche Informationen zur Route. |
optimizedIntermediateWaypointIndex[] |
Wenn Sie |
localizedValues |
Textdarstellungen von Attributen des |
routeToken |
Ein undurchsichtiges Token, das an das Navigation SDK übergeben werden kann, um die Route während der Navigation zu rekonstruieren und bei einer Umleitung die ursprüngliche Absicht beim Erstellen der Route zu berücksichtigen. Behandeln Sie dieses Token als intransparenten Blob. Vergleichen Sie den Wert nicht über Anfragen hinweg, da er sich ändern kann, auch wenn der Dienst genau dieselbe Route zurückgibt. HINWEIS: |
polylineDetails |
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 |
Standard – nicht verwendet. |
DEFAULT_ROUTE |
Die Standardroute, die für die Routenberechnung zurückgegeben wird. |
DEFAULT_ROUTE_ALTERNATE |
Eine Alternative zur Standardroute „Beste Route“. Solche Routen werden zurückgegeben, wenn angegeben ist. |
FUEL_EFFICIENT |
Spritsparende Route Routen mit diesem Wert sind für ökologische Parameter wie den Kraftstoffverbrauch optimiert. |
SHORTER_DISTANCE |
Route mit kürzerer Fahrstrecke. Dies ist eine experimentelle Funktion. |
RouteLeg
Enthält ein Segment zwischen Nicht-via-Wegpunkten.
| JSON-Darstellung |
|---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
| Felder | |
|---|---|
distanceMeters |
Die zurückzulegende Strecke des Routenabschnitts in Metern. |
duration |
Die Zeit, die für die Navigation auf der Etappe benötigt wird. Wenn Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „ |
staticDuration |
Die Dauer der Fahrt auf dem Abschnitt, berechnet ohne Berücksichtigung der Verkehrslage. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „ |
polyline |
Die Gesamtpolylinie für diesen Abschnitt, die die Polylinie jedes |
startLocation |
Der Startort dieses Abschnitts. Dieser Standort kann sich vom angegebenen |
endLocation |
Der Endpunkt dieses Abschnitts. Dieser Standort kann sich vom angegebenen |
steps[] |
Ein Array mit Schritten, die Segmente innerhalb dieses Legs angeben. Jeder Schritt entspricht einer Navigationsanweisung. |
travelAdvisory |
Enthält die zusätzlichen Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen für Verkehrszonen auf einem Routenabschnitt. |
localizedValues |
Textdarstellungen von Attributen des |
stepsOverview |
Übersichtsinformationen zu den Schritten in diesem |
Polyline
Kapselt eine codierte Polylinie.
| JSON-Darstellung |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "encodedPolyline": string, "geoJsonLinestring": { object } // End of mutually exclusive fields. } |
| Felder | |
|---|---|
| Kapselt den Typ der Polylinie ein. Die Standardeinstellung ist „encoded_polyline“. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt: | |
encodedPolyline |
Die String-Codierung der Polylinie mit dem Algorithmus für codierte Polylinien |
geoJsonLinestring |
Gibt eine Polylinie im GeoJSON-Format „LineString“ an. |
| Ende der sich gegenseitig ausschließenden Felder. | |
RouteLegStep
Enthält ein Segment eines . Ein Schritt entspricht einer einzelnen Navigationsanweisung. Routenabschnitte bestehen aus Schritten.RouteLeg
| JSON-Darstellung |
|---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
| Felder | |
|---|---|
distanceMeters |
Die zurückgelegte Strecke dieses Schritts in Metern. Unter Umständen hat dieses Feld keinen Wert. |
staticDuration |
Die Dauer der Fahrt durch diesen Schritt ohne Berücksichtigung der Verkehrslage. Unter Umständen hat 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 |
Der Startort dieses Schritts. |
endLocation |
Der Endpunkt dieses Schritts. |
navigationInstruction |
Navigationsanweisungen. |
travelAdvisory |
Enthält die zusätzlichen Informationen, über die der Nutzer in einem Beinabschnitt informiert werden sollte, z. B. mögliche Einschränkungen für Verkehrszonen. |
localizedValues |
Textdarstellungen von Attributen des |
transitDetails |
Details zu diesem Schritt, wenn der Fortbewegungsmodus |
travelMode |
Die für diesen Schritt verwendete Mobilitätsform. |
Manöver
Eine Reihe von Werten, die die Navigationsaktion für den aktuellen Schritt angeben (z. B. „Links abbiegen“, „Zusammenführen“ oder „Geradeaus“).
| Enums | |
|---|---|
MANEUVER_UNSPECIFIED |
Nicht verwendet. |
TURN_SLIGHT_LEFT |
Halte dich leicht links. |
TURN_SHARP_LEFT |
Scharf nach links abbiegen. |
UTURN_LEFT |
Bitte wenden. |
TURN_LEFT |
Biege links ab. |
TURN_SLIGHT_RIGHT |
Halte dich leicht rechts. |
TURN_SHARP_RIGHT |
Scharf rechts abbiegen. |
UTURN_RIGHT |
Wenden Sie nach rechts. |
TURN_RIGHT |
Biegen Sie rechts ab. |
STRAIGHT |
Gehen Sie geradeaus. |
RAMP_LEFT |
Nimm die linke Auffahrt. |
RAMP_RIGHT |
Nehmen Sie die rechte Auffahrt. |
MERGE |
In den Verkehr einfädeln. |
FORK_LEFT |
Nimm die linke Abzweigung. |
FORK_RIGHT |
Nimm die rechte Gabelung. |
FERRY |
Nehmen Sie die Fähre. |
FERRY_TRAIN |
Nehmen Sie den Zug, der zur Fähre führt. |
ROUNDABOUT_LEFT |
Biegen Sie beim Kreisverkehr links ab. |
ROUNDABOUT_RIGHT |
Biegen Sie beim Kreisverkehr rechts ab. |
DEPART |
Erstes Manöver. |
NAME_CHANGE |
Wird verwendet, um eine Änderung des Straßennamens anzugeben. |
DESTINATION |
Wird verwendet, um die Ankunft an einem Zielort anzugeben. |
RouteLegStepTravelAdvisory
Enthält die zusätzlichen Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen der Verkehrszone für einen Beinabschnitt.
| JSON-Darstellung |
|---|
{
"speedReadingIntervals": [
{
object ( |
| Felder | |
|---|---|
speedReadingIntervals[] |
HINWEIS: Dieses Feld ist derzeit nicht ausgefüllt. |
RouteLegStepLocalizedValues
Textdarstellungen bestimmter Eigenschaften.
| JSON-Darstellung |
|---|
{ "distance": { object ( |
| Felder | |
|---|---|
distance |
Die zurückgelegte Strecke in Textform. |
staticDuration |
Dauer ohne Berücksichtigung der Verkehrslage in Textform. |
RouteLegStepTransitDetails
Zusätzliche Informationen für die RouteLegStep in Bezug auf TRANSIT-Routen.
| JSON-Darstellung |
|---|
{ "stopDetails": { object ( |
| Felder | |
|---|---|
stopDetails |
Informationen zu den Ankunfts- und Abfahrtshaltestellen für den Schritt. |
localizedValues |
Textdarstellungen von Attributen des |
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 Zeit zwischen zwei Fahrten 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 „ |
transitLine |
Informationen zur in diesem Schritt verwendeten ÖPNV-Linie. |
stopCount |
Die Anzahl der Haltestellen von der Abfahrts- bis zur Ankunftshaltestelle. 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, wird für |
tripShortText |
Der Text, der in Fahrplänen und auf Anzeigetafeln erscheint, um eine Fahrt für Fahrgäste zu kennzeichnen. Der Text sollte eine Fahrt innerhalb eines Betriebstags eindeutig identifizieren. 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 voraussichtliche Ankunftszeit für den Schritt. 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: |
departureStop |
Informationen zur Abfahrtshaltestelle für den Schritt. |
departureTime |
Die geschätzte Abfahrtszeit für den Schritt. 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: |
TransitStop
Informationen zu einer Haltestelle.
| JSON-Darstellung |
|---|
{
"name": string,
"location": {
object ( |
| Felder | |
|---|---|
name |
Der Name der Haltestelle. |
location |
Der Standort des Stopps in Breiten-/Längengradkoordinaten. |
TransitDetailsLocalizedValues
Lokalisierte Beschreibungen der Werte für RouteTransitDetails.
| JSON-Darstellung |
|---|
{ "arrivalTime": { object ( |
| Felder | |
|---|---|
arrivalTime |
Die Zeit in ihrer formatierten Textdarstellung mit einer entsprechenden Zeitzone. |
departureTime |
Die Zeit in ihrer formatierten Textdarstellung mit einer entsprechenden Zeitzone. |
LocalizedTime
Lokalisierte Beschreibung der Zeit.
| JSON-Darstellung |
|---|
{
"time": {
object ( |
| Felder | |
|---|---|
time |
Die als String angegebene Zeit in einer bestimmten Zeitzone. |
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 zur in diesem Schritt verwendeten ÖPNV-Linie.
| JSON-Darstellung |
|---|
{ "agencies": [ { object ( |
| Felder | |
|---|---|
agencies[] |
Der Betreiber (oder die Betreiber), der diese ÖPNV-Linie betreibt. |
name |
Der vollständige Name dieser ÖPNV-Linie, z. B. „8th Avenue Local“. |
uri |
die URI für diese ÖPNV-Linie, die vom Betreiber bereitgestellt wird. |
color |
Die Farbe, die üblicherweise für die Beschilderung dieser Linie verwendet wird. Wird als Hexadezimalwert dargestellt. |
iconUri |
Der URI für das Symbol, das dieser Zeile zugeordnet ist. |
nameShort |
Der Kurzname dieser ÖPNV-Linie. Das ist normalerweise eine Nummer wie „M7“ oder „355“. |
textColor |
Die Farbe, die üblicherweise für den Text auf der Beschilderung dieser Linie verwendet wird. Wird als Hexadezimalwert dargestellt. |
vehicle |
Der Fahrzeugtyp, der auf dieser ÖPNV-Linie eingesetzt wird. |
TransitAgency
Ein Betreiber, der eine Linie betreibt.
| JSON-Darstellung |
|---|
{ "name": string, "phoneNumber": string, "uri": string } |
| Felder | |
|---|---|
name |
Der Name dieses Betreibers. |
phoneNumber |
Die lokalisierte Telefonnummer des Betreibers. |
uri |
Der URI des Verkehrsverbunds. |
TransitVehicle
Informationen zu einem Fahrzeug, das auf ÖPNV-Routen verwendet wird.
| JSON-Darstellung |
|---|
{ "name": { object ( |
| Felder | |
|---|---|
name |
Der Name dieses Fahrzeugs in Großbuchstaben. |
type |
Der verwendete Fahrzeugtyp. |
iconUri |
Der URI für ein Symbol, das diesem Fahrzeugtyp zugeordnet ist. |
localIconUri |
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 |
Sammeltaxis sind eine Art Bus, bei dem Fahrgäste überall auf der Strecke ein- und aussteigen können. |
SUBWAY |
U-Bahn |
TRAM |
Straßenbahn |
TROLLEYBUS |
Oberleitungsbus |
RouteLegTravelAdvisory
Enthält die zusätzlichen Informationen, über die der Nutzer bei einem Beinabschnitt informiert werden sollte, z. B. mögliche Einschränkungen für Verkehrszonen.
| JSON-Darstellung |
|---|
{ "tollInfo": { object ( |
| Felder | |
|---|---|
tollInfo |
Enthält Informationen zu Mautgebühren auf der jeweiligen |
speedReadingIntervals[] |
Die Geschwindigkeitsmessintervalle geben die Verkehrsdichte an. Dieses Feld wird nur für Anfragen ausgefüllt, wenn die Anfrage den Beispiel: |
RouteLegLocalizedValues
Textdarstellungen bestimmter Eigenschaften.
| JSON-Darstellung |
|---|
{ "distance": { object ( |
| Felder | |
|---|---|
distance |
Die zurückgelegte Strecke in Textform. |
duration |
Die Dauer in Textform, lokalisiert für die Region der Anfrage. Berücksichtigt die Verkehrslage. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, entspricht dieser Wert dem Wert von „staticDuration“. |
staticDuration |
Dauer ohne Berücksichtigung der Verkehrslage in Textform. |
StepsOverview
Bietet einen Überblick über eine Liste von RouteLegStep-Elementen.
| JSON-Darstellung |
|---|
{
"multiModalSegments": [
{
object ( |
| Felder | |
|---|---|
multiModalSegments[] |
Zusammengefasste Informationen zu verschiedenen multimodalen Segmenten von |
MultiModalSegment
Bietet zusammengefasste Informationen zu verschiedenen multimodalen Segmenten von RouteLeg.steps. Ein multimodales Segment wird als ein oder mehrere zusammenhängende RouteLegStep mit demselben RouteTravelMode definiert. Dieses Feld wird nicht ausgefüllt, wenn die 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 Sichtfeld für Breiten- und Längengrad, das als zwei diagonal gegenüberliegende low- und high-Punkte dargestellt wird. Ein Viewport gilt als geschlossener Bereich, d.h., er umfasst auch seine Grenze. Die Breitengradgrenzen müssen zwischen -90 und 90 Grad liegen und die Längengradgrenzen zwischen -180 und 180 Grad. Dazu gehören:
Wenn
low=highist, besteht der Darstellungsbereich aus diesem einzelnen Punkt.Wenn
low.longitude>high.longitude, wird der Längengradbereich umgekehrt (der Darstellungsbereich überschreitet die 180-Grad-Längengradlinie).Wenn
low.longitude= -180 Grad undhigh.longitude= 180 Grad ist, umfasst 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 der Breitengradbereich leer.
Sowohl low als auch high müssen ausgefüllt sein und das dargestellte Rechteck darf nicht leer sein (wie in den Definitionen oben angegeben). Ein leerer Viewport führt zu einem Fehler.
Beispiel: Dieser Viewport umfasst New York City vollständig:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
| JSON-Darstellung |
|---|
{ "low": { object ( |
| Felder | |
|---|---|
low |
Erforderlich. Der unterste Punkt des Darstellungsbereichs. |
high |
Erforderlich. Der höchste Punkt des Darstellungsbereichs. |
RouteLocalizedValues
Textdarstellungen bestimmter Eigenschaften.
| JSON-Darstellung |
|---|
{ "distance": { object ( |
| Felder | |
|---|---|
distance |
Die zurückgelegte Strecke in Textform. |
duration |
Die Dauer in Textform, lokalisiert für die Region der Anfrage. Berücksichtigt die Verkehrslage. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, entspricht dieser Wert dem Wert von |
staticDuration |
Dauer ohne Berücksichtigung der Verkehrslage in Textform. |
transitFare |
Der Fahrpreis für öffentliche Verkehrsmittel wird in Textform dargestellt. |
PolylineDetails
Details zu einem bestimmten Index oder zusammenhängenden Segment einer Polylinie. Bei einer Polylinie mit den Punkten P_0, P_1, ... , P_N (nullbasierter Index) wird mit PolylineDetails ein Intervall und die zugehörigen Metadaten definiert.
| JSON-Darstellung |
|---|
{ "tunnelInfo": [ { object ( |
| Felder | |
|---|---|
tunnelInfo[] |
Tunneldetails entlang der Polylinie. Dieses Feld wird ausgefüllt, wenn in der Anfrage der Routenmodifikator |
restrictionInfo[] |
Details zu Einschränkungen entlang der Polylinie. Dieses Feld wird nur ausgefüllt, wenn in einer Anfrage der Routenmodifikator |
flyoverInfo[] |
Flyover-Details entlang der Polylinie. |
narrowRoadInfo[] |
Details zu schmalen Straßen entlang der Polylinie. |
bridgeInfo[] |
Brückendetails entlang der Polylinie. |
skywayInfo[] |
Details zur Skyway-Route entlang der Polylinie. |
TunnelInfo
Kapselt Informationen zu Tunneln entlang der Polylinie.
| JSON-Darstellung |
|---|
{ "tunnelPresence": enum ( |
| Felder | |
|---|---|
tunnelPresence |
Gibt an, ob für einen bestimmten Abschnitt der Polylinie ein Tunnel vorhanden ist. |
polylinePointIndex |
Die Position von tunnelbezogenen Informationen entlang der Polylinie. |
RoadFeatureState
Kapselt die Status von Straßeneigenschaften entlang eines Polylinienabschnitts.
| Enums | |
|---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
Der Status der Straßeneigenschaft wurde nicht berechnet (Standardwert). |
EXISTS |
Das Straßenelement ist vorhanden. |
DOES_NOT_EXIST |
Das Straßenmerkmal ist nicht vorhanden. |
PolylinePointIndex
Kapselt die Start- und Endindexe für ein Polyliniendetail. In Fällen, in denen die Daten einem einzelnen Punkt entsprechen, sind startIndex und endIndex gleich.
| JSON-Darstellung |
|---|
{ "startIndex": integer, "endIndex": integer } |
| Felder | |
|---|---|
startIndex |
Der Startindex dieses Details in der Polylinie. |
endIndex |
Der Endindex dieses Details in der Polylinie. |
RestrictionInfo
Kapselt Informationen zu verschiedenen Einschränkungen entlang der Polylinie.
| JSON-Darstellung |
|---|
{ "restrictionPresence": enum ( |
| Felder | |
|---|---|
restrictionPresence |
Nur Ausgabe. Gibt an, ob für einen bestimmten Abschnitt der Polylinie eine Einschränkung vorhanden ist. |
polylinePointIndex |
Die Position der einschränkungsbezogenen Informationen entlang der Polylinie. |
| Kapselt die Arten von Einschränkungen, die für einen bestimmten Abschnitt der Polylinie gelten können. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt: | |
restrictedHeightMm |
Die Höhenbegrenzung in Millimetern. Dieses Feld wird ausgefüllt, wenn die Durchfahrt aufgrund der eingeschränkten Höhe nicht möglich ist oder die Bodenfreiheit für das angegebene Fahrzeug gering ist. |
restrictedWeightKg |
Das Gewichtslimit in Kilogramm. Dieses Feld wird ausgefüllt, wenn die Gewichtsbeschränkung die Durchfahrt verhindert oder das Gewicht des angegebenen Fahrzeugs fast erreicht. |
hazardousGoods |
Dieses Feld ist auf „true“ gesetzt, wenn der Transport von Gefahrgut eingeschränkt ist. |
trucksProhibited |
Dieses Feld wird auf „true“ gesetzt, wenn Lkw verboten sind. |
| Ende der sich gegenseitig ausschließenden Felder. | |
FlyoverInfo
Enthält Informationen zu Überflügen entlang der Polylinie.
| JSON-Darstellung |
|---|
{ "flyoverPresence": enum ( |
| Felder | |
|---|---|
flyoverPresence |
Nur Ausgabe. Gibt an, ob für einen bestimmten Abschnitt der Polylinie ein Flyover vorhanden ist. |
polylinePointIndex |
Der Ort der Flyover-bezogenen Informationen entlang der Polylinie. |
NarrowRoadInfo
Enthält Informationen zu schmalen Straßen entlang der Polylinie.
| JSON-Darstellung |
|---|
{ "narrowRoadPresence": enum ( |
| Felder | |
|---|---|
narrowRoadPresence |
Nur Ausgabe. Gibt an, ob es für einen bestimmten Abschnitt der Polylinie eine schmale Straße gibt. |
polylinePointIndex |
Die Position von Informationen zu schmalen Straßen entlang der Polylinie. |
BridgeInfo
Enthält Informationen zu Brücken entlang der Polylinie.
| JSON-Darstellung |
|---|
{ "bridgePresence": enum ( |
| Felder | |
|---|---|
bridgePresence |
Gibt an, ob für einen bestimmten Abschnitt der Polylinie eine Brücke vorhanden ist. |
polylinePointIndex |
Die Position von brückenbezogenen Informationen entlang der Polylinie. |
SkywayInfo
Kapselt Informationen zu Fußgängerbrücken entlang der Polylinie.
| JSON-Darstellung |
|---|
{ "skywayPresence": enum ( |
| Felder | |
|---|---|
skywayPresence |
Gibt an, ob für einen bestimmten Abschnitt der Polylinie eine Skyway-Verbindung vorhanden ist. |
polylinePointIndex |
Die Position von Informationen zu Skyway entlang der Polylinie. |
GeocodingResults
Enthält für Startort, Zielort und Zwischenwegpunkte. Wird nur für Adressen-Wegpunkte ausgefüllt.GeocodedWaypoints
| JSON-Darstellung |
|---|
{ "origin": { object ( |
| Felder | |
|---|---|
origin |
Geocodierter Wegpunkt für den Startort. |
destination |
Geocodierter Zielwegpunkt. |
intermediates[] |
Eine Liste mit geocodierten Zwischenwegpunkten, die jeweils ein Indexfeld enthalten, das der nullbasierten Position des Wegpunkts in der Reihenfolge entspricht, in der er in der Anfrage angegeben wurde. |
GeocodedWaypoint
Details zu den als Wegpunkte verwendeten Orten. Wird nur für Adressen-Wegpunkte ausgefüllt. Enthält Details zu den Geocoding-Ergebnissen, um zu ermitteln, auf welche Adresse die Adresse geocoded wurde.
| JSON-Darstellung |
|---|
{
"geocoderStatus": {
object ( |
| Felder | |
|---|---|
geocoderStatus |
Gibt den Statuscode des Geocoding-Vorgangs an. |
type[] |
Der Typ bzw. die Typen des Ergebnisses in Form von null oder mehr Typ-Tags. Unterstützte Typen: Typen von Adressen und Adresskomponenten. |
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 Zwischenzielpunkts in der Anfrage. Wird nur ausgefüllt, wenn der entsprechende Wegpunkt ein Zwischenwegpunkt ist. |