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 điều kiện giao thô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
thay đổi 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
.
Để xác định một loại lưu lượng truy cập
Đặt điểm xuất phát và điểm đến.
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 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ì thời gian khởi hành mặc định sẽ là hiện tại.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ầuduration_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 càng quan trọng khideparture_time
càng gần thời điểm hiện tại. Việc sử dụng loại mặc định củaBEST_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ầuduration_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ầuduration_in_traffic
được trả về mô hình hoá thời gian dựa trên đ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 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"
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 trong 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 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 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ì thời lượng được trả về sẽ dài hơn:
"duration": "2436s"