- HTTP-Anfrage
- Anfragetext
- Antworttext
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Route
- RouteLabel
- RouteLeg
- Polylinie
- RouteLegStep
- NavigationInstruction
- Manöver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Darstellungsbereich
- RouteLocalizedValues
- PolylineDetails
- TunnelInfo
- RoadFeatureState
- PolylinePointIndex
- RestrictionInfo
- FlyoverInfo
- NarrowRoadInfo
- BridgeInfo
- SkywayInfo
- GeocodingResults
- GeocodedWaypoint
Gibt die primäre Route zusammen mit optionalen alternativen Routen für eine Reihe von End- und Zwischenwegpunkten zurück.
HINWEIS: Bei dieser Methode müssen Sie in der Eingabe eine Antwortfeldmaske angeben. Sie können die Antwortfeldmaske mit dem URL-Parameter $fields oder fields oder mit 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. Eine ausführliche Dokumentation zum Erstellen der Feldpfade finden Sie hier.
Beispiel für diese Methode:
- Feldmaske aller verfügbaren Felder (für die manuelle Prüfung):
X-Goog-FieldMask: * - Feldmaske für Dauer, Entfernung und Polylinie auf Routenebene (Beispiel für eine Produktionskonfiguration):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google rät von der Verwendung der Platzhalter-Feldmaske (*) für Antworten oder der Angabe der Feldmaske auf der obersten Ebene (routes) ab, weil:
- Wenn Sie nur die Felder auswählen, die Sie benötigen, spart unser Server Rechenzyklen 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 benötigten Felder auswählen, ist die Antwort kleiner und der Netzwerkdurchsatz höher.
HTTP-Anfrage
POST https://routes.googleapis.com/directions/v2:computeRoutes
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
|---|
{ "origin": { object ( |
| Felder | |
|---|---|
origin |
Erforderlich. Ausgangswegpunkt. |
destination |
Erforderlich. Zielwegpunkt. |
intermediates[] |
Optional. Eine Reihe von Wegpunkten entlang der Route (ohne Endpunkte), an denen entweder angehalten oder vorbeigefahren wird. Es werden bis zu 25 Zwischenwegpunkte 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 Routenpräferenz zu berechnen. Wenn die Routingeinstellung 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 dann einen 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 Zwischenwegpunkten werden keine alternativen Routen zurückgegeben. |
routeModifiers |
Optional. Eine Reihe von Bedingungen, die erfüllt sein 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 Wert für die länderspezifische 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 „true“ festgelegt ist, versucht der Dienst, die Gesamtkosten der Route zu minimieren, indem die angegebenen Zwischenwegpunkte neu angeordnet werden. Die Anfrage schlägt fehl, wenn einer der Zwischenwegpunkte ein |
requestedReferenceRoutes[] |
Optional. Gibt an, welche Referenzrouten zusätzlich zur Standardroute als Teil der Anfrage berechnet werden sollen. Eine Referenzroute ist eine Route mit einem anderen Routenberechnungsziel als die Standardroute. Bei der Berechnung einer Referenzroute für ein |
extraComputations[] |
Optional. Eine Liste zusätzlicher Berechnungen, die zum Abschließen der Anfrage verwendet werden können. Hinweis: Diese zusätzlichen Berechnungen können zusätzliche Felder in der Antwort zurückgeben. Diese zusätzlichen Felder müssen auch in der Feldmaske angegeben werden, 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 |
Wenn der Server die Routenergebnisse nicht mit allen Eingabeeinstellungen berechnen kann, wird möglicherweise eine andere Berechnungsmethode verwendet. Wenn der Fallback-Modus verwendet wird, enthält dieses Feld detaillierte Informationen zur Fallback-Antwort. Andernfalls ist dieses Feld nicht festgelegt. |
geocodingResults |
Enthält Informationen zur Geocoding-Antwort für Wegpunkte, die als Adressen angegeben wurden. |
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 mit hoher Qualität an, die aus mehr Punkten als OVERVIEW besteht, was zu einer größeren Antwort führt. Verwenden Sie diesen Wert, wenn Sie mehr Genauigkeit 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. Diese Option hat eine geringere Anfragelatenz als die Option HIGH_QUALITY. |
PolylineEncoding
Gibt den bevorzugten Typ der zurückzugebenden Polylinie an.
| 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, die diesen Wert enthalten, 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 beim Ausführen der Anfrage durchgeführt werden sollen. In Zukunft werden möglicherweise weitere Werte hinzugefügt.
| 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 Route(n) unter Berücksichtigung der aktuellen Verkehrslage. |
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. Sie sollten sie nicht programmatisch parsen. |
FLYOVER_INFO_ON_POLYLINE |
Informationen zu Überflügen für die Route(n). Die Feldmaske routes.polyline_details.flyover_info muss angegeben werden, damit diese Informationen zurückgegeben werden. Diese Daten werden derzeit nur für bestimmte Großräume in Indien erhoben. Diese Funktion ist experimentell und die SKU/Gebühr kann sich ändern. |
NARROW_ROAD_INFO_ON_POLYLINE |
Informationen zu engen Straßen auf der Route bzw. den Routen. Die Feldmaske routes.polyline_details.narrow_road_info muss angegeben werden, damit diese Informationen zurückgegeben werden. Diese Daten werden derzeit nur für bestimmte Großräume in Indien erhoben. Diese Funktion ist experimentell und die SKU/Gebühr kann sich ändern. |
TUNNEL_INFO_ON_POLYLINE |
Tunnelinformationen für die Route(n). Die Feldmaske routes.polyline_details.tunnel_info muss angegeben werden, damit diese Informationen zurückgegeben werden. |
BRIDGE_INFO_ON_POLYLINE |
Informationen zu Brücken auf der Route bzw. den Routen. Die Feldmaske routes.polyline_details.bridge_info muss angegeben werden, damit diese Informationen zurückgegeben werden. |
SKYWAY_INFO_ON_POLYLINE |
Informationen zu Skyways für die Route(n). Die Feldmaske routes.polyline_details.skyway_info muss angegeben werden, damit diese Informationen zurückgegeben werden. |
Route
Enthält eine Route, die aus einer Reihe verbundener Straßensegmente 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. Jeder Abschnitt entspricht der Fahrt zwischen zwei |
distanceMeters |
Die Länge der Route in Metern. |
duration |
Die Zeit, die für die Route benötigt wird. Wenn Sie Wenn
In allen anderen Fällen werden die Geschwindigkeiten von Pkw verwendet, auch wenn in 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 gesamten Route. Diese Polylinie ist die kombinierte Polylinie aller |
description |
Eine Beschreibung der Route. |
warnings[] |
Ein Array mit Warnungen, die zusammen mit der Route angezeigt werden müssen. |
viewport |
Der Begrenzungsrahmen des Darstellungsbereichs der Polylinie. |
travelAdvisory |
Zusätzliche Informationen zur Route. |
optimizedIntermediateWaypointIndex[] |
Wenn Sie |
localizedValues |
Textdarstellungen von Attributen des |
routeToken |
Ein opakes Token, das an das Navigation SDK übergeben werden kann, um die Route während der Navigation zu rekonstruieren und bei einer Neuberechnung der Route die ursprüngliche Absicht bei der Erstellung der Route zu berücksichtigen. Behandeln Sie dieses Token als intransparentes 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 , die nützlich sind, um bestimmte Eigenschaften der Route zu identifizieren und mit anderen zu vergleichen.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. Solche Routen werden zurückgegeben, wenn angegeben ist. |
FUEL_EFFICIENT |
Spritsparende Route. Routen, die mit diesem Wert gekennzeichnet sind, sind für umweltfreundliche 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 des Abschnitts benötigt wird. Wenn Wenn
In allen anderen Fällen werden die Geschwindigkeiten von Pkw verwendet, auch wenn in 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 gesamte Polylinie für diesen Abschnitt, die die Polylinie 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 Abschnitts kennzeichnen. Jeder Schritt entspricht einer Navigationsanweisung. |
travelAdvisory |
Enthält zusätzliche 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 |
Übersicht über die Schritte 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. Der Standardwert ist „encoded_polyline“. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt: | |
encodedPolyline |
Die Stringcodierung der Polylinie mit dem Algorithmus für codierte Polylinien |
geoJsonLinestring |
Gibt eine Polylinie im GeoJSON-LineString-Format 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 bestimmten Umständen hat dieses Feld möglicherweise keinen Wert. |
staticDuration |
Die Dauer der Fahrt durch diesen Schritt, ohne Berücksichtigung der Verkehrslage. Unter bestimmten Umständen hat dieses Feld möglicherweise 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 informiert werden sollte, z. B. mögliche Einschränkungen für Verkehrszonen, für einen Abschnittsschritt. |
localizedValues |
Textdarstellungen von Attributen des |
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 für den aktuellen Schritt angeben (z. B. links abbiegen, einordnen oder geradeaus fahren).
| Enums | |
|---|---|
MANEUVER_UNSPECIFIED |
Nicht verwendet. |
TURN_SLIGHT_LEFT |
Drehe dich leicht nach links. |
TURN_SHARP_LEFT |
Scharf nach links abbiegen. |
UTURN_LEFT |
Links wenden. |
TURN_LEFT |
Links abbiegen. |
TURN_SLIGHT_RIGHT |
Drehe dich leicht nach rechts. |
TURN_SHARP_RIGHT |
Scharf rechts abbiegen. |
UTURN_RIGHT |
Rechts wenden. |
TURN_RIGHT |
Rechts abbiegen. |
STRAIGHT |
Geradeaus fahren. |
RAMP_LEFT |
Nehmen Sie die linke Auffahrt. |
RAMP_RIGHT |
Die rechte Auffahrt nehmen. |
MERGE |
In den Verkehr einordnen. |
FORK_LEFT |
Nimm die linke Gabelung. |
FORK_RIGHT |
Nimm die rechte Abzweigung. |
FERRY |
Nimm die Fähre. |
FERRY_TRAIN |
Nimm den Zug, der auf die Fähre fährt. |
ROUNDABOUT_LEFT |
Biegen Sie am Kreisverkehr links ab. |
ROUNDABOUT_RIGHT |
Biegen Sie am 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 Ziel anzugeben. |
RouteLegStepTravelAdvisory
Enthält die zusätzlichen Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen für Verkehrszonen auf einem Teilstreckenabschnitt.
| 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 Entfernung in Textform. |
staticDuration |
Dauer ohne Berücksichtigung der Verkehrslage, dargestellt in Textform. |
RouteLegStepTransitDetails
Zusätzliche Informationen für RouteLegStep im Zusammenhang mit 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 headway_seconds-Wert von 600 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, wird für |
tripShortText |
Der Text, der in Fahrplänen und auf Schildern angezeigt wird, um Fahrgästen eine Fahrt 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 voraussichtliche 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 der Haltestelle, angegeben in Breiten- und Längengradkoordinaten. |
TransitDetailsLocalizedValues
Lokalisierte Beschreibungen der Werte für RouteTransitDetails.
| JSON-Darstellung |
|---|
{ "arrivalTime": { object ( |
| Felder | |
|---|---|
arrivalTime |
Uhrzeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone. |
departureTime |
Uhrzeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone. |
LocalizedTime
Lokalisierte Beschreibung der Zeit.
| JSON-Darstellung |
|---|
{
"time": {
object ( |
| Felder | |
|---|---|
time |
Die Zeit, die als String in einer bestimmten Zeitzone angegeben ist. |
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 Betreiber (oder die Betreiber), der diese ÖPNV-Linie betreibt. |
name |
Der vollständige Name dieser ÖPNV-Linie, z. B. „8 Avenue Local“. |
uri |
Der URI für die ÖPNV-Linie, die vom Betreiber bereitstellt wird. |
color |
Die Farbe, die üblicherweise für die Beschilderung dieser Linie verwendet wird. Wird im Hexadezimalformat dargestellt. |
iconUri |
Der URI für das Symbol, das dieser Linie zugeordnet ist. |
nameShort |
Der Kurzname der Ö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 im Hexadezimalformat 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 Telefonnummer des Verkehrsverbunds im internationalen Format. |
uri |
Der URI des Betreibers. |
TransitVehicle
Informationen zu einem Fahrzeug, das auf ÖPNV-Routen eingesetzt wird.
| JSON-Darstellung |
|---|
{ "name": { object ( |
| Felder | |
|---|---|
name |
Der Name dieses Fahrzeugs, großgeschrieben. |
type |
Der verwendete Fahrzeugtyp. |
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 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 Teilstreckenabschnitt informiert werden sollte, z. B. mögliche Einschränkungen in Verkehrszonen.
| JSON-Darstellung |
|---|
{ "tollInfo": { object ( |
| Felder | |
|---|---|
tollInfo |
Enthält Informationen zu Mautgebühren für die jeweilige |
speedReadingIntervals[] |
Geschwindigkeitsintervalle, die die Verkehrsdichte angeben. Dieses Feld wird nur für Anfragen ausgefüllt, wenn die Anfrage den Beispiel: |
RouteLegLocalizedValues
Textdarstellungen bestimmter Properties.
| JSON-Darstellung |
|---|
{ "distance": { object ( |
| Felder | |
|---|---|
distance |
Die Entfernung in Textform. |
duration |
Dauer, dargestellt in Textform und lokalisiert für die Region der Abfrage. 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, dargestellt in Textform. |
StepsOverview
Bietet Übersichtsinformationen zu einer Liste von RouteLegSteps.
| 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 ist definiert als ein oder mehrere zusammenhängende RouteLegStep mit derselben RouteTravelMode. 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 Darstellungsbereich mit Breiten- und Längengrad, der durch zwei diagonal gegenüberliegende low- und high-Punkte dargestellt wird. Ein Darstellungsbereich gilt als geschlossene Region, d.h., er schließt seine Grenze ein. Die Grenzen für den Breitengrad müssen zwischen -90 und 90 Grad liegen, die Grenzen für den Längengrad zwischen -180 und 180 Grad. Beispiele:
Wenn
low=highist, besteht der Darstellungsbereich aus diesem einzelnen Punkt.Wenn
low.longitude>high.longitude, wird der Längengradbereich invertiert (der Darstellungsbereich überschreitet den 180-Grad-Längengrad).Wenn
low.longitude= -180 Grad undhigh.longitude= 180 Grad, 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 Feld darf nicht leer sein (wie in den obigen Definitionen angegeben). Ein leerer Darstellungsbereich führt zu einem Fehler.
Dieser Darstellungsbereich umschließt beispielsweise 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 Tiefpunkt des Darstellungsbereichs. |
high |
Erforderlich. Der höchste Punkt des Darstellungsbereichs. |
RouteLocalizedValues
Textdarstellungen bestimmter Properties.
| JSON-Darstellung |
|---|
{ "distance": { object ( |
| Felder | |
|---|---|
distance |
Die Entfernung in Textform. |
duration |
Dauer, dargestellt in Textform und lokalisiert für die Region der Abfrage. Berücksichtigt die Verkehrslage. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, entspricht dieser Wert dem Wert von |
staticDuration |
Dauer ohne Berücksichtigung der Verkehrslage, dargestellt in Textform. |
transitFare |
Fahrpreis in Textform. |
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) definiert PolylineDetails ein Intervall und die zugehörigen Metadaten.
| JSON-Darstellung |
|---|
{ "tunnelInfo": [ { object ( |
| Felder | |
|---|---|
tunnelInfo[] |
Tunneldetails entlang der Polylinie. Dieses Feld wird ausgefüllt, wenn in der Anfrage der Routenmodifikator |
restrictionInfo[] |
Einschränkungsdetails entlang der Polylinie. Dieses field wird nur ausgefüllt, wenn in einer Anfrage der Routenmodifikator |
flyoverInfo[] |
Details zum Überflug entlang der Polylinie. |
narrowRoadInfo[] |
Details zu engen Straßen entlang der Polylinie. |
bridgeInfo[] |
Details zu Brücken entlang der Polylinie. |
skywayInfo[] |
Details zu Skyways entlang der Polylinie. |
TunnelInfo
Enthält 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 Tunnelinformationen entlang der Polylinie. |
RoadFeatureState
Kapselt die Zustände von Straßenelementen 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ßenelement ist nicht vorhanden. |
PolylinePointIndex
Kapselt die Start- und Endindexe für ein Polyliniendetail. Wenn die Daten einem einzelnen Punkt entsprechen, sind startIndex und endIndex gleich.
| JSON-Darstellung |
|---|
{ "startIndex": integer, "endIndex": integer } |
| Felder | |
|---|---|
startIndex |
Der Startindex dieses Details in der Polylinie. |
endIndex |
Der Endindex dieses Details in der Polylinie. |
RestrictionInfo
Enthält 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 besteht. |
polylinePointIndex |
Die Position der Informationen zur Einschränkung 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 Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt: | |
restrictedHeightMm |
Die Höhenbegrenzung in Millimetern. Dieses Feld wird ausgefüllt, wenn die Höhenbeschränkung die Durchfahrt verhindert oder zu einer geringen Durchfahrtshöhe für das angegebene Fahrzeug führt. |
restrictedWeightKg |
Das Gewichtslimit in Kilogramm. Dieses Feld wird ausgefüllt, wenn die Gewichtsbeschränkung die Durchfahrt verhindert oder nahe am Gewicht des angegebenen Fahrzeugs liegt. |
hazardousGoods |
Dieses Feld ist auf „true“ gesetzt, wenn der Transport von Gefahrgut eingeschränkt ist. |
trucksProhibited |
Dieses Feld ist 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 |
Die Position der Informationen zum Überflug entlang der Polylinie. |
NarrowRoadInfo
Enthält Informationen zu engen Straßen entlang der Polylinie.
| JSON-Darstellung |
|---|
{ "narrowRoadPresence": enum ( |
| Felder | |
|---|---|
narrowRoadPresence |
Nur Ausgabe. Gibt an, ob es auf einem bestimmten Abschnitt der Polylinie eine schmale Straße gibt. |
polylinePointIndex |
Die Position der Informationen zu engen 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 Informationen zu Brücken entlang der Polylinie. |
SkywayInfo
Enthält Informationen zu Skyways entlang der Polylinie.
| JSON-Darstellung |
|---|
{ "skywayPresence": enum ( |
| Felder | |
|---|---|
skywayPresence |
Gibt an, ob für einen bestimmten Abschnitt der Polylinie ein Skyway vorhanden ist. |
polylinePointIndex |
Die Position der Informationen zum Skyway entlang der Polylinie. |
GeocodingResults
Enthält für Start, Ziel und Zwischenwegpunkte. Wird nur für Adresswegpunkte ausgefüllt.GeocodedWaypoints
| JSON-Darstellung |
|---|
{ "origin": { object ( |
| Felder | |
|---|---|
origin |
Geocodierter Wegpunkt des Startpunkts. |
destination |
Geocodierter Wegpunkt des Ziels. |
intermediates[] |
Eine Liste von 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 Adresswegpunkte ausgefüllt. Enthält Details zu den Geocoding-Ergebnissen, um festzustellen, zu welcher Adresse das Geocoding durchgeführt wurde.
| JSON-Darstellung |
|---|
{
"geocoderStatus": {
object ( |
| Felder | |
|---|---|
geocoderStatus |
Gibt den Statuscode des Geocoding-Vorgangs an. |
type[] |
Der Typ oder die Typen des Ergebnisses in Form von null oder mehr Typ-Tags. Unterstützte Typen: Typen von Adressen und Adresskomponenten |
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 Zwischenwegpunkts in der Anfrage. Wird nur ausgefüllt, wenn der entsprechende Wegpunkt ein Zwischenwegpunkt ist. |