Method: isochrones.generate

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

HTTP 要求

POST https://isochrones.googleapis.com/v1/isochrones:generate

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "travelDuration": string,
  "travelMode": enum (TravelMode),
  "travelDirection": enum (TravelDirection),
  "routingPreference": enum (RoutingPreference),
  "enableSmoothing": boolean,
  "polygonFidelity": enum (PolygonFidelity),

  // Union field origin can be only one of the following:
  "location": {
    object (LatLng)
  },
  "place": string
  // End of list of possible types for union field origin.
}
欄位
travelDuration

string (Duration format)

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

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。
travelMode

enum (TravelMode)

必填。交通方式。
travelDirection

enum (TravelDirection)

必填。旅行方向。
routingPreference

enum (RoutingPreference)

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

boolean

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

enum (PolygonFidelity)

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

object (LatLng)

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

string

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

回應主體

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

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "isochrone": {
    object (Isochrone)
  }
}
欄位
isochrone

object (Isochrone)

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

LatLng

代表經緯度組合的物件。這個物件會同時指出經度和緯度的度數。除非另有指定，否則這個物件必須符合 WGS84 標準。此外，值必須在正規化範圍內。

JSON 表示法 
{
  "latitude": number,
  "longitude": number
}
欄位
latitude

number

緯度度數，必須介於 [-90.0, +90.0] 的範圍之間。
longitude

number

經度度數，必須介於 [-180.0, +180.0] 的範圍之間。

TravelMode

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

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

TravelDirection

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

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

RoutingPreference

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

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

PolygonFidelity

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

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

等時線

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

JSON 表示法 
{

  // Union field geometry can be only one of the following:
  "geoJson": {
    object
  }
  // End of list of possible types for union field geometry.
}
欄位
聯集欄位 geometry。等時區的幾何表示法。geometry 只能是下列其中一項：
geoJson

object (Struct format)

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