Route Matrix

RouteMatrix-Klasse

Klasse google.maps.routes.RouteMatrix

Eine Matrix von Routen, die von RouteMatrix.computeRouteMatrix für eine Reihe von Start-Ziel-Paaren berechnet wurde

Zugriff durch Aufrufen von const {RouteMatrix} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
computeRouteMatrix
computeRouteMatrix(request)
Parameter: 
Rückgabewert: Promise<{matrix:RouteMatrix}>
Nimmt eine Liste von Start- und Zielorten entgegen und gibt eine Matrix mit Routeninformationen für jede Kombination aus Start- und Zielort zurück.

Hinweis: Bei dieser Methode müssen Sie in der Anfrage eine Antwortfeldmaske angeben, indem Sie die Property ComputeRouteMatrixRequest.fields festlegen. Der Wert ist eine Liste von Feldpfaden.

Beispiel:
  • Feldmaske aller verfügbaren Felder: fields: ['*']
  • Feldmaske für Dauer und Entfernung auf Routenebene: fields: ['durationMillis', 'distanceMeters']

Die Verwendung der Platzhalter-Feldmaske fields: ['*'] wird aus folgenden Gründen nicht empfohlen:
  • Wenn Sie nur die Felder auswählen, die Sie benötigen, spart unser Server Rechenzyklen und wir können Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben.
  • Wenn Sie nur die Felder auswählen, die Sie in Ihrem Produktionsjob benötigen, wird eine stabile Latenzleistung gewährleistet. Möglicherweise werden in Zukunft weitere Antwortfelder hinzugefügt, für die zusätzliche Rechenzeit erforderlich ist. Wenn Sie alle Felder oder alle Felder auf der obersten Ebene auswählen, kann es zu Leistungseinbußen kommen, da jedes neue Feld, das wir hinzufügen, automatisch in die Antwort aufgenommen wird.
  • Wenn Sie nur die benötigten Felder auswählen, ist die Antwort kleiner und wird daher schneller über das Netzwerk geladen.
rows
Die Zeilen der Matrix. Jede Zeile entspricht einem Startort und enthält ein Array von RouteMatrixItem-Objekten, die jeweils eine Route zu einem Ziel darstellen.
toJSON
toJSON()
Parameter: Keine
Rückgabewert: Object
Konvertiert in ein Objekt.

RouteMatrixRow-Klasse

Klasse google.maps.routes.RouteMatrixRow

Entspricht einem Ursprung, der an RouteMatrix.computeRouteMatrix übergeben wurde. Enthält eine Liste von RouteMatrixItems, wobei jedes Element eine Route zu einem Ziel darstellt.

Zugriff durch Aufrufen von const {RouteMatrixRow} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
items
Die Routeninformationen für jedes Ziel.
toJSON
toJSON()
Parameter: Keine
Rückgabewert: Object
Konvertiert in ein Objekt.

RouteMatrixItem-Klasse

Klasse google.maps.routes.RouteMatrixItem

Enthält Routeninformationen, die für ein an RouteMatrix.computeRouteMatrix übergebenes Paar aus Start- und Zielort berechnet wurden.

Zugriff durch Aufrufen von const {RouteMatrixItem} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
condition
Gibt an, ob die Route gefunden wurde oder nicht.
distanceMeters
Typ: number optional
Die Länge der Route in Metern.
durationMillis
Typ: number optional
Die Dauer der Route in Millisekunden. Wenn Sie ComputeRouteMatrixRequest.routingPreference auf TRAFFIC_UNAWARE festlegen, entspricht dieser Wert RouteMatrixItem.staticDurationMillis. Wenn Sie ComputeRouteMatrixRequest.routingPreference auf TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL festlegen, wird dieser Wert unter Berücksichtigung der Verkehrslage berechnet.

Hinweis: Wenn die Dauer 2^53 Millisekunden überschreitet, ist dieser Wert Number.POSITIVE_INFINITY.
error
Typ: RouteMatrixItemError optional
Fehler, der bei der Berechnung der Route aufgetreten ist.
fallbackInfo
Typ: FallbackInfo optional
In einigen Fällen, wenn der Server die Route mit den angegebenen Einstellungen für dieses bestimmte Start-/Zielpaar nicht berechnen kann, wird möglicherweise ein anderer Berechnungsmodus verwendet. Wenn ein Fallback verwendet wird, enthält dieses Feld detaillierte Informationen zur Fallback-Antwort. Andernfalls ist dieses Feld nicht festgelegt.
localizedValues
Textdarstellungen von Attributen des RouteMatrixItem.
staticDurationMillis
Typ: number optional
Die Dauer der Fahrt auf der Route ohne Berücksichtigung der Verkehrslage.

Hinweis: Wenn die Dauer 2^53 Millisekunden überschreitet, ist dieser Wert Number.POSITIVE_INFINITY.
travelAdvisory
Typ: RouteTravelAdvisory optional
Zusätzliche Informationen zur Route.
toJSON
toJSON()
Parameter: Keine
Rückgabewert: Object
Konvertiert in ein Objekt.

ComputeRouteMatrixRequest-Schnittstelle

Schnittstelle google.maps.routes.ComputeRouteMatrixRequest

Anfrage für eine Routenmatrix.
destinations
Array von Zielen, das die Spalten der Antwortmatrix bestimmt. Ein als String übergebener Wert kann eine Adresse, ein Plus Code oder der Ressourcenname eines Orts sein. Höhenwerte werden nicht berücksichtigt.
fields
Typ: Iterable<string>
Sammlung der abzurufenden Felder. Geben Sie für alle Felder ["*"] an.
origins
Array von Startpunkten, das die Zeilen der Antwortmatrix bestimmt. Ein als String übergebener Wert kann eine Adresse, ein Plus Code oder der Ressourcenname eines Orts sein. Höhenwerte werden nicht berücksichtigt.

Für die Kardinalität von Start- und Zielorten gelten mehrere Größenbeschränkungen:
  • Die Gesamtzahl der als strings oder Places angegebenen Start- und Zielpunkte darf nicht größer als 50 sein.
  • Das Produkt aus der Anzahl der Start- und Zielorte darf nicht größer als 625 sein.
  • Das Produkt aus der Anzahl der Start- und Zielorte darf nicht größer als 100 sein, wenn ComputeRouteMatrixRequest.routingPreference auf TRAFFIC_AWARE_OPTIMAL festgelegt ist.
  • Das Produkt aus der Anzahl der Start- und Zielorte darf nicht größer als 100 sein, wenn ComputeRouteMatrixRequest.travelMode auf TRANSIT festgelegt ist.
arrivalTime optional
Typ: Date optional
Die Ankunftszeit.

Hinweis: Kann nur festgelegt werden, wenn ComputeRouteMatrixRequest.travelMode auf TRANSIT gesetzt ist. Sie können entweder ComputeRouteMatrixRequest.departureTime oder ComputeRouteMatrixRequest.arrivalTime angeben, aber nicht beides. Fahrten mit öffentlichen Verkehrsmitteln sind für bis zu 7 Tage in der Vergangenheit oder 100 Tage in der Zukunft verfügbar.
departureTime optional
Typ: Date optional
Die Abfahrtszeit. Wenn Sie diesen Wert nicht festlegen, wird standardmäßig die Zeit verwendet, zu der Sie die Anfrage gestellt haben.

Hinweis: Sie können nur dann einen Zeitpunkt in der Vergangenheit angeben, wenn ComputeRouteMatrixRequest.travelMode auf TRANSIT festgelegt ist. Fahrten mit öffentlichen Verkehrsmitteln sind für bis zu 7 Tage in der Vergangenheit oder 100 Tage in der Zukunft verfügbar.
extraComputations optional
Eine Liste zusätzlicher Berechnungen, die zum Abschließen der Anfrage verwendet werden können.

Hinweis: Diese zusätzlichen Berechnungen können zusätzliche Felder in der Antwort zurückgeben. Diese zusätzlichen Felder müssen auch in ComputeRouteMatrixRequest.fields angegeben werden, damit sie in der Antwort zurückgegeben werden.
language optional
Typ: string optional
Der BCP-47-Sprachcode, z. B. "en-US" oder "sr-Latn" Weitere Informationen finden Sie unter Unicode-Sprachkennzeichnung. Eine Liste der unterstützten Sprachen finden Sie unter Sprachunterstützung. Wenn Sie diesen Wert nicht angeben, wird die Sprache aus den Lokalisierungseinstellungen der Google Maps JavaScript API abgeleitet. Andernfalls wird die Sprache vom Standort des ersten Ursprungs abgeleitet.
region optional
Typ: string optional
Der Regionscode, angegeben als zweistelliger Wert für die länderspezifische Top-Level-Domain (ccTLD). Weitere Informationen finden Sie unter Länderspezifische Top-Level-Domains. Wenn Sie diesen Wert nicht angeben, wird die Region aus den Lokalisierungseinstellungen der Google Maps JavaScript API abgeleitet. Andernfalls wird die Region aus dem Standort des ersten Ursprungs abgeleitet.
routingPreference optional
Typ: RoutingPreference optional
Gibt an, wie die Routenmatrix berechnet werden soll. Der Server versucht, die ausgewählte Routingeinstellung zu verwenden, um die Routenmatrix zu berechnen. Wenn die Routingeinstellung zu einem Fehler oder einer besonders langen Latenz führt, wird ein Fehler zurückgegeben. Sie können diese Option nur angeben, wenn ComputeRouteMatrixRequest.travelMode den Wert DRIVING oder TWO_WHEELER hat. Andernfalls schlägt die Anfrage fehl.
trafficModel optional
Typ: TrafficModel optional
Gibt die Annahmen an, die bei der Berechnung der Reisezeit verwendet werden sollen. Diese Einstellung wirkt sich auf den Wert für die voraussichtliche Reisezeit aus, der in RouteMatrixItem.durationMillis zurückgegeben und anhand bisheriger Durchschnittswerte berechnet wird. ComputeRouteMatrixRequest.trafficModel ist nur für Anfragen verfügbar, bei denen ComputeRouteMatrixRequest.routingPreference auf TRAFFIC_AWARE_OPTIMAL und ComputeRouteMatrixRequest.travelMode auf DRIVING festgelegt ist. Die Standardeinstellung ist BEST_GUESS.
transitPreference optional
Typ: TransitPreference optional
Gibt Einstellungen an, die die für TRANSIT-Routen zurückgegebene Route beeinflussen.

Hinweis: Kann nur angegeben werden, wenn ComputeRouteMatrixRequest.travelMode auf TRANSIT gesetzt ist.
travelMode optional
Typ: TravelMode optional
Gibt die Mobilitätsform an.
units optional
Typ: UnitSystem optional
Gibt die Maßeinheiten für die Anzeigefelder an. Wenn Sie diesen Wert nicht angeben, werden die Anzeigeeinheiten aus dem Standort des ersten Startpunkts abgeleitet.

ComputeRouteMatrixExtraComputation-Konstanten

google.maps.routes.ComputeRouteMatrixExtraComputation-Konstanten

Zusätzliche Berechnungen, die für eine RouteMatrix.computeRouteMatrix-Anfrage ausgeführt werden sollen.

Zugriff durch Aufrufen von const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
TOLLS Mautinformationen für die Matrixelemente.

RouteMatrixItemCondition-Konstanten

google.maps.routes.RouteMatrixItemCondition-Konstanten

Der Zustand einer Route für ein bestimmtes Start-Ziel-Paar.

Zugriff durch Aufrufen von const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
ROUTE_EXISTS Eine Route wurde gefunden.
ROUTE_NOT_FOUND Es wurde keine Route gefunden.

Klasse RouteMatrixItemError

Klasse google.maps.routes.RouteMatrixItemError

Ein Fehler, der während RouteMatrix.computeRouteMatrix für ein bestimmtes Ursprungs-/Zielpaar aufgetreten ist.

Diese Klasse erweitert Error.

Zugriff durch Aufrufen von const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
toJSON
toJSON()
Parameter: Keine
Rückgabewert: Object
Konvertiert in ein Objekt.

RouteMatrixItemLocalizedValues-Klasse

Klasse google.maps.routes.RouteMatrixItemLocalizedValues

Textdarstellungen des RouteMatrixItem.

Zugriff durch Aufrufen von const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
distance
Typ: string optional
Reisedistanz des Routenmatrixelements in Textform.
distanceLanguage
Typ: string optional
Der BCP-47-Sprachcode des Entfernungstexts, z. B. „en-US“ oder „sr-Latn“.

Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
Typ: string optional
Dauer, dargestellt in Textform und lokalisiert für die Region der Abfrage. Die Verkehrslage wird berücksichtigt.

Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, entspricht dieser Wert dem Wert von RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage
Typ: string optional
Der BCP-47-Sprachcode für den Text der Dauer, z. B. „en-US“ oder „sr-Latn“.

Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
Typ: string optional
Dauer ohne Berücksichtigung der Verkehrslage, dargestellt in Textform.
staticDurationLanguage
Typ: string optional
Der BCP-47-Sprachcode des statischen Dauertexts, z. B. „en-US“ oder „sr-Latn“.
transitFare
Typ: string optional
Fahrpreis, dargestellt in Textform.
transitFareLanguage
Typ: string optional
Der BCP-47-Sprachcode für den Text des Fahrpreises, z. B. „en-US“ oder „sr-Latn“.

Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
toJSON
toJSON()
Parameter: Keine
Rückgabewert: Object
Konvertiert in ein Objekt.

RouteMatrixOrigin-Schnittstelle

Schnittstelle google.maps.routes.RouteMatrixOrigin

Ein einzelner Ursprung für ein ComputeRouteMatrixRequest.
waypoint
Der Standort des Ursprungs. Ein als String übergebener Wert kann eine Adresse oder ein Plus Code sein. Höhenwerte werden nicht berücksichtigt.
routeModifiers optional
Typ: RouteModifiers optional
Modifikatoren für jede Route, die diesen als Startpunkt verwendet.