Route

Lớp Route

Lớp google.maps.routes.Route

Chứa một tuyến đường, bao gồm một loạt các đoạn đường được kết nối với nhau, nối các điểm tham chiếu bắt đầu, kết thúc và trung gian.

Truy cập bằng cách gọi const {Route} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
computeRoutes
computeRoutes(request)
Tham số: 
Giá trị trả về:  Promise<{
  routes:Array<Route> optional,
  fallbackInfo:FallbackInfo optional,
  geocodingResults:GeocodingResults optional
}>
Trả về tuyến đường chính cùng với các tuyến đường thay thế (không bắt buộc), dựa trên một tập hợp các điểm tham chiếu cuối và trung gian.

Lưu ý: Phương thức này yêu cầu bạn chỉ định một mặt nạ trường phản hồi trong yêu cầu bằng cách đặt thuộc tính ComputeRoutesRequest.fields. Giá trị là danh sách các đường dẫn trường.

Ví dụ:
  • Mặt nạ trường (field mask) của tất cả các trường hiện có: fields: ['*']
  • Mặt nạ trường của thời gian, khoảng cách và đường đi ở cấp tuyến đường: fields: ['durationMillis', 'distanceMeters', 'path']

Bạn không nên sử dụng mặt nạ trường phản hồi ký tự đại diện fields: ['*'] vì:
  • Việc chỉ chọn những trường bạn cần sẽ giúp máy chủ của chúng tôi tiết kiệm chu kỳ tính toán, nhờ đó chúng tôi có thể trả về kết quả cho bạn với độ trễ thấp hơn.
  • Việc chỉ chọn những trường bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và những trường mới đó có thể cần thêm thời gian tính toán. Nếu chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể gặp phải tình trạng giảm hiệu suất vì mọi trường mới mà chúng tôi thêm vào sẽ tự động được đưa vào phản hồi.
  • Việc chỉ chọn những trường bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tải nhanh hơn qua mạng.
description
Loại:  string optional
Nội dung mô tả tuyến đường.
distanceMeters
Loại:  number optional
Quãng đường di chuyển của tuyến đường, tính bằng mét.
durationMillis
Loại:  number optional
Thời gian cần thiết để di chuyển theo tuyến đường, tính bằng mili giây. Nếu bạn đặt ComputeRoutesRequest.routingPreference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với Route.staticDurationMillis. Nếu bạn đặt ComputeRoutesRequest.routingPreference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính toán dựa trên tình trạng giao thông.

Lưu ý: Nếu thời lượng vượt quá 2^53 mili giây, thì giá trị này là Number.POSITIVE_INFINITY.
legs
Loại:  Array<RouteLeg> optional
Tập hợp các chặng (đoạn đường giữa các điểm tham chiếu) tạo nên tuyến đường. Mỗi chặng tương ứng với chuyến đi giữa hai điểm tham chiếu không phải via.

Ví dụ:
  • Một tuyến đường không có điểm tham chiếu trung gian chỉ có một chặng.
  • Một tuyến đường bao gồm một điểm tham chiếu trung gian không phải via có hai chặng.
  • Một tuyến đường bao gồm một điểm tham chiếu trung gian via sẽ có một chặng.
Thứ tự của các chặng khớp với thứ tự của các điểm tham chiếu từ origin đến intermediates đến destination.
localizedValues
Loại:  RouteLocalizedValues optional
Biểu diễn văn bản của các thuộc tính của Route.
optimizedIntermediateWaypointIndices
Loại:  Array<number> optional
Nếu bạn đặt ComputeRoutesRequest.optimizeWaypointOrder thành true, thì trường này sẽ chứa thứ tự tối ưu của các điểm tham chiếu trung gian. Nếu không, trường này sẽ trống. Chỉ mục bắt đầu bằng 0 cho điểm tham chiếu trung gian đầu tiên được cung cấp trong dữ liệu đầu vào.

Ví dụ: nếu bạn nhập:
  • Nguồn gốc: LA
  • Điểm tham chiếu trung gian: Dallas, Bangor, Phoenix
  • Điểm đến: New York
và thứ tự điểm tham chiếu trung gian được tối ưu hoá là Phoenix, Dallas, Bangor, thì trường này sẽ là [2, 0, 1].
path
Loại:  Array<LatLngAltitude> optional
Danh sách LatLngAltitude của tuyến đường, có thể dùng để vẽ một hình nhiều đường của tuyến đường. Bạn có thể kiểm soát độ chi tiết của đường dẫn bằng cách đặt ComputeRoutesRequest.polylineQuality.
polylineDetails
Loại:  PolylineDetails optional
Chứa thông tin về các chi tiết dọc theo đường dẫn.
routeLabels
Loại:  Array<RouteLabel> optional
Nhãn cho tuyến đường, hữu ích để xác định các thuộc tính cụ thể hoặc để so sánh với các tuyến đường khác.
routeToken
Loại:  string optional
Mã thông báo mờ có thể được truyền đến SDK Điều hướng để tạo lại tuyến đường trong quá trình điều hướng và trong trường hợp định tuyến lại, hãy tuân thủ ý định ban đầu khi tuyến đường được tạo. Hãy coi mã thông báo này là một blob mờ. Đừng so sánh giá trị của trường này giữa các yêu cầu vì giá trị có thể thay đổi ngay cả khi dịch vụ trả về cùng một tuyến đường.

Lưu ý: routeToken chỉ áp dụng cho những yêu cầu đã đặt ComputeRoutesRequest.routingPreference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL. Tính năng này không được hỗ trợ cho các yêu cầu có via điểm tham chiếu.
speedPaths
Loại:  Array<SpeedPath> optional
Nhóm các phần của tuyến đường với thông tin đọc tốc độ tương ứng. Để điền vào trường này, bạn phải đặt ComputeRoutesRequest.routingPreference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL và ComputeRoutesRequest.extraComputations phải bao gồm TRAFFIC_ON_POLYLINE.
staticDurationMillis
Loại:  number optional
Thời gian di chuyển trên tuyến đường mà không tính đến tình trạng giao thông.

Lưu ý: Nếu thời lượng vượt quá 2^53 mili giây, thì giá trị này là Number.POSITIVE_INFINITY.
travelAdvisory
Loại:  RouteTravelAdvisory optional
Thông tin bổ sung về tuyến đường.
viewport
Loại:  LatLngBounds optional
Hộp giới hạn khung nhìn của tuyến đường.
warnings
Loại:  Array<string> optional
Một mảng cảnh báo sẽ xuất hiện khi hiển thị tuyến đường.
createPolylines
createPolylines([options])
Tham số: 
Giá trị trả về:  Array<Polyline>
Tạo hình nhiều đường cho tuyến đường dựa trên dữ liệu có sẵn.

Đường đa phương thức:
  • Yêu cầu:
  • Tạo một hình nhiều đường cho mỗi đoạn tuyến đường đa phương thức. Đường đa tuyến được tạo kiểu theo phương thức di chuyển của đoạn đường và dữ liệu tuyến phương tiện công cộng (nếu có). Bạn có thể truyền các tuỳ chọn để thay đổi kiểu hình nhiều đường dựa trên phương thức di chuyển và tuyến phương tiện công cộng.

Đường đa tuyến giao thông:
  • Yêu cầu:
  • Tạo một hình nhiều đường cho mỗi khoảng thời gian của tuyến đường khi chỉ số tốc độ khác với khoảng thời gian trước đó. Các đường đa tuyến được áp dụng kiểu mặc định dựa trên tốc độ. Bạn có thể truyền các tuỳ chọn để thay đổi kiểu hình nhiều đường dựa trên tốc độ.

Tổng số hình nhiều đường:
  • Yêu cầu:
  • Tạo một hình nhiều đường cho toàn bộ tuyến đường, áp dụng kiểu mặc định. Bạn có thể truyền các tuỳ chọn để thay đổi kiểu hình nhiều đường dựa trên phương thức di chuyển của tuyến đường. Để tuỳ chỉnh thêm, hãy tạo hình nhiều đường trực tiếp bằng Route.path hoặc RouteLeg.path.
createWaypointAdvancedMarkers
createWaypointAdvancedMarkers([options])
Tham số: 
Giá trị trả về:  Promise<Array<AdvancedMarkerElement>>
Tạo điểm đánh dấu cho tuyến đường được gắn nhãn "A", "B", "C", v.v. cho mỗi điểm tham chiếu. Điểm đánh dấu được áp dụng kiểu mặc định. Bạn có thể truyền các tuỳ chọn để thay đổi kiểu điểm đánh dấu dựa trên chỉ mục điểm đánh dấu hoặc thuộc tính của RouteLeg tương ứng. Tham số WaypointMarkerDetails.leg sẽ không được xác định nếu tuyến đường không có chặng nào.

Bạn phải yêu cầu trường "legs" trong ComputeRoutesRequest.fields để thêm các điểm trung gian.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Giao diện ComputeRoutesRequest

google.maps.routes.ComputeRoutesRequest giao diện

Yêu cầu về tuyến đường.
destination
Điểm đến của tuyến đường. Giá trị được truyền dưới dạng chuỗi có thể là địa chỉ, Plus Code hoặc tên tài nguyên Địa điểm. Giá trị độ cao không được xem xét khi tính toán tuyến đường.
fields
Loại:  Iterable<string>
Tập hợp các trường cần tìm nạp. Chỉ định ["*"] cho tất cả các trường.
origin
Điểm xuất phát của tuyến đường. Giá trị được truyền dưới dạng chuỗi có thể là địa chỉ, Plus Code hoặc tên tài nguyên Địa điểm. Giá trị độ cao không được xem xét khi tính toán tuyến đường.
arrivalTime optional
Loại:  Date optional
Thời gian đến.

Lưu ý: Bạn chỉ có thể đặt khi ComputeRoutesRequest.travelMode được đặt thành TRANSIT. Bạn có thể chỉ định ComputeRoutesRequest.departureTime hoặc ComputeRoutesRequest.arrivalTime, nhưng không được chỉ định cả hai. Bạn có thể xem các chuyến đi bằng phương tiện công cộng trong tối đa 7 ngày trước hoặc 100 ngày sau.
computeAlternativeRoutes optional
Loại:  boolean optional
Chỉ định xem có tính toán các tuyến đường thay thế ngoài tuyến đường chính hay không. Không có tuyến đường thay thế nào được trả về cho các yêu cầu có điểm trung gian.
departureTime optional
Loại:  Date optional
Thời gian khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời điểm bạn gửi yêu cầu.

Lưu ý: Bạn chỉ có thể chỉ định thời gian trong quá khứ khi ComputeRoutesRequest.travelMode được đặt thành TRANSIT. Bạn có thể xem các chuyến đi bằng phương tiện công cộng trong tối đa 7 ngày trước hoặc 100 ngày sau.
extraComputations optional
Danh sách các phép tính bổ sung có thể được dùng để hoàn tất yêu cầu.

Lưu ý: Những phép tính bổ sung này có thể trả về các trường bổ sung trong phản hồi. Bạn cũng phải chỉ định các trường bổ sung này trong ComputeRoutesRequest.fields để được trả về trong phản hồi.
intermediates optional
Loại:  Iterable<Waypoint> optional
Một tập hợp các điểm tham chiếu dọc theo tuyến đường (không bao gồm các điểm cuối), để dừng lại hoặc đi qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian.
language optional
Loại:  string optional
Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem bài viết Giá trị nhận dạng ngôn ngữ Unicode. Hãy xem phần Hỗ trợ ngôn ngữ để biết danh sách các ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ sẽ được suy luận từ chế độ cài đặt bản địa hoá của Google Maps JavaScript API. Nếu không, ngôn ngữ sẽ được suy luận từ vị trí của điểm xuất phát.
optimizeWaypointOrder optional
Loại:  boolean optional
Nếu bạn đặt thành true, dịch vụ sẽ cố gắng giảm thiểu tổng chi phí của tuyến đường bằng cách sắp xếp lại các điểm trung gian được chỉ định. Yêu cầu sẽ không thành công nếu có bất kỳ điểm trung gian nào là điểm đi qua. Sử dụng Route.optimizedIntermediateWaypointIndices trong phản hồi để tìm thứ tự mới. Nếu "optimizedIntermediateWaypointIndices" không được yêu cầu trong ComputeRoutesRequest.fields, thì yêu cầu sẽ không thành công. Nếu bạn đặt thành false, Route.optimizedIntermediateWaypointIndices trong phản hồi sẽ trống.
polylineQuality optional
Loại:  PolylineQuality optional
Chỉ định lựa chọn ưu tiên về chất lượng của hình nhiều đường.
region optional
Loại:  string optional
Mã khu vực, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Để biết thêm thông tin, hãy xem bài viết Miền cấp cao nhất theo mã quốc gia. Khi bạn không cung cấp giá trị này, khu vực sẽ được suy luận từ chế độ cài đặt bản địa hoá của Google Maps JavaScript API. Nếu không, khu vực sẽ được suy luận từ vị trí của nguồn gốc.
requestedReferenceRoutes optional
Loại:  Iterable<ReferenceRoute> optional
Chỉ định tuyến đường tham chiếu nào cần tính toán trong yêu cầu, ngoài tuyến đường mặc định. Tuyến đường tham chiếu là tuyến đường có mục tiêu tính toán tuyến đường khác với tuyến đường mặc định. Ví dụ: một phép tính tuyến đường tham chiếu FUEL_EFFICIENT sẽ xem xét nhiều thông số để tạo ra một tuyến đường tiết kiệm nhiên liệu tối ưu. Khi sử dụng tính năng này, hãy tìm biểu tượng Route.routeLabels trên các tuyến đường được đề xuất.
routeModifiers optional
Loại:  RouteModifiers optional
Một nhóm điều kiện cần đáp ứng, ảnh hưởng đến cách tính toán tuyến đường. Ví dụ: bạn có thể chỉ định các đặc điểm cần tránh, chẳng hạn như đường có thu phí hoặc đường cao tốc.
routingPreference optional
Loại:  RoutingPreference optional
Chỉ định cách tính tuyến đường. Máy chủ cố gắng sử dụng lựa chọn ưu tiên về tuyến đường đã chọn để tính toán tuyến đường. Nếu lựa chọn ưu tiên về định tuyến dẫn đến lỗi hoặc độ trễ quá dài, thì hệ thống sẽ trả về lỗi. Bạn chỉ có thể chỉ định lựa chọn này khi ComputeRoutesRequest.travelMode là DRIVING hoặc TWO_WHEELER, nếu không, yêu cầu sẽ không thành công.
trafficModel optional
Loại:  TrafficModel optional
Chỉ định các giả định cần sử dụng khi tính toán thời gian trong tình trạng giao thông. Chế độ cài đặt này ảnh hưởng đến giá trị của Route.durationMillis và RouteLeg.durationMillis, trong đó có thời gian dự kiến trong tình trạng giao thông dựa trên mức trung bình trước đây. ComputeRoutesRequest.trafficModel chỉ áp dụng cho những yêu cầu đã đặt ComputeRoutesRequest.routingPreference thành TRAFFIC_AWARE_OPTIMAL và ComputeRoutesRequest.travelMode thành DRIVING. Giá trị mặc định là BEST_GUESS.
transitPreference optional
Loại:  TransitPreference optional
Chỉ định các lựa chọn ưu tiên ảnh hưởng đến tuyến đường được trả về cho tuyến đường TRANSIT.

Lưu ý: Bạn chỉ có thể chỉ định khi ComputeRoutesRequest.travelMode được đặt thành TRANSIT.
travelMode optional
Loại:  TravelMode optional
Chỉ định phương thức di chuyển.
units optional
Loại:  UnitSystem optional
Chỉ định đơn vị đo lường cho các trường hiển thị, chẳng hạn như hướng dẫn chỉ đường. Đơn vị đo lường dùng cho tuyến đường, chặng, khoảng cách bước và thời lượng không chịu ảnh hưởng của giá trị này. Nếu bạn không cung cấp giá trị này, thì đơn vị hiển thị sẽ được suy luận từ vị trí của điểm xuất phát.

Hằng số ComputeRoutesExtraComputation

hằng số google.maps.routes.ComputeRoutesExtraComputation

Các phép tính bổ sung cần thực hiện cho một yêu cầu Route.computeRoutes.

Truy cập bằng cách gọi const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
FLYOVER_INFO_ON_POLYLINE Thông tin về cầu vượt cho(các) tuyến đường. Bạn phải chỉ định trường "polylineDetails" trong ComputeRoutesRequest.fields để trả về thông tin này. Dữ liệu này hiện chỉ được điền sẵn cho một số thành phố lớn ở Ấn Độ. Tính năng này đang trong giai đoạn thử nghiệm, nên SKU/khoản phí có thể thay đổi.
FUEL_CONSUMPTION Mức tiêu thụ nhiên liệu ước tính cho(các) tuyến đường.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS Hướng dẫn điều hướng được trình bày dưới dạng chuỗi văn bản HTML được định dạng. Nội dung này chỉ dùng để đọc và hiển thị. Đừng phân tích cú pháp theo phương thức lập trình.
NARROW_ROAD_INFO_ON_POLYLINE Thông tin về đường hẹp cho(các) tuyến đường. Bạn phải chỉ định trường "polylineDetails" trong ComputeRoutesRequest.fields để trả về thông tin này. Dữ liệu này hiện chỉ được điền cho một số thành phố lớn ở Ấn Độ. Tính năng này đang trong giai đoạn thử nghiệm, nên SKU/phí có thể thay đổi.
TOLLS Thông tin về phí cầu đường cho(các) tuyến đường.
TRAFFIC_ON_POLYLINE Hình nhiều đường thể hiện tình hình giao thông cho(các) tuyến đường.

Giao diện DirectionalLocationLiteral

google.maps.routes.DirectionalLocationLiteral giao diện

Bạn có thể sử dụng đối tượng chữ thay cho các thực thể DirectionalLocation để thuận tiện hơn. Các giá trị này được chuyển đổi thành DirectionalLocation khi API JS của Maps gặp phải.

Giao diện này mở rộng LatLngAltitudeLiteral.

heading optional
Loại:  number optional
Hướng la bàn liên quan đến hướng của luồng giao thông. Giá trị hướng có thể là các số từ 0 đến 360, trong đó 0 chỉ định hướng chính Bắc, 90 chỉ định hướng chính Đông, v.v. Bạn chỉ có thể sử dụng trường này cho DRIVING và TWO_WHEELER ComputeRoutesRequest.travelMode.
Được kế thừa: altitude, lat, lng

Lớp DirectionalLocation

Lớp google.maps.routes.DirectionalLocation

Đóng gói một điểm địa lý và một tiêu đề không bắt buộc.

Lớp này mở rộng LatLngAltitude.

Lớp này triển khai DirectionalLocationLiteral.

Truy cập bằng cách gọi const {DirectionalLocation} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
Được kế thừa: LatLngAltitude
heading
Loại:  number optional
Hướng la bàn liên quan đến hướng của luồng giao thông. Giá trị hướng có thể là các số từ 0 đến 360, trong đó 0 chỉ định hướng chính Bắc, 90 chỉ định hướng chính Đông, v.v. Bạn chỉ có thể sử dụng trường này cho DRIVING và TWO_WHEELER ComputeRoutesRequest.travelMode.
Được kế thừa: altitude, lat, lng
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  DirectionalLocationLiteral
Chuyển đổi thành một đối tượng.
Được kế thừa: equals

Lớp FallbackInfo

Lớp google.maps.routes.FallbackInfo

Thông tin liên quan đến cách thức và lý do kết quả dự phòng được sử dụng trong một phản hồi của Route.computeRoutes. Nếu trường này được đặt, thì tức là máy chủ đã sử dụng một chế độ định tuyến khác với chế độ ưu tiên của bạn làm phương án dự phòng.

Truy cập bằng cách gọi const {FallbackInfo} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
reason
Loại:  FallbackReason optional
Lý do sử dụng phản hồi dự phòng thay vì phản hồi ban đầu. Trường này chỉ được điền sẵn khi chế độ dự phòng được kích hoạt và phản hồi dự phòng được trả về.
routingMode
Loại:  FallbackRoutingMode optional
Chế độ định tuyến được dùng cho phản hồi. Nếu chế độ dự phòng được kích hoạt, thì chế độ này có thể khác với lựa chọn ưu tiên về tuyến đường được đặt trong yêu cầu ban đầu của ứng dụng.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Hằng số FallbackReason

hằng số google.maps.routes.FallbackReason

Lý do trả về phản hồi dự phòng trong phản hồi Route.computeRoutes.

Truy cập bằng cách gọi const {FallbackReason} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
LATENCY_EXCEEDED Chúng tôi không thể hoàn tất việc tính toán bằng chế độ định tuyến mà bạn ưu tiên đúng hạn, nhưng chúng tôi có thể trả về kết quả được tính toán bằng một chế độ khác.
SERVER_ERROR Đã xảy ra lỗi phía máy chủ khi tính toán tuyến đường bằng chế độ định tuyến ưu tiên của bạn, nhưng chúng tôi có thể trả về kết quả được tính toán bằng một chế độ khác.

Hằng số FallbackRoutingMode

hằng số google.maps.routes.FallbackRoutingMode

Chế độ định tuyến thực tế được sử dụng khi phản hồi dự phòng được trả về trong phản hồi Route.computeRoutes.

Truy cập bằng cách gọi const {FallbackRoutingMode} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
TRAFFIC_AWARE Cho biết TRAFFIC_AWARE RoutingPreference đã được dùng để tính toán câu trả lời.
TRAFFIC_UNAWARE Cho biết TRAFFIC_UNAWARE RoutingPreference đã được dùng để tính toán phản hồi.

Lớp GeocodedWaypoint

Lớp google.maps.routes.GeocodedWaypoint

Mã hoá địa lý về các vị trí được dùng làm điểm tham chiếu. Chỉ được điền sẵn cho điểm tham chiếu địa chỉ. Bao gồm thông tin chi tiết về kết quả mã hoá địa lý nhằm mục đích xác định địa chỉ được mã hoá địa lý.

Truy cập bằng cách gọi const {GeocodedWaypoint} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
geocoderStatus
Loại:  RPCStatus optional
Cho biết mã trạng thái do thao tác mã hoá địa lý.
intermediateWaypointRequestIndex
Loại:  number optional
Chỉ mục của điểm tham chiếu trung gian tương ứng trong yêu cầu. Chỉ được điền sẵn nếu điểm tham chiếu tương ứng là điểm tham chiếu trung gian.
partialMatch
Loại:  boolean
Cho biết rằng bộ mã hoá địa lý không trả về kết quả khớp chính xác cho yêu cầu ban đầu, mặc dù có thể khớp một phần địa chỉ được yêu cầu. Bạn nên kiểm tra yêu cầu ban đầu để xem có lỗi chính tả và/hoặc địa chỉ chưa đầy đủ hay không.
placeId
Loại:  string
Mã địa điểm cho kết quả này.
types
Loại:  Array<string>
(Các) loại kết quả, dưới dạng không hoặc nhiều thẻ loại. Hãy xem https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types để biết các loại được hỗ trợ.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp GeocodingResults

Lớp google.maps.routes.GeocodingResults

Chứa GeocodedWaypoint cho điểm xuất phát, điểm đến và điểm tham chiếu trung gian. Chỉ được điền sẵn cho điểm tham chiếu địa chỉ.

Truy cập bằng cách gọi const {GeocodingResults} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
destination
Loại:  GeocodedWaypoint optional
Điểm tham chiếu được mã hoá địa lý cho điểm đến.
intermediates
Loại:  Array<GeocodedWaypoint> optional
Danh sách các điểm tham chiếu được mã hoá địa lý trung gian, mỗi điểm chứa một trường chỉ mục tương ứng với vị trí dựa trên số 0 của điểm tham chiếu theo thứ tự được chỉ định trong yêu cầu.
origin
Loại:  GeocodedWaypoint optional
Điểm tham chiếu được mã hoá địa lý cho điểm xuất phát.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp MultiModalSegment

Lớp google.maps.routes.MultiModalSegment

Cung cấp thông tin tóm tắt về một đoạn đa phương thức của RouteLeg.steps của một tuyến đường. Một phân đoạn đa phương thức được định nghĩa là một hoặc nhiều RouteLegStep liền kề có cùng TravelMode.

Truy cập bằng cách gọi const {MultiModalSegment} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
instructions
Loại:  string optional
Hướng dẫn đi theo chặng đa phương thức này.
maneuver
Loại:  string optional
Thao tác điều hướng cần thực hiện ở bước này. Hãy xem Thao tác để biết danh sách các giá trị có thể có.
stepEndIndex
Loại:  number
Chỉ mục RouteLegStep tương ứng là điểm kết thúc của một chặng bay đa phương thức.
stepStartIndex
Loại:  number
Chỉ mục RouteLegStep tương ứng là điểm bắt đầu của một phân đoạn đa phương thức.
travelMode
Loại:  TravelMode optional
Phương thức di chuyển được dùng cho phân đoạn đa phương thức này.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp PolylineDetailInfo

Lớp google.maps.routes.PolylineDetailInfo

Đóng gói thông tin về một đối tượng đường dọc theo một đoạn của hình nhiều đường.

Truy cập bằng cách gọi const {PolylineDetailInfo} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
endIndex
Loại:  number optional
Chỉ mục kết thúc của đối tượng đường này trong hình nhiều đường.
presence
Loại:  RoadFeatureState optional
Cho biết liệu đối tượng đường có tồn tại dọc theo hình nhiều đường hay không.
startIndex
Loại:  number optional
Chỉ mục bắt đầu của đối tượng đường này trong hình nhiều đường.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp PolylineDetails

Lớp google.maps.routes.PolylineDetails

Thông tin chi tiết tương ứng với một chỉ mục hoặc đoạn liền kề nhất định của một hình nhiều đường. Với một hình nhiều đường có các điểm P_0, P_1, ... , P_N (chỉ mục dựa trên số 0), PolylineDetails mô tả một đối tượng đường cho một khoảng thời gian nhất định.

Truy cập bằng cách gọi const {PolylineDetails} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
flyoverInfo
Thông tin chi tiết về chuyến bay dọc theo hình nhiều đường.
narrowRoadInfo
Thông tin chi tiết về đường hẹp dọc theo hình nhiều đường.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Hằng số PolylineQuality

hằng số google.maps.routes.PolylineQuality

Chỉ định chất lượng của hình nhiều đường.

Truy cập bằng cách gọi const {PolylineQuality} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
HIGH_QUALITY Chỉ định một hình nhiều đường chất lượng cao được tạo bằng nhiều điểm hơn OVERVIEW, nhưng kích thước phản hồi sẽ tăng lên. Hãy sử dụng giá trị này khi bạn cần độ chính xác cao hơn.
OVERVIEW Chỉ định một hình nhiều đường tổng quan được tạo bằng một số ít điểm. Khi sử dụng lựa chọn này, độ trễ của yêu cầu sẽ thấp hơn so với HIGH_QUALITY. Sử dụng giá trị này khi hiển thị thông tin tổng quan về tuyến đường.

Hằng số ReferenceRoute

hằng số google.maps.routes.ReferenceRoute

Tuyến đường tham chiếu được hỗ trợ trên ComputeRoutesRequest.

Truy cập bằng cách gọi const {ReferenceRoute} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
FUEL_EFFICIENT Tuyến đường tiết kiệm nhiên liệu.
SHORTER_DISTANCE Tuyến đường có quãng đường di chuyển ngắn hơn.

Hằng số RoadFeatureState

hằng số google.maps.routes.RoadFeatureState

Đóng gói trạng thái của các đối tượng đường dọc theo một đoạn hình nhiều đường.

Truy cập bằng cách gọi const {RoadFeatureState} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
DOES_NOT_EXIST Đối tượng đường không tồn tại.
EXISTS Đường này có tồn tại.

Hằng số RouteLabel

hằng số google.maps.routes.RouteLabel

Nhãn cho tuyến đường, hữu ích để xác định các thuộc tính cụ thể để so sánh với các thuộc tính khác.

Truy cập bằng cách gọi const {RouteLabel} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
DEFAULT_ROUTE Tuyến đường "tốt nhất" mặc định được trả về cho phép tính tuyến đường.
DEFAULT_ROUTE_ALTERNATE Tuyến đường thay thế cho tuyến đường "tốt nhất" mặc định. Các tuyến đường như thế này sẽ được trả về khi bạn chỉ định ComputeRoutesRequest.computeAlternativeRoutes.
FUEL_EFFICIENT Tuyến đường tiết kiệm nhiên liệu. Các tuyến đường được gắn nhãn bằng giá trị này được xác định là tối ưu hoá cho các thông số sinh thái như mức tiêu thụ nhiên liệu.
SHORTER_DISTANCE Tuyến đường có quãng đường di chuyển ngắn hơn. Đây là tính năng thử nghiệm.

Lớp RouteLeg

Lớp google.maps.routes.RouteLeg

Chứa một đoạn giữa các điểm tham chiếu không phải via.

Truy cập bằng cách gọi const {RouteLeg} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
distanceMeters
Loại:  number
Quãng đường di chuyển của chặng trong tuyến đường, tính bằng mét.
durationMillis
Loại:  number optional
Thời gian cần thiết để di chuyển trên chặng của tuyến đường, tính bằng mili giây. Nếu bạn đặt ComputeRoutesRequest.routingPreference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với staticDurationMillis. Nếu bạn đặt ComputeRoutesRequest.routingPreference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính toán dựa trên tình trạng giao thông.

Lưu ý: Nếu thời lượng vượt quá 2^53 mili giây, thì giá trị này là Number.POSITIVE_INFINITY.
endLocation
Loại:  DirectionalLocation optional
Vị trí kết thúc của chặng này. Vị trí này có thể khác với ComputeRoutesRequest.destination. Ví dụ: khi ComputeRoutesRequest.destination không ở gần đường, đây là một điểm trên đường.
localizedValues
Loại:  RouteLegLocalizedValues optional
Biểu diễn văn bản của các thuộc tính của RouteLeg.
path
Danh sách LatLngAltitude của chặng hành trình, có thể dùng để vẽ hình nhiều đường của chặng hành trình. Bạn có thể kiểm soát độ chi tiết của đường dẫn bằng cách đặt ComputeRoutesRequest.polylineQuality.
speedPaths
Loại:  Array<SpeedPath>
Nhóm các phần của đường dẫn chặng tuyến đường với thông tin đọc tốc độ tương ứng. Để điền vào trường này, bạn phải đặt ComputeRoutesRequest.routingPreference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL và ComputeRoutesRequest.extraComputations phải bao gồm TRAFFIC_ON_POLYLINE.
startLocation
Loại:  DirectionalLocation optional
Vị trí bắt đầu của chặng này. Vị trí này có thể khác với ComputeRoutesRequest.origin. Ví dụ: khi ComputeRoutesRequest.origin không ở gần đường, đây là một điểm trên đường.
staticDurationMillis
Loại:  number optional
Thời gian di chuyển qua chặng mà không tính đến tình trạng giao thông.

Lưu ý: Nếu thời lượng vượt quá 2^53 mili giây, thì giá trị này là Number.POSITIVE_INFINITY.
steps
Loại:  Array<RouteLegStep>
Một mảng các bước biểu thị các phân đoạn trong chặng này. Mỗi bước đại diện cho một chỉ dẫn đi theo chỉ dẫn.
stepsOverview
Loại:  StepsOverview optional
Thông tin tổng quan về các bước trong RouteLeg này. Trường này chỉ được điền sẵn cho các tuyến TRANSIT.
travelAdvisory
Loại:  RouteLegTravelAdvisory optional
Chứa thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như các quy định hạn chế có thể áp dụng cho khu vực giao thông, trên một chặng của tuyến đường.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp RouteLegLocalizedValues

Lớp google.maps.routes.RouteLegLocalizedValues

Biểu diễn văn bản của RouteLeg.

Truy cập bằng cách gọi const {RouteLegLocalizedValues} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
distance
Loại:  string optional
Khoảng cách di chuyển của chặng tuyến đường ở dạng văn bản.
distanceLanguage
Loại:  string optional
Mã ngôn ngữ BCP-47 của văn bản khoảng cách, chẳng hạn như "en-US" hoặc "sr-Latn".

Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
Loại:  string optional
Thời lượng, được biểu thị dưới dạng văn bản và được bản địa hoá theo khu vực của cụm từ tìm kiếm. Xem xét tình trạng giao thông.
durationLanguage
Loại:  string optional
Mã ngôn ngữ BCP-47 của văn bản về thời lượng, chẳng hạn như "en-US" hoặc "sr-Latn".

Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
Loại:  string optional
Thời lượng không tính đến tình trạng giao thông, được biểu thị dưới dạng văn bản.
staticDurationLanguage
Loại:  string optional
Mã ngôn ngữ BCP-47 của văn bản thời lượng tĩnh, chẳng hạn như "en-US" hoặc "sr-Latn".
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp RouteLegStep

Lớp google.maps.routes.RouteLegStep

Chứa một phân đoạn của RouteLeg. Một bước tương ứng với một chỉ dẫn điều hướng duy nhất. Chặng của tuyến đường bao gồm các bước.

Truy cập bằng cách gọi const {RouteLegStep} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
distanceMeters
Loại:  number
Quãng đường di chuyển của bước này, tính bằng mét.
endLocation
Loại:  DirectionalLocation optional
Vị trí kết thúc của bước này.
instructions
Loại:  string optional
Hướng dẫn thực hiện bước này.
localizedValues
Loại:  RouteLegStepLocalizedValues optional
Biểu diễn văn bản của các thuộc tính của RouteLegStep.
maneuver
Loại:  string optional
Thao tác điều hướng cần thực hiện ở bước này. Hãy xem Thao tác để biết danh sách các giá trị có thể có.
path
Danh sách LatLngAltitude của bước chặng tuyến đường, có thể dùng để vẽ hình nhiều đường của bước chặng tuyến đường. Bạn có thể kiểm soát độ chi tiết của đường dẫn bằng cách đặt ComputeRoutesRequest.polylineQuality. Bạn phải yêu cầu trường "path" trong ComputeRoutesRequest.fields để điền sẵn trường này.
startLocation
Loại:  DirectionalLocation optional
Vị trí bắt đầu của bước này.
staticDurationMillis
Loại:  number optional
Thời gian di chuyển qua bước này mà không tính đến tình trạng giao thông.

Lưu ý: Nếu thời lượng vượt quá 2^53 mili giây, thì giá trị này là Number.POSITIVE_INFINITY.
transitDetails
Loại:  TransitDetails optional
Thông tin chi tiết liên quan đến bước này nếu phương tiện di chuyển là TRANSIT.
travelMode
Loại:  TravelMode optional
Phương thức di chuyển được dùng cho bước này.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp RouteLegStepLocalizedValues

Lớp google.maps.routes.RouteLegStepLocalizedValues

Biểu diễn văn bản của các thuộc tính của RouteLegStep.

Truy cập bằng cách gọi const {RouteLegStepLocalizedValues} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
distance
Loại:  string optional
Khoảng cách di chuyển của bước chặng tuyến đường ở dạng văn bản.
distanceLanguage
Loại:  string optional
Mã ngôn ngữ BCP-47 của văn bản khoảng cách, chẳng hạn như "en-US" hoặc "sr-Latn".

Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
Loại:  string optional
Thời lượng không tính đến tình trạng giao thông, được biểu thị dưới dạng văn bản.
staticDurationLanguage
Loại:  string optional
Mã ngôn ngữ BCP-47 của văn bản thời lượng tĩnh, chẳng hạn như "en-US" hoặc "sr-Latn".

Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp RouteLegTravelAdvisory

Lớp google.maps.routes.RouteLegTravelAdvisory

Chứa thông tin bổ sung mà người dùng cần được thông báo trên RouteLeg.

Truy cập bằng cách gọi const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
speedReadingIntervals
Loại:  Array<SpeedReadingInterval> optional
Khoảng thời gian đọc tốc độ cho biết chi tiết về mật độ giao thông. Áp dụng trong trường hợp TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference. Các khoảng thời gian bao phủ toàn bộ hình nhiều đường của RouteLeg mà không bị chồng chéo. Điểm bắt đầu của một khoảng thời gian cụ thể giống với điểm kết thúc của khoảng thời gian trước đó.

Ví dụ: 
  polyline: A ---- B ---- C ---- D ---- E ---- F ---- G 
 speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo
Loại:  TollInfo optional
Chứa thông tin về phí cầu đường trên RouteLeg cụ thể. Trường này chỉ được điền sẵn nếu dự kiến có phí cầu đường trên RouteLeg. Nếu bạn đặt trường này nhưng không điền TollInfo.estimatedPrices, thì chặng của tuyến đường sẽ có phí cầu đường nhưng không biết giá ước tính. Nếu trường này trống, thì không có phí cầu đường trên RouteLeg.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp RouteLocalizedValues

Lớp google.maps.routes.RouteLocalizedValues

Biểu diễn văn bản của các thuộc tính của Route.

Truy cập bằng cách gọi const {RouteLocalizedValues} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
distance
Loại:  string optional
Khoảng cách di chuyển của tuyến đường được biểu thị dưới dạng văn bản.
distanceLanguage
Loại:  string optional
Mã ngôn ngữ BCP-47 của văn bản khoảng cách, chẳng hạn như "en-US" hoặc "sr-Latn".

Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
Loại:  string optional
Thời lượng, được biểu thị dưới dạng văn bản và được bản địa hoá theo khu vực của cụm từ tìm kiếm. Xem xét tình trạng giao thông. Lưu ý: Nếu bạn không yêu cầu thông tin về tình trạng giao thông, thì giá trị này sẽ giống với giá trị của staticDuration.
durationLanguage
Loại:  string optional
Mã ngôn ngữ BCP-47 của văn bản về thời lượng, chẳng hạn như "en-US" hoặc "sr-Latn".

Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
Loại:  string optional
Thời lượng không tính đến tình trạng giao thông, được biểu thị dưới dạng văn bản.
staticDurationLanguage
Loại:  string optional
Mã ngôn ngữ BCP-47 của văn bản thời lượng tĩnh, chẳng hạn như "en-US" hoặc "sr-Latn".
transitFare
Loại:  string optional
Giá vé phương tiện công cộng được trình bày dưới dạng văn bản.
transitFareLanguage
Loại:  string optional
Mã ngôn ngữ BCP-47 của văn bản giá vé phương tiện công cộng, chẳng hạn như "en-US" hoặc "sr-Latn".
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Giao diện RouteModifiers

google.maps.routes.RouteModifiers giao diện

Đóng gói một tập hợp các điều kiện không bắt buộc cần đáp ứng khi tính toán tuyến đường.
avoidFerries optional
Loại:  boolean optional
Khi được đặt thành true, hệ thống sẽ tránh phà nếu hợp lý, ưu tiên các tuyến đường không có phà. Chỉ áp dụng cho DRIVING hoặc TWO_WHEELER TravelMode.
avoidHighways optional
Loại:  boolean optional
Khi được đặt thành true, hệ thống sẽ tránh đường cao tốc nếu hợp lý, ưu tiên các tuyến đường không có đường cao tốc. Chỉ áp dụng cho DRIVING hoặc TWO_WHEELER TravelMode.
avoidIndoor optional
Loại:  boolean optional
Khi được đặt thành true, tránh điều hướng trong nhà nếu có thể, ưu tiên các tuyến đường không chứa điều hướng trong nhà. Chỉ áp dụng cho WALKING TravelMode.
avoidTolls optional
Loại:  boolean optional
Khi được đặt thành true, hệ thống sẽ tránh các đường có thu phí nếu hợp lý, ưu tiên các tuyến đường không có đường có thu phí. Chỉ áp dụng cho DRIVING hoặc TWO_WHEELER TravelMode.
tollPasses optional
Loại:  Iterable<string> optional
Đóng gói thông tin về thẻ thu phí cầu đường. Nếu bạn cung cấp phí cầu đường, API sẽ cố gắng trả về giá phí. Nếu không cung cấp phí cầu đường, API sẽ coi phí cầu đường là không xác định và cố gắng trả về giá tiền mặt. Chỉ áp dụng cho DRIVING hoặc TWO_WHEELER TravelMode. Hãy xem TollPass để biết danh sách các giá trị hợp lệ.
vehicleInfo optional
Loại:  VehicleInfo optional
Chỉ định thông tin về xe.

Giao diện RoutePolylineDetails

google.maps.routes.RoutePolylineDetails giao diện

Thông tin chi tiết về một đoạn của tuyến đường tương ứng với một hình nhiều đường có thể dùng để tuỳ chỉnh kiểu hình nhiều đường.
speed optional
Loại:  Speed optional
Tốc độ đọc của đoạn đường tương ứng với hình nhiều đường này. Chỉ được điền sẵn cho các tuyến đường có thông tin về tình hình giao thông.
transitDetails optional
Loại:  TransitDetails optional
Thông tin chi tiết về phương tiện công cộng của đoạn đường tương ứng với hình nhiều đường này. Chỉ được điền sẵn cho các tuyến đường có thông tin về phương tiện công cộng.
travelMode optional
Loại:  TravelMode optional
Phương thức di chuyển của đoạn tuyến đường tương ứng với hình nhiều đường này. Để trống đối với hình nhiều đường thể hiện tình trạng giao thông.

Giao diện RoutePolylineOptions

google.maps.routes.RoutePolylineOptions giao diện

Các lựa chọn để tạo hình nhiều đường cho tuyến đường.
colorScheme optional
Loại:  ColorScheme optional
Bảng phối màu dùng cho hình nhiều đường. Khi được chỉ định là FOLLOW_SYSTEM trong khi bản đồ colorScheme cũng là FOLLOW_SYSTEM, thì các hình nhiều đường sẽ được vẽ ở cùng chế độ sáng/tối như bản đồ. Khi không được chỉ định, Route.createPolylines sẽ cố gắng sử dụng colorScheme của bản đồ hoặc quay lại theo giá trị mặc định của hệ thống.
polylineOptions optional
Các lựa chọn để tuỳ chỉnh kiểu của một hình nhiều đường. Có thể là một đối tượng PolylineOptions được áp dụng cho tất cả các hình nhiều đường của tuyến đường hoặc một hàm lấy PolylineOptions và RoutePolylineDetails mặc định rồi trả về PolylineOptions để áp dụng cho hình nhiều đường đó.

Lớp RouteTravelAdvisory

Lớp google.maps.routes.RouteTravelAdvisory

Chứa thông tin bổ sung mà người dùng cần được thông báo trên Route.

Truy cập bằng cách gọi const {RouteTravelAdvisory} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
fuelConsumptionMicroliters
Loại:  number optional
Mức tiêu thụ nhiên liệu dự đoán (tính bằng microlit).

Lưu ý: Nếu mức tiêu thụ nhiên liệu vượt quá 2^53 microlit, thì giá trị này là Number.POSITIVE_INFINITY.
routeRestrictionsPartiallyIgnored
Loại:  boolean optional
Route có thể có các quy định hạn chế không phù hợp với phương thức di chuyển hoặc đối tượng sửa đổi tuyến đường được yêu cầu.
speedReadingIntervals
Loại:  Array<SpeedReadingInterval> optional
Khoảng thời gian đọc tốc độ cho biết chi tiết về mật độ giao thông. Áp dụng trong trường hợp TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference. Các khoảng thời gian bao phủ toàn bộ hình nhiều đường của Route mà không bị chồng chéo. Điểm bắt đầu của một khoảng thời gian cụ thể giống với điểm kết thúc của khoảng thời gian trước đó.

Ví dụ: 
  polyline: A ---- B ---- C ---- D ---- E ---- F ---- G 
 speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo
Loại:  TollInfo optional
Chứa thông tin về phí cầu đường trên Route. Trường này chỉ được điền sẵn nếu dự kiến có phí cầu đường trên Route. Nếu bạn đặt trường này nhưng không điền TollInfo.estimatedPrices, thì tuyến đường có phí cầu đường nhưng không biết giá ước tính. Nếu trường này trống, thì không có phí cầu đường trên Route.
transitFare
Loại:  Money optional
Nếu có, thì trường này sẽ chứa tổng giá vé hoặc chi phí vé của Route này. Thuộc tính này chỉ được trả về cho TRANSIT ComputeRoutesRequest.travelMode và chỉ cho những tuyến đường có thông tin về giá vé cho tất cả các bước đi phương tiện công cộng.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Hằng số RoutingPreference

hằng số google.maps.routes.RoutingPreference

Các yếu tố cần cân nhắc khi tính toán tuyến đường.

Truy cập bằng cách gọi const {RoutingPreference} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
TRAFFIC_AWARE Tính toán tuyến đường dựa trên tình trạng giao thông trực tiếp. Trái ngược với TRAFFIC_AWARE_OPTIMAL, một số tính năng tối ưu hoá được áp dụng để giảm đáng kể độ trễ.
TRAFFIC_AWARE_OPTIMAL Tính toán các tuyến đường có tính đến tình trạng giao thông trực tiếp mà không áp dụng hầu hết các tính năng tối ưu hoá hiệu suất. Việc sử dụng giá trị này sẽ tạo ra độ trễ cao nhất.
TRAFFIC_UNAWARE Tính toán tuyến đường mà không xem xét tình trạng giao thông trực tiếp. Phù hợp khi tình trạng giao thông không quan trọng hoặc không áp dụng. Việc sử dụng giá trị này sẽ tạo ra độ trễ thấp nhất.

Hằng số Speed

hằng số google.maps.routes.Speed

Phân loại tốc độ của hình nhiều đường dựa trên dữ liệu giao thông.

Truy cập bằng cách gọi const {Speed} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
NORMAL Tốc độ bình thường, không bị chậm trễ do giao thông.
SLOW Phát hiện thấy tình trạng ùn tắc nhẹ, lưu lượng giao thông ở mức trung bình.
TRAFFIC_JAM Tình trạng chậm trễ giao thông.

Giao diện SpeedPath

google.maps.routes.SpeedPath giao diện

Nhóm các LatLngAltitude của một khoảng thời gian trên tuyến đường với chỉ số tốc độ cho khoảng thời gian đó.
path
Đường dẫn được bao gồm trong đường dẫn tốc độ này.
speed optional
Loại:  Speed optional
Tốc độ đọc của đường dẫn.

Lớp SpeedReadingInterval

Lớp google.maps.routes.SpeedReadingInterval

Chỉ báo mật độ giao thông trên một đoạn liền kề của hình nhiều đường hoặc đường dẫn. Cho một tuyến đường có các điểm P_0, P_1, ... , P_N (chỉ mục dựa trên số 0), SpeedReadingInterval mô tả mật độ giao thông của một khoảng thời gian.

Truy cập bằng cách gọi const {SpeedReadingInterval} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
endPolylinePointIndex
Loại:  number optional
Chỉ mục kết thúc của khoảng thời gian này trong hình nhiều đường.
speed
Loại:  Speed optional
Tốc độ lưu lượng truy cập trong khoảng thời gian này.
startPolylinePointIndex
Loại:  number optional
Chỉ mục bắt đầu của khoảng thời gian này trong hình nhiều đường.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Không có
Chuyển đổi thành một đối tượng.

Lớp StepsOverview

Lớp google.maps.routes.StepsOverview

Cung cấp thông tin tổng quan về danh sách RouteLeg.steps.

Truy cập bằng cách gọi const {StepsOverview} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
multiModalSegments
Thông tin tóm tắt về các phân đoạn đa phương thức của RouteLeg.steps.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp TollInfo

Lớp google.maps.routes.TollInfo

Đóng gói thông tin về phí cầu đường trên Route hoặc RouteLeg.

Truy cập bằng cách gọi const {TollInfo} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
estimatedPrices
Loại:  Array<Money> optional
Số tiền phí cầu đường cho Route hoặc RouteLeg tương ứng. Danh sách này chứa số tiền cho mỗi đơn vị tiền tệ mà các trạm thu phí dự kiến sẽ tính phí. Thông thường, danh sách này sẽ chỉ chứa một mục cho các tuyến đường có phí cầu đường bằng một đơn vị tiền tệ. Đối với các chuyến đi quốc tế, danh sách này có thể chứa nhiều mục để phản ánh phí cầu đường bằng nhiều đơn vị tiền tệ.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp TransitAgency

Lớp google.maps.routes.TransitAgency

Thông tin về một công ty vận tải.

Truy cập bằng cách gọi const {TransitAgency} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
name
Loại:  string optional
Tên của công ty vận tải này.
phoneNumber
Loại:  string optional
Số điện thoại của công ty vận tải theo định dạng của từng ngôn ngữ.
url
Loại:  URL optional
URL của công ty vận tải.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp TransitDetails

Lớp google.maps.routes.TransitDetails

Thông tin bổ sung về một bước đi bằng phương tiện công cộng trong một tuyến đường.

Truy cập bằng cách gọi const {TransitDetails} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
arrivalStop
Loại:  TransitStop optional
Thông tin về điểm dừng đến của bước.
arrivalTime
Loại:  Date optional
Thời gian đến dự kiến cho bước này.
departureStop
Loại:  TransitStop optional
Thông tin về điểm khởi hành của bước.
departureTime
Loại:  Date optional
Thời gian khởi hành dự kiến cho bước này.
headsign
Loại:  string optional
Chỉ định hướng di chuyển trên tuyến này như được đánh dấu trên phương tiện hoặc tại điểm dừng khởi hành. Hướng thường là ga cuối.
headwayMillis
Loại:  number optional
Chỉ định thời gian dự kiến (tính bằng mili giây) giữa các chuyến khởi hành từ cùng một điểm dừng tại thời điểm này. Ví dụ: với giá trị tần suất là 600.000, bạn sẽ phải đợi 10 phút nếu lỡ chuyến xe buýt.

Lưu ý: Nếu khoảng cách vượt quá 2^53 mili giây, thì giá trị này là Number.POSITIVE_INFINITY.
stopCount
Loại:  number
Số điểm dừng từ điểm khởi hành đến điểm đến. Số lượng này bao gồm điểm dừng đến nhưng không bao gồm điểm dừng đi. Ví dụ: nếu tuyến của bạn xuất phát từ Điểm dừng A, đi qua các điểm dừng B và C, rồi đến điểm dừng D, thì stopCount sẽ là 3.
transitLine
Loại:  TransitLine optional
Thông tin về tuyến phương tiện công cộng được sử dụng trong bước này.
tripShortText
Loại:  string optional
Văn bản xuất hiện trong lịch trình và bảng chỉ dẫn để hành khách nhận biết chuyến đi bằng phương tiện công cộng. Văn bản xác định duy nhất một chuyến đi trong một ngày dịch vụ. Ví dụ: "538" là tripShortText của chuyến tàu Amtrak khởi hành từ San Jose, CA lúc 15:10 vào các ngày trong tuần để đến Sacramento, CA.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp TransitLine

Lớp google.maps.routes.TransitLine

Thông tin về tuyến phương tiện công cộng.

Truy cập bằng cách gọi const {TransitLine} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
agencies
Loại:  Array<TransitAgency>
Công ty vận tải (hoặc các công ty vận tải) vận hành tuyến phương tiện công cộng này.
color
Loại:  string optional
Màu thường dùng trong biển báo cho tuyến này. Được biểu thị bằng hệ thập lục phân.
iconURL
Loại:  URL optional
URL của biểu tượng liên kết với dòng này.
name
Loại:  string optional
Tên đầy đủ của tuyến phương tiện công cộng này, ví dụ: "8 Avenue Local".
shortName
Loại:  string optional
Tên ngắn của tuyến phương tiện công cộng này. Tên này thường là số tuyến, chẳng hạn như "M7" hoặc "355".
textColor
Loại:  string optional
Màu thường dùng trong văn bản trên biển báo cho tuyến này. Được biểu thị bằng hệ thập lục phân.
url
Loại:  URL optional
URL của tuyến phương tiện công cộng này do công ty vận tải cung cấp.
vehicle
Loại:  TransitVehicle optional
Loại phương tiện hoạt động trên tuyến phương tiện công cộng này.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Giao diện TransitPreference

google.maps.routes.TransitPreference giao diện

Lựa chọn ưu tiên cho các tuyến đường dựa trên TRANSIT ảnh hưởng đến tuyến đường được trả về.
allowedTransitModes optional
Loại:  Iterable<TransitMode> optional
Một nhóm phương thức di chuyển để sử dụng khi nhận tuyến đường TRANSIT. Mặc định là tất cả phương tiện đi lại được hỗ trợ.
routingPreference optional
Loại:  TransitRoutePreference optional
Lựa chọn ưu tiên về tuyến đường, khi được chỉ định, sẽ ảnh hưởng đến tuyến đường TRANSIT được trả về.

Lớp TransitStop

Lớp google.maps.routes.TransitStop

Thông tin về một điểm dừng phương tiện công cộng.

Truy cập bằng cách gọi const {TransitStop} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
location
Loại:  DirectionalLocation optional
Vị trí của điểm dừng được biểu thị bằng toạ độ vĩ độ/kinh độ và hướng (không bắt buộc).
name
Loại:  string optional
Tên của điểm dừng phương tiện công cộng.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Lớp TransitVehicle

Lớp google.maps.routes.TransitVehicle

Thông tin về phương tiện được sử dụng trong các tuyến phương tiện công cộng.

Truy cập bằng cách gọi const {TransitVehicle} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
iconURL
Loại:  URL optional
URL của biểu tượng liên kết với loại xe này.
localIconURL
Loại:  URL optional
URL của biểu tượng liên kết với loại phương tiện này, dựa trên biển báo giao thông tại địa phương.
name
Loại:  string optional
Tên của xe này, viết hoa.
nameLanguage
Loại:  string optional
Mã ngôn ngữ BCP-47 của văn bản tên xe, chẳng hạn như "en-US" hoặc "sr-Latn".

Để biết thêm thông tin, hãy xem: https://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
vehicleType
Loại:  string optional
Loại xe được sử dụng.

Hãy xem https://developers.google.com/maps/documentation/routes/reference/rpc/google.maps.routing.v2#transitvehicletype để biết danh sách các giá trị có thể có.
toJSON
toJSON()
Tham số:  Không có
Giá trị trả về:  Object
Chuyển đổi thành một đối tượng.

Hằng số VehicleEmissionType

hằng số google.maps.routes.VehicleEmissionType

Một tập hợp các giá trị mô tả loại khí thải của xe. Chỉ áp dụng cho phương thức di chuyển DRIVING.

Truy cập bằng cách gọi const {VehicleEmissionType} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.
DIESEL Xe chạy bằng dầu diesel.
ELECTRIC Xe chạy bằng điện.
GASOLINE Xe chạy bằng xăng.
HYBRID Xe lai (chẳng hạn như xăng + điện).

Giao diện VehicleInfo

google.maps.routes.VehicleInfo giao diện

Chứa thông tin về xe, chẳng hạn như loại khí thải của xe.
emissionType optional
Loại:  VehicleEmissionType optional
Mô tả loại khí thải của xe. Chỉ áp dụng cho phương thức di chuyển DRIVING.

Giao diện Waypoint

google.maps.routes.Waypoint giao diện

Đại diện cho một điểm tham chiếu trong tuyến đường.
location
Vị trí của điểm tham chiếu. Chuỗi có thể là địa chỉ, Plus Code hoặc tên tài nguyên Địa điểm.
sideOfRoad optional
Loại:  boolean optional
Cho biết rằng vị trí của điểm tham chiếu này ưu tiên cho xe dừng ở một bên đường cụ thể. Khi bạn đặt giá trị này, tuyến đường sẽ đi qua vị trí đó để xe có thể dừng ở bên đường mà vị trí đó thiên về từ giữa đường. Lựa chọn này chỉ áp dụng cho DRIVING và TWO_WHEELER ComputeRoutesRequest.travelMode
vehicleStopover optional
Loại:  boolean optional
Cho biết rằng điểm tham chiếu là nơi xe dừng lại để đón hoặc trả khách. Khi bạn đặt giá trị này, tuyến đường được tính toán sẽ không bao gồm các điểm tham chiếu không phải via trên những tuyến đường không phù hợp để đón và trả khách. Lựa chọn này chỉ hoạt động cho DRIVING và TWO_WHEELER ComputeRoutesRequest.travelMode và khi Waypoint.location không phải là string hoặc Place.
via optional
Loại:  boolean optional
Đánh dấu điểm tham chiếu này là một mốc quan trọng thay vì điểm dừng. Đối với mỗi điểm tham chiếu không phải via trong ComputeRoutesRequest, Route.computeRoutes sẽ thêm một mục vào mảng Route.legs để cung cấp thông tin chi tiết về các điểm dừng trên chặng đó của chuyến đi.

Đặt giá trị này thành true khi bạn muốn tuyến đường đi qua điểm tham chiếu này mà không dừng lại. Điểm trung gian không khiến một mục được thêm vào mảng Route.legs, nhưng chúng sẽ định tuyến hành trình qua điểm trung gian.

Ghi chú:
  • Bạn chỉ có thể đặt giá trị này trên các điểm tham chiếu trung gian. Yêu cầu sẽ không thành công nếu bạn đặt trường này trên các điểm tham chiếu cuối cùng.
  • Nếu ComputeRoutesRequest.optimizeWaypointOrder được đặt thành true, thì bạn không thể đặt trường này thành true; nếu không, yêu cầu sẽ không thành công.

Giao diện WaypointMarkerDetails

google.maps.routes.WaypointMarkerDetails giao diện

Thông tin chi tiết về một điểm tham chiếu có thể dùng để tuỳ chỉnh kiểu điểm đánh dấu.
index
Loại:  number
Chỉ mục của điểm đánh dấu.
totalMarkers
Loại:  number
Tổng số điểm đánh dấu trong tuyến đường.
leg optional
Loại:  RouteLeg optional
Chặng mà điểm đánh dấu thuộc về. Để trống nếu tuyến đường không có chặng nào.