Lý do sử dụng Routes API
Với Routes API, bạn có thể nhận được thông tin chính xác về tuyến đường và chuyến đi bằng cách sử dụng thông tin chi tiết về phương tiện giao thông, tình trạng giao thông và đường sá mới nhất cũng như lựa chọn ưu tiên về tuyến đường:
Loại và chức năng của các phương tiện giao thông
Xe đang đi theo hướng nào
Bờ đường để đón hoặc trả khách
Tình trạng giao thông và đường bị đóng
Vấn đề về an toàn, chẳng hạn như tránh khu vực nguy hiểm hoặc cung cấp khu vực đón khách an toàn
Cân bằng độ trễ, chất lượng và chi phí theo các nhu cầu định tuyến của bạn bằng các tính năng không bắt buộc, chẳng hạn như phí cầu đường và siêu dữ liệu về chuyến đi, chẳng hạn như thời gian và quãng đường, cũng như hiệu suất nhiên liệu
Bạn cũng có thể xác định các tuyến đường hiệu quả nhất để lên lịch điều phối, chẳng hạn như:
Cách tốt nhất để chỉ định một nhóm worker để nhận một loạt gói
Xác định kho hàng tốt nhất để vận chuyển các gói hàng đến điểm đến cuối cùng
Bạn có thể làm gì với Routes API?
Với Routes API, bạn có thể nhận được hai danh mục chính về thông tin định tuyến:
Tuyến đường từ một vị trí đến một hoặc nhiều đích đến
Ma trận các tuyến đường có thể có giữa nhiều vị trí bắt đầu và kết thúc.
Xem tuyến đường cho một hoặc nhiều điểm đến
Với phương thức Compute Routes
của Routes API (API Tuyến đường), bạn có thể tính toán giữa các vị trí:
Xem đường đi cho nhiều cách di chuyển và cho một hoặc nhiều điểm đến:
Các phương tiện giao thông, bao gồm phương tiện công cộng, lái xe, xe hai bánh, đi bộ hoặc đi xe đạp.
Một loạt điểm tham chiếu mà bạn có thể tối ưu hoá nhằm đạt được thứ tự hiệu quả nhất để di chuyển các điểm đó.
Nhiều cách để chỉ định điểm xuất phát, điểm đến và điểm trung gian:
Chuỗi văn bản. Ví dụ: "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043" hoặc "CWF6+FWX Mountain View, California"
Mã địa điểm
Toạ độ vĩ độ và kinh độ, tuỳ chọn có hướng xe
Điều chỉnh các lựa chọn tuyến đường dựa trên nhu cầu và mục tiêu của bạn:
Chọn tuyến đường tiết kiệm nhiên liệu hoặc tiết kiệm năng lượng cho loại động cơ của xe: Dầu diesel, Điện, Kết hợp, Xăng. Để biết thêm thông tin, hãy xem bài viết Xem tuyến đường thân thiện với môi trường.
Đặt các tuỳ chọn chi tiết để tính toán lưu lượng truy cập, cho phép bạn đưa ra quyết định đánh đổi chất lượng với độ trễ. Để biết thông tin chi tiết, hãy xem phần Chỉ định cách thức và xem xét việc có nên thêm dữ liệu lưu lượng truy cập hay không.
Thiết lập hướng đi của xe (hướng đi) và thông tin bên đường cho các điểm tham chiếu để tăng độ chính xác của Giờ đến dự kiến. Để biết thông tin chi tiết, hãy xem phần Chỉ định hướng và bên đường của xe.
Chỉ định vị trí đi qua so với vị trí cuối cùng và vị trí dừng an toàn. Để biết thông tin chi tiết, hãy xem phần Đặt điểm dừng dọc theo một tuyến đường và Đặt một điểm cho tuyến đường sẽ đi qua.
Yêu cầu thông tin phí cầu đường, cùng với khoảng cách tuyến đường và giờ đến dự kiến. Để biết thông tin chi tiết, hãy xem phần Tính phí cầu đường cho một tuyến đường.
Kiểm soát độ trễ và chất lượng của bạn bằng cách chỉ yêu cầu dữ liệu bạn cần qua mặt nạ trường. Điều này giúp bạn tránh thời gian xử lý không cần thiết và tăng tỷ lệ thanh toán cho các yêu cầu. Để biết thông tin chi tiết, hãy xem phần Chọn thông tin cần trả về.
Lấy ma trận các tuyến đường có thể có
Phương thức Compute Route Matrix
của API tuyến đường cung cấp một ma trận thông tin cho các tuyến đường được đề xuất giữa nhiều điểm xuất phát và điểm đến, bao gồm cả khoảng cách và thời gian đến ước tính, để giúp bạn chọn những điểm xuất phát và điểm đến tốt nhất dựa trên nhu cầu kinh doanh của mình. Bạn có thể yêu cầu các loại dữ liệu khoảng cách sau:
Quãng đường cho một phương tiện đi lại đã chọn
Khoảng cách theo ki lô mét hoặc dặm
Thời gian di chuyển ước tính khi giao thông
Với dữ liệu khoảng cách, bạn có thể xác định cách hiệu quả nhất để định tuyến hành khách, lô hàng hoặc nhân viên giữa nhiều điểm xuất phát và điểm đến có thể có.
Bạn có thể truyền trực tuyến các phần tử của phản hồi trước khi toàn bộ ma trận được tính toán, giúp giảm độ trễ phản hồi.
Bạn có thể chỉ định nhiều nguồn gốc và đích đến cho mỗi yêu cầu phía máy chủ bằng số nguồn nhân với số lượng đích lên đến 625.
Cách hoạt động của API Tuyến đường
API Tuyến có 2 phương thức: ComputeRoutes
và ComputeRouteMatrix
.
ComputeRoutes
Phương thức ComputeRoutes
của Routes API chấp nhận yêu cầu POST qua HTTP có nội dung yêu cầu JSON chứa thông tin chi tiết về yêu cầu. Bắt buộc phải có một điểm khởi hành, đích đến, TravelMode và mặt nạ trường để chỉ định các trường cần trả về.
Ví dụ:
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Sau đó, dịch vụ sẽ tính toán tuyến đường được yêu cầu và trả về các trường mà bạn yêu cầu.
ComputeRouteMatrix
API Tuyến ComputeRouteMatrix
chấp nhận yêu cầu POST qua HTTP có nội dung yêu cầu JSON có chứa thông tin chi tiết về yêu cầu. Bắt buộc phải có ít nhất một điểm gốc, hai hoặc nhiều đích đến, TravelMode và một mặt nạ trường để chỉ định trường nào cần trả về.
Ví dụ:
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
Phản hồi chứa các tuyến đường có thể có cho tổ hợp tất cả các điểm trung gian nguồn và đích.
Tài nguyên
Bảng sau đây tóm tắt các tài nguyên có sẵn thông qua Routes API cùng với dữ liệu mà API này trả về.
Tài nguyên dữ liệu | Dữ liệu được trả về | Định dạng trả về |
---|---|---|
ComputeRoutes | Trả về các tuyến đường, chặng và bước cho một tuyến đường, cùng với các tuyến đường thay thế, nếu được yêu cầu. | JSON |
ComputeRouteMatrix | Trả về một mảng tuyến từ một điểm tham chiếu gốc đến một điểm tham chiếu đích. |
Cách sử dụng Routes API
1 | Thiết lập | Hãy bắt đầu bằng việc Thiết lập dự án Google Cloud và hoàn thành hướng dẫn thiết lập sau đó. |
2 | Tính toán tuyến đường và xem xét phản hồi | Để biết thêm thông tin, hãy xem phần Nhận tuyến và Xem xét phản hồi tuyến. |
3 | Tính toán ma trận tuyến đường và xem xét phản hồi | Để biết thêm thông tin, hãy xem phần Lấy ma trận tuyến đường và Xem phản hồi của ma trận tuyến đường. |
Thư viện ứng dụng hiện có
Để biết danh sách các thư viện ứng dụng có sẵn cho API tuyến, hãy xem Thư viện ứng dụng.