Zur Route Matrix-Klasse migrieren

Die Klasse RouteMatrix ersetzt den „Distance Matrix“-Dienst der Maps JavaScript API (Legacy). Auf dieser Seite werden die Unterschiede zwischen dem alten Distance Matrix-Dienst und der neuen JavaScript-Bibliothek erläutert. Außerdem finden Sie hier Vergleichscode.

Distance Matrix API (Legacy) im Vergleich zur Route Matrix-Klasse (Beta)

In der folgenden Tabelle werden die Anfrageparameter für die alte Distance Matrix API und die Klasse RouteMatrix verglichen.

„Distance Matrix“-Dienst (Legacy) RouteMatrix (Beta)

Erforderliche Parameter
origins origins
destinations destinations

Optionale Parameter
travelMode travelMode
transitOptions transitPreference
arrivalTime arrivalTime
drivingOptions departureTime, trafficModel
unitSystem units
avoidHighways, avoidTolls RouteModifiers

Codevergleich

In diesem Abschnitt werden zwei ähnliche Codeabschnitte verglichen, um die Unterschiede zwischen der alten Distance Matrix API und der neuen Klasse RouteMatrix zu veranschaulichen. Die Code-Snippets zeigen den Code, der für die jeweilige API erforderlich ist, um eine Anfrage für Wegbeschreibungen zu stellen und die Ergebnisse aufzurufen.

Directions API (Legacy)

Mit dem folgenden Code wird eine Distance Matrix-Anfrage mit der alten Distance Matrix API 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,
  );
});

Klasse „Route Matrix“ (Beta)

Im folgenden Code wird mit der neuen Route Matrix-Klasse eine Anfrage für eine Distanzmatrix 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,));