Dieses Dokument führt Sie durch die verschiedenen Anfrage- und Antwortparameter der Distance Matrix API und erklärt, wie Sie Daten analog zum Google Distance Matrix-Dienst aus der Distance Matrix API mit der gleichen Genauigkeit extrahieren können, jedoch zu einem günstigeren und faireren Preis.
Distance Matrix anfrage
Google:
GET
https://maps.googleapis.com/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>
https://api.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>
Distance Matrix beispielanfrage
Google:
GET
https://maps.googleapis.com/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=Westminster Abbey, Westminster, London SW1P 3PA, UK&key=<your_access_token>
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=Westminster Abbey, Westminster, London SW1P 3PA, UK&key=<your_access_token>
Erforderliche & Antwortparameter
Die Parameter in einer Anfrage (Teil der URL) sind in beiden Fällen identisch:
- Liste der Ausgangsorte (<longitude, latitude> Koordinaten oder Adresse der Quellposition), getrennt durch einen senkrechten Strich („|“).
- Liste der Zielorte (<longitude, latitude> Koordinaten oder Adresse der Quellposition), getrennt durch einen senkrechten Strich („|“).
- Schlüssel (Ihr Zugriffstoken, das für den Zugriff auf die Ressource autorisiert ist).
Antwort im JSON-Format (ist in beiden Fällen identisch):
- Die Werteinheit von Dauern ist Sekunde.
- Die Werteinheit von Entfernungen ist Meter.
- Für das Routing von Autos gedacht, um die Dauer unter Berücksichtigung des Live-Verkehrs zu ermitteln.
- Die Koordinatenpaare, auf denen die Route berechnet werden soll. Es sind mindestens zwei Paare erforderlich.
Beispielantwort mit einer Entfernungsmatrix
{
"destination_addresses": [
"Westminster Abbey, 20 Deans Yd, London SW1P 3PA, United Kingdom"
],
"origin_addresses": [
"Chapel, London SW6 1BA, UK"
],
"rows": [
{
"elements": [
{
"distance": {
"text": "7.8 km",
"value": 7847
},
"duration": {
"text": "24 mins",
"value": 1481
}
}
]
}
],
"status": "OK"
}
{
"destination_addresses": [
"Westminster Abbey, 20 Deans Yd, London SW1P 3PA, United Kingdom"
],
"origin_addresses": [
"Chapel, London SW6 1BA, UK"
],
"rows": [
{
"elements": [
{
"distance": {
"text": "7.8 km",
"value": 7847
},
"duration": {
"text": "24 mins",
"value": 1481
},
"origin": "51.4822656,-0.1933769",
"destination": "Westminster Abbey, Westminster, London SW1P 3PA, UK",
"status": "OK"
}
]
}
],
"status": "OK"
}