Beispiele für Wegbeschreibungen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Dieses Produkt hat den Legacy-Status. Ab Oktober 2026 kann die Directions API (Legacy) nicht mehr für neue Google Cloud-Projekte aktiviert werden. Bestehende Projekte werden weiterhin vollständig unterstützt. Wenn Sie neue Funktionen und eine verbesserte Leistung nutzen möchten, migrieren Sie zur Routes API.

Beispielanfragen

Mit der folgenden Anfrage wird eine Wegbeschreibung von Toronto, Ontario, nach Montreal, Quebec, zurückgegeben.

URL

https://maps.googleapis.com/maps/api/directions/json?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY'

Wenn Sie die Parameter mode und avoid ändern, können Sie die ursprüngliche Anfrage so anpassen, dass eine landschaftlich schöne Fahrradroute zurückgegeben wird, die Autobahnen vermeidet.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?avoid=highways
  &destination=Montreal
  &mode=bicycling
  &origin=Toronto
  &key=YOUR_API_KEYYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&avoid=highways&mode=bicycling&key=YOUR_API_KEY'YOUR_API_KEY'

Mit der folgenden Anfrage werden Routen für öffentliche Verkehrsmittel von Brooklyn, New York, nach Queens, New York, gesucht. In der Anfrage ist keine departure_time angegeben, daher wird die aktuelle Uhrzeit als Abfahrtszeit verwendet:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&keyYOUR_API_KEY'

Die folgende Anfrage für öffentliche Verkehrsmittel enthält eine bestimmte Abfahrtszeit.

Hinweis:In diesem Beispiel ist die Abfahrtszeit der 30. Juli 2012 um 09:45 Uhr. Damit kein Fehler auftritt, müssen Sie den Parameter vor dem Senden der Anfrage in eine Zeit in der Zukunft ändern.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=1343641500
  &destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&departure_time=1343641500&key=YOUR_API_KEY'

In der folgenden Anfrage werden Plus Codes verwendet, um eine Wegbeschreibung von H8MW+WP nach GCG2+3M in Kolkata, Indien, zurückzugeben.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=GCG2%2B3M%20Kolkata%20India
  &origin=H8MW%2BWP%20Kolkata%20India
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=H8MW%2BWP%20Kolkata%20India&destination=GCG2%2B3M%20Kolkata%20India&key=YOUR_API_KEY'

Mit der folgenden Anfrage wird eine Wegbeschreibung von Glasgow, Vereinigtes Königreich, nach Perth, Vereinigtes Königreich, mithilfe von Orts-IDs zurückgegeben.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y
  &origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE
  &keyYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE&destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y&key=YOUR_API_KEY'

Mobilitätsformen

Wenn Sie eine Route berechnen, können Sie die zu verwendende mode angeben. Standardmäßig werden Routen als driving-Routen berechnet. Folgende Mobilitätsformen werden unterstützt:

  • Bei driving (Standardeinstellung) wird eine standardmäßige Wegbeschreibung auf Grundlage des Straßennetzes angefordert.
  • Bei walking werden Fußgängerrouten auf Fußgängerwegen und Bürgersteigen (sofern vorhanden) angefordert.
  • Bei bicycling werden Fahrradrouten mit Radwegen und bevorzugten Straßen (sofern vorhanden) angefordert.
  • Bei transit werden Routen mit öffentlichen Verkehrsmitteln (sofern vorhanden) angefordert. Wenn Sie den Modus auf transit festlegen, können Sie optional entweder departure_time oder arrival_time angeben. Wenn keine der beiden Zeiten angegeben ist, wird für departure_time standardmäßig die aktuelle Uhrzeit verwendet (d. h. die Abfahrtszeit entspricht der aktuellen Uhrzeit). Optional können Sie auch eine transit_mode und/oder eine transit_routing_preference angeben.

Hinweis:Fußgänger- und Fahrradrouten enthalten unter Umständen keine ausgewiesenen Fußgänger- oder Fahrradwege. In diesen Fällen werden im zurückgegebenen Ergebnis warnings zurückgegeben, die Sie dem Nutzer anzeigen müssen.

Verkehrsinformationen

Verkehrsinformationen werden verwendet, wenn alle der folgenden Bedingungen zutreffen (sie sind erforderlich, um das Feld duration_in_traffic in der Directions-Antwort zu erhalten):

  • Der Parameter mode ist driving oder nicht angegeben (driving ist die Standardmobilitätsform).
  • Die Anfrage enthält einen gültigen Parameter departure_time. Für departure_time kann die aktuelle oder eine Zeit in der Zukunft festgelegt werden. Der Wert darf nicht in der Vergangenheit liegen.
  • Die Anfrage enthält keine Wegpunkte mit Aufenthalt. Wenn die Anfrage Wegpunkte enthält, müssen Sie für jeden Wegpunkt das Präfix via: verwenden, um Aufenthalte zu vermeiden. Beispiel: 
    &waypoints=via:San Francisco|via:Mountain View|...

Optional können Sie den Parameter traffic_model in Ihre Anfrage aufnehmen, um die Annahmen anzugeben, die bei der Berechnung der Reisezeit verwendet werden sollen.

Mit der folgenden URL wird eine Routenanfrage für eine Fahrt von Boston, MA, nach Concord, MA, über Charlestown und Lexington initiiert. Die Anfrage enthält eine Abfahrtszeit und erfüllt alle Anforderungen, damit das Feld duration_in_traffic in der Routenantwort zurückgegeben wird.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=now
  &destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&departure_time=now&key=YOUR_API_KEY'

Wegpunkte

Wenn Sie Routen mit der Directions API (Legacy) berechnen, können Sie Wegpunkte angeben, um eine Route mit Zwischenstopps oder Durchfahrten an Zwischenorten zu erhalten. Sie können Wegpunkte zu Routen für Autofahrer, Fußgänger oder Fahrradrouten hinzufügen, aber nicht zu Routen für öffentliche Verkehrsmittel.

Geben Sie im Parameter waypoints Standorte an.

Sie können einen oder mehrere Orte angeben, die durch das Pipe-Zeichen (| oder %7C) getrennt sind. Die Angabe kann in Form einer Orts-ID, einer Adresse oder von Breiten-/Längengradkoordinaten erfolgen. Standardmäßig berechnet der Directions-Dienst die Route über die Wegpunkte in der angegebenen Reihenfolge. Die Reihenfolge für das Parsen des Werts des Wegpunkts ist Orts-ID, Breiten-/Längengradkoordinaten und dann Adresse.

  • Wenn Sie eine Orts-ID übergeben, müssen Sie ihr das Präfix place_id: voranstellen. Sie können Orts-IDs aus der Geocoding API und der Places API (einschließlich Place Autocomplete) abrufen. Ein Beispiel für die Verwendung von Orts-IDs aus dem „Place Autocomplete“-Dienst finden Sie hier. Weitere Informationen finden Sie in der Übersicht zur Orts-ID.

    Verwenden Sie nach Möglichkeit Orts-IDs, um die Effizienz und Genauigkeit zu erhöhen. Diese IDs sind eindeutig und explizit wie ein Breiten-/Längengrad-Wertepaar und bieten Geocoding-Vorteile für das Routing, z. B. Zugangspunkte und Verkehrsvariablen. Im Gegensatz zu einer Adresse ist für eine ID keine Suche oder Zwischenanfrage für Ortsdetails erforderlich. Daher ist die Leistung besser.

  • Wenn Sie Breiten- und Längengradkoordinaten übergeben, werden die Werte direkt an den Frontend-Server gesendet, um die Route ohne Geocoding zu berechnen. Die Punkte werden an Straßen ausgerichtet und bieten möglicherweise nicht die Genauigkeit, die Ihre App benötigt. Verwenden Sie Koordinaten, wenn Sie sicher sind, dass die Werte genau die Punkte angeben, die Ihre Anwendung für das Routing benötigt, ohne dass mögliche Zugangspunkte oder zusätzliche Geocoding-Details berücksichtigt werden müssen. Achten Sie darauf, dass die Werte für den Breiten- und Längengrad durch ein Komma (%2C) und nicht durch ein Leerzeichen (%20) getrennt sind.
  • Wenn Sie eine Adresse übergeben, wird der String vom Directions-Dienst geocodiert und in Breiten- und Längengradkoordinaten umgewandelt, um die Wegbeschreibung zu berechnen. Wenn der Adresswert mehrdeutig ist, kann der Wert eine Suche auslösen, um ihn von ähnlichen Adressen zu unterscheiden. Beispielsweise könnte „1st Street“ ein vollständiger Wert oder ein Teilwert für „1st street NE“ oder „1st St SE“ sein. Dieses Ergebnis kann sich von dem der Geocoding API unterscheiden. Mit Orts-IDs können Sie mögliche Fehlinterpretationen vermeiden. Weitere Informationen finden Sie unter Fehlerbehebung bei den Ergebnissen meiner Routenanfrage.

Alternativ können Sie eine codierte Gruppe von Punkten mit dem Algorithmus für codierte Polylinien angeben. Ein codierter Satz ist für eine große Anzahl von Wegpunkten nützlich, da die URL dadurch erheblich kürzer wird. Für alle Webdienste gilt ein URL-Limit von 16.384 Zeichen.

  • Codierten Polylinien muss enc: vorangestellt werden, gefolgt von einem Doppelpunkt (:). Beispiel: waypoints=enc:gfo}EtohhU:.
  • Sie können auch mehrere codierte Polylinien angeben, die durch einen senkrechten Strich (|) getrennt sind. Beispiel: waypoints=via:enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:| via:enc:udymA{~bxM:

Mit der folgenden URL wird eine Directions-Anfrage für eine Fahrt zwischen Boston, MA, und Concord, MA, mit Zwischenstopps in Charlestown und Lexington (in dieser Reihenfolge) initiiert. In diesem Beispiel werden Adressen verwendet:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

Routen mit Zwischenstopps und Durchgangspunkten beeinflussen

Für jeden Wegpunkt in der Anfrage wird der Antwort mit den Wegbeschreibungen ein Eintrag im Array legs hinzugefügt, um Details zu Zwischenstopps auf diesem Abschnitt der Reise anzugeben.

Wenn Sie die Route mithilfe von Wegpunkten beeinflussen möchten, ohne einen Zwischenstopp hinzuzufügen, fügen Sie dem Wegpunkt das Präfix via: hinzu. Wegpunkte mit dem Präfix via: werden nicht in das Array legs aufgenommen, aber die Route führt über den Wegpunkt.

Mit der folgenden URL wird die vorherige Anfrage so geändert, dass die Route ohne Zwischenstopp durch Lexington führt:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

Das Präfix via: ist am effektivsten, wenn Routen erstellt werden, während der Nutzer die Wegpunkte auf der Karte zieht. So kann der Nutzer in Echtzeit sehen, wie die endgültige Route aussehen könnte, und es wird sichergestellt, dass Wegpunkte an Orten platziert werden, die für die Directions API (Legacy) zugänglich sind.

Über die folgende URL werden Wegpunkte mithilfe von Koordinaten (Längen- und Breitengrad) angefordert:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008&key=YOUR_API_KEY'

Dies ist dieselbe Anforderung, wobei in diesem Fall jedoch eine codierte Polylinie verwendet wird:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

Sie können eine via:-Spezifikation beliebig mit Standortmodifikatoren kombinieren. Beispiel:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

Wegpunkte optimieren

Standardmäßig berechnet der „Directions“-Dienst die Route über die Wegpunkte in der angegebenen Reihenfolge. Optional können Sie optimize:true als erstes Argument im Parameter waypoints übergeben, damit der „Directions“-Dienst die Wegpunkte in eine effizientere Reihenfolge bringen kann, um die Route zu optimieren. Diese Optimierung ist eine Umsetzung des Rundreiseproblems. Die Route wird primär nach der Fahrzeit optimiert, es können aber auch andere Faktoren berücksichtigt werden, wie z. B. die Entfernung oder die Anzahl der Abzweige. Damit der „Directions“-Dienst die Route optimieren kann, müssen alle Wegpunkte als Aufenthalte definiert sein.

Wenn Sie den Directions-Dienst anweisen, die Reihenfolge der Wegpunkte zu optimieren, wird die Reihenfolge im Feld waypoint_order im routes-Objekt zurückgegeben. Das Feld waypoint_order gibt nullbasierte Werte zurück.

Im folgenden Beispiel wird eine Fahrt von Adelaide, South Australia, zu den wichtigsten Weinregionen von South Australia mithilfe der Routenoptimierung berechnet.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Adelaide%2C%20SA
  &origin=Adelaide%2C%20SA
  &waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Adelaide%2C%20SA&destination=Adelaide%2C%20SA&waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA&key=YOUR_API_KEY'

Bei der Prüfung der berechneten Route wird angezeigt, dass die Berechnung Wegpunkte in der folgenden Wegpunktreihenfolge verwendet:

"waypoint_order": [ 3, 2, 0, 1 ]

Einschränkungen

Routen können so berechnet werden, dass sie bestimmte Einschränkungen beachten. Einschränkungen werden durch den Parameter avoid und ein Argument für diesen Parameter angegeben, das die zu vermeidende Einschränkung angibt. Folgende Einschränkungen werden unterstützt:

  • avoid=tolls
  • avoid=highways
  • avoid=ferries

Sie können eine Route anfordern, bei der eine beliebige Kombination aus Mautstraßen, Autobahnen und Fähren vermieden wird, indem Sie beide Einschränkungen an den Parameter „avoid“ übergeben. Beispiel: avoid=tolls|highways|ferries.

Hinweis:Durch das Hinzufügen von Einschränkungen werden Routen, die das eingeschränkte Element enthalten, nicht ausgeschlossen. Das Ergebnis wird jedoch zugunsten günstigerer Routen beeinflusst.

Einheitensysteme

Routenergebnisse enthalten text-Felder innerhalb von distance-Feldern, die dem Nutzer angezeigt werden können, um die Entfernung eines bestimmten „Schritts“ der Route anzugeben. Standardmäßig wird für diesen Text das Einheitensystem des Ausgangslands bzw. der Ausgangsregion verwendet.

Bei einer Route von „Chicago, IL“ nach „Toronto, ONT“ werden die Ergebnisse also in Meilen angezeigt, für die Rückfahrt aber in Kilometern. Sie können das Einheitensystem überschreiben, indem Sie in der Anfrage explizit ein anderes System im Parameter units festlegen. Folgende Werte sind zulässig:

  • metric gibt an, dass das metrische System verwendet werden soll. Entfernungen im Textformat werden in Kilometern und Metern zurückgegeben.
  • imperial gibt an, dass das imperiale (englische) System verwendet werden soll. Entfernungen im Textformat werden in Meilen und Fuß zurückgegeben.

Hinweis : Die Einstellung für das Einheitensystem wirkt sich nur auf die text aus, die in distance-Feldern angezeigt werden. Die distance-Felder enthalten auch values, die immer in Metern angegeben werden.

Gewichtung nach Region

Sie können den Directions-Dienst so einstellen, dass er Ergebnisse aus einer bestimmten Region zurückgibt, indem Sie den Parameter region verwenden. Dieser Parameter akzeptiert ein zweistelliges ccTLD-Argument (länderspezifische Top-Level-Domain), das die regionale Gewichtung angibt. Die meisten ccTLD-Codes entsprechen den Alpha-2-Codes nach ISO 3166. Es gibt jedoch einige Ausnahmen. So lautet beispielsweise die ccTLD des Vereinigten Königreichs „uk“ (.co.uk), der ISO 3166-1-Code dagegen „gb“ (technisch gesehen für die Entität „Vereinigtes Königreich Großbritannien und Nordirland“). Welche Regionen unterstützt werden, sehen Sie in den Details zur Google Maps Platform-Abdeckung.

Sie können jede Domain verwenden, in der die Hauptanwendung von Google Maps Wegbeschreibungen anbietet.

Wenn Sie beispielsweise eine Routenanfrage von „Toledo“ nach „Madrid“ stellen und region auf es festgelegt ist, wird „Toledo“ als die spanische Stadt interpretiert und Sie erhalten entsprechende Ergebnisse:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &region=es
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid®ion=es&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ8f21C60Lag0R_q11auhbf8Y",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 40.4165207, "lng": -3.7026134 },
            "southwest": { "lat": 39.862808, "lng": -4.029406799999999 },
          },
        "copyrights": "Map data ©2022 Inst. Geogr. Nacional",
        "legs":
          [
            {
              "distance": { "text": "74.3 km", "value": 74327 },
              "duration": { "text": "57 mins", "value": 3446 },
              "end_address": "Madrid, Spain",
              "end_location": { "lat": 40.4165207, "lng": -3.705076 },
              "start_address": "Toledo, Spain",
              "start_location": { "lat": 39.862808, "lng": -4.0273727 },
              "steps":
                [
                  {
                    "distance": { "text": "0.6 km", "value": 615 },
                    "duration": { "text": "2 mins", "value": 106 },
                    "end_location":
                      { "lat": 39.8681019, "lng": -4.029378299999999 },
                    "html_instructions": "Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b>",
                    "polyline":
                      {
                        "points": "quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC",
                      },
                    "start_location": { "lat": 39.862808, "lng": -4.0273727 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
          ],
        "overview_polyline":
          {
            "points": "quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)",
          },
        "summary": "A-42",
        "warnings": [],
        "waypoint_order": [],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>A-42</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>39.8628080</lat>
     <lng>-4.0273727</lng>
    </start_location>
    <end_location>
     <lat>39.8681019</lat>
     <lng>-4.0293783</lng>
    </end_location>
    <polyline>
     <points>quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC</points>
    </polyline>
    <duration>
     <value>106</value>
     <text>2 mins</text>
    </duration>
    <html_instructions>Head &lt;b&gt;northwest&lt;/b&gt; on &lt;b&gt;Av. de la Reconquista&lt;/b&gt; toward &lt;b&gt;C. de la Diputación&lt;/b&gt;</html_instructions>
    <distance>
     <value>615</value>
     <text>0.6 km</text>
    </distance>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>3446</value>
    <text>57 mins</text>
   </duration>
   <distance>
    <value>74327</value>
    <text>74.3 km</text>
   </distance>
   <start_location>
    <lat>39.8628080</lat>
    <lng>-4.0273727</lng>
   </start_location>
   <end_location>
    <lat>40.4165207</lat>
    <lng>-3.7050760</lng>
   </end_location>
   <start_address>Toledo, Spain</start_address>
   <end_address>Madrid, Spain</end_address>
  </leg>
  <copyrights>Map data ©2022 Inst. Geogr. Nacional</copyrights>
  <overview_polyline>
   <points>quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)</points>
  </overview_polyline>
  <bounds>
   <southwest>
    <lat>39.8628080</lat>
    <lng>-4.0294068</lng>
   </southwest>
   <northeast>
    <lat>40.4165207</lat>
    <lng>-3.7026134</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ8f21C60Lag0R_q11auhbf8Y</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

Eine Routenanfrage für „Toledo“ nach „Madrid“, die ohne den Parameter region gesendet wird, liefert keine Ergebnisse, da „Toledo“ als die Stadt in Ohio und nicht in Spanien interpretiert wird:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJeU4e_C2HO4gRRcM6RZ_IPHw",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes": [],
  "status": "ZERO_RESULTS",
}

XML

      
<DirectionsResponse>
 <status>ZERO_RESULTS</status>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJeU4e_C2HO4gRRcM6RZ_IPHw</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

Standortmodifikatoren

Mit Standortmodifikatoren können Sie angeben, aus welcher Richtung die Fahrer einen bestimmten Standort anfahren sollen. Dazu können Sie mit dem Parameter side_of_road die Straßenseite oder mit einem Kurs die richtige Fahrtrichtung angeben. Diese Modifikatoren können beliebig mit dem Modifikator via: für Zwischenwegpunkte kombiniert werden.

Angeben, dass Routen über eine bestimmte Straßenseite führen müssen

Wenn Sie einen Wegpunkt angeben, können Sie mit dem Präfix side_of_road: festlegen, dass die Route über die Straßenseite führen soll, auf der sich der Wegpunkt befindet. In dieser Wegbeschreibungsanfrage wird beispielsweise eine lange Route zurückgegeben, sodass das Fahrzeug auf der Straßenseite endet, auf die der Wegpunkt ausgerichtet war:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=side_of_road%3A37.7663444%2C-122.4412006
  &origin=37.7680296%2C-122.4375126
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=37.7680296%2C-122.4375126&destination=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'

Wenn Sie side_of_road: mit codierten Polylinien verwenden, wird der Parameter auf jeden Ort entlang der Polylinie angewendet.

Der Modifikator side_of_road: darf nur mit den folgenden Einschränkungen verwendet werden:

  • Der Parameter mode ist driving oder nicht angegeben (driving ist die Standardmobilitätsform).

Angeben, dass Routen eine bestimmte Richtung haben sollen

Wenn Sie einen Wegpunkt angeben, können Sie festlegen, dass die Route in einer bestimmten Richtung durch den Wegpunkt verlaufen soll. Diese Richtung wird mit dem Präfix heading=X: angegeben, wobei X ein ganzzahliger Gradwert zwischen 0 (einschließlich) und 360 (ausschließlich) ist. Eine Aufnahmerichtung von 0 entspricht Norden, 90 entspricht Osten und so weiter im Uhrzeigersinn. In dieser Routenanfrage verläuft die Route beispielsweise vom Startpunkt aus nach Osten und macht dann eine Kehrtwende:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=37.773245%2C-122.469502
  &origin=heading%3D90%3A37.773279%2C-122.468780
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=heading%3D90%3A37.773279%2C-122.468780&destination=37.773245%2C-122.469502&key=YOUR_API_KEY'

Der Modifikator heading=X: darf nur mit den folgenden Einschränkungen verwendet werden:

  • Der Parameter mode ist driving, bicycling oder nicht angegeben (driving ist die Standardmobilitätsform).
  • Der Modifikator side_of_road ist nicht für denselben Standort angegeben.
  • Der Standort wird mit einem Breiten-/Längengradwert angegeben. Sie dürfen heading nicht mit Adressen, Orts-IDs oder codierten Polylinien verwenden.