建立等時區

如要生成等時線,請向 generate 端點傳送 HTTP POST 要求:

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

如要驗證要求,請在 X-Goog-Api-Key HTTP 標頭 (建議) 或 ?key= 網址查詢參數中傳遞 API 金鑰,或在 Authorization: Bearer 標頭中傳遞 OAuth 2.0 不記名權杖。您可以選擇加入 X-Goog-FieldMask 標頭 (例如 X-Goog-FieldMask: isochrone.geoJson 或 *);由於 isochrone.geoJson 是唯一的回應欄位,省略 X-Goog-FieldMask 會傳回完整回應。

範例:標準開車等時線

下列要求會從華盛頓州西雅圖的某個地點,產生五分鐘 (300 秒) 的平滑行車等時線。

curl -X POST "https://isochrones.googleapis.com/v1/isochrones:generate" \
  -H "X-Goog-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location": {
      "latitude": 47.6062,
      "longitude": -122.3321
    },
    "travelDuration": "300s",
    "travelMode": "DRIVE",
    "routingPreference": "TRAFFIC_UNAWARE",
    "enableSmoothing": true,
    "travelDirection": "FROM"
  }'

西雅圖開車等時線 (平滑處理)

範例:步行等時線

這項要求會從羅馬競技場附近的位置,產生 30 分鐘 (1,800 秒) 的步行等時線。

curl -X POST "https://isochrones.googleapis.com/v1/isochrones:generate?key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "location": {
    "latitude": 41.8967068,
    "longitude": 12.4822025
  },
  "travelDuration": "1800s",
  "travelMode": "WALK",
  "routingPreference": "TRAFFIC_UNAWARE",
  "enableSmoothing": true,
  "travelDirection": "FROM"
}'

羅馬步行等時線 (未經平滑處理)

範例:使用地點 ID 建立開車等時線

下列要求會產生 30 分鐘 (1,800 秒) 的開車等時線,起點是舊金山的渡輪大廈。

curl -X POST "https://isochrones.googleapis.com/v1/isochrones:generate" \
  -H "X-Goog-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "place": "places/ChIJIQBpAG2ahYAR_6128GcTUEo",
    "travelDuration": "1800s",
    "travelMode": "DRIVE",
    "routingPreference": "TRAFFIC_UNAWARE",
    "enableSmoothing": true,
    "travelDirection": "FROM"
  }'

金門大橋開車等時線