指定是否要納入流量資料，以及如何加入

您選取的流量偏好設定可平衡路線詳細資料的準確度與要求效能。提出要求時，您需要權衡是否應盡可能傳回最準確的結果，或是盡可能快速傳回結果。Routes API 提供的選項可讓您控制回應資料品質與回應延遲時間。

注意： 使用 TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL 的請求會以較高的費率計費。進一步瞭解帳單。

設定流量資料層級

Routes API 提供 RoutingPreference (REST) 和 RoutingPreference (gRPC)，可讓您指定計算路線的路徑偏好設定。這些偏好設定會將交通狀況納入路線計算，但考量程度不同。每個路徑偏好設定的結果，在路線品質、預估到達時間和回應延遲方面都會有所差異。

路況會顯示交通流量速度。例如：

• 在沒有壅塞的情況下，系統會將交通狀況視為正常，並以正常不受阻礙的速度流動。
• 接近尖峰時段，車流密度增加，導致車流速度變慢，造成車流量從輕度到中度。
• 在車水馬龍的交通狀況下，流量率會停滯不前，導致交通擁塞。

不瞭解流量

設定 TRAFFIC_UNAWARE 路徑偏好設定時，系統會計算路線，但不會考量目前的交通狀況。這個路由偏好設定可提供最低的回應延遲時間 (回應會以最快速度傳回)。

TRAFFIC_UNAWARE 為預設設定。

如果選擇 TRAFFIC_UNAWARE，系統會根據路網及與時間無關的平均路況來選擇路線和時間，不會考量目前路況。因此，路線可能會包含暫時封閉的道路。受到路網變動、平均路況更新，以及這項服務的分散性質影響，特定要求的結果可能會隨時間而改變。此外，在時間或頻率都沒有限制的情況下，即使兩條路線幾乎相同，結果還是有可能不同。

在回應中：

• 預估抵達時間包含在 duration 回應屬性中。

• duration 和 staticDuration 回應屬性包含相同的值。

如要盡快取得回應，且大致的路線詳細資料就足夠時，請使用這個路線偏好設定。

注意： 這項設定等同於在 Directions API 和 Distance Matrix API 中不使用目前的車流量。

交通感知

設定 TRAFFIC_AWARE 路線偏好設定時，系統會根據目前的交通狀況計算路線。因此，路線和路線詳細資料可更準確地反映實際情況。由於提高資料品質會導致回應延遲時間增加，因此我們會套用效能最佳化設定，盡可能減少延遲時間。

在回應中：

• duration 回應資源包含考量即時流量的預估廣告費用。

• staticDuration 回應屬性包含路線的旅行時間，不考慮交通狀況。

如需比 TRAFFIC_UNAWARE 更準確的路徑詳細資料，但不介意回應的延遲時間略微增加，請使用這個路徑偏好設定。

注意： 這項設定是路徑 API 的新功能，在 Directions API 和 Distance Matrix API 中沒有對應的功能。

車流量監測最佳路線

設定 TRAFFIC_AWARE_OPTIMAL 路由偏好設定時，系統會根據目前的交通狀況計算路線，但不會套用效能最佳化設定。在這個模式中，伺服器會更徹底地搜尋道路網路，找出最佳路線。

TRAFFIC_AWARE_OPTIMAL 路徑偏好設定等同於 maps.google.com 和 Google 地圖行動應用程式使用的模式。

搭配 Compute Route Matrix 使用此選項時，要求中的元素數 (起點數 × 目的地數) 不得超過 100。如要進一步瞭解 Compute Route Matrix 的限制，請參閱「計算路徑矩陣」。

在回應中：

• duration 回應資源包含考量即時流量的預估廣告費用。

• staticDuration 回應屬性包含路線的旅行時間，不考慮交通狀況。

這個轉送偏好設定會提供最高的回應延遲時間 (也就是回應的回傳延遲時間最長)。如要取得最高品質的結果，不考慮回應所需的時間，請使用這個路由偏好設定。

注意： 這個選項等同於在 Directions API 和 Distance Matrix API 中指定 departure_time。

設定出發時間的影響

您可以選擇使用 departureTime 屬性來設定行程的出發時間。如果您未設定 departureTime 屬性，則預設為您提出要求的時間。

• 對於 TRAFFIC_UNAWARE，您無法設定 departureTime，因為路線和所需時間的選擇取決於路網，以及不考慮時間的平均路況。

• 對於考量即時車流量狀況的 TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL，departureTime 距離現在的時間越近，即時車流量的影響力就越大。您設定的出發時間越晚，系統就會越重視歷來交通狀況。

設定路徑偏好設定的範例

下列 JSON 程式碼示範如何在要求訊息實體主體中設定路由偏好設定。

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}

設定折線上的車流量

您可以使用 Routes API 要求沿著路況感知折線的路況資訊。詳情請參閱「要求多邊形線」。