如何計算「通勤」的進城等時線 (前往目的地) 和出城等時線 (離開出發地)?
v1 API 支援使用 travelDirection (travel_direction) 參數計算入站和出站:
FROM(去程):計算在指定時間限制內,從起點from可到達的區域。這項功能適用於商家派送區域或服務範圍等用途。TO(入境):計算在指定時間限制內,可從哪些區域前往to起點。這項功能適用於通勤功能,或判斷中央辦公室或轉運站周圍的集水區。
四種交通方式 (DRIVE、TWO_WHEELER、BICYCLE 和 WALK) 有何差異?
每種模式都有各自的道路網路存取規則、轉彎成本和速度模型:
DRIVE:使用公告或自由流速,或即時車速 (TRAFFIC_AWARE) 穿越可行駛道路,最長 3,600 秒 (60 分鐘)。TWO_WHEELER:行經機車可通行的道路,在高速道路上的模擬速度低於DRIVE,並可選用TRAFFIC_AWARE路線,最長 3,600 秒 (60 分鐘)。因此,沿著高速公路,TWO_WHEELER等時線會大於BICYCLE,但小於DRIVE。BICYCLE:行經單車可通行的街道、單車道和路徑,速度會根據道路類型和坡度調整 (不含高速公路和快速道路),最長 7,200 秒 (120 分鐘)。WALK:沿著人行道、步道和街道行走,步行速度會根據坡度調整 (忽略單向車輛限制),最長 7,200 秒 (120 分鐘)。
Isochrones API 是否包含渡輪或水上交通工具?
不會。Isochrones API 只會遍歷道路、橋梁、隧道和通道連結,所有交通方式皆不包含渡輪路線和水上交通。如果島嶼或半島只能透過渡輪抵達,就不會納入從本島產生的等時線。
有時傳回的多邊形看起來會像塊狀,或有鋸齒狀、階梯狀的邊緣,尤其是時間較長時。為什麼詳細程度會改變?
Isochrones API 會根據要求的 travel_duration 和 travel_mode,動態調整空間計算網格的解析度:
- 較短時間:使用高度精細的高解析度格線,因為總面積較小,可產生詳細的邊界。
- 較長期間:轉換為較粗略、解析度較低的網格,有效率地涵蓋廣大的地理區域,不會造成嚴重延遲。
如果您需要特定且一致的詳細程度 (無論時間長度為何),可以將選用的 polygon_fidelity 設為 HIGH、MEDIUM 或 LOW。
為什麼要求公園、湖泊或大型工業園區內座標的等時線時,有時會傳回「找不到」錯誤?
Isochrones API 會使用道路和路徑計算行程時間。如果要求的起點座標不在系統辨識出的道路上,API 必須先將該點「貼齊」至最接近的相容路段,再開始計算。
每種交通方式的貼齊距離上限約為 200 公尺。WALK 和 BICYCLE 的距離比 DRIVE 和 TWO_WHEELER 短,而 DRIVE 和 TWO_WHEELER 會忽略行人專用道。
如果起點座標與有效且模式相容路段的距離超過這個值,貼齊就會失敗,API 則會傳回 NOT_FOUND 錯誤。如要解決這個問題,請確認座標位置靠近公共街道或通道。
為什麼我要求步行或騎自行車的車流感知路線時,會收到錯誤訊息?
DRIVE 和 TWO_WHEELER 交通方式支援即時路況 (TRAFFIC_AWARE)。如果嘗試要求 WALK 或 BICYCLE 的等時線,並將 routingPreference 設為 TRAFFIC_AWARE,API 會傳回 400 INVALID_ARGUMENT 錯誤。
在地圖上算繪 GeoJSON 回應時,形狀顯示在錯誤的位置、扭曲或無法算繪。造成這個問題的原因是什麼?
這幾乎都是因為座標順序不符所致。
Isochrones API 遵循 GeoJSON 標準 (RFC 7946),會依 [longitude, latitude] 的順序傳回座標。不過,許多地圖 SDK 和自訂幾何圖形物件都預期座標順序為 [latitude, longitude]。
如果地圖算繪不正確,請檢查地圖 SDK 如何處理 GeoJSON:
- Google Maps JavaScript API:如果您使用資料層 (
map.data.addGeoJson()),系統會以原生方式處理這個順序,您不需要採取任何行動。 - 自訂物件或其他 SDK:如果您手動將回應剖析為
LatLng物件,則必須在轉譯前,循環處理 GeoJSON 酬載中的座標,並將[lng, lat]值轉置為[lat, lng]配對。
為什麼等時線多邊形內有空心「洞」?可以改為實心形狀嗎?
孔洞代表在時間限制內無法抵達的區域。這在有大片森林、水域、機場或私有地產的區域很常見,因為車輛或行人都無法通行。
外部 v1 API 不會公開自動移除孔洞的參數。如果應用程式需要實體邊界 (例如執行多邊形內點包含檢查),您可以:
- 將
polygon_fidelity參數設為MEDIUM或LOW,鼓勵演算法歸納並合併這些內部間隙。 - 使用用戶端 GIS 程式庫 (例如 Turf.js) 剖析 GeoJSON,並只擷取第一個座標環 (外殼),捨棄後續的任何內環 (孔洞)。
是否應啟用 enable_smoothing 選項,以便進行後端空間分析?
否。enable_smoothing 參數純粹用於視覺美感。這項功能會將基礎計算網格的銳角修圓,讓形狀在地圖上看起來更自然。
平滑化會改變頂點並稍微移動邊界,因此不建議用於精確的空間分析。如要進行後端計算、資料庫查詢或點在多邊形內測試,請將 enable_smoothing 設為 false,確保使用數學上精確計算的邊界。