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

Mô hình giao thông sử dụng các thuật toán và yếu tố cụ thể để dự đoán mức độ ảnh hưởng của tình trạng giao thông đối với tổng thời gian di chuyển cho một tuyến đường nhất định. Routes API (API Tuyến đường) cung cấp nhiều loại mô hình lưu lượng truy cập để ưu tiên các yếu tố dùng để tính toán thời lượng trong lưu lượng truy cập. Bạn có thể chỉ định kiểu mô hình lưu lượng truy cập mà bạn muốn các tuyến đường sử dụng khi tính 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ả hai phương thức Compute Routes và Compute Route Matrix của API tuyến đều hỗ trợ các loại mô hình lưu lượng truy cập.

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

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

  1. Thiết lập điểm xuất phát và điểm đến.

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

  3. Chọn mô hình lưu lượng truy cập để 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à thông tin ước tính chính xác nhất về thời gian di chuyển, dựa trên những gì đã biết về cả điều kiện giao thông trước đây và lưu lượng truy cập trực tiếp. Lưu lượng truy cập trực tiếp càng trở nên quan trọng hơn khi gần đến thời điểm departure_time. Việc sử dụng loại BEST_GUESS mặc định sẽ đưa ra các 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 điều kiện giao thông trước đây vào những ngày có lưu lượng truy cập xấu. Kiểu này cung cấp thời lượng ước tính rất có thể lâu hơn so với thời gian di chuyển thực tế trong hầu hết các ngày. Một số ngày không thường xuyên với điều kiện đặc biệt xấu vẫn có thể vượt quá số liệu ướ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 điều kiện giao thông trước đây vào những ngày có lưu lượng truy cập tốt. Loại này cung cấp thời lượng ước tính rất có thể ngắn hơn so với thời gian di chuyển thực tế trong hầu hết các ngày. Một số ngày không thường xuyên có điều kiện đặc biệt tốt vẫn có thể nhanh hơn so với số liệu ước tính này.

    Ví dụ: 

    "trafficModel": "OPTIMISTIC"

  4. Chỉ định trường routes.duration trong mặt nạ cho trường (field mask).

    REST

    -H X-Goog-FieldMask: routes.duration

    RPC

    const (fieldMask = "routes.duration")

Khi ước tính thời gian lưu lượng truy cập, Routes API sẽ sử dụng loại mô hình lưu lượng truy cập mà bạn đã yêu cầu.

Ví dụ: Yêu cầu mô hình lưu lượng truy cập

Ví dụ: yêu cầu này chỉ định thời gian ước tính dựa trên loại mô hình lưu lượng truy cập OPTIMISTIC tại một thời điểm 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 cách sử dụng loại mô hình lưu lượng truy cập OPTIMISTIC cho chuyến đi:

"duration": "1238s"

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

"duration": "2436s"