Route Matrix クラスに移行する

RouteMatrix クラスは、Distance Matrix Service、Maps JavaScript API（以前のバージョン）を置き換えます。このページでは、以前の Distance Matrix サービスと新しい JavaScript ライブラリの違いについて説明し、比較用のコードを紹介します。

Distance Matrix API（以前のバージョン）と Route Matrix クラス（ベータ版）

次の表は、以前の Distance Matrix API と RouteMatrix クラスのリクエスト パラメータを比較したものです。

距離行列サービス（レガシー）	RouteMatrix（ベータ版）
必須パラメータ
origins	origins
destinations	destinations
オプション パラメータ
travelMode	travelMode
transitOptions	transitPreference
arrivalTime	arrivalTime
drivingOptions	departureTime、trafficModel
unitSystem	units
avoidHighways、avoidTolls	RouteModifiers

コードの比較

このセクションでは、2 つの類似したコードを比較して、以前の 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 クラス（ベータ版）

次のコードは、新しい 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,));