Route Matrix

Lớp RouteMatrix

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

Một ma trận các tuyến đường được tính toán cho một tập hợp các cặp điểm xuất phát/điểm đến bằng RouteMatrix.computeRouteMatrix

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

Phương thức tĩnh

computeRouteMatrix

computeRouteMatrix(request) Tham số: request: ComputeRouteMatrixRequest Giá trị trả về: Promise<{matrix:RouteMatrix}> Nhận danh sách điểm xuất phát và điểm đến, đồng thời trả về một ma trận chứa thông tin về tuyến đường cho mỗi tổ hợp điểm xuất phát và điểm đến. 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 ComputeRouteMatrixRequest.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 (field mask) của thời gian và khoảng cách ở cấp tuyến đường: fields: ['durationMillis', 'distanceMeters'] 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
rows readonly	Loại: Array<RouteMatrixRow> Các hàng của ma trận. Mỗi hàng tương ứng với một điểm xuất phát và chứa một mảng RouteMatrixItem, mỗi hàng đại diện cho một tuyến đường đến một điểm đến.

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

Lớp RouteMatrixRow

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

Tương ứng với một nguồn gốc được truyền đến RouteMatrix.computeRouteMatrix. Chứa danh sách RouteMatrixItem, mỗi mục đại diện cho một tuyến đường đến một điểm đến.

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

Thuộc tính
items readonly	Loại: Array<RouteMatrixItem> Thông tin về tuyến đường cho từng điểm đến.

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

Lớp RouteMatrixItem

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

Chứa thông tin về tuyến đường được tính toán cho một cặp điểm xuất phát/điểm đến được truyền đến RouteMatrix.computeRouteMatrix.

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

Thuộc tính
condition readonly	Loại: RouteMatrixItemCondition optional Cho biết có tìm thấy tuyến đường hay khô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 ComputeRouteMatrixRequest.routingPreference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với RouteMatrixItem.staticDurationMillis. Nếu bạn đặt ComputeRouteMatrixRequest.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.
error readonly	Loại: RouteMatrixItemError optional Lỗi xảy ra trong quá trình tính toán tuyến đường.
fallbackInfo readonly	Loại: FallbackInfo optional Trong một số trường hợp, khi máy chủ không thể tính toán tuyến đường theo lựa chọn ưu tiên đã cho đối với cặp điểm xuất phát/điểm đến cụ thể này, máy chủ có thể quay lại sử dụng một chế độ tính toán khác. Khi sử dụng phương án dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.
localizedValues readonly	Loại: RouteMatrixItemLocalizedValues optional Biểu diễn văn bản của các thuộc tính của RouteMatrixItem.
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.

Giao diện ComputeRouteMatrixRequest

giao diện google.maps.routes.ComputeRouteMatrixRequest

Yêu cầu ma trận tuyến đường.

Thuộc tính
destinations	Loại: Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint> Mảng điểm đến, xác định các cột của ma trận phản hồi. 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.
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.
origins	Loại: Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|RouteMatrixOrigin|Waypoint> Mảng điểm xuất phát, xác định các hàng của ma trận phản hồi. 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. Có một số quy định hạn chế về kích thước áp dụng cho số lượng giá trị riêng biệt của điểm xuất phát và điểm đến: Tổng số điểm xuất phát và điểm đến được chỉ định dưới dạng string hoặc Place không được vượt quá 50. Tích của số điểm xuất phát và số điểm đến không được lớn hơn 625. Tích của số điểm xuất phát và số điểm đến không được lớn hơn 100 nếu ComputeRouteMatrixRequest.routingPreference được đặt thành TRAFFIC_AWARE_OPTIMAL. Tích của số điểm xuất phát và số điểm đến không được lớn hơn 100 nếu ComputeRouteMatrixRequest.travelMode được đặt thành TRANSIT.
arrivalTime không bắt buộc	Loại: Date optional Thời gian đến. Lưu ý: Bạn chỉ có thể đặt khi ComputeRouteMatrixRequest.travelMode được đặt thành TRANSIT. Bạn có thể chỉ định ComputeRouteMatrixRequest.departureTime hoặc ComputeRouteMatrixRequest.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.
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 ComputeRouteMatrixRequest.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<ComputeRouteMatrixExtraComputation> 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 ComputeRouteMatrixRequest.fields để được trả về trong phản hồi.
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 nguồn gốc đầu tiên.
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 điểm xuất phát đầu tiên.
routingPreference không bắt buộc	Loại: RoutingPreference optional Chỉ định cách tính ma trận 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 ma trậ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 ComputeRouteMatrixRequest.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 trả về trong RouteMatrixItem.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. ComputeRouteMatrixRequest.trafficModel chỉ áp dụng cho những yêu cầu đã đặt ComputeRouteMatrixRequest.routingPreference thành TRAFFIC_AWARE_OPTIMAL và ComputeRouteMatrixRequest.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 ComputeRouteMatrixRequest.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ị. 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 đầu tiên.

Hằng số ComputeRouteMatrixExtraComputation

hằng số google.maps.routes.ComputeRouteMatrixExtraComputation
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 ComputeRouteMatrixExtraComputationString.

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

Hằng số
TOLLS	Thông tin về phí cầu đường cho(các) phần tử ma trận. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Hằng số RouteMatrixItemCondition

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

Tình trạng của tuyến đườ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 RouteMatrixItemConditionString.

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

Hằng số
ROUTE_EXISTS	Đã tìm thấy một tuyến đường và thông tin tương ứng đã được điền cho phần tử. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
ROUTE_NOT_FOUND	Không tìm thấy tuyến đường nào. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Lớp RouteMatrixItemError

class google.maps.routes.RouteMatrixItemError extends Error
library "routes"

Lỗi xảy ra trong quá trình RouteMatrix.computeRouteMatrix cho một cặp điểm xuất phát/điểm đến cụ thể.

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

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

Lớp RouteMatrixItemLocalizedValues

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

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

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

Thuộc tính
distance readonly	Loại: string optional Khoảng cách di chuyển của mục ma trận 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. 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ị RouteMatrixItemLocalizedValues.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". Để 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

Giao diện RouteMatrixOrigin

giao diện google.maps.routes.RouteMatrixOrigin

Một nguồn gốc duy nhất cho ComputeRouteMatrixRequest.

Thuộc tính
waypoint	Loại: string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint Vị trí của nguồn gốc. Giá trị được truyền dưới dạng chuỗi có thể là địa chỉ hoặc Plus Code. Giá trị độ cao không được xem xét.
routeModifiers không bắt buộc	Loại: RouteModifiers optional Hệ số điều chỉnh cho mọi tuyến đường lấy tuyến đường này làm điểm xuất phát.