Route Matrix

RouteMatrix-Klasse

Klasse google.maps.routes.RouteMatrix
Bibliothek "routes"

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

const {RouteMatrix} = await google.maps.importLibrary("routes");
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
readonly
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.
Übernommen: toJSON

RouteMatrixRow-Klasse

Klasse google.maps.routes.RouteMatrixRow
Bibliothek "routes"

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

const {RouteMatrixRow} = await google.maps.importLibrary("routes");
items
readonly
Die Routeninformationen für jedes Ziel.
Übernommen: toJSON

RouteMatrixItem-Klasse

Klasse google.maps.routes.RouteMatrixItem
Bibliothek "routes"

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

const {RouteMatrixItem} = await google.maps.importLibrary("routes");
condition
readonly
Gibt an, ob die Route gefunden wurde oder nicht.
distanceMeters
readonly
Typ: number optional
Die Länge der Route in Metern.
durationMillis
readonly
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
readonly
Typ: RouteMatrixItemError optional
Fehler, der bei der Berechnung der Route aufgetreten ist.
fallbackInfo
readonly
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
readonly
Textdarstellungen von Attributen des RouteMatrixItem.
staticDurationMillis
readonly
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
readonly
Typ: RouteTravelAdvisory optional
Zusätzliche Informationen zur Route.

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.
internalUsageAttributionIds
optional
Typ: Iterable<string> optional
Kennungen, mit denen Aufrufe bestimmten Paketen oder OSS-Bibliotheken zugeordnet 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

Konstanten google.maps.routes.ComputeRouteMatrixExtraComputation
Bibliothek "routes"

Zusätzliche Berechnungen, die beim Ausführen der Anfrage durchgeführt werden sollen. Weitere Informationen finden Sie in der Dokumentation zum Webdienst.

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

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes");
TOLLS Mautinformationen für die Matrixelemente. Weitere Informationen finden Sie in der Dokumentation zum Webdienst.

RouteMatrixItemCondition-Konstanten

Konstanten google.maps.routes.RouteMatrixItemCondition
Bibliothek "routes"

Der Zustand der zurückgegebenen Route. Weitere Informationen finden Sie in der Dokumentation zum Webdienst.

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

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes");
ROUTE_EXISTS Eine Route wurde gefunden und die entsprechenden Informationen wurden für das Element ausgefüllt. Weitere Informationen finden Sie in der Dokumentation zum Webdienst.
ROUTE_NOT_FOUND Es wurde keine Route gefunden. Weitere Informationen finden Sie in der Dokumentation zum Webdienst.

Klasse RouteMatrixItemError

Klasse google.maps.routes.RouteMatrixItemError erweitert Error
Bibliothek "routes"

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

const {RouteMatrixItemError} = await google.maps.importLibrary("routes");
Übernommen: toJSON

RouteMatrixItemLocalizedValues-Klasse

Klasse google.maps.routes.RouteMatrixItemLocalizedValues
Bibliothek "routes"

Textdarstellungen des RouteMatrixItem.

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
Typ: string optional
Reisedistanz des Routenmatrixelements in Textform.
distanceLanguage
readonly
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
readonly
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
readonly
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
readonly
Typ: string optional
Dauer ohne Berücksichtigung der Verkehrslage, dargestellt in Textform.
staticDurationLanguage
readonly
Typ: string optional
Der BCP-47-Sprachcode des statischen Dauertexts, z. B. „en-US“ oder „sr-Latn“.
transitFare
readonly
Typ: string optional
Fahrpreis, dargestellt in Textform.
transitFareLanguage
readonly
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.
Übernommen: toJSON

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.