Zur Route Matrix-Klasse migrieren

Entwickler im Europäischen Wirtschaftsraum (EWR)

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,));