Entfernungsmatrix-API | Reisezeit und Entfernung

Richtlinien für Entwickler
Bevor du anfängst
Es handelt sich um einen HTTP-API-Dienst, der alle möglichen Kombinationen zwischen Startpunkt und Ziel berechnet und es Ihnen ermöglicht, Verkehrsstaus und ein bestimmtes Transportmittel zu berücksichtigen. Diese Reisezeit-API ist überall auf der Welt verfügbar und gewährleistet ein ähnliches Maß an Genauigkeit und Reaktionsfähigkeit wie die besten Analoga wie die Google Distance Matrix API.

In dieser Distance Matrix API-Dokumentation finden Sie eine Einführung in die Produktverwendung sowie Referenzmaterial zu den verfügbaren Parametern.

Was können Sie mit der Distance Matrix API machen?

Dieses Produkt bietet Entwicklern die Möglichkeit, die Reisezeit und Entfernung zwischen einigen Punkten zu berechnen. Verschiedene Arten von Liefer- und Kurierdiensten, wie z. B. die Lieferung von Lebensmitteln, Waren und Medikamenten, haben also erhebliche Vorteile, wenn sie eingesetzt werden. Außerdem können Sie unsere API in den Bereichen Routenplanung, Logistik und Transport sowie in den Bereichen Softwareentwicklung, Immobilien sowie Heim- und Geschäftsdienstleistungen verwenden.

Insbesondere für Taxianwendungen ist das Produkt von entscheidender Bedeutung. Es ermöglicht die Berechnung der Autolieferzeit unter Berücksichtigung von Staus und Staus.

Um die kürzeste Route des Lebensmittellieferdienstes von Cafés und Restaurants aus zu wählen, berechnet unsere Reisezeit-API die Lieferzeit von jedem Restaurant zur Adresse des Kunden unter Berücksichtigung der Verkehrsstaus.

Warum Distance Matrix API 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 für die Verkehrsmittel Fahren, Gehen, Radfahren und Transitreisen 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 die Version ohne Verkehrsüberwachung verwenden. Für ein großes Berechnungsvolumen können Sie unsere Asynchronous Distance Matrix API in Betracht ziehen.

So verwenden Sie die Distance Matrix API

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 Dauer jedes erstellten Routenabschnitts. Die berechnete Reisezeit für einen Routenabschnitt berücksichtigt immer die aktuelle Verkehrslage und die Verkehrsprognose.

Beispielsweise gibt es drei Startpositionen A, B und C sowie drei Zielorte E, B und D. Die Entfernungs-API gibt die Matrix der Dauer in Sekunden und Entfernungen in Metern zwischen den Standorten zurück. Es werden keine Routengeometrien zurückgegeben.
origins \ destinations
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 erhalten Sie detailliertere Informationen, die auf Distance Matrix-API-Beispielen basieren.

Parameter anfordern

Die Distance Matrix API-Anforderung 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-Anfrage hat die folgende Form:
GET:
Kopiert!
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>
Beispiel für eine Distance Matrix API-Anforderung:
GET:
Kopiert!
https://api.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:
Kopiert!
https://api.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
Kopiert!
{
   "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"
}
Zeige weniger
Zeig mehr
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:
Kopiert!
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&key=<your_access_token>
Antwort
BODY
Kopiert!
{
   "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"
}
Zeige weniger
Zeig mehr
  • 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

  • Modus (standardmäßig Fahren) — gibt das Transportmittel an, das bei der Berechnung der Entfernung verwendet werden soll. Gültige Werte und andere Anforderungsdetails sind in der Reisemodi Abschnitt dieses Dokuments.
  • Sprache — eine Sprache, die verwendet wird, um Ergebnisse zurückzugeben.
    • Sehen Sie sich die Liste der unterstützten Sprachen an.
    • Wenn keine Sprache angegeben wird, versucht die API, die bevorzugte Sprache zu verwenden, wie im Accept-Language-Header angegeben, oder die Muttersprache der Domain, von der die Anfrage gesendet wird.
    • Die API gibt ihr Bestes, um eine Straßenadresse bereitzustellen, die sowohl für den Benutzer als auch für die Einheimischen lesbar ist. Um dieses Ziel zu erreichen, gibt sie Straßenadressen in der Landessprache zurück, die bei Bedarf in eine vom Benutzer lesbare Schrift transliteriert werden, wobei die bevorzugte Sprache eingehalten wird. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Adresskomponenten werden alle in derselben Sprache zurückgegeben, die aus der ersten Komponente ausgewählt wurde.
    • Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, verwendet die API den am ehesten passenden Namen.
    • Die bevorzugte Sprache hat einen geringen Einfluss auf die Ergebnismenge, die die API zurückgibt, und auf die Reihenfolge, in der sie zurückgegeben werden. Der Geocoder interpretiert Abkürzungen je nach Sprache unterschiedlich, z. B. die Abkürzungen für Straßentypen oder Synonyme, die in einer Sprache gültig sein können, in einer anderen jedoch nicht. Zum Beispiel sind utca und tér Synonyme für Straße auf Ungarisch.
Sprachen einblenden
Sprachen ausblenden
Sprachcode
Sprache
Sprachcode
Sprache
Af
Afrikaans
ja
japanisch
q
albanisch
kn
Kannada
bin
Amharisch
kk
kasachisch
bin
arabisch
km
Khmer
Hy
Armenisch
Ko
koreanisch
az
aserbaidschanisch
Ky
Kirgisisch
eu
baskisch
lo
laotisch
Sein
Belarussisch
lv
lettisch
bn
Bengalisch
lt
litauisch
bs
Bosnisch
mk
mazedonisch
bg
Bulgarisch
Frau
malaiisch
meine
birmanisch
Mililiter
Malayalam
ca.
katalanisch
Herr
Marathi
zh
chinesisch
mn
mongolisch
zh-CN
Chinesisch (vereinfacht)
ne
Nepali
zh-HK
Chinesisch (Hongkong)
no
Norwegian
zh-TW
Chinese (Traditional)
pl
Polish
hr
Croatian
pt
Portuguese
cs
Czech
pt-BR
Portuguese (Brazil)
da
Danish
pt-PT
Portuguese (Portugal)
nl
Dutch
pa
Punjabi
en
English
ro
Romanian
en-AU
English (Australian)
ru
Russian
en-GB
English (Great Britain)
sr
Serbian
et
Estonian
si
Sinhalese
fa
Farsi
sk
Slovak
fi
Finnish
sl
Slovenian
fil
Filipino
es
Spanish
fr
French
es-419
Spanish (Latin America)
fr-CA
French (Canada)
sw
Swahili
gl
Galician
sv
Swedish
ka
Georgian
ta
Tamil
de
German
te
Telugu
el
Greek
th
Thai
gu
Gujarati
tr
Turkish
iw
Hebrew
uk
Ukrainian
hi
Hindi
ur
Urdu
hu
Hungarian
uz
Uzbek
is
Icelandic
vi
Vietnamese
id
Indonesian
zu
Zulu
it
Italian


  • vermeiden — führt Einschränkungen für die Route ein. Gültige Werte sind angegeben im Einschränkungen Abschnitt dieses Dokuments. Es kann nur eine Einschränkung angegeben werden.
  • Einheiten — gibt das Einheitensystem an, das beim Ausdrücken von Entfernungen als Text verwendet werden soll. Sehen Sie sich die Einheitensysteme Abschnitt dieses Dokuments für weitere Informationen.
  • arrival_time — gibt die gewünschte Ankunftszeit für Transitanfragen in Sekunden seit Mitternacht, 1. Januar 1970, UTC an. Sie können entweder departure_time oder arrival_time angeben, aber nicht beide. Beachten Sie, dass arrival_time als Ganzzahl angegeben werden muss.
Beispiel einblenden
Beispiel ausblenden
Beispiel für eine Anfrage mit arrival_time:
GET:
Kopiert!
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.507033,-0.1277161&destinations=52.486243,-1.890401&arrival_time=now&transit_mode=bus&mode=transit&key=<your_access_token>
Antwort
BODY
Kopiert!
{
   "destination_addresses": [
       "Raw Network, Sherborne B16 8FN, United Kingdom"
   ],
   "origin_addresses": [
       "Giaralis Karavasilis Tsavdaridis, 49 The Mall, London N14 6LR, United Kingdom"
   ],
   "rows": [
       {
           "elements": [
               {
                   "distance": {
                       "text": "166.4 km",
                       "value": 166409
                   },
                   "duration": {
                       "text": "4 hour 2 mins",
                       "value": 14524
                   },
                   "origin": "51.507033,-0.1277161",
                   "destination": "52.486243,-1.890401",
                   "status": "OK"
               }
           ]
       }
   ],
   "status": "OK"
}
Zeige weniger
Zeig mehr
  • departure_time — eine gewünschte Abfahrtszeit. Sie können die Uhrzeit als Ganzzahl in Sekunden seit Mitternacht, 1. Januar 1970, UTC angeben. Alternativ können Sie den Wert now angeben, wodurch die Abfahrtszeit auf die aktuelle Uhrzeit (auf die nächste Sekunde genau) gesetzt wird. Die Abflugzeit muss auf die aktuelle Uhrzeit oder einen Zeitpunkt in der Zukunft gesetzt werden. Es kann nicht in der Vergangenheit sein. Die Ergebnisse für eine bestimmte Anfrage können im Laufe der Zeit aufgrund der Änderungen im Straßennetz, der aktualisierten durchschnittlichen Verkehrsbedingungen und der verteilten Art des Dienstes variieren. Die Ergebnisse können auch zwischen nahezu gleichwertigen Strecken zu jeder Zeit oder Häufigkeit variieren. Die Abfahrtszeit kann in zwei Fällen angegeben werden:
    • Für Anfragen, bei denen der Reisemodus Transit ist: Sie können optional zwischen departure_time oder arrival_time angeben. Wenn keine der beiden Zeiten angegeben ist, ist die Abflugzeit standardmäßig auf jetzt gesetzt (das heißt, die Abfahrtszeit entspricht standardmäßig der aktuellen Uhrzeit).
    • Für Anfragen, bei denen der Reisemodus fährt: Sie können die Abfahrtszeit angeben, um eine Route und die Reisedauer (Antwortfeld: duration_in_traffic) zu erhalten, die die Verkehrsbedingungen berücksichtigen. Die Abflugzeit muss auf die aktuelle Uhrzeit oder einen Zeitpunkt in der Zukunft gesetzt werden. Es kann nicht in der Vergangenheit sein.
* Hinweis: Wenn die Abfahrtszeit nicht angegeben ist, basieren die Wahl der Route und Dauer auf dem Straßennetz und den durchschnittlichen zeitunabhängigen Verkehrsbedingungen. Die Ergebnisse für eine bestimmte Anfrage können im Laufe der Zeit aufgrund von Änderungen im Straßennetz, aktualisierten durchschnittlichen Verkehrsbedingungen und dem verteilten Charakter des Dienstes variieren. Die Ergebnisse können auch zwischen nahezu gleichwertigen Strecken zu jeder Zeit oder Häufigkeit variieren.
Beispiel einblenden
Beispiel ausblenden
Beispielanfrage mit departure_time:
GET:
Kopiert!
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.507033,-0.1277161&destinations=52.486243,-1.890401&departure_time=now&key=<your_access_token>
Antwort
BODY
Kopiert!
{
   "destination_addresses": [
       "Raw Network, Sherborne B16 8FN, United Kingdom"
   ],
   "origin_addresses": [
       "Giaralis Karavasilis Tsavdaridis, 49 The Mall, London N14 6LR, United Kingdom"
   ],
   "rows": [
       {
           "elements": [
               {
                   "distance": {
                       "text": "207.3 km",
                       "value": 207323
                   },
                   "duration": {
                       "text": "2 hour 27 mins",
                       "value": 8844
                   },
                   "duration_in_traffic": {
                       "text": "2 hour 29 mins",
                       "value": 8968
                   },
                   "origin": "51.507033,-0.1277161",
                   "destination": "52.486243,-1.890401",
                   "status": "OK"
               }
           ]
       }
   ],
   "status": "OK"
}
Zeig mehr
  • traffic_model (standardmäßig best_guess) — gibt die Annahmen an, die bei der Berechnung der Zeit im Verkehr verwendet werden sollen. Diese Einstellung wirkt sich auf den Wert aus, der in der Antwort im Feld duration_in_traffic zurückgegeben wird. Dieses Feld enthält die auf historischen Durchschnittswerten basierende prognostizierte Verkehrszeit. Der Parameter traffic_model darf nur für Anfragen angegeben werden, bei denen der Reisemodus Fahren lautet und bei denen die Anforderung eine departure_time enthält. Die verfügbaren Werte für diesen Parameter sind:
    • best_guess (Standard) gibt an, dass die zurückgegebene duration_in_traffic die beste Schätzung der Reisezeit sein sollte, wenn man bedenkt, was sowohl über historische Verkehrsbedingungen als auch über Live-Verkehr bekannt ist. Der aktuelle Verkehr wird umso wichtiger, je näher die Abfahrtszeit an der aktuellen Uhrzeit liegt.
    • pessimistisch bedeutet, dass die zurückgegebene duration_in_traffic an den meisten Tagen länger als die tatsächliche Reisezeit sein sollte, obwohl gelegentlich Tage mit besonders schlechten Verkehrsbedingungen diesen Wert überschreiten können. Wirkt sich auf das Feld in der distance_in_traffic_model-Antwort aus und gibt die kürzeste Route zurück.
    • optimistisch bedeutet, dass die zurückgegebene duration_in_traffic an den meisten Tagen kürzer als die tatsächliche Reisezeit sein sollte, obwohl gelegentlich Tage mit besonders guten Verkehrsbedingungen schneller als dieser Wert sein können. Wirkt sich auf das Feld in der distance_in_traffic_model-Antwort aus und gibt die kürzeste Route zurück.
Beispiel einblenden
Beispiel ausblenden
Beispielanfrage mit traffic_model:
GET:
Kopiert!
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.507033,-0.1277161&destinations=52.486243,-1.890401&traffic_model=pessimistic&departure_time=now&key=<your_access_token>
Antwort
BODY
Kopiert!
{
   "destination_addresses": [
       "Raw Network, Sherborne B16 8FN, United Kingdom"
   ],
   "origin_addresses": [
       "Giaralis Karavasilis Tsavdaridis, 49 The Mall, London N14 6LR, United Kingdom"
   ],
   "rows": [
       {
           "elements": [
               {
                   "distance": {
                       "text": "207.3 km",
                       "value": 207323
                   },
                   "duration": {
                       "text": "2 hour 27 mins",
                       "value": 8844
                   },
                   "duration_in_traffic": {
                       "text": "4 hour 0 mins",
                       "value": 14400
                   },
                   "distance_in_traffic_model": {
                       "text": "118 miles",
                       "value": 189274
                   },
                   "origin": "51.507033,-0.1277161",
                   "destination": "52.486243,-1.890401",
                   "status": "OK"
               }
           ]
       }
   ],
   "status": "OK"
}
Zeig mehr
  • transit_mode — gibt einen oder mehrere bevorzugte Transitmodi an. Dieser Parameter darf nur für Anfragen angegeben werden, bei denen der Transitmodus ist. Der Parameter unterstützt die folgenden Argumente:
    • Bus gibt an, dass die berechnete Route die Fahrt mit dem Bus bevorzugen sollte.
    • U-Bahn gibt an, dass die berechnete Route eine Fahrt mit der U-Bahn bevorzugen sollte.
    • Zug gibt an, dass die berechnete Route eine Reise mit dem Zug bevorzugen sollte.
    • tram gibt an, dass die berechnete Route eine Fahrt mit Straßenbahn und Stadtbahn bevorzugen sollte.
    • Bahn gibt an, dass die berechnete Route Reisen mit Zug, Straßenbahn, Stadtbahn und U-Bahn bevorzugen sollte. Dies entspricht transit_mode=train|tram|subway.
Beispiel einblenden
Beispiel ausblenden
Beispiel mit transit_mode anfordern:
GET:
Kopiert!
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.507033,-0.1277161&destinations=52.486243,-1.890401&transit_mode=bus|train|tram|subway&mode=transit&departure_time=now&key=<your_access_token>
Antwort
BODY
Kopiert!
{
   "destination_addresses": [
       "Raw Network, Sherborne B16 8FN, United Kingdom"
   ],
   "origin_addresses": [
       "Giaralis Karavasilis Tsavdaridis, 49 The Mall, London N14 6LR, United Kingdom"
   ],
   "rows": [
       {
           "elements": [
               {
                   "distance": {
                       "text": "207.3 km",
                       "value": 207323
                   },
                   "duration": {
                       "text": "2 hour 27 mins",
                       "value": 8844
                   },
                   "duration_in_traffic": {
                       "text": "2 hour 29 mins",
                       "value": 8968
                   },
                   "origin": "51.507033,-0.1277161",
                   "destination": "52.486243,-1.890401",
                   "status": "OK"
               }
           ]
       }
   ],
   "status": "OK"
}
Zeige weniger
Zeig mehr

Reisemodi

Für die Berechnung von Entfernungen können Sie das zu verwendende Transportmittel angeben. Standardmäßig werden Entfernungen für den Fahrmodus berechnet. Die folgenden Reisemodi werden unterstützt:
  • Fahren (Standard) gibt die Entfernungsberechnung mithilfe des Straßennetzes an.
  • Gehen fordert die Berechnung der Entfernung für das Gehen über Fußgängerwege und Bürgersteige an (sofern verfügbar).
  • Radfahren fordert die Berechnung der Entfernung für das Radfahren über Fahrradwege und bevorzugte Straßen an (sofern verfügbar).
  • Transit fordert die Berechnung der Entfernung über öffentliche Verkehrswege an (sofern verfügbar). Wenn Sie den Modus auf Transit einstellen, müssen Sie entweder eine Abflugzeit oder eine Ankunftszeit angeben. Wenn keine der beiden Zeiten angegeben ist, ist die Abflugzeit standardmäßig auf jetzt gesetzt (das heißt, die Abfahrtszeit entspricht standardmäßig der aktuellen Uhrzeit). Sie müssen auch einen transit_mode angeben.
Beispiel einblenden
Beispiel ausblenden
Beispielanfrage mit Reisemodi:
GET:
Kopiert!
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&mode=walking&departure_time=now&key=<your_access_token>
Antwort
BODY
Kopiert!
{
   "destination_addresses": [
       "Westminster Abbey, London SW1P 3PA, UK"
   ],
   "origin_addresses": [
       "Chapel, London SW6 1BA, UK"
   ],
   "rows": [
       {
           "elements": [
               {
                   "distance": {
                       "text": "5.7 km",
                       "value": 5699
                   },
                   "duration": {
                       "text": "1 hour 12 mins",
                       "value": 4379
                   },
                   "origin": "51.4822656,-0.1933769",
                   "destination": "51.4994794,-0.1269979",
                   "status": "OK"
               }
           ]
       }
   ],
   "status": "OK"
}
Zeige weniger
Zeig mehr

Informationen zum Verkehr

Verkehrsinformationen werden verwendet, wenn alles Folgendes gilt (dies sind die Bedingungen, die erforderlich sind, um das Feld duration_in_traffic in der Antwort der Entfernungsmatrix zu erhalten):
  • Der Reisemodusparameter ist Fahren oder er ist nicht angegeben (Fahren ist der Standardreisemodus).
  • Die Anfrage enthält einen gültigen departure_time-Parameter. Die Abflugzeit kann auf die aktuelle Uhrzeit oder eine andere Uhrzeit gesetzt werden.
Optional können Sie den Parameter traffic_model in Ihre Anfrage aufnehmen, um die Annahmen anzugeben, die bei der Berechnung der Zeit im Verkehr verwendet werden sollen.
Beispiel einblenden
Beispiel ausblenden
Beispielanfrage mit Verkehrsinformationen:
GET:
Kopiert!
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&mode=driving&departure_time=now&key=<your_access_token>
Antwort
BODY
Kopiert!
{
   "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
                   },
                   "duration_in_traffic": {
                       "text": "23 mins",
                       "value": 1395
                   },
                   "origin": "51.4822656,-0.1933769",
                   "destination": "51.4994794,-0.1269979",
                   "status": "OK"
               }
           ]
       }
   ],
   "status": "OK"
}
Zeig mehr

Einschränkungen

Es können Entfernungen berechnet werden, die bestimmten Einschränkungen entsprechen. Einschränkungen werden durch die Verwendung des Vermeidungsparameters und eines Arguments für diesen Parameter angegeben, das die zu vermeidende Einschränkung angibt. Die folgenden Einschränkungen werden unterstützt:
  • avoid=tolls
  • avoid=highways
  • avoid=ferries
  • avoid=indoor
* Hinweis: Das Hinzufügen von Einschränkungen schließt Strecken, die die eingeschränkte Funktion enthalten, nicht aus; es verzerrt das Ergebnis lediglich auf günstigere Strecken.
Beispiel einblenden
Beispiel ausblenden
Beispielanfrage mit Einschränkungen:
GET:
Kopiert!
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&mode=driving&departure_time=now&avoid=ferries&key=<your_access_token>
Antwort
BODY
Kopiert!
{
   "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
                   },
                   "duration_in_traffic": {
                       "text": "26 mins",
                       "value": 1568
                   },
                   "origin": "51.4822656,-0.1933769",
                   "destination": "51.4994794,-0.1269979",
                   "status": "OK"
               }
           ]
       }
   ],
   "status": "OK"
}
Zeig mehr

Einheitensysteme

Die Ergebnisse der Entfernungsmatrix enthalten Text in Entfernungsfeldern, um die Entfernung der berechneten Route anzugeben. Das zu verwendende Einheitensystem kann angegeben werden:
  • units=metric (Standard) gibt Entfernungen in Kilometern und Metern zurück.
  • units=imperial gibt Entfernungen in Meilen und Fuß zurück.
Beispiel einblenden
Beispiel ausblenden
Beispielanfrage mit Einheitensystem:
GET:
Kopiert!
https://api.distancematrix.ai/maps/api/distancematrix/json?origins=51.4822656,-0.1933769&destinations=51.4994794,-0.1269979&departure_time=now&units=imperial&key=<your_access_token>
Antwort
BODY
Kopiert!
{
   "destination_addresses": [
       "Westminster Abbey, London SW1P 3PA, UK"
   ],
   "origin_addresses": [
       "Chapel, London SW6 1BA, UK"
   ],
   "rows": [
       {
           "elements": [
               {
                   "distance": {
                       "text": "4.7 mi",
                       "value": 7567
                   },
                   "duration": {
                       "text": "22 mins",
                       "value": 1359
                   },
                   "duration_in_traffic": {
                       "text": "26 mins",
                       "value": 1568
                   },
                   "origin": "51.4822656,-0.1933769",
                   "destination": "51.4994794,-0.1269979",
                   "status": "OK"
               }
           ]
       }
   ],
   "status": "OK"
}
Zeig mehr
* Hinweis: Diese Einstellung des Einheitensystems wirkt sich nur auf den Text aus, der in Entfernungsfeldern angezeigt wird. Die Entfernungsfelder enthalten auch Werte, die immer in Metern ausgedrückt werden.

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
Kopiert!
{
   "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"
}
Zeig mehr

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.
  • duration_in_traffic: Die Dauer, die benötigt wird, um diese Route zurückzulegen, basierend auf aktuellen und historischen Verkehrsbedingungen.
  • 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.
  • distance_in_traffic_model: Die kürzeste Entfernung, die benötigt wird, um diese Route zurückzulegen, basierend auf aktuellen und historischen Verkehrsbedingungen.
FAQ

Wie verwende ich die Entfernungs-API?

Die Verwendung einer Entfernungs-API wie DistanceMatrix.ai ist in der Regel ein unkomplizierter Vorgang. Hier sind die grundlegenden Schritte zur Verwendung der API:

  • Registrieren Sie sich auf der Plattform und erhalten Sie einen API-Schlüssel. Der API-Schlüssel ist eine eindeutige Kennung, mit der Sie auf die API zugreifen können.
  • Wählen Sie Ihr API-Produkt: Die DistanceMatrix.ai API bietet verschiedene Methoden für verschiedene Arten von Entfernungsberechnungen, z. B. Entfernung zwischen zwei Punkten, Entfernungsmatrix für mehrere Startpunkte und Ziele sowie Schätzungen der Reisezeit. Wählen Sie die beste Methode, um die API zu verwenden, die Ihren Anforderungen entspricht.
  • Stellen Sie Ihre Parameter ein: Je nachdem, für welches Produkt Sie sich entscheiden, müssen Sie Parameter wie Start- und Zielorte (in Form von Adressen oder Längenkoordinaten), den Transportmodus (Fahren, Gehen usw.) und andere Optionen wie das Vermeiden von Mautgebühren oder Autobahnen festlegen.
  • Anfrage senden: Sobald Sie Ihre Parameter festgelegt haben, können Sie mit Ihrem API-Schlüssel eine Anfrage an die API-Entfernungsmatrix senden. Die API verarbeitet Ihre Anfrage und gibt die Entfernungsergebnisse und Reisezeiten in dem in Ihrer Anfrage angegebenen Format zurück.
  • Zwischenspeichern und die Ergebnisse verwenden: Schließlich können Sie die von der API zurückgegebenen Ergebnisse analysieren und in Ihrer Anwendung oder Website verwenden. Die API kann Ergebnisse in JSON zurückgeben, die einfach in verschiedene Formate, einschließlich XML und CSV, konvertiert werden können.

Die spezifischen Schritte zur Verwendung der DistanceMatrix.ai API können je nach Programmiersprache oder Framework variieren. Wir stellen jedoch eine detaillierte Distance Matrix-API-Dokumentation und Beispielcode zur Verfügung, um Ihnen den Einstieg zu erleichtern.

Was ist der Unterschied zwischen einer API-Distanzmatrix und anderen APIs?

API-Entfernungsmatrix, Kartenentfernungs-API und Richtungsmatrix-API sind alles Arten von APIs, die entfernungsbezogene Daten bereitstellen, aber sie haben einige Besonderheiten.
Eine API-Entfernungsmatrix dient zur Berechnung der Entfernungen zwischen mehreren Startpunkten und Zielen. Sie bietet eine Entfernungsmatrix, die zur Berechnung der Reisezeit oder zur Optimierung von Liefer- oder Logistikrouten verwendet werden kann. Diese Art von API ist nützlich für Unternehmen, die Reiserouten oder Logistikabläufe planen und optimieren müssen.

Eine Kartenentfernungs-API stellt dagegen entfernungsbezogene Daten für ein bestimmtes geografisches Gebiet bereit, z. B. die Entfernung zwischen zwei Punkten auf einer Karte. Diese Art von API ist nützlich für Anwendungen, die entfernungsbezogene Daten auf einer Karte anzeigen müssen, z. B. ein Fitness-Tracker oder eine Reise-App.

Eine Richtungsmatrix-API, z. B. die Google Maps Directions API, bietet Abbiegehinweise zwischen zwei oder mehr Punkten. Sie enthält Informationen wie die Entfernung, die geschätzte Reisezeit und die einzuschlagende Route. Diese Art von API ist nützlich für Anwendungen, die Navigations- oder Routing-Funktionen benötigen, wie z. B. eine Mitfahr-App oder ein GPS-Gerät.

Zusammenfassend lässt sich sagen, dass die Entfernungsmatrix-API, die Kartenentfernungs-API und die Richtungsmatrix-API zwar alle entfernungsbezogene Daten bereitstellen, aber für verschiedene Anwendungsfälle optimiert sind. Die Distance Matrix API von DistanceMatrix.ai umfasst derzeit Produkte für Entfernungsmatrix und Geokodierung. Wir bieten derzeit keine Lösungen für Karten oder Wegbeschreibungen an. Sie können die Daten in Ihrem Unternehmen jedoch verwenden, um Reiserouten oder Logistikabläufe zu optimieren. Diese Daten sind für Anwendungen bestimmt, die entfernungsbezogene Daten auf einer Karte anzeigen müssen, und für Anwendungen, die Navigations- oder Routing-Funktionen benötigen.

Einfach zu integrierende Distance Matrix API
Beginne
So migrieren Sie zu DistanceMatrix
Es ist keine Vorauszahlung erforderlich.
Starten Sie kostenlos und erhalten Sie sofortigen Zugriff auf alle Produkte und Funktionen von DistanceMatrix.AI
access to all Distancematrix.ai
products and features