平滑度和保真度
您可以使用 polygon_fidelity 和 enable_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):起點無法對齊道路。請嘗試將座標移近已知街道,或確認該區域是否支援這項功能。