設定沿途的停靠站

歐洲經濟區 (EEA) 開發人員

如要在路線上設定停靠點 (例如接送地點)，可以透過下列兩種方式：

  • 新增中途停靠點：這是預設選項。在 intermediates 陣列中，於起點和目的地之間新增中途停靠點。路徑引擎會將途中的停靠點對應至最近的可導航道路，並將路徑劃分為 RouteLeg 個路段，這些路段會由該停靠點連接。
  • 指定 vehicleStopover：如要讓路徑引擎執行額外分析，避免在不適合停車的路段 (例如高速公路、隧道或高架橋) 停車，請在路徑點上設定 vehicleStopover: true。

新增中途航點

如要設定路線中的停靠點，請在要求中的 intermediates 陣列新增中途航點。

新增中途停靠點會產生下列影響：

  • 路線會分成RouteLeg多個路段：每個路段會連接一個停靠站到下一個停靠站。
  • 座標會對齊道路：路徑引擎會將您的經緯度座標 (可能位於屋頂或庭院) 對齊最近的可導航路段。

對於許多平面道路，貼齊最近的道路可提供實用的停靠位置。不過，路段對齊功能不會判斷該路段是否適合靠邊停車，例如最近的道路是高速公路或隧道時。

範例：新增中途路線點

以下範例說明如何透過在 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

標準中途停靠點會自動對齊最近的道路，但該道路不一定適合車輛停靠。如要讓路徑引擎執行額外分析，評估道路是否適合上車或下車，請在路徑點上設定 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'

如要進一步瞭解路線控點類型和選項，請參閱路線控點類型和選項。