Route Matrix (beta)

Lớp RouteMatrix

Lớp google.maps.routes.RouteMatrix

Ma trận các tuyến đường do RouteMatrix.computeRouteMatrix tính toán cho một tập hợp các cặp điểm khởi hành/đích đến

Truy cập bằng cách gọi const {RouteMatrix} = await google.maps.importLibrary("routes").
Xem Thư viện trong Maps JavaScript API.
computeRouteMatrix
computeRouteMatrix(request)
Tham số: 
Giá trị trả về:  Promise<{matrix:RouteMatrix}>
Nhận danh sách các đ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 từng 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ị 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 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ạ 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.
rows
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 RouteMatrixItem đại diện cho một tuyến đường đến một điểm đế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 RouteMatrixRow

Lớp google.maps.routes.RouteMatrixRow

Tương ứng với một nguồn được truyền đến RouteMatrix.computeRouteMatrix. Chứa danh sách các 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 Maps JavaScript API.
items
Thông tin về tuyến đường cho từng điểm đế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 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 khởi hành/đích đế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 Maps JavaScript API.
condition
Loại:  RouteMatrixItemCondition optional
Cho biết tuyến đường có được tìm thấy 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
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 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 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.
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 các lựa chọn ưu tiên đã cho đối với cặp điểm xuất phát/đích đến cụ thể này, thì 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 sẽ 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
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.

Giao diện ComputeRouteMatrixRequest

google.maps.routes.ComputeRouteMatrixRequestgiao diện

Yêu cầu ma trận tuyến đường.
destinations
Mảng đích đế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ỉ, mã cộng 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
Mảng nguồn gốc, 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ỉ, mã cộng hoặc tên tài nguyên Địa điểm. Giá trị độ cao không được xem xét.

Một số quy định hạn chế về kích thước được áp dụng cho số lượng giá trị riêng biệt của nguồn và đích đến:
  • Tổng số điểm xuất phát và điểm đến được chỉ định là string hoặc Place không được vượt quá 50.
  • Tích số của số lượng điểm xuất phát và số lượng điểm đến không được lớn hơn 625.
  • Tích số của số lượng điểm xuất phát và điểm đến không được lớn hơn 100 nếu ComputeRouteMatrixRequest.routingPreference được đặt thành TRAFFIC_AWARE_OPTIMAL.
  • Tích số của số lượng điểm xuất phát và đ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 là 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 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 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
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 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 nguồn gốc đầu tiê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 gốc đầ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ề định tuyến đã 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ì 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 di chuyển. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong RouteMatrixItem.durationMillis. Giá trị này chứa thời gian dự đoán khi có lưu lượng truy cập dựa trên mức trung bình trong quá khứ. ComputeRouteMatrixRequest.trafficModel chỉ dành 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 các tuyến đường TRANSIT.

Lưu ý: Chỉ có thể được chỉ định khi ComputeRouteMatrixRequest.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ị. 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 đầ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 Maps JavaScript API.
TOLLS Thông tin về phí cầu đường cho(các) mục trong 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 khởi hành/đ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 Maps JavaScript API.
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 nguồn/đích 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 Maps JavaScript API.
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 Maps JavaScript API.
distance
Loại:  string optional
Quãng đường đi 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. 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, giá trị này sẽ giống với giá trị của 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 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ướ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.
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.RouteMatrixOrigingiao diện

Một nguồn gốc duy nhất cho một ComputeRouteMatrixRequest.
waypoint
Vị trí của nguồn. Giá trị được truyền dưới dạng chuỗi có thể là địa chỉ hoặc plus code. Giá trị độ cao cho không được xem xét.
routeModifiers optional
Loại:  RouteModifiers optional
Đối tượng sửa đổi cho mọi tuyến đường lấy tuyến đường này làm điểm xuất phát.