Isochrone Endpoint

v1.0.0

Example

You can get an example response via:

Don't forget to replace the placeholder with your own key.

Introduction

An isochrone of a location is ''a line connecting points at which a vehicle arrives at the same time'', see Wikipedia. With the same API you can also calculate isodistances, just use the parameter distance_limit instead of time_limit`.

Use Cases

Some possible areas in which this API may be useful to you:

real estate analysis
realtors
vehicle scheduling
geomarketing
reach of electric vehicles
transport planning
logistics (distribution and retail network planning)

API Clients and Examples

See the section in the main documentation, and .

Input

{
  "type": "object",
  "properties": {
    "buckets": {
      "type": "integer",
      "format": "int32"
    },
    "distance_limit": {
      "type": "integer",
      "format": "int32"
    },
    "point": {
      "type": "string"
    },
    "reverse_flow": {
      "type": "boolean"
    },
    "time_limit": {
      "type": "integer",
      "format": "int32"
    },
    "vehicle": {
      "type": "string",
      "enum": [
        "car",
        "bike",
        "foot",
        "hike",
        "mtb",
        "racingbike",
        "scooter",
        "truck",
        "small_truck"
      ]
    },
    "weighting": {
      "type": "string",
      "enum": [
        "fastest",
        "shortest"
      ]
    }
  },
  "required": [
    "point"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "properties": {
    "copyrights": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "polygons": {
      "type": "array",
      "description": "The list of polygons in GeoJson format. It can be used e.g. in the Leaflet framework:\n\n```\nL.geoJson(json.polygons).addTo(map)\n```\n\nThe number of polygon is identical to the specified buckets in the query. Every polygon contains the bucket number in the properties section of the GeoJson.\n",
      "items": {
        "type": "object",
        "description": "A found path",
        "properties": {
          "geometry": {
            "type": "object",
            "properties": {
              "coordinates": {
                "type": "array",
                "items": {
                  "type": "array",
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "number"
                    }
                  }
                }
              },
              "type": {
                "type": "string"
              }
            }
          },
          "properties": {
            "type": "object",
            "properties": {
              "bucket": {
                "type": "integer",
                "format": "int32"
              }
            }
          },
          "type": {
            "type": "string"
          }
        }
      }
    }
  }
}