Einführung

Die Entfernungsmatrix-API ist ein Dienst, der Reisedistanz und -zeit für eine Matrix von Ursprüngen und Zielen bereitstellt. Die API gibt Informationen basierend auf der von der Google Maps-API berechneten empfohlenen Route zwischen Start- und Endpunkt zurück und besteht aus Zeilen, die duration und distance Werte für jedes Paar enthalten.

Hinweis: Dieser Dienst gibt keine detaillierten Routeninformationen zurück. Routeninformationen können abgerufen werden, indem der gewünschte einzelne Ursprung und das gewünschte Ziel an die Richtungs-API übergeben werden.

Bevor Sie beginnen

Dieses Dokument richtet sich an Entwickler, die die Entfernung und Zeit zwischen mehreren Punkten in Karten berechnen möchten, die von einer der Google Maps-APIs bereitgestellt werden. Es bietet eine Einführung in die Verwendung der API und Referenzmaterial zu den verfügbaren Parametern.

Bevor Sie mit der Entwicklung mit der Distance Matrix API beginnen, überprüfen Sie die Authentifizierungsanforderungen (Sie benötigen einen API-Schlüssel) und die API-Nutzungs- und Abrechnungsinformationen (Sie müssen die Abrechnung für Ihr Projekt aktivieren).

Distanzmatrix-Anfragen

Eine Distanzmatrix-API-Anfrage hat die folgende Form:

wobei outputFormat einer der folgenden Werte sein kann:

• json (empfohlen), zeigt die Ausgabe in JavaScript-Objektnotation an JSON); oder
• xml, gibt die Ausgabe als XML an.

Hinweis: URLs müssen ordnungsgemäß codiert sein, um gültig zu sein, und sind für alle Webdienste auf 8192 Zeichen beschränkt. Beachten Sie dieses Limit beim Erstellen Ihrer URLs. Beachten Sie, dass verschiedene Browser, Proxys und Server auch unterschiedliche URL-Zeichenbeschränkungen haben können.

HTTPS oder HTTP

Sicherheit ist wichtig und HTTPS wird nach Möglichkeit empfohlen, insbesondere für Anwendungen, die vertrauliche Benutzerdaten wie den Standort eines Benutzers in Anforderungen enthalten. Die Verwendung der HTTPS-Verschlüsselung macht Ihre Anwendung sicherer und widerstandsfähiger gegen Schnüffeln oder Manipulationen.

Wenn HTTPS nicht möglich ist, verwenden Sie, um über HTTP auf die Distance Matrix API zuzugreifen:

Anforderungsparameter

Bestimmte Parameter sind erforderlich, während andere optional sind. Wie bei URLs üblich, werden alle Parameter durch das kaufmännische Und-Zeichen (&) getrennt. Alle reservierten Zeichen (z. B. das Pluszeichen „+“) müssen URL-codiert sein.Die Liste der Parameter und ihre möglichen Werte sind unten aufgeführt.

Erforderliche Parameter

• origins — Der Ausgangspunkt für die Berechnung von Fahrstrecke und Zeit. Sie können einen oder mehrere Orte getrennt durch das Pipe-Zeichen (|) in Form einer Orts-ID, einer Adresse oder Längen-/Breitengradkoordinaten angeben:
  • Wenn Sie eine Orts-ID angeben, müssen Sie ihr place_id: voranstellen. Sie können eine Orts-ID nur angeben, wenn die Anforderung einen API-Schlüssel oder eine Google Maps Platform Premium-Plan-Client-ID enthält. Sie können Orts-IDs von der Geokodierungs-API und der Orts-API abrufen (einschließlich der automatischen Vervollständigung von Orts). Ein Beispiel für die Verwendung von Place-IDs aus Place Autocomplete finden Sie unter Place Autocomplete und Wegbeschreibungen. Weitere Informationen zu Orts-IDs finden Sie in der Orts-ID-Übersicht.
  • Wenn Sie eine Adresse übergeben, geokodiert der Dienst die Zeichenfolge und konvertiert sie in eine Breiten- / 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 anstelle seines Zentrums.

    origins=Bobcaygeon+ON|24+Sussex+Drive+Ottawa+ON

    Hinweis: Die Verwendung von Orts-IDs wird der Verwendung von Adressen oder Längen- / Breitengradkoordinaten vorgezogen. Die Verwendung von Koordinaten führt immer dazu, dass der Punkt an der Straße festgehalten wird, die diesen Koordinaten am nächsten liegt – was möglicherweise kein Zugangspunkt zur Immobilie oder sogar eine Straße ist, die schnell oder sicher zum Ziel führt.
  • Wenn Sie Breiten- / Längengradkoordinaten übergeben, werden sie auf der nächsten Straße einrasten. Das Übergeben einer Orts-ID wird bevorzugt. Wenn Sie Koordinaten übergeben, stellen Sie sicher, dass zwischen den Breiten- und Längengradwerten kein Leerzeichen vorhanden ist.

    origins=41.43206,-81.38992|-33.86748,151.20699

    origins=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE

  • Plus-Codes müssen als globaler Code oder zusammengesetzter Code formatiert sein. Formatieren Sie Pluscodes wie hier gezeigt (Pluszeichen sind URL-Escaped zu %2B und Leerzeichen sind url-escaped zu %20):
    • Globaler Code ist ein 4-stelliger Ortscode und 6-stelliger oder längerer lokaler Code (849VCWC8+R9 ist 849VCWC8%2BR9).
    • zusammengesetzter Code ist ein 6-stelliger oder längerer lokaler Code mit einer expliziten Position (CWC8+R9 Mountain View, CA, USA ist CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Alternativ können Sie einen codierten Koordinatensatz mit dem codierten Polylinienalgorithmus angeben. Dies ist besonders nützlich, wenn Sie eine große Anzahl von Ursprungspunkten haben, da die URL bei Verwendung einer codierten Polylinie erheblich kürzer ist.
    • Codierten Polylinien muss enc: vorangestellt sein und ein Doppelpunkt (:) folgen.Beispiel: origins=enc:gfo}EtohhU:
    • Sie können auch mehrere codierte Polylinien einschließen, die durch das Pipe-Zeichen getrennt sind (|). Beispielsweise: origins=enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:|enc:udymA{~bxM:
• destinations — Ein oder mehrere Orte, die als Endpunkt für die Berechnung von Fahrstrecke und Zeit verwendet werden sollen. Die Optionen für den Parameter destinations sind dieselben wie für den Parameter origins, wie oben beschrieben.
• key — Der API-Schlüssel Ihrer Anwendung. Dieser Schlüssel identifiziert Ihre Anwendung zum Zwecke der Kontingentverwaltung. Erfahren Sie, wie Sie einen Schlüssel erhalten.

  Hinweis: Kunden des Google Maps Platform Premium-Plans können in Ihren Entfernungsmatrix-Anfragen entweder einen API-Schlüssel oder eine gültige Client-ID und digitale Signatur verwenden. Weitere Informationen zu Authentifizierungsparametern für Premium-Plan-Kunden.

Im folgenden Beispiel werden Breiten-/Längenkoordinaten verwendet, um die Zielkoordinaten anzugeben:

Im folgenden Beispiel werden Plus-Codes verwendet, um die Zielkoordinaten anzugeben:

Im folgenden Beispiel wird dieselbe Anforderung unter Verwendung einer codierten Polylinie angezeigt:

Optionale Parameter

• mode (standardmäßig driving) — Gibt die Transportart an, die bei der Berechnung der Entfernung verwendet werden soll. Gültige Werte und andere Anforderungsdetails sind im Abschnitt Reisemodi dieses Dokuments angegeben.
• language — Die Sprache, in der die Ergebnisse zurückgegeben werden.
  • Siehe die Liste der unterstützten Sprachen. Google aktualisiert häufig die unterstützten Sprachen, sodass diese Liste möglicherweise nicht vollständig ist.
  • Wenn language nicht angegeben wird, versucht die API, die bevorzugte Sprache zu verwenden, wie im Header Accept-Language angegeben, oder die Muttersprache der Domäne, von der die Anforderung gesendet wird.
  • Die API tut ihr Bestes, um eine Straßenadresse bereitzustellen, die sowohl für den Benutzer als auch für Einheimische lesbar ist. Um dieses Ziel zu erreichen, werden Straßenadressen in der Landessprache zurückgegeben, die bei Bedarf in ein vom Benutzer lesbares Skript transkribiert werden, wobei die bevorzugte Sprache zu beachten ist. 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 wird.
  • Wenn ein Name nicht in der bevorzugten Sprache verfügbar ist, verwendet die API die nächstgelegene Übereinstimmung.
  • Die bevorzugte Sprache hat einen geringen Einfluss auf die Menge der Ergebnisse, die die API zurückgibt, und 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.
• region — Der Regionscode, angegeben als zweistelliger ccTLD-Wert (Country Code Top-Level Domain). Die meisten ccTLD-Codes sind mit einigen Ausnahmen identisch mit ISO 3166-1-Codes. Dieser Parameter wird nur die Ergebnisse des Geocoders beeinflussen, nicht vollständig einschränken. Wenn relevantere Ergebnisse außerhalb der angegebenen Region vorhanden sind, können sie einbezogen werden.
• avoid — Führt Einschränkungen für die Route ein. Gültige Werte werden im Abschnitt Einschränkungen dieses Dokuments angegeben. Es kann nur eine Einschränkung angegeben werden.
• units — Gibt das Einheitensystem an, das beim Ausdrücken der Entfernung als Text verwendet werden soll. Weitere Informationen finden Sie im Abschnitt Einheitensysteme dieses Dokuments.
• 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 beides. Beachten Sie, dass arrival_time als Ganzzahl angegeben werden muss.
• departure_time — Die gewünschte Abfahrtszeit. Sie können die Zeit als ganze Zahl in Sekunden seit Mitternacht, 1. Januar 1970 UTC angeben. Wenn eine departure_time später als 9999-12-31T23:59:59.999999999Z angegeben ist, wird die API die departure_time auf 9999-12-31T23:59:59.999999999Z. Alternativ können Sie einen Wert von now, die die Abfahrtszeit auf die aktuelle Zeit setzt (auf die nächste Sekunde korrigieren). Die Abfahrtszeit kann in zwei Fällen angegeben werden:
  • Für Anfragen, bei denen der Reisemodus Transit ist: Sie können optional departure_time oder arrival_time angeben. Wenn keine Zeit angegeben ist, wird departure_time standardmäßig auf jetzt gesetzt (dh die Abfahrtszeit wird standardmäßig auf die aktuelle Zeit gesetzt).
  • Für Anfragen, bei denen der Reisemodus fährt: Sie können die departure_time angeben, um eine Route und Fahrtdauer zu erhalten (Antwortfeld: duration_in_traffic), die die Verkehrsbedingungen berücksichtigen. Diese Option ist nur verfügbar, wenn die Anforderung einen gültigen API-Schlüssel oder eine gültige Google Maps Platform Premium-Plan-Client-ID und -Signatur enthält. Die departure_time muss auf die aktuelle Zeit oder einige Zeit in der Zukunft gesetzt werden. Es kann nicht in der Vergangenheit sein.

    Hinweis: Wenn die Abfahrtszeit nicht angegeben ist, basieren Routenwahl und Dauer auf dem Straßennetz und den durchschnittlichen zeitunabhängigen Verkehrsbedingungen. Die Ergebnisse für eine bestimmte Anforderung können im Laufe der Zeit aufgrund von Änderungen im Straßennetz, aktualisierten durchschnittlichen Verkehrsbedingungen und der verteilten Art des Dienstes variieren. Die Ergebnisse können auch zwischen nahezu gleichwertigen Routen zu jeder Zeit oder Häufigkeit variieren.

    Hinweis: Distanzmatrix-Anfragen, die departure_time angeben, wenn mode=driving sind auf maximal 100 Elemente pro Anfrage beschränkt. Die Anzahl der Ursprünge mal die Anzahl der Ziele definiert die Anzahl der Elemente.

• traffic_model (standardmäßig best_guess) — Gibt die Annahmen an, die bei der Berechnung der Zeit im Datenverkehr verwendet werden sollen. Diese Einstellung wirkt sich auf den im Feld duration_in_traffic in der Antwort zurückgegebenen Wert aus, der die vorhergesagte Zeit im Datenverkehr basierend auf historischen Durchschnittswerten enthält. Der Parameter traffic_model darf nur für Anforderungen angegeben werden, bei denen der Reisemodus driving ist und bei denen die Anforderung eine departure_time enthält, und nur, wenn die Anforderung einen API-Schlüssel oder eine Google Maps Platform Premium-Plan-Client-ID 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. Live-Traffic wird umso wichtiger, je näher der departure_time jetzt ist.
  • pessimistic gibt an, dass die zurückgegebene duration_in_traffic an den meisten Tagen länger sein sollte als die tatsächliche Reisezeit, obwohl gelegentliche Tage mit besonders schlechten Verkehrsbedingungen diesen Wert überschreiten können.
  • optimistic gibt an, dass die zurückgegebene duration_in_traffic an den meisten Tagen kürzer als die tatsächliche Reisezeit sein sollte, obwohl gelegentliche Tage mit besonders guten Verkehrsbedingungen schneller als dieser Wert sein können.
• transit_mode — Gibt einen oder mehrere bevorzugte Transitarten an. Dieser Parameter darf nur für Anforderungen angegeben werden, bei denen modetransit ist. Der Parameter unterstützt die folgenden Argumente:
  • bus gibt an, dass die berechnete Route Reisen mit dem Bus bevorzugen sollte.
  • subway gibt an, dass die berechnete Route die Fahrt mit der U-Bahn bevorzugen sollte.
  • train gibt an, dass die berechnete Route Reisen mit dem Zug bevorzugen sollte.
  • tram gibt an, dass die berechnete Route die Fahrt mit Straßenbahn und Stadtbahn bevorzugen sollte.
  • rail gibt an, dass die berechnete Route Reisen mit Zug, Straßenbahn, Stadtbahn und U-Bahn bevorzugen sollte. Dies entspricht transit_mode=train|tram|subway .
• transit_routing_preference — Gibt Einstellungen für Transitanfragen an. Mit diesem Parameter können Sie die zurückgegebenen Optionen ändern, anstatt die von der API ausgewählte beste Standardroute zu akzeptieren. Dieser Parameter darf nur für Anforderungen angegeben werden, bei denen modetransit ist. Der Parameter unterstützt die folgenden Argumente:
  • less_walking gibt an, dass die berechnete Route begrenzte Gehmengen bevorzugen sollte.
  • fewer_transfers gibt an, dass die berechnete Route eine begrenzte Anzahl von Transfers bevorzugen sollte.

Reisemodi

Für die Berechnung von Entfernungen können Sie den Transport mode verwenden. Standardmäßig werden Entfernungen für den Fahrmodus berechnet. Die folgenden Fahrmodi werden unterstützt:

• driving (Standard) zeigt die Entfernungsberechnung mithilfe des Straßennetzes an.
• walking fordert Entfernungsberechnung für das Gehen über Fußgängerwege an & Bürgersteige (wo verfügbar).
• bicycling fordert Entfernungsberechnung für das Radfahren über Radwege an & bevorzugte Straßen (wo verfügbar).
• transit fordert Entfernungsberechnung über öffentliche Verkehrsmittel an (sofern verfügbar). Dieser Wert kann nur angegeben werden, wenn die Anforderung einen API-Schlüssel oder eine Google Maps Platform Premium-Plan-Client-ID enthält. Wenn Sie den Modus auf transit einstellen, können Sie optional entweder eine departure_time oder eine arrival_time angeben. Wenn keine Zeit angegeben ist, wird departure_time standardmäßig auf jetzt gesetzt (dh die Abfahrtszeit wird standardmäßig auf die aktuelle Zeit gesetzt). Sie können optional auch eine transit_mode und/oder eine transit_routing_preference .

Verkehrsinformationen

Verkehrsinformationen werden verwendet, wenn alle folgenden Bedingungen zutreffen (dies sind die Bedingungen, die erforderlich sind, um das Feld duration_in_traffic in der Antwort der Entfernungsmatrix zu erhalten):

• Der Parameter travel mode ist driving oder nicht angegeben (driving ist der Standard-Reisemodus).
• Die Anfrage enthält einen gültigen departure_time Parameter. Die departure_time kann auf die aktuelle Zeit oder einige Zeit in der Zukunft eingestellt werden. Es kann nicht in der Vergangenheit sein.

Optional können Sie den Parameter traffic_model in Ihre Anfrage aufnehmen, um die Annahmen anzugeben, die bei der Berechnung der Zeit im Datenverkehr verwendet werden sollen.

Die folgende URL initiiert eine Entfernungsmatrix-Anforderung für Fahrstrecken zwischen Boston, MA oder Charlestown, MA, und Lexington, MA und Concord, MA. Die Anforderung enthält eine Abfahrtszeit, die alle Anforderungen erfüllt, um das Feld duration_in_traffic in der Antwort der Entfernungsmatrix zurückzugeben.

Einschränkungen

Es können Entfernungen berechnet werden, die bestimmten Einschränkungen unterliegen. Einschränkungen werden durch die Verwendung des avoid -Parameters und eines Arguments für diesen Parameter angezeigt, 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 Routen, die die eingeschränkte Funktion enthalten, nicht aus; es verzerrt das Ergebnis auf günstigere Routen.

Einheitensysteme

Entfernungsmatrix-Ergebnisse enthalten text innerhalb distance Felder, 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.

* Hinweis: Diese Einstellung des Einheitensystems betrifft nur die text, die in distance-Feldern angezeigt werden. Die distance -Felder enthalten auch values, die immer in Metern ausgedrückt werden.

Distanzmatrix-Antworten

Antworten auf Distanzmatrix-API-Abfragen werden in dem Format zurückgegeben, das durch das Flag output im Pfad der URL-Anforderung angegeben wird.

Im Folgenden werden zwei Beispiel-HTTP-Anforderungen angezeigt, die Entfernung und Dauer von Vancouver, BC, Kanada und von Seattle, WA, USA, nach San Francisco, CA, USA und nach Victoria, BC, Kanada anfordern.

Diese Anfrage demonstriert die Verwendung des JSON output Flags:

Diese Anfrage demonstriert die Verwendung des XML output Flags:

Diese Anfrage gibt vier Elemente zurück – zwei Ursprünge mal zwei Ziele:

Die Ergebnisse werden in Zeilen zurückgegeben, wobei jede Zeile einen Ursprung enthält, der mit jedem Ziel gepaart ist.

Sie können dies testen, indem Sie die URL in Ihren Webbrowser eingeben (ersetzen Sie YOUR_API_KEY durch Ihren tatsächlichen API-Schlüssel).

Wählen Sie die Registerkarten unten aus, um die JSON- und XML-Beispielantworten anzuzeigen.

Der Rest dieser Dokumentation verwendet die JSON-Syntax.

Distanzmatrix-Antwortelemente

Distanzmatrix-Antworten 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 von Ihrer ursprünglichen Anfrage zurückgegeben wurden. Diese werden vom Geocoder formatiert und gemäß dem mit der Anforderung übergebenen Parameter language lokalisiert.
• destination_addresses enthält ein Array von Adressen, wie sie von der API von Ihrer ursprünglichen Anfrage zurückgegeben wurden. Wie bei origin_addresses werden diese gegebenenfalls lokalisiert.
• rows enthält ein Array von elements, die wiederum jeweils ein statusduration und distance Element.

Statuscodes

Die status Felder innerhalb des Antwortobjekts enthalten den Status der Anforderung und können nützliche Debugging-Informationen enthalten. Die Entfernungsmatrix-API gibt ein Statusfeld der obersten Ebene mit Informationen zur Anforderung im Allgemeinen sowie ein Statusfeld für jedes Elementfeld mit Informationen zu dieser bestimmten Herkunfts-Ziel-Paarung zurück.

Statuscodes der obersten Ebene

• OK zeigt an, dass die Antwort eine gültige result enthält.
• INVALID_REQUEST zeigt an, dass die bereitgestellte Anforderung ungültig war.
• MAX_ELEMENTS_EXCEEDED gibt an, dass das Produkt aus Ursprüngen und Zielen das Limit pro Abfrage überschreitet.
• MAX_DIMENSIONS_EXCEEDED gibt an, dass die Anzahl der Ursprünge oder Ziele das Limit pro Abfrage überschreitet.
• OVER_DAILY_LIMIT zeigt einen der folgenden Zustände an:
  • Der API-Schlüssel fehlt oder ist ungültig.
  • Die Abrechnung wurde in Ihrem Konto nicht aktiviert.
  • Eine selbst auferlegte Nutzungsobergrenze wurde überschritten.
  • Die angegebene Zahlungsmethode ist nicht mehr gültig (z. B. eine Kreditkarte ist abgelaufen).

  Lesen Sie die Maps FAQ, um zu erfahren, wie Sie dieses Problem beheben können.

• OVER_QUERY_LIMIT zeigt an, dass der Dienst innerhalb des zulässigen Zeitraums zu viele Anforderungen von Ihrer Anwendung erhalten hat.
• REQUEST_DENIED gibt an, dass der Dienst die Verwendung des Entfernungsmatrix-Dienstes durch Ihre Anwendung verweigert hat.
• UNKNOWN_ERROR zeigt an, dass eine Entfernungsmatrix-Anforderung aufgrund eines Serverfehlers nicht verarbeitet werden konnte. Die Anforderung kann erfolgreich sein, wenn Sie es erneut versuchen.

Statuscodes auf Elementebene

• OK gibt an, dass die Antwort eine gültige result enthält.
• NOT_FOUND gibt an, dass der Ursprung und/oder das Ziel dieser Paarung nicht geocodiert werden konnten.
• ZERO_RESULTS zeigt an, dass keine Route zwischen Ursprung und Ziel gefunden werden konnte.
• MAX_ROUTE_LENGTH_EXCEEDED zeigt an, dass die angeforderte Route zu lang ist und nicht verarbeitet werden kann.

Fehlermeldungen

Wenn der Statuscode der obersten Ebene ein anderer als OK ist, befindet sich möglicherweise ein zusätzlicheserror_message Feld innerhalb des Distanzmatrix-Antwortobjekts. Dieses Feld enthält detailliertere Informationen zu den Gründen für den angegebenen Statuscode.

Hinweis: Es ist nicht garantiert, dass dieses Feld immer vorhanden ist, und sein Inhalt kann sich ändern.

Zeilen

Wenn die Entfernungsmatrix-API Ergebnisse zurückgibt, platziert sie diese in einem JSON rows Array. Selbst wenn keine Ergebnisse zurückgegeben werden (z. B. wenn die Ursprünge und / oder Ziele nicht vorhanden sind), wird immer noch ein leeres Array zurückgegeben. XML-Antworten bestehen aus null oder mehr <row>-Elementen.

Zeilen werden nach den Werten im origin Parameter der Anforderung sortiert. Jede Zeile entspricht einem Ursprung, und jeder element innerhalb dieser Zeile entspricht einer Paarung des Ursprungs mit einem destination Wert.

Jedes row Array enthält einen oder mehrere element Einträge, die wiederum die Informationen über eine einzelne Herkunfts-Ziel-Paarung enthalten.

Elemente

Die Informationen zu jeder Ursprungs-Ziel-Paarung werden in einem element Eintrag zurückgegeben. Ein element enthält die folgenden Felder:

• status: Eine Liste möglicher Statuscodes finden Sie unter Statuscodes.
• duration: Die Zeit, die benötigt wird, um diese Route zurückzulegen, ausgedrückt in Sekunden (das Feld value) und als text. Die Textdarstellung wird gemäß dem Parameter language der Abfrage lokalisiert.

• duration_in_traffic: Die Zeit, die benötigt wird, um diese Route zu fahren, basierend auf aktuellen und historischen Verkehrsbedingungen. Im Anforderungsparameter traffic_model finden Sie die Optionen, mit denen Sie anfordern können, dass der zurückgegebene Wert optimistisch, pessimistisch oder eine Best-Guess-Schätzung ist. Die Dauer wird in Sekunden ausgedrückt (das value Feld) und als text. Die Textdarstellung wird gemäß dem Parameter language der Abfrage lokalisiert. Die Dauer im Datenverkehr wird nur zurückgegeben, wenn alle folgenden Werte zutreffen:

  • Die Anforderung enthält einen departure_time -Parameter.
  • Die Anforderung enthält einen gültigen API-Schlüssel oder eine gültige Google Maps Platform Premium-Plan-Client-ID und -Signatur.
  • Verkehrsbedingungen sind für die angeforderte Route verfügbar.
  • Der mode Parameter ist auf driving gesetzt.
• distance: Die Gesamtstrecke dieser Route, ausgedrückt in Metern (value) und als text. Der Textwert verwendet das Einheitensystem, das mit dem Parameter unit der ursprünglichen Anforderung oder der Region des Ursprungs angegeben wurde.
• fare: Falls vorhanden, enthält den Gesamtpreis (dh die Gesamtkosten des Tickets) auf dieser Strecke. Diese Eigenschaft wird nur für Transitanfragen und nur für Transitanbieter zurückgegeben, bei denen Tarifinformationen verfügbar sind. Die Informationen umfassen:
  • currency: Ein ISO 4217-Währungscode, der die Währung angibt, in der der Betrag ausgedrückt wird.
  • value: Der Gesamtpreis in der oben angegebenen Währung.
  • text: Der Gesamtpreis, formatiert in der gewünschten Sprache.

Nachfolgend finden Sie ein Beispiel für einen element mit Tarifinformationen:

Der Sensorparameter

Die Google Maps-API erforderte zuvor, dass Sie den Parametersensor angeben, ob Ihre Anwendung asensor verwendet hat, um den Standort des Benutzers zu bestimmen. Dieser Parameter ist nicht mehr erforderlicherforderlich.