Erste Schritte

Bei der Google Maps Distance Matrix API handelt es sich um einen Dienst, der basierend auf der empfohlenen Route zwischen den Start- und Zielpunkten Entfernungen und Reisezeiten für eine Start- und Zielortmatrix bereitstellt.

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 Distance Matrix API erfolgt über eine HTTP-Schnittstelle. Die Anforderungen werden als URL-Zeichenfolge konstruiert und es werden die Start- und Zielpunkte (origins und destinations) sowie Ihr API-Schlüssel verwendet.

Im folgenden Beispiel werden die Distance Matrix-Daten für die Entfernung zwischen Washington, DC und New York City, NY, im JSON-Format angefordert:

https://maps.googleapis.com/maps/api/distancematrix/json?units=imperial&origins=Washington,DC&destinations=New+York+City,NY&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). Die Antwort enthält die Entfernung und die Reisedauer zwischen den angegebenen Start- und Zielpunkten.

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:

{
   "destination_addresses" : [ "New York, NY, USA" ],
   "origin_addresses" : [ "Washington, DC, USA" ],
   "rows" : [
      {
         "elements" : [
            {
               "distance" : {
                  "text" : "225 mi",
                  "value" : 361715
               },
               "duration" : {
                  "text" : "3 hours 49 mins",
                  "value" : 13725
               },
               "status" : "OK"
            }
         ]
      }
   ],
   "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 Distance Matrix 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 Distance Matrix 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:

1. Ein Projekt erstellen oder auswählen
2. Die API aktivieren
3. API-Schlüssel anfordern

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 Distance Matrix API gelten.

Richtlinien

Die Nutzung der Google Maps Distance Matrix API muss im Einklang mit den API-Richtlinien stehen.

Weitere Infos

Die Distance Matrix API bietet Ihnen noch zahlreiche weitere Möglichkeiten. So können Sie beispielsweise Entfernungsdaten für unterschiedliche Verkehrsmittel anfordern, Entfernungsdaten in verschiedenen Einheiten (z. B. Kilometer oder Meilen) anfordern und die Reisezeit je nach Verkehrsbedingungen schätzen. Weitere Beispiele und Informationen finden Sie im Entwickler-Leitfaden zur Distance Matrix API.