Переход на класс Route Matrix

Класс RouteMatrix заменяет Distance Matrix Service, Maps JavaScript API (устаревший) . На этой странице объясняются различия между устаревшим Distance Matrix Service и новой библиотекой JavaScript, а также представлен фрагмент кода для сравнения.

API Distance Matrix (устаревший) и класс Route Matrix (бета-версия)

В следующей таблице сравниваются параметры запроса для устаревшего API Distance Matrix и класса RouteMatrix .

Служба Distance Matrix (устаревшая)	RouteMatrix (бета)
Обязательные параметры
origins	origins
destinations	destinations
Дополнительные параметры
travelMode	travelMode
transitOptions	transitPreference
arrivalTime	arrivalTime
drivingOptions	departureTime , trafficModel
unitSystem	units
avoidHighways , avoidTolls	RouteModifiers

Сравнение кодов

В этом разделе сравниваются два похожих фрагмента кода, чтобы проиллюстрировать различия между устаревшим API Distance Matrix и новым классом RouteMatrix . Фрагменты кода показывают код, необходимый для выполнения запроса маршрута и просмотра результатов в каждом API.

API маршрутов (устаревший)

Следующий код выполняет запрос матрицы расстояний с использованием устаревшего API Distance Matrix.

// 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 (бета)

Следующий код выполняет запрос матрицы расстояний с использованием нового класса Route Matrix:

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