Die Klasse RouteMatrix ersetzt den Distanzmatrix-Dienst der Maps JavaScript API (Legacy).
Auf dieser Seite werden die Unterschiede zwischen dem alten Distanzmatrix-Dienst und der neuen JavaScript-Bibliothek erläutert. Außerdem finden Sie hier Codebeispiele zum Vergleich.
Distance Matrix API (Legacy) im Vergleich zur Route Matrix-Klasse
In der folgenden Tabelle werden die Anfrageparameter für die alte Distance Matrix API (Legacy) und die Klasse RouteMatrix verglichen.
| Distanzmatrix-Dienst, Maps JavaScript API (alt) | RouteMatrix |
Erforderlich oder optional |
|---|---|---|
origins |
origins |
Erforderlich |
destinations |
destinations |
Erforderlich |
travelMode |
travelMode |
Optional |
transitOptions |
transitPreference |
Optional |
arrivalTime |
arrivalTime |
Optional |
drivingOptions |
departureTime,
trafficModel |
Optional |
unitSystem |
units |
Optional |
avoidHighways,
avoidTolls |
RouteModifiers |
Optional |
Codevergleich
In diesem Abschnitt werden zwei ähnliche Codeabschnitte verglichen, um die Unterschiede zwischen der Distance Matrix API (Legacy) und der neuen RouteMatrix-Klasse zu veranschaulichen. Die Code-Snippets zeigen den Code, der für die jeweilige API erforderlich ist, um eine Routenanfrage zu stellen und die Ergebnisse aufzurufen.
Distance Matrix API (Legacy)
Mit dem folgenden Code wird eine Distanzmatrixanfrage über die Distance Matrix API (Legacy) gestellt.
// Define the request. const request = { origins: [{lat: 55.93, lng: -3.118}, 'Greenwich, England'], destinations: ['Stockholm, Sweden', {lat: 50.087, lng: 14.421}], travelMode: 'DRIVING', drivingOptions: { departureTime: new Date(Date.now()), trafficModel: 'optimistic' } }; // Make the request. service.getDistanceMatrix(request).then((response) => { // Display the response. document.getElementById("response").textContent = JSON.stringify( response, null, 2, ); });
Route Matrix-Klasse
Im folgenden Code wird eine Distanzmatrix-Anfrage mit der neuen Route Matrix-Klasse gestellt:
// Define the request. const request = { origins: [{lat: 55.93, lng: -3.118}, 'Greenwich, England'], destinations: ['Stockholm, Sweden', {lat: 50.087, lng: 14.421}], travelMode: 'DRIVING', departureTime: new Date(), trafficModel: 'optimistic' }; // Make the request. const response = await RouteMatrix.computeRouteMatrix(request); // Display the response. document.getElementById("response").setValue(JSON.stringify(response, null, 2,));