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

Mô hình lưu lượng truy cập 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 các điều kiện giao thông đối với tổng thời gian di chuyển cho một tuyến đường nhất định. 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 trong việc tính toán thời lượng trong lưu lượng truy cập. Bạn có thể chỉ định loại 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 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ẽ thay đổi 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 Compute RoutesCompute Route Matrix của API Tuyến đường đề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.

Để xác định một loại lưu lượng truy cập

  1. Đặt điểm khởi hành và điểm đến của bạn.

  2. Nếu thời gian khởi hành của bạn là một ngày trong tương lai, hãy thêm thời gian bằng cách sử dụng thông 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ẽ được đặ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 thông 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ời gian di chuyển ước tính chính xác nhất, dựa trên thông tin đã biết về cả tình trạng giao thông trước đây và tình hình giao thông trực tiếp. Lưu lượng truy cập trực tiếp càng quan trọng khi departure_time càng gần thời điểm hiện tại. Việc sử dụng loại mặc định của BEST_GUESS sẽ đưa ra những dự đoán hữu ích nhất cho hầu hết các trường hợp sử dụng.

    • PESSIMISTIC để yêu cầu duration_in_traffic được trả về lập mô hình thời gian dựa trên tình trạng giao thông trước đây vào những ngày có lưu lượng truy cập không tốt. Loại này cung cấp thời lượng ước tính rất có thể 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 thỉnh thoảng có đ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 các điều kiện lưu lượng truy cập 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 có khả năng ngắn hơn so với thời gian di chuyển thực tế vào hầu hết các ngày. Đôi khi, những ngày có điều kiện đặc biệt tốt vẫn có thể nhanh hơn thời gian ước tính này.

    Ví dụ:

    "trafficModel": "OPTIMISTIC"

  4. 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 ước tính thời gian lưu lượng truy cập, API tuyến đường 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 lượng được ước tính bằng cách sử dụng 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 được trả về sẽ dài hơn:

"duration": "2436s"