遷移至 Route Matrix 類別

RouteMatrix 類別會取代 Maps JavaScript API 距離矩陣服務 (舊版)。本頁說明舊版距離矩陣服務與新版 JavaScript 程式庫的差異，並提供一些程式碼以供比較。

Distance Matrix API (舊版) 與 Route Matrix 類別 (Beta 版) 的比較

下表比較舊版 Distance Matrix API 和 RouteMatrix 類別的要求參數。

Distance Matrix Service (Legacy)	RouteMatrix (Beta 版)
必要參數
origins	origins
destinations	destinations
選用參數
travelMode	travelMode
transitOptions	transitPreference
arrivalTime	arrivalTime
drivingOptions	departureTime, trafficModel
unitSystem	units
avoidHighways, avoidTolls	RouteModifiers

程式碼比較

本節將比較兩段類似的程式碼，說明舊版 Distance Matrix API 和新版 RouteMatrix 類別之間的差異。程式碼片段會顯示各個 API 進行路線要求及查看結果所需的程式碼。

Directions API (舊版)

下列程式碼使用舊版 Distance Matrix API 發出距離矩陣要求。

// 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 類別 (Beta 版)

下列程式碼使用新的 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,));