Chỉ định loại mô hình lưu lượng truy cập để sử dụng

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

Các mô hình giao thông sử dụng các thuật toán và yếu tố cụ thể để dự đoán tình trạng giao thông ảnh hưởng đến tổng thời gian di chuyển cho một tuyến đường nhất định như thế nào. Routes API cung cấp nhiều loại mô hình giao thông để ưu tiên các yếu tố khác nhau được dùng trong việc tính toán thời lượng di chuyển trong điều kiện giao thông. Bạn có thể chỉ định loại mô hình giao thông mà bạn muốn tuyến đường của mình sử dụng khi tính toán thời lượng cho các tuyến đường hoặc ma trận tuyến đường. Khi bạn đặt loại mô hình lưu lượng truy cập, giá trị được trả về trong trường duration sẽ khác nhau tuỳ thuộc vào mô hình lưu lượng truy cập mà bạn chọn.

Cả phương thức Routes API Compute Routes và Compute Route Matrix đều hỗ trợ các loại mô hình giao thông.

Theo mặc định, cả hai phương thức đều sử dụng loại mô hình giao thông BEST_GUESS.

Cách chỉ định loại lưu lượng truy cập

  1. Đặt điểm xuất phát và điểm đến.

  2. Nếu thời gian khởi hành của bạn là trong tương lai, hãy thêm thời gian đó bằng tham số departure_time. Nếu bạn không chỉ định thời gian khởi hành, thì thời gian hiện tại sẽ được đặt làm giá trị mặc định.

  3. Đặt tham số routingPreference thành TRAFFIC_AWARE_OPTIMAL. Việc đặt routingPreference thành TRAFFIC_UNAWARE hoặc TRAFFIC_AWARE không tương thích với tham số trafficModel.

  4. Chọn mô hình giao thông để sử dụng với tham số trafficModel và một trong các loại sau:

    • BEST_GUESS (mặc định) để yêu cầu duration_in_traffic được trả về là ước tính tốt nhất về thời gian di chuyển dựa trên những thông tin đã biết về cả tình trạng giao thông trong quá khứ và tình trạng giao thông theo thời gian thực. Tình trạng giao thông theo thời gian thực sẽ trở nên quan trọng hơn khi departure_time gần với thời gian hiện tại. Việc sử dụng loại BEST_GUESS mặc định sẽ đưa ra những dự đoán hữu ích nhất cho phần lớn các trường hợp sử dụng.

    • PESSIMISTIC để yêu cầu duration_in_traffic được trả về mô hình hoá thời gian dựa trên tình trạng giao thông trong quá khứ vào những ngày giao thông tệ. Loại này đưa ra thời lượng ước tính có khả năng dài hơn thời gian di chuyển thực tế vào hầu hết các ngày. Những ngày có tình trạng giao thông đặc biệt tệ vẫn có thể vượt quá mức ước tính này.

    • OPTIMISTIC để yêu cầu duration_in_traffic được trả về mô hình hoá thời gian dựa trên tình trạng giao thông trong quá khứ vào những ngày giao thông tốt. Loại này đưa ra thời lượng ước tính có khả năng ngắn hơn thời gian di chuyển thực tế vào hầu hết các ngày. Những ngày có tình trạng giao thông đặc biệt tốt vẫn có thể nhanh hơn mức ước tính này.

    Ví dụ: 

    "trafficModel": "OPTIMISTIC"

  5. Chỉ định trường routes.duration trong mặt nạ trường.

    REST

    -H X-Goog-FieldMask: routes.duration

    RPC

    const (fieldMask = "routes.duration")

Khi Routes API ước tính thời gian di chuyển trong điều kiện giao thông, API này sẽ sử dụng loại mô hình giao thông mà bạn đã yêu cầu.

Ví dụ: Yêu cầu mô hình giao thông

Ví dụ: yêu cầu này chỉ định rằng thời lượng phải được ước tính bằng loại mô hình giao thông OPTIMISTIC tại một thời gian khởi hành cụ thể:

curl -X POST -H 'content-type: application/json' -d ' {
"origin": {
  "address": "Kyoto, Japan"
  },
"destination": {
  "placeId": "ChIJrYtcv-urAWAR3XzWvXv8n_s"
  },
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE_OPTIMAL",
"trafficModel": "OPTIMISTIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Yêu cầu này trả về thời lượng ước tính bằng loại mô hình giao thông OPTIMISTIC cho chuyến đi:

"duration": "1238s"

Nếu bạn thay đổi loại mô hình giao thông thành PESSIMISTIC, thì thời lượng được trả về sẽ dài hơn:

"duration": "2436s"