等時區 API 最佳做法

平滑度和保真度

您可以使用 polygon_fidelityenable_smoothing 參數,自訂輸出多邊形的外觀和精確度。雖然這些選項彼此獨立,但會共同決定最終形狀。

  • polygon_fidelity解決方法。控制用於計算可到達區域的基礎格線儲存格 (S2 儲存格) 大小。
    • LOW:使用較大的格線儲存格,最適合涵蓋大範圍區域,不會有間隙,因此會產生一般形狀。
    • MEDIUM:平衡精確度。
    • HIGH:使用較小的格線儲存格。結果會更貼近道路網路,但道路網路稀疏處可能會產生空白區域或「洞」。
    • 預設值:如未指定,服務會根據要求的行程時間動態選取精確度。
  • enable_smoothing美觀。控制由保真度定義的格線儲存格尖銳邊緣是否要圓角。
    • false (原始):傳回確切的幾何計算結果。邊緣會呈現鋸齒狀或階梯狀,反映格線儲存格。最適合用於分析準確度,例如嚴格的點在多邊形內測試。
    • true (平滑):套用後製演算法,將邊角修圓,最適合在地圖上顯示。

互動方式:保真度會設定平滑化演算法的基準詳細資料

  • 高保真度 + 平滑處理:產生細緻的自然形狀,並緊密貼合道路終點。
  • 低保真度 + 平滑處理:產生廣泛的概略「斑點」形狀。

酬載大小和算繪

大型等時區可能包含數千個座標,有效負載則介於 300 到 500 KB 之間。

  • 頻寬:請注意,要求最長持續時間時,JSON 回應大小會相當可觀。
  • 算繪:算繪極為詳細的多邊形會影響效能。建議使用 enable_smoothing 參數或用戶端簡化程式庫,減少顯示的頂點數量。

處理錯誤

針對 5xx 伺服器錯誤,導入指數輪詢重試邏輯。 不過,請不要在未變更參數的情況下重試 4xx 用戶端錯誤:

  • INVALID_ARGUMENT (400):確認時間長度為正數,且在所選模式的限制內。DRIVE 模式的時間長度上限為 3,600 秒,其他模式則為 7,200 秒。
  • NOT_FOUND (404):起點無法對齊道路。請嘗試將座標移近已知街道,或確認該區域是否支援這項功能。