Route (beta)

Lớp Route

Lớp google.maps.routes.Route

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

Truy cập bằng cách gọi const {Route} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
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à điểm tham chiếu 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ị này là một danh sách các đường dẫn đến trường.

Ví dụ:
  • Mặt nạ cho trường (field mask) của tất cả các trường có sẵn: fields: ['*']
  • Mặt nạ cho trường (field mask) của thời lượng, 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ạ cho 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 giúp máy chủ của chúng tôi tiết kiệm các chu kỳ tính toán, cho phép chúng tôi trả về kết quả cho bạn với độ trễ thấp hơn.
  • Chỉ chọn những trường bạn cần trong công việc sản xuất để đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm nhiều trường phản hồi hơn 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 sẽ tự động được đưa vào phản hồi.
  • 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ả về 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
Khoảng 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 có 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.
legs
Loại:  Array<RouteLeg> optional
Một tập hợp các đoạn đườ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 2 điểm đánh dấu không phải là 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 có một điểm via trung gian không phải là điểm dừng chân sẽ có hai chặng.
  • Một tuyến đường có một điểm tham chiếu trung gian via sẽ có một chặng.
Thứ tự của các đoạn đường trùng khớp với thứ tự của các điểm tham chiếu từ origin đến intermediates rồi đế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, trường này sẽ chứa thứ tự được tối ưu hoá 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
  • Các đ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 đường nhiều đoạn 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 đi.
routeLabels
Loại:  Array<RouteLabel> optional
Nhãn cho tuyến đường, hữu ích khi xác định các thuộc tính cụ thể để so sánh với các thuộc tính khác.
routeToken
Loại:  string optional
Một mã thông báo không công khai có thể được truyền đến Navigation SDK để 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ị này giữa các yêu cầu vì giá trị này có thể thay đổi ngay cả khi dịch vụ trả về chính xác cùng một tuyến đường.

Lưu ý: routeToken chỉ dùng được cho những yêu cầu đã đặt ComputeRoutesRequest.routingPreference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL. Không hỗ trợ các yêu cầu có điểm tham chiếu via.
speedPaths
Loại:  Array<SpeedPath> optional
Nhóm các đoạn của đường đi với tốc độ đọc tương ứng. Để trường này được điền sẵn, 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
Khung giới hạn khung nhìn của tuyến đường.
warnings
Loại:  Array<string> optional
Một mảng các 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 nhiều đường cho tuyến đường dựa trên dữ liệu có sẵn.

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

Đường giao thông dạng nhiều đường:
  • Yêu cầu:
  • Tạo một đường nhiều đoạn 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 đó. Đường nhiều đoạn có kiểu dựa trên tốc độ mặc định được áp dụng. Bạn có thể truyền các lựa chọn để thay đổi kiểu đường nhiều đoạn dựa trên tốc độ.

Đường nhiều đoạn tổng thể:
  • Yêu cầu:
  • Tạo một đường nhiều đoạn duy nhất cho toàn bộ tuyến đường với kiểu mặc định được áp dụng. Bạn có thể truyền các lựa chọn để thay đổi kiểu đường nhiều đoạn dựa trên chế độ di chuyển của tuyến đường. Để tuỳ chỉnh thêm, hãy tạo đường nhiều đoạn trực tiếp bằng cách sử dụ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 từng điểm tham chiếu. Các điểm đánh dấu đã được áp dụng kiểu mặc định. Bạn có thể truyền các lựa 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 các thuộc tính của RouteLeg tương ứng. Tham số WaypointMarkerDetails.leg sẽ không xác định nếu tuyến đường không có chặng.

Bạn phải yêu cầu trường "legs" trong ComputeRoutesRequest.fields để các điểm tham chiếu trung gian được đưa vào.
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.ComputeRoutesRequestgiao diện

Yêu cầu chỉ đườ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ỉ, mã cộng hoặc tên tài nguyên Địa điểm. Các giá trị độ cao không được xem xét để tính toán các 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 khởi hành của tuyến đường. Giá trị được truyền dưới dạng chuỗi có thể là địa chỉ, mã cộng hoặc tên tài nguyên Địa điểm. Các giá trị độ cao không được xem xét để tính toán các 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 là 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 có tính toán các tuyến đường thay thế ngoài tuyến đường 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 tham chiếu 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 gian bạn đưa ra yêu cầu.

Lưu ý: Bạn chỉ có thể chỉ định một thời điểm 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 Mã nhận dạng ngôn ngữ theo chuẩn 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 API JavaScript của Google Maps. Nếu không, ngôn ngữ sẽ được suy đoán dựa trên 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 tham chiếu trung gian đã chỉ định. Yêu cầu sẽ không thành công nếu bất kỳ điểm tham chiếu trung gian nào là điểm tham chiếu qua. Hãy dùng Route.optimizedIntermediateWaypointIndices trong câu trả lờ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 đường nhiều đoạn.
region optional
Loại:  string optional
Mã vùng, được chỉ định dưới dạng giá trị gồm 2 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 API JavaScript của Google Maps. Nếu không, khu vực sẽ được suy luận từ vị trí của nguồn.
requestedReferenceRoutes optional
Loại:  Iterable<ReferenceRoute> optional
Chỉ định những tuyến đường tham chiếu 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ụ: tính toán tuyến đường tham chiếu FUEL_EFFICIENT có tính đến 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 kết quả.
routeModifiers optional
Loại:  RouteModifiers optional
Một nhóm các đ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 những đối tượng cần tránh như đường cao tốc hoặc đường có thu phí.
routingPreference optional
Loại:  RoutingPreference optional
Chỉ định cách tính toán tuyến đường. Máy chủ cố gắng sử dụng lựa chọn ưu tiên về định tuyến đã 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ì 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 di chuyển. Chế độ cài đặt này ảnh hưởng đến giá trị của Route.durationMillis và RouteLeg.durationMillis. Các giá trị này chứa thời gian dự đoán trong lưu lượng truy cập dựa trên mức trung bình trong quá khứ. ComputeRoutesRequest.trafficModel chỉ dành 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 các tuyến đường TRANSIT.

Lưu ý: Chỉ có thể được chỉ định khi ComputeRoutesRequest.travelMode được đặt thành TRANSIT.
travelMode optional
Loại:  TravelMode optional
Chỉ định phương tiện giao thông.
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. Giá trị này không ảnh hưởng đến các đơn vị đo lường được dùng cho tuyến đường, đoạn đường, khoảng cách bước và thời lượng. Nếu bạn không cung cấp giá trị này, thì các đơn vị hiển thị sẽ được suy ra từ vị trí của nguồn gốc.

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 Maps JavaScript API.
FLYOVER_INFO_ON_POLYLINE Thông tin về đường trên cao 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. Hiện tại, dữ liệu này sẽ chỉ được điền sẵn cho một số khu vực đô thị ở Ấn Độ. Tính năng này đang trong giai đoạn thử nghiệm và SKU/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 chỉ đường được trình bày dưới dạng một chuỗi văn bản HTML được định dạng. Nội dung này chỉ được dùng để hiển thị và không được chỉnh sửa. Đừ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. Hiện tại, dữ liệu này sẽ chỉ được điền sẵn cho một số khu vực đô thị ở Ấn Độ. Tính năng này đang trong giai đoạn thử nghiệm và SKU/phí có thể thay đổi.
TOLLS Thông tin về phí cầu đường cho(các) tuyến đường.
TRAFFIC_ON_POLYLINE Đường nhiều đoạn có thông tin giao thông cho(các) tuyến đường.

Giao diện DirectionalLocationLiteral

google.maps.routes.DirectionalLocationLiteralgiao diện

Các chữ số đối tượng được chấp nhận thay cho các thực thể DirectionalLocation để thuận tiện. Các giá trị này sẽ được chuyển đổi thành DirectionalLocation khi Maps JS API gặp phải chúng.

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 lưu lượng truy cập. Giá trị hướng có thể là số từ 0 đến 360, trong đó 0 chỉ định hướng Bắc, 90 chỉ định hướng Đông, v.v. Bạn chỉ có thể sử dụng trường này cho DRIVING và TWO_WHEELER ComputeRoutesRequest.travelMode.
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à 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 Maps JavaScript API.
Kế thừa: LatLngAltitude
heading
Loại:  number optional
Hướng la bàn liên quan đến hướng lưu lượng truy cập. Giá trị hướng có thể là số từ 0 đến 360, trong đó 0 chỉ định hướng Bắc, 90 chỉ định hướng Đông, v.v. Bạn chỉ có thể sử dụng trường này cho DRIVING và TWO_WHEELER ComputeRoutesRequest.travelMode.
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.
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 dùng trong câu trả lời của Route.computeRoutes. Nếu bạn đặt trường này, thì có nghĩa là máy chủ đã sử dụng một chế độ định tuyến khác với chế độ bạn muốn làm chế độ dự phòng.

Truy cập bằng cách gọi const {FallbackInfo} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
reason
Loại:  FallbackReason optional
Lý do khiến phản hồi dự phòng được dùng thay vì phản hồi ban đầu. Trường này chỉ được điề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, chế độ này có thể khác với lựa chọn ưu tiên định tuyến được đặt trong yêu cầu ban đầu của ứng dụng.

Hằng số FallbackReason

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

Lý do 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 {FallbackReason} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
LATENCY_EXCEEDED Chúng tôi không thể hoàn tất việc tính toán với chế độ định tuyến mà bạn ưu tiên đúng thời gian, nhưng chúng tôi đã có thể trả về kết quả được tính toán bằng một chế độ thay thế.
SERVER_ERROR Đã xảy ra lỗi máy chủ khi tính toán các tuyến đường bằng chế độ định tuyến mà bạn ưu tiên, nhưng chúng tôi đã có thể trả về kết quả được tính toán bằng một chế độ thay thế.

Hằng số FallbackRoutingMode

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

Chế độ định tuyến thực tế được dùng khi một 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 Maps JavaScript API.
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 câu trả lờ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 các điểm tham chiếu địa chỉ. Bao gồm thông tin chi tiết về kết quả mã hoá địa lý cho 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 Maps JavaScript API.
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à một điểm tham chiếu trung gian.
partialMatch
Loại:  boolean
Cho biết rằng trình 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ù trình mã hoá này có thể khớp một phần của đị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ỉ không đầ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 0 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à các điểm tham chiếu trung gian. Chỉ được điền sẵn cho các đ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 Maps JavaScript API.
destination
Loại:  GeocodedWaypoint optional
Điểm tham chiếu được mã hoá địa lý cho đích đế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 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 khởi hành.
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 đường đa phương thức của RouteLeg.steps trong một tuyến đường. Đoạn đa phương thức được xác định là một hoặc nhiều RouteLegStep liên tiếp 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 Maps JavaScript API.
instructions
Loại:  string optional
Hướng dẫn thao tác trong đoạn video đ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 Maneuver để 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 cuối của một phân đoạn đ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
Chế độ di chuyển được dùng cho đoạn đường đ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 đường nhiều đường.

Truy cập bằng cách gọi const {PolylineDetailInfo} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
endIndex
Loại:  number optional
Chỉ mục cuối của đối tượng đường này trong đường đa tuyến.
presence
Loại:  RoadFeatureState optional
Cho biết đối tượng đường có tồn tại dọc theo đường đa tuyến hay không.
startIndex
Loại:  number optional
Chỉ mục bắt đầu của đối tượng đường này trong đường nhiều đoạn.
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 tục của một đường nhiều đoạn. Cho trước một đường nhiều đoạn có các điểm P_0, P_1, ... , P_N (chỉ mục dựa trên 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 Maps JavaScript API.
flyoverInfo
Thông tin chi tiết về đường bay dọc theo đường nhiều đoạn.
narrowRoadInfo
Thông tin chi tiết về đường hẹp dọc theo đường nhiều đoạn.
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 đường nhiều đoạn.

Truy cập bằng cách gọi const {PolylineQuality} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
HIGH_QUALITY Chỉ định một đường nhiều đoạn có chất lượng cao được tạo thành từ nhiều điểm hơn OVERVIEW với chi phí tăng kích thước phản hồi. 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 đường nhiều đoạn tổng quan được tạo thành từ 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 Maps JavaScript API.
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 trên đường dọc theo một đoạn đường nhiều đường.

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

Hằng số RouteLabel

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

Nhãn cho tuyến đường, giúp 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 Maps JavaScript API.
DEFAULT_ROUTE Tuyến đường "tốt nhất" mặc định được trả về cho quá trình tính toán tuyến đường.
DEFAULT_ROUTE_ALTERNATE Một lựa chọn thay thế cho tuyến đường "tốt nhất" mặc định. Những 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. Những tuyến đường được gắn nhãn bằng giá trị này được xác định là tuyến đường tối ưu hoá cho các thông số về môi trường như mức tiêu thụ nhiên liệu.
SHORTER_DISTANCE Tuyến đường có khoảng cách 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 đường giữa các điểm đánh dấ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 Maps JavaScript API.
distanceMeters
Loại:  number
Quãng đường di chuyển của đoạn đường, tính bằng mét.
durationMillis
Loại:  number optional
Khoảng thời gian cần thiết để di chuyển trên đoạ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 có 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.
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 vị trí của 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 các LatLngAltitude của đoạn đường, có thể dùng để vẽ một đường nhiều đoạn của đoạ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.
speedPaths
Loại:  Array<SpeedPath>
Nhóm các phần của đường dẫn đoạn đường với tốc độ đọc tương ứng. Để trường này được điền sẵn, 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 vị trí của 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 đường mà không xem xét 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 đoạn trong chặng này. Mỗi bước đại diện cho một chỉ dẫn điều hướng.
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 đường 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ể có về khu vực giao thông, trên một đoạ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 Maps JavaScript API.
distance
Loại:  string optional
Quãng đường đi của chặng đường 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. Tính đến 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 tĩnh về thời lượ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.

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. Các chặng đường bao gồm nhiều bước.

Truy cập bằng cách gọi const {RouteLegStep} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
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 cách đi theo chỉ dẫn cho chặng 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 Maneuver để biết danh sách các giá trị có thể có.
path
Danh sách LatLngAltitude của bước đoạn đường, có thể dùng để vẽ một đường đa tuyến của bước đoạ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 thì trường này mới được điền sẵn.
startLocation
Loại:  DirectionalLocation optional
Vị trí bắt đầu của bước này.
staticDurationMillis
Loại:  number optional
Thời lượng di chuyển qua bước này mà không xem xét 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 chế độ di chuyển là TRANSIT.
travelMode
Loại:  TravelMode optional
Phương tiện 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 Maps JavaScript API.
distance
Loại:  string optional
Quãng đường di chuyển của bước trong chặng đường 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.
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 tĩnh 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.
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 một RouteLeg.

Truy cập bằng cách gọi const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
speedReadingIntervals
Loại:  Array<SpeedReadingInterval> optional
Khoảng thời gian đọc nhanh cho biết 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 này bao phủ toàn bộ đường nhiều đoạn của RouteLeg mà không bị trùng lặp. Đ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 có phí cầu đường trên RouteLeg. Nếu bạn đặt trường này nhưng không điền sẵn TollInfo.estimatedPrices,thì đoạn đường có trạm thu phí nhưng giá ước tính là không xác định. Nếu trường này trống, tức là RouteLeg không có trạm thu phí.
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 Maps JavaScript API.
distance
Loại:  string optional
Khoảng cách di chuyển của tuyến đường được thể hiện 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. Tính đến tình trạng giao thông. Lưu ý: Nếu bạn không yêu cầu thông tin 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 tĩnh về thời lượng, 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 thể hiện ở 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.RouteModifiersgiao diện

Đóng gói một nhóm các điều kiện không bắt buộc cần đáp ứng khi tính toán các tuyến đường.
avoidFerries optional
Loại:  boolean optional
Khi được đặt thành true, chế độ này sẽ tránh phà nếu có thể, ưu tiên những 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, chế độ này sẽ tránh đường cao tốc nếu có thể, ưu tiên những 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, chế độ này sẽ tránh điều hướng trong nhà nếu có thể, ưu tiên những tuyến đường không có tính năng đ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, chế độ này sẽ tránh đường có thu phí nếu có thể, ưu tiên những 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
Bao gồm thông tin về thẻ thu phí. Nếu bạn cung cấp thẻ thu phí, API sẽ cố gắng trả về giá của thẻ. Nếu bạn không cung cấp thẻ thu phí, API sẽ coi thẻ thu phí 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.RoutePolylineDetailsgiao diện

Thông tin chi tiết về một đoạn đường tương ứng với một đường nhiều đường mà bạn có thể dùng để tuỳ chỉnh kiểu đường nhiều đường.
speed optional
Loại:  Speed optional
Tốc độ đọc của đoạn đường tương ứng với đường nhiều đường này. Chỉ được điền sẵn cho những tuyến đường có thông tin 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 đường nhiều đoạn 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
Chế độ di chuyển của đoạn đường tương ứng với đường nhiều đường này. Để trống đối với đường nhiều đường giao thông.

Giao diện RoutePolylineOptions

google.maps.routes.RoutePolylineOptionsgiao diện

Các lựa chọn để tạo đường nhiều đoạn cho tuyến đường.
colorScheme optional
Loại:  ColorScheme optional
Bảng phối màu dùng cho đường nhiều đoạn. Khi được chỉ định là FOLLOW_SYSTEM trong khi bản đồ colorScheme cũng là FOLLOW_SYSTEM, các đường nhiều đoạn sẽ được vẽ ở cùng chế độ tối/sáng như bản đồ. Nếu không được chỉ định, Route.createPolylines sẽ cố gắng sử dụng colorScheme của bản đồ hoặc quay lại 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 đường nhiều đoạn. Có thể là một đối tượng PolylineOptions được áp dụng cho tất cả các đường nhiều đoạn của tuyến đường hoặc một hàm nhận PolylineOptions và RoutePolylineDetails mặc định, đồng thời trả về PolylineOptions sẽ được áp dụng cho đường nhiều đoạn đó.

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 một Route.

Truy cập bằng cách gọi const {RouteTravelAdvisory} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
fuelConsumptionMicroliters
Loại:  number optional
Lượng nhiên liệu tiêu thụ dự kiế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ó những hạn chế không phù hợp với chế độ di chuyển hoặc các thông số sửa đổi tuyến đường được yêu cầu.
speedReadingIntervals
Loại:  Array<SpeedReadingInterval> optional
Khoảng thời gian đọc nhanh cho biết 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 này bao phủ toàn bộ đường nhiều đoạn của Route mà không bị trùng lặp. Đ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 có phí cầu đường trên Route. Nếu bạn đặt trường này nhưng không điền sẵn TollInfo.estimatedPrices,thì tuyến đường sẽ có trạm thu phí nhưng giá ước tính là không xác định. Nếu trường này trống, tức là Route không có trạm thu phí.
transitFare
Loại:  Money optional
Nếu có, hãy cho biết 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ỉ dành 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 một tuyến đường.

Truy cập bằng cách gọi const {RoutingPreference} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
TRAFFIC_AWARE Tính toán các tuyến đường có tính đến tình hình giao thông thực tế. Ngược lại với TRAFFIC_AWARE_OPTIMAL, một số chế độ 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 thực tế mà không áp dụng hầu hết các hoạt độ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 thực tế. 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ố tốc độ

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

Phân loại tốc độ của đường 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 Maps JavaScript API.
NORMAL Tốc độ bình thường, không có trở ngại giao thông.
SLOW Đã phát hiện tình trạng giao thông chậm, lượng giao thông ở mức trung bình.
TRAFFIC_JAM Trở ngại giao thông.

Giao diện SpeedPath

google.maps.routes.SpeedPathgiao diện

Nhóm các LatLngAltitude của một khoảng thời gian trên tuyến đường với tốc độ đọc cho khoảng thời gian đó.
path
Đường đi mà đường tốc độ này bao phủ.
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 một đường nhiều đoạn hoặc đường dẫn. Cho trước một đường dẫn có các điểm P_0, P_1, ... , P_N (chỉ mục dựa trên 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 Maps JavaScript API.
endPolylinePointIndex
Loại:  number optional
Chỉ mục kết thúc của khoảng thời gian này trong đường nhiều đường.
speed
Loại:  Speed optional
Tốc độ giao thông 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 đường 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 Maps JavaScript API.
multiModalSegments
Thông tin tóm tắt về các phân đoạn đa phương thức khác nhau 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 Maps JavaScript API.
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ó trạm thu phí bằng một loại 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 Maps JavaScript API.
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 định dạng theo ngôn ngữ của địa phương của cơ quan vận tải công cộ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.

TransitDetails class

Lớp google.maps.routes.TransitDetails

Thông tin bổ sung về một bước đi 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 Maps JavaScript API.
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 dừng 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 đường này như được đánh dấu trên xe hoặc tại điểm dừng khởi hành. Hướng đi 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ị khoảng thời gian giữa các chuyến là 600.000, bạn sẽ phải chờ 10 phút nếu lỡ chuyến xe buýt.

Lưu ý: Nếu khoảng thời gian giữa các lần xuất hiện 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 dừng khởi hành đến điểm dừng đế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 đường của bạn bắt đầu từ Điểm dừng A, đi qua đ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 giao thông công cộng được 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 hiệu để xác định chuyến đi bằng phương tiện công cộng cho hành khách. Văn bản này 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 tàu Amtrak khởi hành từ San Jose, California lúc 15:10 vào các ngày trong tuần đến Sacramento, California.
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ề một tuyến giao thông 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 Maps JavaScript API.
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 đường 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 giao thông 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ố hiệu 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 đường 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 đường vận chuyể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.TransitPreferencegiao 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 các chế độ di chuyển để sử dụng khi nhận được tuyến đường TRANSIT. Theo mặc định, tất cả cá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ề định tuyến. Khi được chỉ định, lựa chọn này 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 trạ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 Maps JavaScript API.
location
Loại:  DirectionalLocation optional
Vị trí của trạ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ề một phương tiện được sử dụng trong các tuyến đường vận chuyển.

Truy cập bằng cách gọi const {TransitVehicle} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
iconURL
Loại:  URL optional
URL của một biểu tượng được 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 xe 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 chiếc 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.

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ể.
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 chế độ 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 Maps JavaScript API.
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/dầu.
HYBRID Xe sử dụng nhiên liệu kết hợp (chẳng hạn như xăng + điện).

Giao diện VehicleInfo

google.maps.routes.VehicleInfogiao 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 chế độ di chuyển DRIVING.

Giao diện Waypoint

google.maps.routes.Waypointgiao diện

Đại diện cho một điểm tham chiếu trên 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 có nghĩa là xe nên 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í đó hướng đến từ giữa đường. Tuỳ chọn này chỉ hoạt động trên DRIVING và TWO_WHEELER ComputeRoutesRequest.travelMode
vehicleStopover optional
Loại:  boolean optional
Cho biết rằng điểm đánh dấu dành cho xe dừng lại, nơi có ý định đó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 đánh dấu không phải via trên những con đườ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 cột mốc chứ không phải là đ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 chân trên chặng đường đó.

Đặ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. Các điểm tham chiếu 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 tham chiếu.

Lưu ý:
  • Bạn chỉ có thể đặt giá trị này trên các điểm đánh dấu là điểm 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.
  • 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.WaypointMarkerDetailsgiao diện

Thông tin chi tiết về một điểm đánh dấ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 trên tuyến đường.
leg optional
Loại:  RouteLeg optional
Chặng đường mà điểm đánh dấu thuộc về. Để trống nếu tuyến đường không có chặng.