Routes Data

Lớp Route

lớp google.maps.routes.Route
thư viện "routes"

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.

const {Route} = await google.maps.importLibrary("routes");

Phương thức tĩnh

computeRoutes

computeRoutes(request) Tham số: request: ComputeRoutesRequest 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.

Thuộc tính
description readonly	Loại: string optional Nội dung mô tả tuyến đường.
distanceMeters readonly	Loại: number optional Quãng đường di chuyển của tuyến đường, tính bằng mét.
durationMillis readonly	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 readonly	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 readonly	Loại: RouteLocalizedValues optional Biểu diễn văn bản của các thuộc tính của Route.
optimizedIntermediateWaypointIndices readonly	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 readonly	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 readonly	Loại: PolylineDetails optional Chứa thông tin về các chi tiết dọc theo đường dẫn.
routeLabels readonly	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 readonly	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 readonly	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 readonly	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 readonly	Loại: RouteTravelAdvisory optional Thông tin bổ sung về tuyến đường.
viewport readonly	Loại: LatLngBounds optional Hộp giới hạn khung nhìn của tuyến đường.
warnings readonly	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.

Phương thức
create3DPolylines	Lưu ý: Chỉ có trong kênh v=alpha. create3DPolylines([options]) Tham số: options: RoutePolyline3DOptions optional Giá trị trả về: Promise<Array<Polyline3DElement>> Tạo hình nhiều đường 3D cho tuyến đường dựa trên dữ liệu có sẵn cho tuyến đường đó.
createPolylines	createPolylines([options]) Tham số: options: RoutePolylineOptions optional 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: Bạn phải yêu cầu các trường "path" và "legs" trong ComputeRoutesRequest.fields ComputeRoutesRequest.travelMode phải được đặt thành TRANSIT. 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: Bạn phải yêu cầu các trường "path" và "travelAdvisory" (hoặc chỉ "speedPaths" dưới dạng viết tắt) trong ComputeRoutesRequest.fields. ComputeRoutesRequest.routingPreference phải được đặt thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL. ComputeRoutesRequest.extraComputations phải bao gồm TRAFFIC_ON_POLYLINE. 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: Bạn phải yêu cầu trường "path" hoặc "legs" trong ComputeRoutesRequest.fields. 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.
createPopover	Lưu ý: Chỉ có trong kênh v=alpha. createPopover() Tham số: Không có Giá trị trả về: Promise<PopoverElement> Tạo một cửa sổ bật lên cho tuyến đường dựa trên dữ liệu có sẵn cho tuyến đường, được định cấu hình theo cách phù hợp để chú thích một tuyến đường trên bản đồ. Hiện đang sử dụng Route.localizedValues, Route.path và Route.legs (nếu có).
createWaypointAdvancedMarkers	createWaypointAdvancedMarkers([options]) Tham số: options: AdvancedMarkerElementOptions|(function(AdvancedMarkerElementOptions, WaypointMarkerDetails): AdvancedMarkerElementOptions) optional 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.
createWaypointMarkers	Lưu ý: Chỉ có trong kênh v=alpha. createWaypointMarkers<T extends MarkerElement|Marker3DElement|MarkerInteractiveElement|Marker3DInteractiveElement>([options]) Tham số: options: CreateWaypointMarkersOptions<T> optional Giá trị trả về: Promise<Array<T>> Tạo điểm đánh dấu cho điểm xuất phát và điểm đến của tuyến đường. Điểm đánh dấu được áp dụng kiểu mặc định, trừ phi bạn chỉ định một hàm customOverride. Hiện chưa hỗ trợ điểm tham chiếu trung gian. Theo mặc định, các điểm đánh dấu đã tạo sẽ có CollisionBehavior được đặt thành CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL.
Được kế thừa: toJSON

Giao diện ComputeRoutesRequest

giao diện google.maps.routes.ComputeRoutesRequest

Yêu cầu về tuyến đường.

Thuộc tính
destination	Loại: string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint Đ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	Loại: string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint Đ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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	Loại: Iterable<ComputeRoutesExtraComputation> 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 không bắt buộc	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.
internalUsageAttributionIds không bắt buộc	Loại: Iterable<string> optional Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể.
language không bắt buộc	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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	Loại: TravelMode optional Chỉ định phương thức di chuyển.
units không bắt buộc	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
thư viện "routes"

Các phép tính bổ sung cần thực hiện trong khi hoàn tất yêu cầu. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại ComputeRoutesExtraComputationString.

const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes");

Hằng số
FLYOVER_INFO_ON_POLYLINE	Thông tin về cầu vượt cho(các) tuyến đường. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
FUEL_CONSUMPTION	Mức tiêu thụ nhiên liệu ước tính cho(các) tuyến đường. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS	Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
NARROW_ROAD_INFO_ON_POLYLINE	Thông tin về đường hẹp cho(các) tuyến đường. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
TOLLS	Thông tin về phí cầu đường cho(các) tuyến đường. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
TRAFFIC_ON_POLYLINE	Hình nhiều đường thể hiện tình hình giao thông cho(các) tuyến đường. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Giao diện CreateWaypointMarkersOptions

giao diện google.maps.routes.CreateWaypointMarkersOptions<T = MarkerElement|Marker3DElement|MarkerInteractiveElement|Marker3DInteractiveElement>

Lưu ý: Chỉ có trong kênh v=alpha.

Các lựa chọn để tạo điểm đánh dấu điểm tham chiếu.

Thuộc tính
forEach không bắt buộc	Loại: function(T): void optional Một hàm tuỳ chỉnh để thay đổi các phần tử đã tạo. Hàm forEach mặc định sẽ thêm ghim có ký tự từ A đến Z vào mỗi điểm đánh dấu. Để có hành vi khác, hãy ghi đè hàm này.
markerClass không bắt buộc	Loại: new () => T optional Hàm khởi tạo của phần tử cần tạo. Các loại được hỗ trợ bao gồm: Marker3DElement Marker3DInteractiveElement MarkerElement MarkerInteractiveElement

Giao diện DirectionalLocationLiteral

giao diện google.maps.routes.DirectionalLocationLiteral mở rộng LatLngAltitudeLiteral, LatLngLiteral
được triển khai bởi DirectionalLocation

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.

Thuộc tính
heading không bắt buộc	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

class google.maps.routes.DirectionalLocation extends LatLngAltitude implements DirectionalLocationLiteral, LatLngAltitudeLiteral, LatLngLiteral
library "routes"

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

const {DirectionalLocation} = await google.maps.importLibrary("routes");

Hàm dựng
Được kế thừa: LatLngAltitude

Thuộc tính
heading readonly	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

Phương thức
toJSON	toJSON([key]) Tham số: key: string optional Giá trị trả về: DirectionalLocationLiteral Chuyển đổi thành một đối tượng thuần tuý.
Được kế thừa: equals

Lớp FallbackInfo

lớp google.maps.routes.FallbackInfo
thư viện "routes"

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.

const {FallbackInfo} = await google.maps.importLibrary("routes");

Thuộc tính
reason readonly	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 readonly	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.

Phương thức
Được kế thừa: toJSON

Hằng số FallbackReason

hằng số google.maps.routes.FallbackReason
thư viện "routes"

Lý do sử dụng câu trả lời dự phòng. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại FallbackReasonString.

const {FallbackReason} = await google.maps.importLibrary("routes");

Hằng số
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. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
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ãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Hằng số FallbackRoutingMode

hằng số google.maps.routes.FallbackRoutingMode
thư viện "routes"

Chế độ định tuyến thực tế được dùng cho phản hồi dự phòng được trả về. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại FallbackRoutingModeString.

const {FallbackRoutingMode} = await google.maps.importLibrary("routes");

Hằng số
TRAFFIC_AWARE	Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
TRAFFIC_UNAWARE	Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Lớp GeocodedWaypoint

lớp google.maps.routes.GeocodedWaypoint
thư viện "routes"

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ý.

const {GeocodedWaypoint} = await google.maps.importLibrary("routes");

Thuộc tính
geocoderStatus readonly	Loại: RPCStatus optional Cho biết mã trạng thái do thao tác mã hoá địa lý.
intermediateWaypointRequestIndex readonly	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 readonly	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 readonly	Loại: string Mã địa điểm cho kết quả này.
types readonly	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ợ.

Phương thức
Được kế thừa: toJSON

Lớp GeocodingResults

lớp google.maps.routes.GeocodingResults
thư viện "routes"

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ỉ.

const {GeocodingResults} = await google.maps.importLibrary("routes");

Thuộc tính
destination readonly	Loại: GeocodedWaypoint optional Điểm tham chiếu được mã hoá địa lý cho điểm đến.
intermediates readonly	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 readonly	Loại: GeocodedWaypoint optional Điểm tham chiếu được mã hoá địa lý cho điểm xuất phát.

Phương thức
Được kế thừa: toJSON

Lớp MultiModalSegment

lớp google.maps.routes.MultiModalSegment
thư viện "routes"

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.

const {MultiModalSegment} = await google.maps.importLibrary("routes");

Thuộc tính
instructions readonly	Loại: string optional Hướng dẫn đi theo chặng đa phương thức này.
maneuver readonly	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 readonly	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 readonly	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 readonly	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.

Phương thức
Được kế thừa: toJSON

Lớp PolylineDetailInfo

lớp google.maps.routes.PolylineDetailInfo
thư viện "routes"

Đó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.

const {PolylineDetailInfo} = await google.maps.importLibrary("routes");

Thuộc tính
endIndex readonly	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 readonly	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 readonly	Loại: number optional Chỉ mục bắt đầu của đối tượng đường này trong hình nhiều đường.

Phương thức
Được kế thừa: toJSON

Lớp PolylineDetails

lớp google.maps.routes.PolylineDetails
thư viện "routes"

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.

const {PolylineDetails} = await google.maps.importLibrary("routes");

Thuộc tính
flyoverInfo readonly	Loại: Array<PolylineDetailInfo> Thông tin chi tiết về chuyến bay dọc theo hình nhiều đường.
narrowRoadInfo readonly	Loại: Array<PolylineDetailInfo> Thông tin chi tiết về đường hẹp dọc theo hình nhiều đường.

Phương thức
Được kế thừa: toJSON

Hằng số PolylineQuality

hằng số google.maps.routes.PolylineQuality
thư viện "routes"

Một tập hợp các giá trị chỉ định chất lượng của hình nhiều đường. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại PolylineQualityString.

const {PolylineQuality} = await google.maps.importLibrary("routes");

Hằng số
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 xem tài liệu về dịch vụ web để biết thêm thông tin.
OVERVIEW	Chỉ định một hình nhiều đường tổng quan – được tạo bằng một số ít điểm. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Hằng số ReferenceRoute

hằng số google.maps.routes.ReferenceRoute
thư viện "routes"

Tuyến đường tham chiếu được hỗ trợ trên ComputeRoutesRequest. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại ReferenceRouteString.

const {ReferenceRoute} = await google.maps.importLibrary("routes");

Hằng số
FUEL_EFFICIENT	Tuyến đường tiết kiệm nhiên liệu. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
SHORTER_DISTANCE	Tuyến đường có quãng đường di chuyển ngắn hơn. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Hằng số RoadFeatureState

hằng số google.maps.routes.RoadFeatureState
thư viện "routes"

Đó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. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại RoadFeatureStateString.

const {RoadFeatureState} = await google.maps.importLibrary("routes");

Hằng số
DOES_NOT_EXIST	Đối tượng đường không tồn tại. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
EXISTS	Đường này có tồn tại. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Hằng số RouteLabel

hằng số google.maps.routes.RouteLabel
thư viện "routes"

Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại RouteLabelString.

const {RouteLabel} = await google.maps.importLibrary("routes");

Hằng số
DEFAULT_ROUTE	Tuyến đường "tốt nhất" mặc định được trả về cho phép tính tuyến đường. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
DEFAULT_ROUTE_ALTERNATE	Tuyến đường thay thế cho tuyến đường "tốt nhất" mặc định. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
FUEL_EFFICIENT	Tuyến đường tiết kiệm nhiên liệu. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
SHORTER_DISTANCE	Tuyến đường có quãng đường di chuyển ngắn hơn. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Lớp RouteLeg

lớp google.maps.routes.RouteLeg
thư viện "routes"

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

const {RouteLeg} = await google.maps.importLibrary("routes");

Thuộc tính
distanceMeters readonly	Loại: number Quãng đường di chuyển của chặng trong tuyến đường, tính bằng mét.
durationMillis readonly	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 readonly	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 readonly	Loại: RouteLegLocalizedValues optional Biểu diễn văn bản của các thuộc tính của RouteLeg.
path readonly	Loại: Array<LatLngAltitude> 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 readonly	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 readonly	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 readonly	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 readonly	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 readonly	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 readonly	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.

Phương thức
Được kế thừa: toJSON

Lớp RouteLegLocalizedValues

lớp google.maps.routes.RouteLegLocalizedValues
thư viện "routes"

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

const {RouteLegLocalizedValues} = await google.maps.importLibrary("routes");

Thuộc tính
distance readonly	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 readonly	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 readonly	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 readonly	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 readonly	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 readonly	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".

Phương thức
Được kế thừa: toJSON

Lớp RouteLegStep

lớp google.maps.routes.RouteLegStep
thư viện "routes"

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.

const {RouteLegStep} = await google.maps.importLibrary("routes");

Thuộc tính
distanceMeters readonly	Loại: number Quãng đường di chuyển của bước này, tính bằng mét.
endLocation readonly	Loại: DirectionalLocation optional Vị trí kết thúc của bước này.
instructions readonly	Loại: string optional Hướng dẫn thực hiện bước này.
localizedValues readonly	Loại: RouteLegStepLocalizedValues optional Biểu diễn văn bản của các thuộc tính của RouteLegStep.
maneuver readonly	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 readonly	Loại: Array<LatLngAltitude> 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 readonly	Loại: DirectionalLocation optional Vị trí bắt đầu của bước này.
staticDurationMillis readonly	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 readonly	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 readonly	Loại: TravelMode optional Phương thức di chuyển được dùng cho bước này.

Phương thức
Được kế thừa: toJSON

Lớp RouteLegStepLocalizedValues

lớp google.maps.routes.RouteLegStepLocalizedValues
thư viện "routes"

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

const {RouteLegStepLocalizedValues} = await google.maps.importLibrary("routes");

Thuộc tính
distance readonly	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 readonly	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 readonly	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 readonly	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.

Phương thức
Được kế thừa: toJSON

Lớp RouteLegTravelAdvisory

lớp google.maps.routes.RouteLegTravelAdvisory
thư viện "routes"

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

const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes");

Thuộc tính
speedReadingIntervals readonly	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 readonly	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.

Phương thức
Được kế thừa: toJSON

Lớp RouteLocalizedValues

lớp google.maps.routes.RouteLocalizedValues
thư viện "routes"

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

const {RouteLocalizedValues} = await google.maps.importLibrary("routes");

Thuộc tính
distance readonly	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 readonly	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 readonly	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 readonly	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 readonly	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 readonly	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 readonly	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 readonly	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".

Phương thức
Được kế thừa: toJSON

Giao diện RouteModifiers

giao diện google.maps.routes.RouteModifiers

Đó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.

Thuộc tính
avoidFerries không bắt buộc	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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	Loại: VehicleInfo optional Chỉ định thông tin về xe.

Giao diện RoutePolyline3DOptions

giao diện google.maps.routes.RoutePolyline3DOptions

Lưu ý: Chỉ có trong kênh v=alpha.

Các lựa chọn để tạo hình nhiều đường 3D cho tuyến đường.

Thuộc tính
colorScheme không bắt buộc	Loại: ColorScheme optional Bảng phối màu dùng cho hình nhiều đường 3D. 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.create3DPolylines 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 không bắt buộc	Loại: Polyline3DElementOptions|(function(Polyline3DElementOptions, RoutePolylineDetails): Polyline3DElementOptions) optional Các lựa chọn để tuỳ chỉnh kiểu của một hình nhiều đường 3D.
trafficPolylinesDisabled không bắt buộc	Loại: boolean optional Có tắt hình nhiều đường nhận biết tình hình giao thông hay không. Đường đa tuyến nhận biết lưu lượng truy cập chỉ có sẵn khi routingPreference được đặt thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL.

Giao diện RoutePolylineDetails

giao diện google.maps.routes.RoutePolylineDetails

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.

Thuộc tính
speed không bắt buộc	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 không bắt buộc	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 không bắt buộc	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

giao diện google.maps.routes.RoutePolylineOptions

Các lựa chọn để tạo hình nhiều đường cho tuyến đường.

Thuộc tính
colorScheme không bắt buộc	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 không bắt buộc	Loại: PolylineOptions|(function(PolylineOptions, RoutePolylineDetails): 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
thư viện "routes"

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

const {RouteTravelAdvisory} = await google.maps.importLibrary("routes");

Thuộc tính
fuelConsumptionMicroliters readonly	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 readonly	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 readonly	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 readonly	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 readonly	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.

Phương thức
Được kế thừa: toJSON

Hằng số RoutingPreference

hằng số google.maps.routes.RoutingPreference
thư viện "routes"

Một tập hợp các giá trị chỉ định các yếu tố cần xem xét khi tính toán tuyến đường. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại RoutingPreferenceString.

const {RoutingPreference} = await google.maps.importLibrary("routes");

Hằng số
TRAFFIC_AWARE	Tính toán tuyến đường dựa trên tình trạng giao thông trực tiếp. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
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. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
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. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Hằng số Speed

hằng số google.maps.routes.Speed
thư viện "routes"

Phân loại tốc độ của hình nhiều đường dựa trên dữ liệu giao thông. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại SpeedString.

const {Speed} = await google.maps.importLibrary("routes");

Hằng số
NORMAL	Tốc độ bình thường, không bị chậm trễ do giao thông. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
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. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
TRAFFIC_JAM	Tình trạng chậm trễ giao thông. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Giao diện SpeedPath

giao diện google.maps.routes.SpeedPath

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 đó.

Thuộc tính
path	Loại: Array<LatLngAltitude> Đường dẫn được bao gồm trong đường dẫn tốc độ này.
speed không bắt buộc	Loại: Speed optional Tốc độ đọc của đường dẫn.

Lớp SpeedReadingInterval

lớp google.maps.routes.SpeedReadingInterval
thư viện "routes"

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.

const {SpeedReadingInterval} = await google.maps.importLibrary("routes");

Thuộc tính
endPolylinePointIndex readonly	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 readonly	Loại: Speed optional Tốc độ lưu lượng truy cập trong khoảng thời gian này.
startPolylinePointIndex readonly	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.

Lớp StepsOverview

lớp google.maps.routes.StepsOverview
thư viện "routes"

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

const {StepsOverview} = await google.maps.importLibrary("routes");

Thuộc tính
multiModalSegments readonly	Loại: Array<MultiModalSegment> Thông tin tóm tắt về các phân đoạn đa phương thức của RouteLeg.steps.

Phương thức
Được kế thừa: toJSON

Lớp TollInfo

lớp google.maps.routes.TollInfo
thư viện "routes"

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

const {TollInfo} = await google.maps.importLibrary("routes");

Thuộc tính

estimatedPrices readonly

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ệ. Trường này có thể là một mảng trống nếu dự kiến có phí cầu đường nhưng không biết giá ước tính.

Phương thức
Được kế thừa: toJSON

Lớp TransitAgency

lớp google.maps.routes.TransitAgency
thư viện "routes"

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

const {TransitAgency} = await google.maps.importLibrary("routes");

Thuộc tính
name readonly	Loại: string optional Tên của công ty vận tải này.
phoneNumber readonly	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 readonly	Loại: URL optional URL của công ty vận tải.

Phương thức
Được kế thừa: toJSON

Lớp TransitDetails

lớp google.maps.routes.TransitDetails
thư viện "routes"

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.

const {TransitDetails} = await google.maps.importLibrary("routes");

Thuộc tính
arrivalStop readonly	Loại: TransitStop optional Thông tin về điểm dừng đến của bước.
arrivalTime readonly	Loại: Date optional Thời gian đến dự kiến cho bước này.
departureStop readonly	Loại: TransitStop optional Thông tin về điểm khởi hành của bước.
departureTime readonly	Loại: Date optional Thời gian khởi hành dự kiến cho bước này.
headsign readonly	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 readonly	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 readonly	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 readonly	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 readonly	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.

Phương thức
Được kế thừa: toJSON

Lớp TransitLine

lớp google.maps.routes.TransitLine
thư viện "routes"

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

const {TransitLine} = await google.maps.importLibrary("routes");

Thuộc tính
agencies readonly	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 readonly	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 readonly	Loại: URL optional URL của biểu tượng liên kết với dòng này.
name readonly	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 readonly	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 readonly	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 readonly	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 readonly	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.

Phương thức
Được kế thừa: toJSON

Giao diện TransitPreference

giao diện google.maps.routes.TransitPreference

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ề.

Thuộc tính
allowedTransitModes không bắt buộc	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 không bắt buộc	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ư viện "routes"

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

const {TransitStop} = await google.maps.importLibrary("routes");

Thuộc tính
location readonly	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 readonly	Loại: string optional Tên của điểm dừng phương tiện công cộng.

Phương thức
Được kế thừa: toJSON

Lớp TransitVehicle

lớp google.maps.routes.TransitVehicle
thư viện "routes"

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.

const {TransitVehicle} = await google.maps.importLibrary("routes");

Thuộc tính
iconURL readonly	Loại: URL optional URL của biểu tượng liên kết với loại xe này.
localIconURL readonly	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 readonly	Loại: string optional Tên của xe này, viết hoa.
nameLanguage readonly	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 readonly	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ó.

Phương thức
Được kế thừa: toJSON

Hằng số VehicleEmissionType

hằng số google.maps.routes.VehicleEmissionType
thư viện "routes"

Một tập hợp các giá trị mô tả loại khí thải của xe. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại VehicleEmissionTypeString.

const {VehicleEmissionType} = await google.maps.importLibrary("routes");

Hằng số
DIESEL	Xe chạy bằng dầu diesel. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
ELECTRIC	Xe chạy bằng điện. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
GASOLINE	Xe chạy bằng xăng. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
HYBRID	Xe lai (chẳng hạn như xăng + điện). Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Giao diện VehicleInfo

giao diện google.maps.routes.VehicleInfo

Chứa thông tin về xe, chẳng hạn như loại khí thải của xe.

Thuộc tính
emissionType không bắt buộc	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

giao diện google.maps.routes.Waypoint

Đại diện cho một điểm tham chiếu trong tuyến đường.

Thuộc tính
location	Loại: string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place 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 không bắt buộc	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 không bắt buộc	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 không bắt buộc	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

giao diện google.maps.routes.WaypointMarkerDetails

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.

Thuộc tính
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 không bắt buộc	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.