Create an isochrone

To generate an isochrone, send an HTTP POST request to the generate endpoint:

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

Example: Standard driving isochrone

The following request generates a five-minute (300 seconds) smoothed driving isochrone from a location in Seattle, Washington.

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
    },
    "travel_duration": "300s",
    "travel_mode": "DRIVE",
    "routing_preference": "TRAFFIC_UNAWARE",
    "enable_smoothing": true,
    "travel_direction": "FROM"
  }'

seattle driving isochrone with smoothing

Example: Walking isochrone

This request generates a 26-minute (1800 second) walking isochrone from a location near the Colosseum in Rome.

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
  },
  "travel_duration": "1800s",
  "travel_mode": "WALK",
  "routing_preference": "TRAFFIC_UNAWARE",
  "enable_smoothing": true,
  "travel_direction": "FROM"
}'

rome walking isochrone without smoothing

Example: Driving isochrone using a place ID

The following request generates a 26-minute (1800 second) driving isochrone starting from the Golden Gate Bridge Vista Point.

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/ChIJZbs2BuyGhYARE9aDfk_IKf0",
    "travel_duration": "1800s",
    "travel_mode": "DRIVE",
    "routing_preference": "TRAFFIC_UNAWARE",
    "enable_smoothing": true,
    "travel_direction": "FROM"
  }'

golden gate driving isochrone