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 lưu lượng truy cập ảnh hưởng đến tổng thời gian di chuyển cho một tuyến đường nhất định. API Tuyến đường cung cấp các loại mô hình lưu lượng truy cập khác nhau để ưu tiên các yếu tố khác nhau được sử dụng trong tính toán thời lượng tham gia 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ình muốn như tuyến đường để sử dụng khi tính toán thời gian cho tuyến đường hoặc tuyến đường của bạn ma trận. 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 khác nhau tuỳ thuộc vào mô hình lưu lượng truy cập mà bạn chọn.

Cả API tuyến Compute Routes và Phương thức Compute Route Matrix 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 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 Tham số departure_time. Nếu bạn không chỉ định thời gian khởi hành, 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à giao thông trực tiếp. Lưu lượng truy cập trực tiếp trở nên nhiều hơn điều quan trọng là departure_time càng gần bây giờ. Đang sử dụng loại mặc định của BEST_GUESS đư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 đã trả về tạo mô hình dựa trên điều kiện giao thông trước đây vào những ngày giao thông xấu. Loại này đưa ra 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. Đôi khi có những ngày cực kỳ xấu điều kiện vẫn có thể vượt quá số liệu ước tính này.

    • OPTIMISTIC để yêu cầu duration_in_traffic đã trả về tạo mô hình 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 đưa ra thời lượng ước tính rất có thể sẽ 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 không thường xuyên với sự kiện đặc biệt điều kiện tốt vẫn có thể nhanh hơn ước tính này.

    Ví dụ: 

    "trafficModel": "OPTIMISTIC"

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

    Kiến trúc chuyển trạng thái đại diện (REST)

    -H X-Goog-FieldMask: routes.duration

    RPC

    const (fieldMask = "routes.duration")

Khi ước tính thời gian tham gia giao thông, API tuyến đường sử dụng lưu lượng truy cập đó loại mô hình 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 rằng thời lượng được ước tính bằng cách sử dụng OPTIMISTIC loại mô hình lưu lượng truy cập tại thời điểm xuất phát 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 mô hình lưu lượng truy cập OPTIMISTIC nhập 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ời lượng được trả về sẽ là dài hơn:

"duration": "2436s"