ルート沿いの停車地を設定

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

ルートに沿って、乗車または降車などの立ち寄り場所を設定するには、次の 2 つの方法があります。

  • 経由地を追加: デフォルトではこのオプションが選択されています。intermediates 配列の出発地と目的地の間に中間経由地を追加します。ルーティング エンジンは、経由地を最も近いナビゲーション可能な道路にスナップし、ルートをその経由地で接続された RouteLeg セグメントに分割します。
  • vehicleStopover を指定する: ルーティング エンジンで、高速道路、トンネル、高架橋など、停車に適さない道路区間を回避するための追加分析を行う場合は、経由地に vehicleStopover: true を設定します。

経由地を追加する

ルートに経由地を設定するには、リクエストの intermediates 配列に中間経由地を追加します。

中間地点を追加すると、次のような影響があります。

  • ルートは RouteLeg 個のセグメントに分割されます。各セグメントは 1 つの停留所を次の停留所に接続します。
  • 座標が道路にスナップされる: ルート エンジンは、屋上や庭にある可能性のある緯度と経度の座標を、最も近いナビゲーション可能な道路セグメントにスナップします。

多くの一般道では、最寄りの道路にスナップすることで、実用的な停車位置が提供されます。ただし、スナップでは、最寄りの道路が高速道路やトンネルである場合など、その道路区間が停車に適しているかどうかは判断されません。

例: 中間地点を追加する

次の例は、computeRoutes POST リクエストで中間地点を追加して、ルートに沿って経由地を設定する方法を示しています。

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

中間経由地とルート区間の詳細については、中間経由地を設定するをご覧ください。

乗車地と降車地の適合性を指定する

標準の中間ウェイポイントは最も近い道路にスナップされますが、その道路が車両の停止に適しているとは限りません。ルート エンジンで追加の分析を行い、乗車または降車に適した道路を評価する場合は、経由地に vehicleStopover: true を設定します。

vehicleStopover: true を設定すると、ルーティング エンジンは候補となる道路セグメントを評価し、高速道路、トンネル、高架道路など、停車に適さない道路を回避しようとします。

たとえば、トンネル内の高速道路の真上を一般道路が通っている場所を考えてみましょう。 * 標準の中間地点: 座標に幾何学的に近い場合は、下の高速道路またはトンネルにスナップされます。* 車両の立ち寄り: 高速道路やトンネルを迂回するための追加の分析を行い、停車に適した一般道路に立ち寄りをスナップします。

例: 経由地に vehicleStopover を指定する

次の例は、完全な POST リクエストの中間経由地に vehicleStopover: true を設定する方法を示しています。

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      },
      "vehicleStopover": true
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

地点のタイプとオプションの詳細については、地点のタイプとオプションをご覧ください。