Tổng quan về API tuyến đường

Routes API là một dịch vụ chấp nhận yêu cầu HTTPS và trả về tuyến đường lý tưởng giữa hai vị trí hoặc khoảng cách và thời gian di chuyển cho một ma trận tuyến đường giữa các vị trí xuất phát và đích đến khác nhau.

Lý do sử dụng Routes API

Với API Tuyến đường, bạn có thể nhận 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 mới nhất, cũng như các 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

  • Mối lo ngại về an toàn, chẳng hạn như tránh các khu vực nguy hiểm hoặc cung cấp khu vực nhận hàng 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 đến lấy một loạt các gói hàng

  • 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 API Tuyến đường?

Với API tuyến đường, bạn có thể nhận hai danh mục thông tin định tuyến chính:

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

Nhận 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:

    • Phương tiện đi lại, 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, đích đế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 độ, 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:

  • 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ề.

Nhận ma trận các tuyến đường có thể có

Phương thức Compute Route Matrix của Routes API 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 bắt đầu và điểm cuối, bao gồm cả khoảng cách và thời gian đến dự kiến, để giúp bạn chọn đ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 tính bằng ki lô mét hoặc dặm

  • Thời gian di chuyển ước tính trong tình trạng 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 tính toán toàn bộ ma trận, 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ủ với số lượng nguồn gốc nhân với số lượng đích đến tối đa là 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 API Routes chấp nhận yêu cầu POST HTTP với phần nội dung yêu cầu JSON chứa thông tin chi tiết về yêu cầu. Bạn phải có một đ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 bạn đã yêu cầu.

ComputeRouteMatrix

Routes API ComputeRouteMatrix chấp nhận yêu cầu POST qua HTTP với phần 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ó ít nhất một điểm xuất phát, hai hoặc nhiều điểm đến, travelMode và một mặt nạ trường để chỉ định các trường sẽ 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 API Tuyến 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 các tuyến đường từ một điểm trung gian xuất phát đến một điểm trung gian đích.

Cách sử dụng Routes API

1 Thiết lập Bắt đầu bằng cách Thiết lập dự án Google Cloud và hoàn tất hướng dẫn thiết lập theo 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 bài viết Nhận ma trận tuyến đường và Xem xét phản hồi về ma trận tuyến đường.

Các thư viện ứng dụng hiện có

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

Bước tiếp theo