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