Bei der Google Maps Directions API handelt es sich um einen Dienst, mit dem Wegbeschreibungen zwischen Standorten berechnet werden können. Sie können nach Wegbeschreibungen für verschiedene Transportmittel suchen, darunter Beschreibungen für öffentliche Verkehrsmittel, Kfz, Fußgänger oder Radfahrer.
Dieser Dienst steht auch als Teil der clientseitigen Google Maps JavaScript API oder zur Verwendung auf Serverseite mit dem Java Client, Python Client, Go Client und Node.js Client for Google Maps Services zur Verfügung.
Beispielanforderung und -antwort
Der Zugriff auf die Google Maps Directions API erfolgt über eine HTTP-Schnittstelle. Die Anforderungen werden als URL-Zeichenfolge konstruiert und es werden Textstrings oder Längengrad- und Breitengradkoordinaten zur Angabe der Standorte sowie Ihr API-Schlüssel verwendet.
Im nachfolgenden Beispiel wird die Beschreibung des Fahrwegs von Disneyland zu den Universal Studios Hollywood im JSON-Format angefordert.
https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood4&key=YOUR_API_KEY
Probieren Sie es aus! Sie können diese Anforderung testen, indem Sie die URL in Ihren Webbrowser eingeben. (Ersetzen Sie „YOUR_API_KEY“ durch Ihren tatsächlichen API-Schlüssel). In der Antwort wird die Beschreibung des Fahrwegs zurückgegeben.
Im Entwickler-Leitfaden finden Sie weitere Informationen zum Erstellen von URLs für Anforderungen und zu verfügbaren Parametern sowie Erläuterungen zur Antwort.
Nachfolgend ist ein Antwortbeispiel im JSON-Format aufgeführt:
{
"geocoded_waypoints" : [
{
"geocoder_status" : "OK",
"place_id" : "ChIJRVY_etDX3IARGYLVpoq7f68",
"types" : [
"bus_station",
"transit_station",
"point_of_interest",
"establishment"
]
},
{
"geocoder_status" : "OK",
"partial_match" : true,
"place_id" : "ChIJp2Mn4E2-woARQS2FILlxUzk",
"types" : [ "route" ]
}
],
"routes" : [
{
"bounds" : {
"northeast" : {
"lat" : 34.1330949,
"lng" : -117.9143879
},
"southwest" : {
"lat" : 33.8068768,
"lng" : -118.3527671
}
},
"copyrights" : "Map data ©2016 Google",
"legs" : [
{
"distance" : {
"text" : "35.9 mi",
"value" : 57824
},
"duration" : {
"text" : "51 mins",
"value" : 3062
},
"end_address" : "Universal Studios Blvd, Los Angeles, CA 90068, USA",
"end_location" : {
"lat" : 34.1330949,
"lng" : -118.3524442
},
"start_address" : "Disneyland (Harbor Blvd.), S Harbor Blvd, Anaheim, CA 92802, USA",
"start_location" : {
"lat" : 33.8098177,
"lng" : -117.9154353
},
... Additional results truncated in this example[] ...
"overview_polyline" : {
"points" : "knjmEnjunUbKCfEA?_@]@kMBeE@qIIoF@wH@eFFk@WOUI_@?u@j@k@`@EXLTZHh@Y`AgApAaCrCUd@cDpDuAtAoApA{YlZiBdBaIhGkFrDeCtBuFxFmIdJmOjPaChDeBlDiAdD}ApGcDxU}@hEmAxD}[tt@yNb\\yBdEqFnJqB~DeFxMgK~VsMr[uKzVoCxEsEtG}BzCkHhKWh@]t@{AxEcClLkCjLi@`CwBfHaEzJuBdEyEhIaBnCiF|K_Oz\\
{MdZwAbDaKbUiB|CgCnDkDbEiE|FqBlDsLdXqQra@kX|m@aF|KcHtLm@pAaE~JcTxh@w\\`v@gQv`@}F`MqK`PeGzIyGfJiG~GeLhLgIpIcE~FsDrHcFfLqDzH{CxEwAbBgC|B}F|DiQzKsbBdeA{k@~\\oc@bWoKjGaEzCoEzEwDxFsUh^wJfOySx[uBnCgCbCoFlDmDvAiCr@eRzDuNxC_EvAiFpCaC|AqGpEwHzFoQnQoTrTqBlCyDnGmCfEmDpDyGzGsIzHuZzYwBpBsC`CqBlAsBbAqCxAoBrAqDdDcNfMgHbHiPtReBtCkD|GqAhBwBzBsG~FoAhAaCbDeBvD_BlEyM``@uBvKiA~DmAlCkA|B}@lBcChHoJnXcB`GoAnIS~CIjFDd]A|QMlD{@jH[vAk@`CoGxRgPzf@aBbHoB~HeMx^eDtJ}BnG{DhJU`@mBzCoCjDaAx@mAnAgCnBmAp@uAj@{Cr@wBPkB@kBSsEW{GV}BEeCWyAWwHs@qH?
cIHkDXuDn@mCt@mE`BsH|CyAp@}AdAaAtAy@lBg@pCa@jE]fEcBhRq@pJKlCk@hLFrB@lD_@xCeA`DoBxDaHvM_FzImDzFeCpDeC|CkExDiJrHcBtAkDpDwObVuCpFeCdHoIl\\uBjIuClJsEvMyDbMqAhEoDlJ{C|J}FlZuBfLyDlXwB~QkArG_AnDiAxC{G|OgEdLaE`LkBbEwG~KgHnLoEjGgDxCaC`BuJdFkFtCgCnBuClD_HdMqEzHcBpB_C|BuEzCmPlIuE|B_EtDeBhCgAdCw@rCi@|DSfECrCAdCS~Di@jDYhA_AlC{AxCcL`U{GvM_DjFkBzBsB`BqDhBaEfAsTvEmEr@iCr@qDrAiFnCcEzCaE~D_@JmFdGQDwBvCeErEoD|BcFjC}DbEuD~D`@Zr@h@?d@Wr@}@vAgCbEaHfMqA`Cy@dAg@bAO`@gCi@w@W"
},
"summary" : "I-5 N and US-101 N",
"warnings" : [],
"waypoint_order" : []
}
],
"status" : "OK"
}
Codierung mit unseren Clientbibliotheken
Clientbibliotheken erleichtern die Entwicklung mit den Google Maps-Webdienst-APIs, indem sie einfache, native Implementierungen häufiger Aufgaben wie Authentifizierung, Anforderungsbegrenzung und automatische Wiederholungsversuche ermöglichen. Die Google Maps Directions API ist im Java Client, Python Client, Go Client und Node.js Client for Google Maps Services verfügbar.
Authentifizierung, Kontingente und Richtlinien
API aktivieren und API-Schlüssel anfordern
Zur Verwendung der Google Maps Directions API müssen Sie zunächst die API in der Google API Console aktivieren und die zugehörigen Authentifizierungsdaten abrufen. Sie müssen in jeder Anforderung einen API-Schlüssel bereitstellen (oder eine Client-ID, falls Sie einen Premium-Plan nutzen).
Klicken Sie auf die Schaltfläche unten, um einen Prozess zu durchlaufen, in dem Sie:
- Ein Projekt erstellen oder auswählen
- Die API aktivieren
- API-Schlüssel anfordern
Hier erhalten Sie weitere Informationen zu Authentifizierungsdaten.
Kontingente
In den Informationen über Nutzungsbeschränkungen erhalten Sie weitere Einzelheiten zu Kontingenten, die für die Google Maps Directions API gelten.
Richtlinien
Die Nutzung der Google Maps Directions API muss im Einklang mit den API-Richtlinien stehen.
Weitere Infos
Die Directions API bietet Ihnen noch zahlreiche weitere Möglichkeiten. So können Sie beispielsweise Wegbeschreibungen für unterschiedliche Verkehrsmittel anfordern, anhand von Wegpunkten Routen mit zusätzlichen Orten berechnen und die Reisezeit schätzen. Weitere Beispiele und Informationen finden Sie im Entwickler-Leitfaden zur Directions API.
Weitere Fragen?