Bevor du anfängst
Es ist ein HTTP-API-Dienst, der alle möglichen Kombinationen zwischen dem Startpunkt und dem Ziel berechnet und es Ihnen ermöglicht, diese Daten in Sekunden und Metern abzurufen. Die Distance Matrix API Fast ist überall auf der Welt verfügbar und gewährleistet ein ähnliches Maß an Genauigkeit und Reaktion wie die besten Analoga wie die Google-Distanzmatrix-API. Das beste Ergebnis, das Sie für die englische Sprache erzielen können.
In dieser Distance Matrix API Fast-Dokumentation finden Sie eine Einführung in die Verwendung des Produkts sowie Referenzmaterial zu den verfügbaren Parametern.
Was können Sie mit der Distance Matrix API Fast machen?
Dieses Produkt bietet Entwicklern die Möglichkeit, die Reisezeit und Entfernung zwischen einigen Punkten zu berechnen. Es ist also wertvoller für Unternehmen, die Reaktionszeiten Vorrang vor hochgenauen Daten einräumen und in schnelllebigen, zeitkritischen Branchen tätig sind, in denen schnelle Entscheidungen und Routenoptimierung entscheidend sind. Es kann also für verschiedene Arten von Liefer- und Kurierdiensten verwendet werden, z. B. für die Lieferung von Lebensmitteln, Waren und Medikamenten, Mitfahrdienste, Logistik usw.
Unternehmen, die Techniker oder Servicepersonal zu den Kundenstandorten schicken, wie z. B. Reparaturunternehmen für Klimaanlagen oder Kabeldienstleister, profitieren von schnellen Reaktionszeiten, um Termine effizient zu vereinbaren und Kunden über die Ankunftszeit zu informieren.
Zu den Unternehmen, die mit der Distance Matrix API schnelle Reaktionszeiten statt punktgenauer Reaktionszeiten benötigen, gehören auch Rettungsdienste, On-Demand-Dienste, Einzelhandel, Reisen, Flottenmanagement und Smart-City-Initiativen. Der schnelle Zugriff auf Entfernungsdaten ist entscheidend für die Optimierung von Routen, die Minimierung von Verzögerungen und die Verbesserung des Kundenerlebnisses in diesen zeitkritischen Branchen.
Warum sollten Sie Distance Matrix API Fast verwenden?
Sie können unser Produkt verwenden, um den Zielpunkt zu finden, der dem Ausgangspunkt am nächsten liegt, oder für einen anderen Zweck. Die API gibt eine Dauer und Entfernung auf der schnellsten oder kürzesten Route jedes Elements zurück. Jedes Element ist wiederum ein Quell-Ziel-Paar.
Diese Lösung funktioniert weltweit und ist nur für einen Fahrmodus verfügbar.
Wenn der Verkehr in Echtzeit Ihr Unternehmen nicht wesentlich beeinträchtigt, können Sie Zeit sparen und die Leistung des Produkts steigern, indem Sie Distance Matrix API Fast verwenden. Für große Berechnungsvolumina können Sie unsere Asynchronous Distance Matrix API in Betracht ziehen.
Wenn Datengenauigkeit und Echtzeit-Traffic für Ihr Unternehmen wertvoller sind, sollten Sie sich unsere Lösung ansehen -
Genaue Entfernungsmatrix-API.
Wie sollten Sie Distance Matrix API Fast verwenden?
Sie geben Eingabedaten (Adressen oder Koordinaten) an, für die Sie eine Schätzung vornehmen möchten. Sie erhalten eine Antwort im JSON-Format, und die Antwort enthält Informationen über die durchschnittliche Dauer jedes erstellten Routenabschnitts. Die berechnete Reisezeit für einen Routenabschnitt berücksichtigt nicht die aktuellen Verkehrsbedingungen.
Beispielsweise gibt es drei Startpositionen A, B und C sowie drei Zielorte E, B und D. Die Distance API Fast gibt die Matrix der Dauern in Sekunden/Minuten und Entfernungen in Metern/Kilometern zwischen den Standorten zurück. Es werden keine Routengeometrien zurückgegeben.
↓ Ursprünge\ Ziele ➔
E
B
D
A
A to E
A to B
A to D
B
B to E
B to B = 0
B to D
C
C to E
C to B
C to D
Die Zeit und die Entfernung zwischen den Punkten sind möglicherweise nicht symmetrisch, da die Routen aufgrund von Einbahnstraßen oder Abbiegebeschränkungen je nach Richtung unterschiedlich sein können. Beispielsweise kann A nach B eine andere Dauer haben als B nach A.
In den folgenden Abschnitten finden Sie detailliertere Informationen, die auf Distance Matrix-API-Beispielen basieren.
Parameter anfordern
Die Distance Matrix API Fast-Anfrage wurde speziell so erstellt, dass sie dem Google Distance Matrix API-Anforderungsformat ähnelt. Weitere Informationen erhalten Sie auf
Migrieren Sie zur DistanceMatrix.ai API Seite.
Eine Distance Matrix API Fast-Anfrage hat die folgende Form:
GET:
https://api-v2.distancematrix.ai/maps/api/distancematrix/json?origins=<origin_location_1|origin_location_2|...|origin_location_n>&destinations=<destination_location_1|destination_location_2|...|destination_location_n>&key=<your_access_token>
Beispiel für eine Distance Matrix API-Anforderung:
GET:
https://api-v2.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&key=<your_access_token>
Erforderliche Parameter
Ursprünge — ein Ausgangspunkt für die Berechnung von Reisedistanz und -zeit. Sie können einen oder mehrere durch das Pipe-Zeichen (|) getrennte Orte in Form einer Adresse oder Breitengrad/Längengrad-Koordinaten angeben:
1. Wenn Sie eine Adresse übergeben, geokodiert der Dienst die Zeichenfolge und konvertiert sie in eine Breiten- und Längenkoordinate, um die Entfernung zu berechnen. Diese Koordinate kann sich von der von der Geocoding-API zurückgegebenen Koordinate unterscheiden, z. B. ein Gebäudeeingang und nicht dessen Mittelpunkt.
Beispiel einblenden
Beispiel ausblenden
Beispielanfrage mit Adressen:
GET:
https://api-v2.distancematrix.ai/maps/api/distancematrix/json?origins=Westminster Abbey, 20 Deans Yd, Westminster, London SW1P 3PA, United Kingdom&destinations=St John's Church, North End Rd, Fulham, London SW6 1PB, United Kingdom&key=<your_access_token>
Antwort
BODY
{
"destination_addresses": [
"St John's Church, North End Rd, London SW6 1PB, United Kingdom"
],
"origin_addresses": [
"Westminster Abbey, 20 Deans Yd, London SW1P 3PA, United Kingdom"
],
"rows": [
{
"elements": [
{
"distance": {
"text": "7.3 km",
"value": 7346
},
"duration": {
"text": "23 mins",
"value": 1401
},
"origin": "Westminster Abbey, 20 Deans Yd, Westminster, London SW1P 3PA, United Kingdom",
"destination": "St John's Church, North End Rd, Fulham, London SW6 1PB, United Kingdom",
"status": "OK"
}
]
}
],
"status": "OK"
}
2. Wenn Sie Breiten- und Längenkoordinaten angeben, werden diese unverändert zur Berechnung der Entfernung verwendet. Stellen Sie sicher, dass zwischen den Breitengrad- und Längengradwerten kein Leerzeichen vorhanden ist.
Beispiel einblenden
Beispiel ausblenden
Beispielanfrage mit Koordinaten:
GET:
https://api-v2.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&key=<your_access_token>
Antwort
BODY
{
"destination_addresses": [
"Westminster Abbey, London SW1P 3PA, UK"
],
"origin_addresses": [
"Chapel, London SW6 1BA, UK"
],
"rows": [
{
"elements": [
{
"distance": {
"text": "7.6 km",
"value": 7567
},
"duration": {
"text": "22 mins",
"value": 1359
},
"origin": "51.4822656,-0.1933769",
"destination": "51.4994794,-0.1269979",
"status": "OK"
}
]
}
],
"status": "OK"
}
Ziele — ein oder mehrere Orte, die als endgültiges Ziel für die Berechnung von Reisedistanz und -zeit verwendet werden sollen. Die Optionen für den Zielparameter sind dieselben wie für den Originalparameter, wie oben beschrieben.
key — der API-Schlüssel Ihrer Anwendung.
Optionale Parameter
Falls Sie an der Verwendung optionaler Parameter wie Fahr-, Geh- und Fahrradmodi, Verkehrsdaten in Echtzeit, zur Vermeidung von Autobahnen, Fähren und Innenräumen interessiert sind, wählen Sie bitte ein anderes Produkt, Distance Matrix API Accurate. Für weitere Informationen schauen Sie bitte nach
seine Dokumentation.
Beispiel für eine Antwort
Die Antwort enthält ein Array von Zeilenobjekten, wobei jede Zeile einen Ursprung und jedes Ziel enthält. Jedes Element des Objekts im Array enthält die Eigenschaften einer einzelnen Routenvariante. Eine ausführliche Beschreibung der Elemente finden Sie im Abschnitt
Reaktionselemente der Entfernungsmatrix.
Antwort
BODY
{
"destination_addresses": [
"Westminster Abbey, London SW1P 3PA, UK"
],
"origin_addresses": [
"Chapel, London SW6 1BA, UK"
],
"rows": [
{
"elements": [
{
"distance": {
"text": "7.6 km",
"value": 7567
},
"duration": {
"text": "22 mins",
"value": 1359
},
"origin": "51.4822656,-0.1933769",
"destination": "51.4994794,-0.1269979",
"status": "OK"
}
]
}
],
"status": "OK"
}
Reaktionselemente der Entfernungsmatrix
Die Antworten der Entfernungsmatrix enthalten die folgenden Stammelemente:
status enthält Metadaten zur Anfrage. Siehe
Statuscodes unten.
origin_addresses enthält ein Array von Adressen, wie sie von der API aus Ihrer ursprünglichen Anfrage zurückgegeben wurden. Diese werden vom Geocoder formatiert und entsprechend dem mit der Anfrage übergebenen Sprachparameter lokalisiert.
destination_addresses enthält ein Array von Adressen, die von der API aus Ihrer ersten Anfrage zurückgegeben wurden. Wie bei origin_addresses sind diese gegebenenfalls lokalisiert.
Zeilen enthalten ein Array von Elementen, die wiederum Status-, Dauer- und Entfernungselemente enthalten.
Statuscodes
Die Statusfelder innerhalb des Antwortobjekts enthalten den Status der Anfrage und können nützliche Debugging-Informationen enthalten. Die Distance Matrix API gibt ein Statusfeld der obersten Ebene mit Informationen zur Anfrage im Allgemeinen sowie ein Statusfeld für jedes Elementfeld mit Informationen zu dieser bestimmten Quell-Ziel-Paarung zurück.
Statuscodes der obersten Ebene
OK bedeutet, dass die Antwort ein gültiges Ergebnis enthält.
INVALID_REQUEST gibt an, dass die angegebene Anfrage ungültig war.
MAX_ELEMENTS_EXCEEDED gibt an, dass das Produkt aus Ursprung und Ziel das Limit pro Abfrage überschreitet.
OVER_DAILY_LIMIT gibt einen der folgenden Werte an:
Der API-Schlüssel fehlt oder ist ungültig.
Die Abrechnung wurde für Ihr Konto nicht aktiviert.
Eine selbst auferlegte Nutzungsobergrenze wurde überschritten.
Die angegebene Zahlungsmethode ist nicht mehr gültig (z. B. ist eine Kreditkarte abgelaufen).
OVER_QUERY_LIMIT gibt an, dass der Dienst innerhalb des zulässigen Zeitraums zu viele Anfragen von Ihrer Anwendung erhalten hat.
REQUEST_DENIED gibt an, dass der Dienst die Verwendung des Distance Matrix-Dienstes durch Ihre Anwendung verweigert hat.
UNKNOWN_ERROR gibt an, dass eine Entfernungsmatrix-Anfrage aufgrund eines Serverfehlers nicht verarbeitet werden konnte. Die Anfrage kann erfolgreich sein, wenn Sie es erneut versuchen.
Statuscodes auf Elementebene
OK gibt die Antwort an und enthält ein gültiges Ergebnis.
NOT_FOUND gibt an, dass der Ursprung und/oder das Ziel dieser Paarung nicht geokodiert werden konnten.
ZERO_RESULTS gibt an, dass keine Route zwischen dem Start- und dem Zielort gefunden werden konnte.
MAX_ROUTE_LENGTH_EXCEEDED gibt an, dass die angeforderte Route zu lang ist und nicht verarbeitet werden kann.
Fehlermeldungen
Wenn der Statuscode der obersten Ebene ein anderer Wert als OK ist, gibt es möglicherweise ein zusätzliches error_message-Feld im Distance Matrix-Antwortobjekt. Dieses Feld enthält detailliertere Informationen zu den Gründen für den angegebenen Statuscode.
Reihen
Wenn die Distance Matrix API Ergebnisse zurückgibt, platziert sie sie in einem JSON-Zeilenarray. Auch wenn keine Ergebnisse zurückgegeben werden (z. B. wenn die Startpunkte und/oder Ziele nicht existieren), wird dennoch ein leeres Array zurückgegeben.
Die Zeilen werden entsprechend den Werten im Origin-Parameter der Anfrage sortiert. Jede Zeile entspricht einem Ursprung, und jedes Element innerhalb dieser Zeile entspricht einer Paarung des Ursprungs mit einem Zielwert.
Jedes Zeilenarray enthält einen oder mehrere Elementeinträge, die wiederum die Informationen über eine einzelne Quell-Ziel-Paarung enthalten.
Elemente
Die Informationen zu jeder Quell-Ziel-Paarung werden in einem Elementeintrag zurückgegeben. Ein Element enthält die folgenden Felder:
Status: Siehe
Statuscodes für eine Liste möglicher Statuscodes.
Dauer: Die Dauer, die benötigt wird, um diese Route zurückzulegen, ausgedrückt in Sekunden (das Wertfeld) und als Text.
Entfernung: Die Gesamtstrecke dieser Route, ausgedrückt in Metern (Wert) und als Text. Der Textwert verwendet das Einheitensystem, das mit dem Einheitenparameter der ursprünglichen Anfrage angegeben wurde, oder die Region des Ursprungs.