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