Maps JavaScript API 的 Routes Library 包含 Route 和 RouteMatrix 類別,可取代舊版 DirectionsService 和 DistanceMatrixService 物件。使用 google.maps.importLibrary("routes") 在網頁應用程式中載入程式庫 (請參閱「使用用戶端 SDK」,瞭解瀏覽器應用程式為何應使用這個程式庫,而非直接呼叫 https://routes.googleapis.com 網路服務)。
Route 類別
Route 類別提供 computeRoutes() 方法,可傳回兩個地點之間的理想路線。提供多個地點之間的大眾運輸、單車、開車、2 輪機動車輛或步行路線和即時路況。
RouteMatrix 類別
RouteMatrix 類別會傳回不同起點和目的地位置之間路線矩陣的距離和行程時間。計算多個目的地之間的行程時間和距離,最多可包含 625 個路線元素。
選擇適合您用途的類別
- 規劃有多個停靠點的路線:請使用
Route.computeRoutes()。支援中途路線控點、停靠點最佳化、替代路線和過路費預估。如要在 2D 地圖上繪製路線,請呼叫createPolylines()和createWaypointAdvancedMarkers()。如要在 3D 地圖上算繪路線,請使用Route3DElement(<gmp-route-3d>) 網頁元件,或呼叫create3DPolylines()、createPopover()和createWaypointMarkers()。 - 派遣和最近地點比對:使用
RouteMatrix.computeRouteMatrix()比較多個起點和目的地之間的行程時間和距離,最多可包含 625 個路線元素。例如,指派距離最近的司機前往載客,或選擇距離最近的倉庫出貨。