Route Matrix クラスに移行する

欧州経済領域（EEA）のデベロッパー

RouteMatrix クラスは、Distance Matrix Service、Maps JavaScript API（従来版）に代わるものです。このページでは、従来の Distance Matrix サービスと新しい JavaScript ライブラリの違いについて説明し、比較用のコードをいくつか紹介します。

Distance Matrix API（従来版）と Route Matrix クラス

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

Distance Matrix Service、Maps JavaScript API（従来版） 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 で必要なコードを示しています。

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

ルート マトリックス クラス

次のコードは、新しいルート マトリックス クラスを使用して距離行列リクエストを送信します。

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