Tổng quan về tính toán tuyến đường

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

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 thông tin đường đi kèm theo tình hình giao thông theo thời gian thực cho phương tiện công cộng, xe đạp, ô tô, xe máy hoặc đi bộ giữa nhiều địa điểm.

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ề Compute Route Matrix.

Bạn đang di chuyển? Nếu bạn đang di chuyển từ Distance Matrix API (Phiên bản cũ), hãy xem hướng dẫn di chuyển bắt đầu từ phần 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 ý muốn, đồng thời tối ưu hoá chi phí và chất lượng nhờ nhiều thông tin chi tiết về tuyến đường.

Bạn có thể làm gì 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 phương tiện di chuyển, cũng như cho một hoặc nhiều điểm đến:

    • Phương tiện giao thông: phương tiện công cộng, lái xe, xe hai bánh, xe tải, đ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á để có thứ tự di chuyển hiệu quả nhất.

  • 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 của xe

  • Tinh 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:

  • 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 thông qua mặt nạ trường. Việc này giúp bạn tránh được thời gian xử lý không cần thiết và tỷ lệ thanh toán yêu cầu cao hơn. Để biết thông tin 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 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ụ 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, 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

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 Google Cloud rồi hoàn tất các hướng dẫn thiết lập sau đây.
2 Tìm hiểu cách tính phí của Routes API Để biết thông tin, hãy xem phần Mức sử dụng và thanh toán.
3 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 bài viết Lấy tuyến đường và Xem xét phản hồi về tuyến đường.

Thư viện ứng dụng hiện có

Để xem danh sách các thư viện ứng dụng có sẵn cho Compute Routes, hãy xem phần Thư viện ứng dụng.

Bước tiếp theo