Freigeben über


MapsRoutingClient.GetRouteMatrixAsync Methode

Definition

Der Matrixroutingdienst ermöglicht die Berechnung einer Matrix von Routenzusammenfassungen für eine Gruppe von Routen, die von Ursprungs- und Zielstandorten definiert sind, indem eine asynchrone (asynchrone) oder synchrone (Synchronisierungsanforderung) verwendet wird. Für jeden angegebenen Ursprung berechnet der Dienst die Kosten für das Routing von diesem Ursprung zu jedem angegebenen Ziel. Die Gruppe der Ursprünge und der Satz von Zielen können als Spalten- und Zeilenüberschriften einer Tabelle betrachtet werden, und jede Zelle in der Tabelle enthält die Kosten für das Routing vom Ursprung zum Ziel für diese Zelle. Für jede Route werden die Fahrzeiten und Entfernungen zurückgegeben. Mithilfe der berechneten Kosten können Sie mithilfe der Routenbeschreibungs-API ermitteln, welche detaillierten Routen berechnet werden sollen. Die maximale Größe einer Matrix für asynchrone Anforderungen ist 700 (die Anzahl der Ursprünge multipliziert mit der Anzahl der Ziele).

public virtual System.Threading.Tasks.Task<Azure.Maps.Routing.Models.GetRouteMatrixOperation> GetRouteMatrixAsync (Azure.WaitUntil waitUntil, Azure.Maps.Routing.RouteMatrixOptions options, System.Threading.CancellationToken cancellationToken = default);
abstract member GetRouteMatrixAsync : Azure.WaitUntil * Azure.Maps.Routing.RouteMatrixOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Maps.Routing.Models.GetRouteMatrixOperation>
override this.GetRouteMatrixAsync : Azure.WaitUntil * Azure.Maps.Routing.RouteMatrixOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Maps.Routing.Models.GetRouteMatrixOperation>
Public Overridable Function GetRouteMatrixAsync (waitUntil As WaitUntil, options As RouteMatrixOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of GetRouteMatrixOperation)

Parameter

waitUntil
WaitUntil

Wenn die Methode auf die Rückgabe warten soll, bis der lange ausgeführte Vorgang für den Dienst abgeschlossen ist; Started , wenn es nach dem Starten des Vorgangs zurückgegeben werden soll.

options
RouteMatrixOptions

Die Routenrichtungsoptionen.

cancellationToken
CancellationToken

Das zu verwendende Abbruchtoken.

Gibt zurück

Ausnahmen

options ist NULL.

Der Dienst hat einen nicht erfolgreichen status Code zurückgegeben.

Gilt für: