Di chuyển sang lớp Ma trận tuyến đường

Lớp RouteMatrix sẽ thay thế Dịch vụ ma trận khoảng cách, API Maps JavaScript (Cũ). Trang này giải thích sự khác biệt giữa dịch vụ Distance Matrix cũ và thư viện JavaScript mới, đồng thời cung cấp một số mã để so sánh.

Distance Matrix API (Cũ) so với lớp Route Matrix (Beta)

Bảng sau đây so sánh các tham số yêu cầu cho Distance Matrix API cũ và lớp RouteMatrix.

Distance Matrix Service (Cũ) RouteMatrix (Thử nghiệm)

Tham số bắt buộc
origins origins
destinations destinations

Thông số không bắt buộc
travelMode travelMode
transitOptions transitPreference
arrivalTime arrivalTime
drivingOptions departureTime, trafficModel
unitSystem units
avoidHighways, avoidTolls RouteModifiers

So sánh mã

Phần này so sánh 2 đoạn mã tương tự để minh hoạ sự khác biệt giữa Distance Matrix API cũ và lớp RouteMatrix mới. Các đoạn mã này cho biết mã cần thiết trên mỗi API tương ứng để đưa ra yêu cầu chỉ đường và xem kết quả.

Directions API (Cũ)

Đoạn mã sau đây đưa ra yêu cầu ma trận khoảng cách bằng cách sử dụng Distance Matrix API cũ. 

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

Lớp Ma trận tuyến đường (Beta)

Đoạn mã sau đây đưa ra yêu cầu ma trận khoảng cách bằng cách sử dụng lớp Route Matrix mới: 

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