Giới thiệu
Compute Routes là một phương thức trong dịch vụ Routes API, chấp nhận yêu cầu HTTPS và trả về tuyến đường lý tưởng giữa hai vị trí. Cung cấp chỉ đường với thông tin giao thông theo thời gian thực cho phương tiện công cộng, xe đạp, xe ô tô, xe cơ giới 2 bánh hoặc đi bộ giữa nhiều vị trí.
Bạn cần ma trận tuyến đường? Nếu bạn quan tâm đến ma trận tuyến đường, hãy xem phần Tổng quan về việc tính toán ma trận tuyến đường.
Bạn có đang di chuyển không? Nếu bạn đang di chuyển từ Distance Matrix API (cũ), hãy xem hướng dẫn di chuyển bắt đầu từ Lý do nên di chuyển sang Routes API.
Lý do nên sử dụng Compute Routes
Với Compute Routes, bạn có thể định tuyến xe hoặc gói hàng theo lựa chọn ưu tiên của mình trong khi tối ưu hoá chi phí và chất lượng nhờ nhiều thông tin chi tiết về tuyến đường.
Những việc bạn có thể làm với Compute Routes
Với phương thức Compute Routes
của Routes API, bạn có thể làm những việc sau:
Xem đường đi cho nhiều cách di chuyển, cũng như cho một hoặc nhiều đích đến:
Phương tiện di chuyển: 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 các điểm tham chiếu mà bạn có thể tối ưu hoá để có được thứ tự hiệu quả nhất khi di chuyển đến các điểm đó.
Sử dụng nhiều cách để chỉ định điểm xuất phát, điểm đến và điểm tham chiếu:
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 độ, có thể kèm theo hướng di chuyển của xe
Điều chỉnh các lựa chọn cho 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 năng lượng theo loại động cơ xe của bạn: 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 Tìm tuyến đường thân thiện với môi trường.
Đặt các lựa chọn chi tiết cho việc tính toán lưu lượng truy cập, cho phép bạn đưa ra quyết định đánh đổi giữa chất lượng và độ trễ. Để biết thông tin chi tiết, hãy xem phần Chỉ định cách thức và liệu có nên thêm dữ liệu lưu lượng truy cập hay không.
Đặt hướng đi của xe (hướng di chuyển) và thông tin về lề đường cho các điểm tham chiếu để tăng độ chính xác của thời gian đến dự kiến. Để biết thông tin chi tiết, hãy xem bài viết Chỉ định hướng và lề đường của xe.
Chỉ định vị trí đi qua so với vị trí cuối và vị trí dừng chân an toàn. Để biết thông tin chi tiết, hãy xem bài viết Đặt điểm dừng dọc theo tuyến đường và Đặt điểm để tuyến đường đi qua.
Yêu cầu thông tin về phí cầu đường, cùng với khoảng cách và giờ đến dự kiến của tuyến đường. Để biết thông tin chi tiết, hãy xem bài viết Tính phí cầu đường cho một tuyến đường.
Kiểm soát độ trễ và chất lượng bằng cách chỉ yêu cầu dữ liệu bạn cần bằng cách sử dụng mặt nạ trường. Việc này giúp bạn tránh thời gian xử lý không cần thiết và mức phí thanh toán yêu cầu cao hơn. Để biết chi tiết, hãy xem phần Chọn thông tin cần trả về.
Cách hoạt động của Compute Routes
Phương thức ComputeRoutes
của Routes API chấp nhận yêu cầu HTTP POST có nội dung yêu cầu là JSON chứa thông tin chi tiết về yêu cầu. Bạn cần có điểm xuất phát, điểm đến, travelMode
và mặt nạ trường để chỉ định những 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ụ này 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.
Tài nguyên
Bảng sau đây tóm tắt các tài nguyên có sẵn thông qua phương thức Compute Routes của Routes API, cùng với dữ liệu mà phương thức 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, đoạn đườ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 |
Cách sử dụng Compute Routes
1 | Thiết lập | Bắt đầu bằng cách Thiết lập dự án trên Google Cloud và hoàn tất các hướng dẫn thiết lập tiếp theo. |
2 | Tìm hiểu cách Routes API tính phí | Để biết thông tin, hãy xem phần Mức sử dụng và phí thanh toán. |
3 | Tính toán một 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 một tuyến đường và Xem xét các phản hồi về tuyến đường. |
Các thư viện ứng dụng hiện có
Để xem danh sách các thư viện ứng dụng hiện có cho Compute Routes, hãy xem Thư viện ứng dụng.
Bước tiếp theo
- Xem tuyến đường
- Các lựa chọn về tuyến đường hiện có
- Chọn thông tin cần trả về
- Di chuyển từ Directions API (cũ)
- Di chuyển từ bản dùng thử Routes API sang phiên bản GA