Package google.maps.isochrones.v1

索引

IsochroneService

用於計算等時線的服務。等時線是指從指定起點出發，在特定行程時間內可抵達的區域。

GenerateIsochrone

rpc GenerateIsochrone(GenerateIsochroneRequest) returns (GenerateIsochroneResponse)

根據指定參數計算並傳回單一等時線。

GenerateIsochroneRequest

產生單一等時區的要求。

欄位
travel_duration

Duration

必填。等時區計算的行程時間。值必須為正數，上限為 7200 秒 (120 分鐘)。在「DRIVE」模式下，允許的最長時長為 3600 秒 (60 分鐘)。
travel_mode

TravelMode

必填。交通方式。
travel_direction

TravelDirection

必填。行進方向。
routing_preference

RoutingPreference

(選用步驟) 指定路由偏好設定。預設值為 TRAFFIC_UNAWARE。
enable_smoothing

bool

(選用步驟) 指定是否要平滑處理產生的等時線多邊形邊緣。
polygon_fidelity

PolygonFidelity

(選用步驟) 控制生成多邊形的精確度。預設為 POLYGON_FIDELITY_UNSPECIFIED。
聯集欄位 origin。必填。計算等時區的起點。origin 只能是下列其中一項：
location

LatLng

以經緯度座標表示的起點。
place

string

地點的資源名稱，格式為 places/{place_id}。

PolygonFidelity

控制等時區多邊形的詳細程度。

列舉
POLYGON_FIDELITY_UNSPECIFIED 未指定多邊形精確度。伺服器會根據旅遊時間長度使用預設值。
LOW 精確度偏低。適合以較少的頂點涵蓋大面積區域。
MEDIUM 中等精確度。在細節和構件大小之間取得平衡。
HIGH 高精確度。邊緣保真度高，但道路網路密度較低時，可能會在多邊形中產生孔洞。

RoutingPreference

決定如何將路況納入計算。

列舉
ROUTING_PREFERENCE_UNSPECIFIED 未指定任何轉送偏好設定。伺服器會使用預設值 TRAFFIC_UNAWARE。
TRAFFIC_UNAWARE 計算時不會將路況納入考量，等時線會根據路網和靜態交通時間繪製。如果規劃行程時不需考慮路況，這個選項就非常適合。
TRAFFIC_AWARE 系統會將即時路況納入計算。

TravelDirection

指定等時線計算的行進方向。

列舉
TRAVEL_DIRECTION_UNSPECIFIED 未指定旅行方向。
FROM 計算從起點可到達的區域。例如：「我可以在 30 分鐘內從倉庫送達哪些地點？」
TO 計算可從中前往起點的區域。例如：「員工從哪裡通勤到辦公室需要 30 分鐘？」

TravelMode

定義等時區計算的交通方式。

列舉
TRAVEL_MODE_UNSPECIFIED 未指定交通方式。
DRIVE 搭乘客車。
BICYCLE 騎自行車。
WALK 步行。

GenerateIsochroneResponse

含有產生的等時區資料的回應。

欄位
isochrone

Isochrone

僅供輸出。產生的等時區。

等時線

等時線計算結果，代表從起點出發，在指定行程時間內可抵達的區域。

欄位
聯集欄位 geometry。等時區的幾何表示法。geometry 只能是下列其中一項：
geo_json

Struct

採用 RFC 7946 格式的等時區幾何圖形 (GeoJSON 格式)：https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6。