- 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
- FlyoverInfo
- RoadFeatureState
- PolylinePointIndex
- NarrowRoadInfo
- GeocodingResults
- GeocodedWaypoint
Gibt die primäre Route zusammen mit optionalen alternativen Routen zurück, wenn eine Reihe von End- und Zwischenwegpunkten angegeben wird.
HINWEIS:Für diese Methode müssen Sie im Input eine Antwortfeldmaske angeben. Sie können die Feldmaske für die Antwort 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 Dokumentation 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 fügen wir in Zukunft weitere Antwortfelder hinzu. 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 neue Feld, das wir hinzufügen, automatisch in die Antwort aufgenommen wird.
- Wenn Sie nur die benötigten Felder auswählen, 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. Start-Wegpunkt. |
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 Zeit verwendet, zu der Sie die Anfrage gestellt haben. HINWEIS: Sie können nur 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 erfüllt werden müssen und 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ä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 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 zum Ausführen der Anfrage verwendet werden können. Hinweis: Durch diese zusätzlichen Berechnungen können zusätzliche Felder in der Antwort 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 für die voraussichtliche Reisezeit aus, der in der Antwort im Feld „duration“ (Dauer) 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 |
Es wurde keine Einstellung für die Qualität der Polylinie 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. Bei dieser Option ist die Anfrage-Latenz geringer als bei 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 Polylinentyp 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 Für Diese Funktion ist nicht mit anderen Verkehrsmitteln, Zwischenwegpunkten oder |
ExtraComputation
Zusätzliche Berechnungen, die beim Ausführen der Anfrage durchgeführt werden sollen.
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 |
NavigationInstructions wird als formatierter HTML-Textstring dargestellt. Dieser Inhalt ist so zu lesen, wie er ist. Er dient nur zur Anzeige. Wir raten davon ab, diesen Code programmatisch zu parsen. |
FLYOVER_INFO_ON_POLYLINE |
Informationen zu Überflügen 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 Metropolen 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 Metropolen in Indien erfasst. Diese Funktion ist experimentell und die SKU/Gebühr kann sich ändern. |
Route
Enthält eine Route, die aus einer Reihe verbundener Straßenabschnitte besteht, die Anfangs-, 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 zurückzulegende Strecke 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 gesamte Routen-Polylinie. Diese Polylinie ist die kombinierte Polylinie aller |
description |
Eine Beschreibung der Route. |
warnings[] |
Ein Array mit Warnungen, die beim Anzeigen der Route eingeblendet werden sollen. |
viewport |
Der Begrenzungsrahmen des Darstellungsbereichs der Polylinie. |
travelAdvisory |
Zusätzliche Informationen zur Route. |
optimizedIntermediateWaypointIndex[] |
Wenn Sie |
localizedValues |
Textdarstellungen von Attributen der |
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, die mit anderen verglichen werden sollen.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 Standardroute „Beste“. 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 Wegpunkten, die nicht via
sind.
JSON-Darstellung |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Felder | |
---|---|
distanceMeters |
Die zurückgelegte Strecke des Routenabschnitts in Metern. |
duration |
Die Zeit, die für die Navigation auf dem Abschnitt benötigt wird. Wenn Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
staticDuration |
Die Dauer der Reise auf dem Abschnitt, berechnet ohne Berücksichtigung der Verkehrsbedingungen. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
polyline |
Der gesamte Linienzug für diesen Abschnitt, der den Linienzug jedes |
startLocation |
Der Startort dieses Abschnitts. Dieser Standort kann sich von der angegebenen |
endLocation |
Der Endpunkt dieses Abschnitts. Dieser Standort kann sich von der angegebenen |
steps[] |
Ein Array von Schritten, die Segmente innerhalb dieses Legs darstellen. Jeder Schritt entspricht einer Navigationsanweisung. |
travelAdvisory |
Enthält die zusätzlichen Informationen, über die der Nutzer auf einem Routenabschnitt informiert werden sollte, z. B. mögliche Einschränkungen für Verkehrszonen. |
localizedValues |
Textdarstellungen von Attributen der |
stepsOverview |
Übersichtsinformationen zu den Schritten in diesem |
Polyline
Kapselt eine codierte Polylinie.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld polyline_type . Kapselt den Typ des Linienzugs. Die Standardeinstellung ist „encoded_polyline“. Für polyline_type ist nur einer der folgenden Werte zulässig: |
|
encodedPolyline |
Die String-Codierung der Polylinie mit dem Algorithmus für codierte Polylinien |
geoJsonLinestring |
Gibt eine Polylinie im GeoJSON-Format „LineString“ an. |
RouteLegStep
Enthält ein Segment von
. 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 Verkehrsbedingungen. Unter Umständen hat dieses Feld keinen Wert. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
polyline |
Die Polylinie, die mit diesem Schritt verknüpft ist. |
startLocation |
Der Startort dieses Schritts. |
endLocation |
Der Endpunkt dieses Schritts. |
navigationInstruction |
Hinweise zur Navigation. |
travelAdvisory |
Enthält die zusätzlichen Informationen, über die der Nutzer in einem Leg-Schritt informiert werden sollte, z. B. mögliche Einschränkungen für Verkehrszonen. |
localizedValues |
Textdarstellungen von Attributen der |
transitDetails |
Details zu diesem Schritt, wenn der Fortbewegungsmodus |
travelMode |
Die für diesen Schritt verwendete Art der Fortbewegung. |
Maneuver
Eine Reihe von Werten, die die Navigationsaktion für den aktuellen Schritt angeben (z. B. „Links abbiegen“, „Einordnen“ oder „Geradeaus“).
Enums | |
---|---|
MANEUVER_UNSPECIFIED |
Nicht verwendet. |
TURN_SLIGHT_LEFT |
Drehe dich leicht nach links. |
TURN_SHARP_LEFT |
Biegen Sie scharf links ab. |
UTURN_LEFT |
Bitte wenden. |
TURN_LEFT |
Biegen Sie links ab. |
TURN_SLIGHT_RIGHT |
Drehe dich leicht nach rechts. |
TURN_SHARP_RIGHT |
Biegen Sie scharf rechts ab. |
UTURN_RIGHT |
Machen Sie eine Rechtskurve. |
TURN_RIGHT |
Biegen Sie rechts ab. |
STRAIGHT |
Gehen Sie geradeaus. |
RAMP_LEFT |
Nehmen Sie die linke Rampe. |
RAMP_RIGHT |
Nehmen Sie die rechte Rampe. |
MERGE |
Fahren Sie in den fließenden Verkehr ein. |
FORK_LEFT |
Nimm die linke Abzweigung. |
FORK_RIGHT |
Nimm die rechte Abzweigung. |
FERRY |
Nimm die Fähre. |
FERRY_TRAIN |
Nehmen Sie den Zug, der auf die 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. |
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 Properties.
JSON-Darstellung |
---|
{ "distance": { object ( |
Felder | |
---|---|
distance |
Die zurückgelegte Entfernung 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 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 „Headway seconds“ 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 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. |
tripShortText |
Der Text, der in Fahrplänen und auf Anzeigetafeln erscheint, um eine Fahrt mit öffentlichen Verkehrsmitteln 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 |
Die Position der Haltestelle oder des Bahnhofs 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 hexadezimal 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 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 dieses Betreibers. |
phoneNumber |
Die sprachen- bzw. regionsspezifisch formatierte 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 |
Die 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 Leg-Schritt informiert werden sollte, z. B. mögliche Einschränkungen der Verkehrszone.
JSON-Darstellung |
---|
{ "tollInfo": { object ( |
Felder | |
---|---|
tollInfo |
Enthält Informationen zu Mautgebühren auf der jeweiligen |
speedReadingIntervals[] |
Schnellleseintervalle mit Angaben zur Verkehrsdichte. Gilt für die Routing-Einstellungen Beispiel:
|
RouteLegLocalizedValues
Textdarstellungen bestimmter Properties.
JSON-Darstellung |
---|
{ "distance": { object ( |
Felder | |
---|---|
distance |
Die zurückgelegte Entfernung 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
s.
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 RouteLeg
keine multimodalen Segmente in den Schritten enthält.
JSON-Darstellung |
---|
{ "navigationInstruction": { object ( |
Felder | |
---|---|
navigationInstruction |
NavigationInstruction für das multimodale Segment. |
travelMode |
Das Transportmittel des multimodalen Segments. |
stepStartIndex |
Der entsprechende |
stepEndIndex |
Der entsprechende |
Darstellungsbereich
Ein Darstellungsbereich für Breiten- und Längengrad, der als zwei diagonal gegenüberliegende Punkte low
und high
dargestellt wird. Ein Darstellungsbereich gilt als geschlossene Region, d.h., er umfasst seine Grenze. Die Breitengradgrenzen müssen zwischen -90 und 90 Grad liegen (einschließlich), die Längengradgrenzen zwischen -180 und 180 Grad (einschließlich). Dazu gehören:
Wenn
low
=high
ist, 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 niedrigste Punkt des Darstellungsbereichs. |
high |
Erforderlich. Der höchste Punkt des Darstellungsbereichs. |
RouteLocalizedValues
Textdarstellungen bestimmter Properties.
JSON-Darstellung |
---|
{ "distance": { object ( |
Felder | |
---|---|
distance |
Die zurückgelegte Entfernung 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, die einem bestimmten Index oder einem zusammenhängenden Segment einer Polylinie entsprechen. 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 |
---|
{ "flyoverInfo": [ { object ( |
Felder | |
---|---|
flyoverInfo[] |
Flyover-Details entlang der Polylinie. |
narrowRoadInfo[] |
Details zu schmalen Straßen entlang der Polylinie. |
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 |
Die Position von Flyover-bezogenen Informationen entlang der Polylinie. |
RoadFeatureState
Kapselt die Status von Straßenmerkmalen entlang eines Polylinienabschnitts.
Enums | |
---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
Der Status des Straßenelements wurde nicht berechnet (Standardwert). |
EXISTS |
Die Straße 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. |
NarrowRoadInfo
Enthält Informationen zu schmalen Straßen entlang der Polylinie.
JSON-Darstellung |
---|
{ "narrowRoadPresence": enum ( |
Felder | |
---|---|
narrowRoadPresence |
Nur Ausgabe. Gibt an, ob für einen bestimmten Abschnitt der Polylinie eine schmale Straße vorhanden ist. |
polylinePointIndex |
Die Position von Informationen zu schmalen Straßen 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 sie in der Anfrage angegeben wurden. |
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 was die Adresse geocodiert 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. |