如要產生等時線，請向 API 提供起點、交通方式 (例如開車、騎自行車或步行) 和時間限制。您也可以調整路徑偏好設定，以及產生的多邊形外觀。
時間範圍
您提供給服務的主要限制是 travel_duration。這會定義計算的時間範圍。
- 時間上限：API 支援
DRIVE模式的行程時間上限為 3600 秒 (1 小時)，WALK和BICYCLE模式則為 7200 秒 (2 小時)。 - 效能：計算時間會隨著要求時間長度和所選交通方式而變化。與步行等時線相比，一小時的開車等時線涵蓋的地理區域和路網範圍明顯較大，因此開車要求延遲時間較長。
起點和道路對齊
您可以透過下列兩種方式指定等時線的起點：
- 座標：一組經緯度 (
location)。 - 地點 ID：Google 地圖上特定地點的專屬 ID (
place)。提供地點 ID 後，服務會將該地點的質心做為原點。請注意，API 預期資源名稱格式為places/ChIJ...。如要進一步瞭解地點 ID，請參閱「地點 ID」。
無論輸入方法為何，如果該點不在道路上 (例如公園或建築物內)，API 就不會從確切的實體點計算行程時間。為處理這種情況，服務會使用道路對齊功能。道路對齊功能具備下列特色：
- 智慧吸附：服務會嘗試將起點吸附到最近的可穿越路段。
- 模式感知：路徑對齊邏輯會考量
travel_mode。如果您要求DRIVE，API 會忽略僅限行人的路徑，並尋找最近的可行駛街道。如果您要求WALK，API 會優先考量可步行路徑和人行道。 - 失敗案例：如果 API 無法在起點約 100 公尺內找到合適的路段，就會傳回
404 NOT_FOUND錯誤。這通常表示該點距離道路網路太遠，或位於地圖資料不支援所要求交通方式的區域。
流量認知度
使用 routing_preference 參數控管交通資訊對生成多邊形的影響：
TRAFFIC_UNAWARE(預設)：使用速限和道路階層產生等時線多邊形。這會產生確定性形狀，不會因一天中的時間而波動。這個參數非常適合一般分析或基準情境規劃。TRAFFIC_AWARE：根據要求時的即時或預測交通狀況計算等時線，因此在壅塞時段，可抵達的區域會縮小，離峰時段則會擴大。
平滑度和保真度
您可以使用 polygon_fidelity 和 enable_smoothing 參數，自訂輸出多邊形的外觀和精確度。雖然這些選項彼此獨立，但會共同決定最終形狀。
polygon_fidelity：控制用於計算可到達區域的基礎格線儲存格大小。LOW：使用較大的格線儲存格，最適合涵蓋大面積區域，不會產生間隙，因此會形成一般形狀。MEDIUM：平衡精確度。HIGH：使用較小的格線儲存格。結果會更貼近道路網路，但如果道路網路稀疏，可能會產生空白區域或孔洞。POLYGON_FIDELITY_UNSPECIFIED：如未指定，服務會根據要求的行程時間動態選取保真度。
高、中和低多邊形保真度
enable_smoothing：控制是否要將保真度定義的格線儲存格銳利邊緣設為圓角。false(原始)：預設值。傳回精確的幾何計算結果。 邊緣呈現鋸齒狀或階梯狀。最適合用於分析準確度，例如嚴格的點在多邊形內測試。延遲時間比平滑處理更短。true(平滑)：套用後處理演算法，將邊角修圓。最適合在地圖上顯示。
等時線 (有平滑處理和沒有平滑處理)