公共交通機関のルートでは、その地域で利用可能な公共交通機関を利用したナビゲーションの手順が提供されます。交通機関のオプションには、バス、地下鉄、電車などが含まれます。通常、乗換案内には、乗換駅への移動、乗換駅からの移動、乗換駅間の移動に関する手順も含まれます。通常、公共交通機関のルートでは複数の移動手段を使用する必要があるため、ルートのリクエスト方法とレスポンスの一部が異なります。
公共交通機関の経路と他の経路の違い
travelMode を TRANSIT に設定してリクエストする公共交通機関のルートは、別の移動手段オプションを使用するルートとは異なります。同じオブジェクトとオプションをすべてリクエストすることはできません。また、他のルートと比較して、レスポンスで返されるフィールドが異なります。
Routes API では、ステップはすべての移動手段で一貫して 1 つのナビゲーション指示です。そのため、各ナビゲーション指示が 1 つのステップになります。公共交通機関のルート レスポンスは、他の交通手段のルートとよく似ていますが、いくつかの重要な違いがあります。
| リクエストの違い | レスポンスの違い |
|---|---|
| 経由地を指定することはできません。 | 公共交通機関の詳細が含まれます。 |
| 環境に優しいルートを取得できない | 各交通手段のメタデータが含まれます。このメタデータには、その交通手段の手順の概要が stepsOverview に含まれています（このメタデータをリクエストするには、stepsOverview フィールド マスクを使用します）。 |
| トラフィック データを含める方法と含めるかどうかを指定できない | |
| 回避するルートの特徴を指定できない | |
transitPreferences のみを指定できます。詳細については、TransitPreference をご覧ください。 |
公共交通機関のルートを取得するには
- 出発地と目的地を設定します。
travelModeをTRANSITに設定します。- 必要なレスポンスを取得するには、適切なフィールド マスクを追加します。必要な交通機関のルート フィールドをリクエストするをご覧ください。
- 必要に応じて、オプション パラメータを設定します。交通機関のルートのパラメータを設定するをご覧ください。
必要な交通機関のルート フィールドをリクエストする
フィールド マスクを使用して、必要な交通機関のルート フィールドをリクエストします。次の表に、乗換ルートの推奨レスポンスと、それらをリクエストするために使用するフィールド マスクを示します。
| この情報をリクエストするには | このフィールド マスクを使用する |
|---|---|
| すべてのルートの詳細。 | * |
| 経路の区間の交通機関の詳細。 | legs |
| ルートの各ステップの推定料金と、ローカライズされた推定料金。 | travelAdvisory |
| 所要時間と距離のローカライズされたテキスト | localizedValues |
公共交通機関のルートのパラメータを設定する
公共交通機関のルートに関連するパラメータは次のとおりです。
| 操作 | このパラメータを使用する | メモ |
|---|---|---|
| 交通手段を選択する | travelMode: "TRANSIT" |
必須。詳細 |
| 到着時刻または出発時刻を設定する | arrivalTime: new Date(yyyy-mm-ddThh:mm:ssZ)
または departureTime: new Date(yyyy-mm-ddThh:mm:ssZ) |
省略可。到着時刻または出発時刻のいずれかを指定できます。どちらの時間も指定されていない場合は、departureTimeデフォルトは現在の実行時間（now ）。到着時刻と出発時刻は、現在の実行時刻（now ）を参照:
Date物体。
注: 公共交通機関のスケジュールは頻繁に変更されるため、利用可能な公共交通機関のルートは時間とともに変化する可能性があります。また、かなり先の予測については、一貫した結果が得られるとは限りません。 |
| 別の経路を含める | computeAlternativeRoutes: true |
省略可。true に設定すると、computeRoutes は利用可能な場合に最大 3 つの追加ルートを計算します。詳細 |
| 交通手段の条件を指定する | transitPreference: {allowedTransitModes: ["BUS", "SUBWAY", "TRAIN", "LIGHT_RAIL", "RAIL"]}
注: 優先する交通手段を指定した場合でも、返されるルートでは、優先する交通手段の効率や利用可能性に応じて、他の交通手段が使用されることがあります。 |
省略可。優先する交通手段を指定します。 詳細 |
| 乗換ルートの条件設定を指定する | transitPreference: {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} |
省略可。トランジット ルーティングの設定を指定します。詳細 |
リクエスト例
次の例は、交通機関のルートをリクエストする方法を示しています。
const request = { origin: 'Hunters Point San Francisco, CA 94124', destination: '201 Marine Dr, San Francisco, CA 94129', travelMode: 'TRANSIT', departureTime: new Date(), transitPreference: { allowedTransitModes: ['BUS', 'SUBWAY', 'TRAIN', 'LIGHT_RAIL', 'RAIL'], routingPreference: 'FEWER_TRANSFERS', // Alternatively, 'LESS_WALKING'. }, fields: ['path', 'legs', 'travelAdvisory', 'localizedValues'], };