- HTTP-Anfrage
- Anfragetext
- Antworttext
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Route
- RouteLabel
- RouteLeg
- Polylinie
- RouteLegStep
- NavigationInstruction
- Maneuver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Darstellungsbereich
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint
Gibt die primäre Route zusammen mit optionalen alternativen Routen für eine Reihe von Terminal- und Zwischenwegpunkten zurück.
HINWEIS:Bei dieser Methode müssen Sie in der Eingabe eine Antwortfeldmaske angeben. Sie können die Antwortfeldmaske über den URL-Parameter $fields
oder fields
oder einen HTTP-/gRPC-Header X-Goog-FieldMask
angeben. Weitere Informationen zu verfügbaren URL-Parametern und -Headern Der Wert ist eine durch Kommas getrennte Liste von Feldpfaden. Ausführliche Informationen zum Erstellen der Feldpfade finden Sie hier.
Beispiel:
- Feldmaske aller verfügbaren Felder (zur manuellen Überprü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 von der Verwendung der Platzhalterantwortfeldmaske (*
) oder der Angabe der Feldmaske auf oberster Ebene (routes
) ab, da:
- Wenn Sie nur die Felder auswählen, die Sie benötigen, spart unser Server Rechenzyklen, sodass wir Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben können.
- Wenn Sie nur die Felder auswählen, die Sie in Ihrem Produktionsjob benötigen, wird eine stabile Latenzleistung sichergestellt. Möglicherweise werden in Zukunft weitere Antwortfelder hinzugefügt, die möglicherweise 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 neu hinzugefügte Feld automatisch in die Antwort aufgenommen wird.
- Wenn Sie nur die benötigten Felder auswählen, verringert sich die Antwortgröße und damit der 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. Wegpunkt des Startorts. |
destination |
Erforderlich. Wegpunkt des Ziels. |
intermediates[] |
Optional. Eine Reihe von Wegpunkten entlang der Route (ohne Startpunkte), um an einem Ort zu halten oder an diesem vorbeizukommen. 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 ausgewählte Routingeinstellung zur Berechnung der Route zu verwenden. Wenn die Routingeinstellung zu einem Fehler oder zu einer extrem 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: Du kannst ein Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
arrivalTime |
Optional. Die Ankunftszeit. HINWEIS: Kann nur festgelegt werden, wenn Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. 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 die Art und Weise der Routenberechnung beeinflussen. |
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 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 die Richtlinie auf „true“ gesetzt ist, versucht der Dienst, die Gesamtkosten der Route durch eine Neuanordnung der angegebenen Wegpunkte zu minimieren. Die Anfrage schlägt fehl, wenn einer der Wegpunkte ein |
requestedReferenceRoutes[] |
Optional. Gibt an, welche Referenzrouten als Teil der Anfrage zusätzlich zur Standardroute berechnet werden sollen. Eine Referenzroute ist eine Route mit einem anderen Routenberechnungsziel als die Standardroute. Bei einer Berechnung der |
extraComputations[] |
Optional. Eine Liste zusätzlicher Berechnungen, die zum Ausführen der Anfrage verwendet werden können. Hinweis: Diese zusätzlichen Berechnungen geben möglicherweise zusätzliche Felder für die Antwort zurück. 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 für die Dauer in |
transitPreferences |
Optional. Gibt Einstellungen an, die sich auf die für |
Antworttext
v2.computeRoutes wird die Antwortnachricht gesendet.
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 Eingabeeinstellungen berechnen kann, wird unter Umständen 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. |
geocodingResults |
Enthält Geocoding-Antwortinformationen für Wegpunkte, die als Adressen angegeben werden. |
PolylineQuality
Ein Satz von Werten, die die Qualität der Polylinie angeben.
Enums | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Keine Einstellung für Polylinienqualität angegeben. Die Standardeinstellung ist OVERVIEW . |
HIGH_QUALITY |
Gibt eine Polylinie von hoher Qualität an, die aus mehr Punkten als OVERVIEW besteht, allerdings auf Kosten einer größeren Antwortgröße. Verwenden Sie diesen Wert, wenn Sie mehr Genauigkeit benötigen. |
OVERVIEW |
Gibt eine Übersichtspolygone an, die aus einer kleinen Anzahl von Punkten besteht. Verwenden Sie diesen Wert, wenn Sie eine Übersicht der Route anzeigen möchten. Die Verwendung dieser Option hat eine geringere Anfragelatenz als die Option HIGH_QUALITY . |
PolylineEncoding
Gibt den bevorzugten Polylinientyp an, der zurückgegeben werden soll.
Enums | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
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. Routen, die mit diesem Wert gekennzeichnet sind, sind im Hinblick auf Parameter wie den Kraftstoffverbrauch optimiert. |
ExtraComputation
Zusätzliche Berechnungen, die während der Ausführung 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, bei denen der Datenverkehr berücksichtigt wird, für die Route(n). |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions wird als formatierter HTML-Textstring dargestellt. Dieser Inhalt ist so zu lesen, wie er ist. Er dient nur zur Anzeige. Parsen Sie ihn nicht programmatisch. |
Route
Enthält eine Route, die aus einer Reihe miteinander verbundener Straßensegmente besteht, die Start-, End- und Zwischenwegpunkte miteinander verbinden.
JSON-Darstellung |
---|
{ "routeLabels": [ enum ( |
Felder | |
---|---|
routeLabels[] |
Labels für die |
legs[] |
Mehrere Streckenabschnitte (Pfadsegmente zwischen Wegpunkten), die die Route ausmachen. Jeder Abschnitt entspricht der Fahrt zwischen zwei Nicht- |
distanceMeters |
Die Entfernung der Route in Metern. |
duration |
Die für die Navigation auf der Route erforderliche Zeit. Wenn Sie Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
staticDuration |
Die Reisezeit auf der Route ohne Berücksichtigung der Verkehrslage. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
polyline |
Polylinie der gesamten 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. |
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 Routen-Token, das an das Navigation SDK übergeben werden kann, mit dem das Navigation SDK die Route während der Navigation rekonstruieren und im Fall einer Routenänderung die ursprüngliche Absicht beim Erstellen der Route durch Aufrufen von v2.computeRoutes berücksichtigen kann. Kunden sollten dieses Token als intransparenten Blob behandeln. Sie ist nicht zum Lesen oder Ändern gedacht. HINWEIS: |
RouteLabel
Labels für die
, mit denen bestimmte Attribute der Route für den Vergleich mit anderen identifiziert werden können.Route
Enums | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Standard – nicht verwendet. |
DEFAULT_ROUTE |
Die standardmäßige „beste“ Route, die für die Routenberechnung zurückgegeben wird. |
DEFAULT_ROUTE_ALTERNATE |
Eine Alternative zur standardmäßigen „besten“ Route. Routen wie diese werden zurückgegeben, wenn angegeben ist. |
FUEL_EFFICIENT |
Spritsparende Route. Routen, die mit diesem Wert gekennzeichnet sind, sind im Hinblick auf 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 Entfernung des Streckenabschnitts in Metern. |
duration |
Die Zeit, die für die Navigation im Streckenabschnitt benötigt wird. Wenn Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
staticDuration |
Die Reisedauer für diesen Abschnitt, berechnet ohne Berücksichtigung der Verkehrslage. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
polyline |
Die gesamte Polylinie für diesen Streckenabschnitt, die die Polylinien der einzelnen |
startLocation |
Startposition dieses Abschnitts. Dieser Standort kann sich vom angegebenen |
endLocation |
Die Endposition dieses Abschnitts. Dieser Standort kann sich vom angegebenen |
steps[] |
Ein Array von Schritten, die Segmente in diesem Abschnitt bezeichnen. Jeder Schritt entspricht einer Navigationsanweisung. |
travelAdvisory |
Enthält die zusätzlichen Informationen, über die der Nutzer auf einem Routenabschnitt informiert werden soll, z. B. mögliche Einschränkungen von Verkehrszonen. |
localizedValues |
Textdarstellungen von Attributen von |
stepsOverview |
Hier finden Sie Informationen zu den Schritten in diesem |
Polyline
Kapselt eine codierte Polylinie ein.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld polyline_type . Zusammenfassung des Polylinientyps. Die Standardeinstellung ist Encrypted_polyline. Für polyline_type ist nur einer der folgenden Werte zulässig: |
|
encodedPolyline |
Die Stringcodierung der Polylinie mit dem Algorithmus zur Codierung von Polylinien. |
geoJsonLinestring |
Gibt eine Polylinie im GeoJSON-LineString-Format an. |
RouteLegStep
Enthält ein Segment von einem
. Ein Schritt entspricht einer einzelnen Navigationsanweisung. Routenabschnitte bestehen aus Stufen.RouteLeg
JSON-Darstellung |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Felder | |
---|---|
distanceMeters |
Die Strecke dieses Schritts in Metern. Manchmal enthält dieses Feld keinen Wert. |
staticDuration |
Die Reisedauer für diesen Schritt, ohne die Verkehrslage zu berücksichtigen. Manchmal enthält dieses Feld keinen Wert. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
polyline |
Polylinie, die mit diesem Schritt verknüpft ist. |
startLocation |
Der Startort dieses Schritts. |
endLocation |
Der Endpunkt dieses Schritts. |
navigationInstruction |
Navigationshinweise. |
travelAdvisory |
Enthält die zusätzlichen Informationen, über die der Nutzer informiert werden soll, z. B. mögliche Einschränkungen in Bezug auf Zonen für einen Streckenabschnitt. |
localizedValues |
Textdarstellungen von Attributen von |
transitDetails |
Details zu diesem Schritt, wenn die Mobilitätsform |
travelMode |
Die für diesen Schritt verwendete Mobilitätsform. |
Manövrieren
Eine Reihe von Werten, die die Navigationsaktion für den aktuellen Schritt angeben, z. B. „Nach links abbiegen“, „Zusammenführung“ oder „Geradeaus“.
Enums | |
---|---|
MANEUVER_UNSPECIFIED |
Nicht verwendet. |
TURN_SLIGHT_LEFT |
Biegen Sie leicht nach links ab. |
TURN_SHARP_LEFT |
Scharf nach links abbiegen. |
UTURN_LEFT |
Nach links wenden. |
TURN_LEFT |
Biegen Sie nach links ab. |
TURN_SLIGHT_RIGHT |
Biegen Sie leicht nach rechts ab. |
TURN_SHARP_RIGHT |
Scharf nach rechts abbiegen. |
UTURN_RIGHT |
Nach rechts wenden. |
TURN_RIGHT |
Biegen Sie nach rechts ab. |
STRAIGHT |
Geradeaus. |
RAMP_LEFT |
Nehmen Sie die linke Auffahrt. |
RAMP_RIGHT |
Nehmen Sie die rechte Auffahrt. |
MERGE |
In Verkehrslage integrieren |
FORK_LEFT |
Nehmen Sie die linke Gabelung. |
FORK_RIGHT |
Nehmen Sie die richtige Gabel. |
FERRY |
Nehmen Sie die Fähre. |
FERRY_TRAIN |
Nehmen Sie den Zug, der zur Fähre führt. |
ROUNDABOUT_LEFT |
Beim Kreisverkehr links abbiegen. |
ROUNDABOUT_RIGHT |
Biegen Sie beim Kreisverkehr rechts ab. |
DEPART |
Erste Vorgehensweise |
NAME_CHANGE |
Wird verwendet, um eine Änderung des Straßennamens anzuzeigen. |
RouteLegStepTravelAdvisory
Enthält die zusätzlichen Informationen, über die der Nutzer informiert werden soll, z. B. mögliche Einschränkungen in Bezug auf Zonen für einen Streckenabschnitt.
JSON-Darstellung |
---|
{
"speedReadingIntervals": [
{
object ( |
Felder | |
---|---|
speedReadingIntervals[] |
HINWEIS: Dieses Feld ist derzeit nicht ausgefüllt. |
RouteLegStepLocalizedValues
Textdarstellungen bestimmter Attribute.
JSON-Darstellung |
---|
{ "distance": { object ( |
Felder | |
---|---|
distance |
Entfernung in Textform. |
staticDuration |
Dauer ohne Berücksichtigung der Verkehrslage in Textform. |
RouteLegStepTransitDetails
Zusätzliche Informationen für die RouteLegStep
zu TRANSIT
-Routen.
JSON-Darstellung |
---|
{ "stopDetails": { object ( |
Felder | |
---|---|
stopDetails |
Informationen zu den Ankunfts- und Abfahrtshaltestellen für den Schritt. |
localizedValues |
Textdarstellungen von Attributen von |
headsign |
Die Fahrtrichtung für diese Linie, die auf dem Fahrzeug oder an der Abfahrtshaltestelle angegeben ist. Die Richtung ist oft die Endhaltestelle. |
headway |
Gibt die voraussichtliche Dauer zwischen Abfahrten von derselben Haltestelle zu diesem Zeitpunkt als Dauer an. Bei einem Taktsekundenwert von 600 wäre z. B. mit einer Wartezeit von zehn Minuten zu rechnen, wenn Sie Ihren Bus verpassen sollten. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
transitLine |
Informationen zur in diesem Schritt verwendeten ÖPNV-Linie. |
stopCount |
Die Anzahl der Haltestellen von der Abfahrts- bis zur Ankunftshaltestelle. Diese Zahl umfasst die Zielhaltestelle, die Starthaltestelle jedoch nicht. Wenn Ihre Route beispielsweise an Haltestelle A abfährt, die Haltestellen B und C durchquert und an Haltestelle D ankommt, gibt „stopCount“ den Wert 3 zurück. |
tripShortText |
Der Text, der in Fahrplänen und auf Anzeigetafeln erscheint und Fahrgästen eine Fahrt mit öffentlichen Verkehrsmitteln anzeigt. Der Text sollte eine Fahrt innerhalb eines Betriebstags eindeutig identifizieren. Beispielsweise ist „538“ der |
TransitStopDetails
Details zu den Haltestellen öffentlicher Verkehrsmittel am RouteLegStep
.
JSON-Darstellung |
---|
{ "arrivalStop": { object ( |
Felder | |
---|---|
arrivalStop |
Informationen zur Ankunftshaltestelle für den Schritt. |
arrivalTime |
Die voraussichtliche Ankunftszeit für den Schritt. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
departureStop |
Informationen zur Abfahrtshaltestelle für diesen Schritt. |
departureTime |
Die voraussichtliche Abfahrtszeit für diesen Schritt. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung 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 |
Uhrzeit in formatierter Textdarstellung mit einer entsprechenden Zeitzone. |
departureTime |
Uhrzeit in formatierter 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 in diesem Schritt verwendeten ÖPNV-Linie.
JSON-Darstellung |
---|
{ "agencies": [ { object ( |
Felder | |
---|---|
agencies[] |
Der oder die Betreiber, der diese ÖPNV-Linie betreibt. |
name |
Der vollständige Name dieser ÖPNV-Linie, z. B. „8 Avenue Local“. |
uri |
URI für diese ÖPNV-Linie, wie vom Betreiber angegeben. |
color |
Die Farbe, die üblicherweise für die Beschilderung dieser Linie verwendet wird. Wird in Hexadezimalzahlen dargestellt. |
iconUri |
Der URI für das Symbol, das dieser Zeile zugeordnet ist. |
nameShort |
Der Kurzname dieser ÖPNV-Linie. Der Name ist normalerweise eine Nummer wie „M7“ oder „355“. |
textColor |
Die Farbe, die üblicherweise im Text der Beschilderung dieser Linie verwendet wird. Wird in Hexadezimalzahlen 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 dieses Betreibers. |
phoneNumber |
Die länderspezifische formatierte Telefonnummer des Verkehrsverbunds. |
uri |
URI des Verkehrsverbunds. |
TransitVehicle
Informationen zu einem Fahrzeug, das für 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 |
Der 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. |
TransitVehicleType
Der Fahrzeugtyp für Routen mit öffentlichen Verkehrsmitteln.
Enums | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
nicht in Verwendung. |
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 einer Etappe informiert werden soll, z. B. mögliche Einschränkungen in Bezug auf Verkehrszonen.
JSON-Darstellung |
---|
{ "tollInfo": { object ( |
Felder | |
---|---|
tollInfo |
Enthält Informationen zu Mautgebühren für das angegebene |
speedReadingIntervals[] |
Intervalle für Geschwindigkeitslesevorgänge, in denen die Verkehrsdichte detailliert angegeben wird. Anwendbar bei den Routingeinstellungen Beispiel:
|
RouteLegLocalizedValues
Textdarstellungen bestimmter Attribute.
JSON-Darstellung |
---|
{ "distance": { object ( |
Felder | |
---|---|
distance |
Entfernung in Textform. |
duration |
Dauer unter Berücksichtigung der Verkehrslage in Textform. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, ist dieser Wert derselbe Wert wie staticDuration. |
staticDuration |
Dauer ohne Berücksichtigung der Verkehrslage in Textform. |
StepsOverview
Liefert Übersichtsinformationen zu einer Liste von RouteLegStep
s.
JSON-Darstellung |
---|
{
"multiModalSegments": [
{
object ( |
Felder | |
---|---|
multiModalSegments[] |
Zusammengefasste Informationen zu verschiedenen multimodalen Segmenten der |
MultiModalSegment
Bietet zusammengefasste Informationen zu verschiedenen multimodalen Segmenten von RouteLeg.steps
. Ein multimodales Segment ist als eine oder mehrere zusammenhängende RouteLegStep
mit derselben RouteTravelMode
definiert. Dieses Feld wird nicht ausgefüllt, wenn RouteLeg
in den Schritten keine multimodalen Segmente 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 Punkte von low
und high
. Ein Darstellungsbereich wird als geschlossener Bereich betrachtet, d.h. er enthält seine Begrenzung. Die Breitengradgrenzen müssen zwischen -90 und 90 Grad liegen und die Längengradgrenzen zwischen -180 und 180 Grad (jeweils einschließlich). Verschiedene Fälle sind:
Wenn
low
=high
ist, besteht der Darstellungsbereich aus diesem einzelnen Punkt.Wenn
low.longitude
>high.longitude
ist, wird der Längengradbereich invertiert (der Darstellungsbereich kreuzt die 180-Grad-Längengradlinie).Ist
low.longitude
= -180 Grad undhigh.longitude
= 180 Grad, 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 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 umfasst beispielsweise 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 Tiefstpunkt des Darstellungsbereichs. |
high |
Erforderlich. Der höchste Punkt im Darstellungsbereich. |
RouteLocalizedValues
Textdarstellungen bestimmter Attribute.
JSON-Darstellung |
---|
{ "distance": { object ( |
Felder | |
---|---|
distance |
Entfernung in Textform. |
duration |
Dauer unter Berücksichtigung der Verkehrslage in Textform. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, ist dieser Wert derselbe Wert wie |
staticDuration |
Dauer ohne Berücksichtigung der Verkehrslage in Textform. |
transitFare |
Fahrpreis in Textform. |
GeocodingResults
Enthält
für Start- und Zielort und Wegpunkte. Wird nur für Wegpunkte in Adressen ausgefüllt.GeocodedWaypoints
JSON-Darstellung |
---|
{ "origin": { object ( |
Felder | |
---|---|
origin |
Vom Startort geocodierter Wegpunkt. |
destination |
Geocodierter Wegpunkt des Ziels. |
intermediates[] |
Eine Liste geocodierter Zwischenwegpunkte mit jeweils einem Indexfeld, das der nullbasierten Position des Wegpunkts in der Reihenfolge entspricht, in der sie in der Anfrage angegeben wurden. |
GeocodedWaypoint
Details zu den Orten, die als Wegpunkte verwendet wurden Wird nur für Wegpunkte in Adressen ausgefüllt. Enthält Details zu den Geocoding-Ergebnissen, anhand derer die Adresse ermittelt werden kann, in der 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 Tag-Typen. 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 |
Index des entsprechenden Wegpunkts in der Anfrage Dieses Feld wird nur ausgefüllt, wenn der entsprechende Wegpunkt ein Zwischenwegpunkt ist. |