指定要使用的流量模型類型
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
流量模型會使用特定的演算法和因素來預測流量
條件會影響指定路線的總交通時間。Routes API
提供不同的流量模型類型,以便優先處理
計算流量時間長度您可以指定路線或路線矩陣計算時間時,要使用的交通模型類型。設定流量模型類型時,
duration
欄位會因您選擇的流量模式而異。
Routes API Compute Routes
和
Compute Route Matrix
方法支援流量模型類型。
這兩種方法都預設使用 BEST_GUESS
流量模型類型。
如何指定流量類型
設定出發地和目的地。
如果您的出發時間是未來的時間,請使用
departure_time
參數。如果未指定出發時間,
預設為現在。
選取要搭配 trafficModel
參數使用的流量模型,並
下列其中一種類型:
BEST_GUESS
(預設):要求傳回的 duration_in_traffic
是估計行程時間的最佳目的地
歷來路況和即時路況資訊。即時路況變得更加
departure_time
距離現在的時間越近。使用 BEST_GUESS
的預設類型,可為大多數用途提供最實用的預測結果。
PESSIMISTIC
:要求傳回的 duration_in_traffic
建立
根據無效流量日子的歷來路況計算得出。
這個類型推算出的預估時間長度很可能大於
因此建議在多數日子查看實際行程時間但偶爾路況特別差時,實際交通時間可能會超過這個預估值。
OPTIMISTIC
:要求傳回的 duration_in_traffic
建立
根據良好路況計算出的歷來路況。
這個類型推算出的預估時間長度可能短於
因此建議在多數日子查看實際行程時間但偶爾路況特別好時,實際交通時間可能會短於這個值。
例如:
"trafficModel": "OPTIMISTIC"
在欄位遮罩中指定 routes.duration
欄位。
REST
-H X-Goog-FieldMask: routes.duration
RPC
const (fieldMask = "routes.duration")
Routes API 預估車流量時,會使用
挑選所需的模型類型
範例:流量模型要求
例如,這個請求指定系統會使用
特定出發時間的「OPTIMISTIC
」車流量模型類型:
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'
這項要求會使用 OPTIMISTIC
流量模型傳回預估持續時間
行程的類型:
"duration": "1238s"
如果將流量模型類型變更為 PESSIMISTIC
,傳回的時間長度就會是
更長:
"duration": "2436s"
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-12 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-09-12 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-09-12 (世界標準時間)。"]]