Distance Matrix (deprecated)

DistanceMatrixService-Klasse

google.maps.DistanceMatrixService Klasse
Bibliothek "routes"

Eingestellt: „google.maps.DistanceMatrixService“ wurde am 25. Februar 2026 eingestellt. Derzeit ist noch nicht bekannt, zu welchem Datum google.maps.DistanceMatrixService eingestellt wird. Wir stellen für google.maps.DistanceMatrixService weiterhin bei schwerwiegenden Regressionen Fehlerkorrekturen bereit. Die Unterstützung endet erst 12 Monate nach Bekanntgabe der Einstellungsphase. Weitere Informationen finden Sie unter https://developers.google.com/maps/legacy.

const {DistanceMatrixService} = await google.maps.importLibrary("routes");

Konstruktor
DistanceMatrixService	DistanceMatrixService() Parameter: Keine Erstellt eine neue Instanz von DistanceMatrixService, die Distanzmatrixabfragen an Google-Server sendet.

Methoden
getDistanceMatrix	getDistanceMatrix(request[, callback]) Parameter: request: DistanceMatrixRequest callback: function(DistanceMatrixResponse optional, DistanceMatrixStatus): void optional Rückgabewert: Promise<DistanceMatrixResponse> Erstellt eine Distance Matrix-Anfrage.

DistanceMatrixRequest-Schnittstelle

Schnittstelle google.maps.DistanceMatrixRequest

Eine von der DistanceMatrixService gesendete Distanzmatrix-Anfrage, die Arrays mit Start- und Zielorten sowie verschiedene Optionen zum Berechnen von Messwerten enthält.

Attribute
destinations	Typ: Array<string|LatLng|LatLngLiteral|Place> Ein Array mit Zieladressstrings, LatLng- oder Place-Objekten, auf deren Grundlage Strecke und Reisezeit berechnet werden. Erforderlich.
origins	Typ: Array<string|LatLng|LatLngLiteral|Place> Ein Array mit Adressstrings für den Startort oder LatLng- oder Place-Objekten, auf deren Grundlage Strecke und Reisezeit berechnet werden. Erforderlich.
travelMode	Typ: TravelMode Typ der angeforderten Route. Erforderlich.
avoidFerries optional	Typ: boolean optional Wenn true, wird der Distanzmatrix-Dienst angewiesen, Fähren nach Möglichkeit zu vermeiden. Optional.
avoidHighways optional	Typ: boolean optional Wenn true, wird der Distanzmatrix-Dienst angewiesen, Autobahnen nach Möglichkeit zu vermeiden. Optional.
avoidTolls optional	Typ: boolean optional Wenn true, wird der Distanzmatrix-Dienst angewiesen, Mautstraßen nach Möglichkeit zu vermeiden. Optional.
drivingOptions optional	Typ: DrivingOptions optional Einstellungen, die nur für Anfragen gelten, bei denen travelMode den Wert DRIVING hat. Dieses Objekt hat keine Auswirkungen auf andere Mobilitätsformen.
language optional	Typ: string optional Eine Sprachkennung für die Sprache, in der Ergebnisse nach Möglichkeit zurückgegeben werden sollen. Hier finden Sie eine Liste der unterstützten Sprachen.
region optional	Typ: string optional Regionscode für die Gewichtung von Geocodierungsanfragen. Für den Regionscode ist ein zweistelliger Wert für die ccTLD („Top-Level-Domain“) zulässig. Die meisten ccTLD-Codes entsprechen den ISO 3166-1-Codes, mit folgenden Ausnahmen. So lautet beispielsweise die ccTLD des Vereinigten Königreichs „uk“ (.co.uk), der ISO 3166-1-Code dagegen „gb“ (technisch gesehen für das Vereinigte Königreich Großbritannien und Nordirland).
transitOptions optional	Typ: TransitOptions optional Einstellungen, die nur für Anfragen gelten, bei denen travelMode auf TRANSIT festgelegt ist. Dieses Objekt hat keine Auswirkungen auf andere Mobilitätsformen.
unitSystem optional	Typ: UnitSystem optional Bevorzugtes Maßeinheitensystem für die Anzeige der Entfernung. Optional; der Standardwert ist metrisch.

DistanceMatrixResponse-Schnittstelle

Schnittstelle google.maps.DistanceMatrixResponse

Die Antwort auf eine DistanceMatrixService-Anfrage, bestehend aus den formatierten Start- und Zieladressen und einer Sequenz von DistanceMatrixResponseRows, eine für jede entsprechende Startadresse.

Attribute
destinationAddresses	Typ: Array<string> Die formatierten Zieladressen.
originAddresses	Typ: Array<string> Die formatierten Adressen des Ursprungsorts.
rows	Typ: Array<DistanceMatrixResponseRow> Die Zeilen der Matrix, die den Ursprungsadressen entsprechen.

DistanceMatrixResponseRow-Schnittstelle

Schnittstelle google.maps.DistanceMatrixResponseRow

Eine Zeile der Antwort auf eine DistanceMatrixService-Anfrage, die aus einer Sequenz von DistanceMatrixResponseElements besteht, eine für jede entsprechende Zieladresse.

Attribute
elements	Typ: Array<DistanceMatrixResponseElement> Die Elemente der Zeile, die den Zieladressen zugeordnet sind.

DistanceMatrixResponseElement-Schnittstelle

Schnittstelle google.maps.DistanceMatrixResponseElement

Ein einzelnes Element einer Antwort auf eine DistanceMatrixService-Anfrage, das die Dauer und Entfernung von einem Startort zu einem Zielort enthält.

Attribute
distance	Typ: Distance Die Entfernung für dieses Ursprungs-/Zielortpaar. Diese Eigenschaft ist möglicherweise nicht definiert, falls die Entfernung nicht bekannt ist.
duration	Typ: Duration Die Dauer für dieses Ursprungs-/Zielortpaar. Diese Eigenschaft ist möglicherweise nicht definiert, falls die Dauer nicht bekannt ist.
duration_in_traffic	Typ: Duration Die Dauer für dieses Start-Ziel-Paar unter Berücksichtigung der Verkehrslage, die durch die Property trafficModel angegeben wird. Dieses Attribut kann undefined sein, da die Dauer möglicherweise nicht bekannt ist. Nur für Premium-Tarif-Kunden verfügbar, wenn drivingOptions bei der Anfrage definiert ist.
fare	Typ: TransitFare Der Gesamtpreis für diese Kombination aus Abfahrts- und Zielort. Gilt nur für Anfragen zu öffentlichen Verkehrsmitteln.
status	Typ: DistanceMatrixElementStatus Der Status von diesem bestimmten Ursprungs-/Zielortpaar.

DistanceMatrixStatus-Konstanten

google.maps.DistanceMatrixStatus Konstanten
Bibliothek "routes"

Der allgemeine Status der Anfrage, der von der DistanceMatrixService nach Abschluss einer Distanzmatrixanfrage zurückgegeben wird. Geben Sie diese nach Wert oder mit dem Namen der Konstante an. Beispiel: 'OK'oder google.maps.DistanceMatrixStatus.OK

Diese Konstanten können auch als Strings verwendet werden. In TypeScript werden die Stringliterale durch den Typ DistanceMatrixStatusString definiert.

const {DistanceMatrixStatus} = await google.maps.importLibrary("routes");

Konstanten
INVALID_REQUEST	Die eingegebene Anfrage ist ungültig.
MAX_DIMENSIONS_EXCEEDED	Die Anfrage enthält mehr als 25 Ursprungsorte oder mehr als 25 Ziele.
MAX_ELEMENTS_EXCEEDED	Das Produkt der Ursprungs- und Zielorte überschreitet den Grenzwert pro Abfrage.
OK	Die Antwort enthält ein gültiges Ergebnis.
OVER_QUERY_LIMIT	Innerhalb des zulässigen Zeitraums wurden zu viele Elemente angefragt. Die Anfrage sollte erfolgreich sein, wenn Sie es nach einiger Zeit noch einmal versuchen.
REQUEST_DENIED	Die Verwendung des Distance Matrix-Dienstes durch Ihre Webpage wurde abgelehnt.
UNKNOWN_ERROR	Eine Distance Matrix-Anfrage konnte aufgrund eines Serverfehlers nicht verarbeitet werden. Die Anfrage ist möglicherweise erfolgreich, wenn Sie es erneut versuchen.

DistanceMatrixElementStatus-Konstanten

google.maps.DistanceMatrixElementStatus Konstanten
Bibliothek "routes"

Der Status auf Elementebene für ein bestimmtes Start-Ziel-Paar, der von der DistanceMatrixService nach Abschluss einer Distanzmatrixanfrage zurückgegeben wird. Diese Werte werden als Strings angegeben, z. B. 'OK'.

Diese Konstanten können auch als Strings verwendet werden. In TypeScript werden die Stringliterale durch den Typ DistanceMatrixElementStatusString definiert.

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes");

Konstanten
NOT_FOUND	Der Ursprungs- und/oder Zielort dieses Paares konnte nicht geocodiert werden.
OK	Die Antwort enthält ein gültiges Ergebnis.
ZERO_RESULTS	Zwischen Ursprungsort und Zielort konnte keine Route gefunden werden.