Migracja do klasy Route Matrix

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Klasa RouteMatrix zastępuje usługę macierzy odległości w Maps JavaScript API (starsza wersja). Na tej stronie wyjaśniamy różnice między starszą wersją usługi macierzy odległości a nową biblioteką JavaScript oraz podajemy przykładowy kod do porównania.

Distance Matrix API (starsza wersja) a klasa macierzy tras

Tabela poniżej zawiera porównanie parametrów żądania w przypadku starszej wersji interfejsu Distance Matrix API (starsza wersja) i klasy RouteMatrix.

Distance Matrix Service, Maps JavaScript API (starsza wersja) RouteMatrix Wymagana czy opcjonalna
origins origins Wymagane
destinations destinations Wymagane
travelMode travelMode Opcjonalny
transitOptions transitPreference Opcjonalny
arrivalTime arrivalTime Opcjonalny
drivingOptions departureTime, trafficModel Opcjonalny
unitSystem units Opcjonalny
avoidHighways, avoidTolls RouteModifiers Opcjonalny

Porównanie kodu

W tej sekcji porównujemy 2 podobne fragmenty kodu, aby zilustrować różnice między interfejsem Distance Matrix API (starsza wersja) a nową klasą RouteMatrix. Fragmenty kodu pokazują kod wymagany w każdym interfejsie API do wysłania żądania wskazówek dojazdu i wyświetlenia wyników.

Distance Matrix API (starsza wersja)

Poniższy kod wysyła żądanie macierzy odległości za pomocą interfejsu Distance Matrix API (starsza wersja). 

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

Klasa Route Matrix

Poniższy kod wysyła żądanie macierzy odległości za pomocą nowej klasy macierzy tras: 

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