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

Tại sao nên sử dụng API Tuyến đường

Với API Tuyến đường, bạn có thể nhận được các tuyến đường và thông tin chuyến đi chính xác sử dụng thông tin về giao thông, tình trạng giao thông, đường bộ và tuyến đường mới nhất tùy chọn:

• Loại và khả năng của các phương thức vận tải khác nhau

• Xe đang đi theo hướng nào

• lề đường để đón hoặc trả xe

• 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 đón nhận an toàn các khu vực

• 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 với các lựa chọn không bắt buộc các tính năng như phí cầu đường và siêu dữ liệu về chuyến đi, chẳng hạn như thời gian, quãng đường và nhiên liệu hiệu quả

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ư dưới dạng:

• 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 phù hợp nhất để vận chuyển các gói hàng đến kho hàng cuối cùng điểm đến

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 được hai danh mục định tuyến chính của bạn:

• Tuyến đường từ một vị trí đến một hoặc nhiều điểm đế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 các cách di chuyển và cho một hoặc nhiều cách di chuyển điểm đến:

  • 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á để có đơn hàng hiệu quả nhất đưa họ đến.

• 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

  • Vĩ độ và kinh độ, không bắt buộc kèm theo 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 năng lượng cho loại động cơ xe của bạn: Dầu diesel, điện, xăng lai điện, xăng. Để biết thêm thông tin, hãy xem 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, giúp bạn đảm bảo chất lượng với quyết định đánh đổi độ trễ. Để biết thông tin chi tiết, hãy xem Chỉ định cách thức và trường hợp nên đưa dữ liệu lưu lượng truy cập vào.

  • Đặt hướng đi của xe (hướng đi) và thông tin bên đường cho tham chiếu để tăng độ chính xác của ETA. Để biết thông tin chi tiết, hãy xem Chỉ định hướng xe và lề đường.

  • Chỉ định vị trí xuyên qua so với nhà ga và vị trí dừng an toàn. Cho chi tiết, xem Đặt điểm dừng dọc theo một tuyến đường và Đặt một điểm cho tuyến đường đ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, xem 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 mà bạn cần sử dụng mặt nạ trường, giúp bạn tránh thời gian xử lý không cần thiết và yêu cầu mức giá thanh toán. Để biết thông tin chi tiết, hãy xem 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 (API Tuyến đường) cung cấp 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 kết thúc điểm, bao gồm 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 họ. 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 về khoảng cách, bạn có thể xác định cách định tuyến hiệu quả nhất hành khách, hàng vận chuyển hoặc công nhân giữa nhiều điểm xuất phát và đích đến.

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 xử lý 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ố lượng điểm gốc nhân với số lượng đích đến, lên tới 625.

Cách hoạt động của API Tuyến đường

API Tuyến đường 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 bằng 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 là nguồn gốc, đích đến, TravelMode và mặt nạ trường để chỉ định những trường cần trả về.

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 đường ComputeRouteMatrix chấp nhận yêu cầu POST qua HTTP bằng 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 khởi hành, hai hoặc nhiều điểm đến, TravelMode và một mặt nạ trường để chỉ định cần trả về.

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 có thể dùng cho tổ hợp của tất cả nguồn gốc và điểm tham chiếu đí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 Định tuyến API cùng với dữ liệu mà API trả về.

Cách sử dụng API 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.

Các bước tiếp theo

• Các tuyến đường hiện có
• Chọn thông tin cần trả lại
• Di chuyển từ API Chỉ đường hoặc API Ma trận khoảng cách
• Di chuyển từ bản xem trước API Tuyến đường sang GA