Route Matrix

Lớp RouteMatrix

Lớp google.maps.routes.RouteMatrix

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

Truy cập bằng cách gọi const {RouteMatrix} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.

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	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
toJSON	toJSON() Tham số:  Không có Giá trị trả về:  Object Chuyển đổi thành một đối tượng.

Lớp RouteMatrixRow

Lớp google.maps.routes.RouteMatrixRow

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.

Truy cập bằng cách gọi const {RouteMatrixRow} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.

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

Phương thức
toJSON	toJSON() Tham số:  Không có Giá trị trả về:  Object Chuyển đổi thành một đối tượng.

Lớp RouteMatrixItem

Lớp google.maps.routes.RouteMatrixItem

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.

Truy cập bằng cách gọi const {RouteMatrixItem} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.

Thuộc tính
condition	Loại:  RouteMatrixItemCondition optional Cho biết có tìm thấy tuyến đường hay không.
distanceMeters	Loại:  number optional Quãng đường di chuyển của tuyến đường, tính bằng mét.
durationMillis	Loại:  number optional Thời gian cần thiết để di chuyển theo tuyến đường, tính bằng mili giây. Nếu bạn đặt 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	Loại:  RouteMatrixItemError optional Lỗi xảy ra trong quá trình tính toán tuyến đường.
fallbackInfo	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	Loại:  RouteMatrixItemLocalizedValues optional Biểu diễn văn bản của các thuộc tính của RouteMatrixItem.
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.

Phương thức
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 ComputeRouteMatrixRequest

google.maps.routes.ComputeRouteMatrixRequest giao diện

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 optional	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 optional	Loại:  Date optional Thời gian khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời điểm bạn gửi yêu cầu. Lưu ý: Bạn chỉ có thể chỉ định thời gian trong quá khứ khi 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 optional	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.
language optional	Loại:  string optional Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem bài viết Giá trị nhận dạng ngôn ngữ Unicode. Hãy xem phần Hỗ trợ ngôn ngữ để biết danh sách các ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ sẽ được suy luận từ chế độ cài đặt bản địa hoá của Google Maps JavaScript API. Nếu không, ngôn ngữ sẽ được suy luận từ vị trí của nguồn gốc đầu tiên.
region optional	Loại:  string optional Mã khu vực, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Để biết thêm thông tin, hãy xem bài viết Miền cấp cao nhất theo mã quốc gia. Khi bạn không cung cấp giá trị này, khu vực sẽ được suy luận từ chế độ cài đặt bản địa hoá của Google Maps JavaScript API. Nếu không, khu vực sẽ được suy luận từ vị trí của điểm xuất phát đầu tiên.
routingPreference optional	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 optional	Loại:  TrafficModel optional Chỉ định các giả định cần sử dụng khi tính toán thời gian trong tình trạng giao thông. Chế độ cài đặt này ảnh hưởng đến giá trị được 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 optional	Loại:  TransitPreference optional Chỉ định các lựa chọn ưu tiên ảnh hưởng đến tuyến đường được trả về cho tuyến đường TRANSIT. Lưu ý: Bạn chỉ có thể chỉ định khi ComputeRouteMatrixRequest.travelMode được đặt thành TRANSIT.
travelMode optional	Loại:  TravelMode optional Chỉ định phương thức di chuyển.
units optional	Loại:  UnitSystem optional Chỉ định đơn vị đo lường cho các trường hiển thị. 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

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

Truy cập bằng cách gọi const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.

Hằng số
TOLLS	Thông tin về phí cầu đường cho(các) mục ma trận.

Hằng số RouteMatrixItemCondition

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

Tình trạng của một tuyến đường cho một cặp điểm xuất phát/điểm đến nhất định.

Truy cập bằng cách gọi const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.

Hằng số
ROUTE_EXISTS	Đã tìm thấy một tuyến đường.
ROUTE_NOT_FOUND	Không tìm thấy tuyến đường nào.

Lớp RouteMatrixItemError

Lớp google.maps.routes.RouteMatrixItemError

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

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

Truy cập bằng cách gọi const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.

Phương thức
toJSON	toJSON() Tham số:  Không có Giá trị trả về:  Object Chuyển đổi thành một đối tượng.

Lớp RouteMatrixItemLocalizedValues

Lớp google.maps.routes.RouteMatrixItemLocalizedValues

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

Truy cập bằng cách gọi const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
Xem Thư viện trong API JavaScript của Maps.

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

Phương thức
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 RouteMatrixOrigin

google.maps.routes.RouteMatrixOrigin giao diện

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