OpenRouteService · Schema

OpenRouteService Isochrones Request

Request body schema for the OpenRouteService Isochrones API endpoint

RoutingGeospatialDirectionsIsochronesMatrixGeocodingElevationOptimizationOpenStreetMapNavigationLogisticsHumanitarian

Properties

Name Type Description
locations array Center coordinates for isochrone computation as [longitude, latitude] pairs. Maximum 5.
range array Maximum travel range values. For time-based: seconds. For distance-based: meters. Maximum 10 values.
range_type string Type of range measurement
interval number Interval for creating concentric isochrone rings within the maximum range
units string Units for distance-based range values
area_units string Units for area computation in the response
attributes array Additional attributes to compute and include in the response
intersections boolean Compute and return intersections between isochrone polygons
smoothing number Smoothing factor for isochrone polygon edges (0 = no smoothing, 1 = maximum smoothing)
avoid_features array Road features to avoid when computing reachability
avoid_borders string Border crossing restrictions for reachability
avoid_polygons object GeoJSON Polygon or MultiPolygon defining areas to avoid
id string Arbitrary identifier echoed back in the response
View JSON Schema on GitHub

JSON Schema

openrouteservice-isochrones-request.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/openrouteservice/main/json-schema/openrouteservice-isochrones-request.json",
  "title": "OpenRouteService Isochrones Request",
  "description": "Request body schema for the OpenRouteService Isochrones API endpoint",
  "type": "object",
  "required": ["locations", "range"],
  "properties": {
    "locations": {
      "type": "array",
      "description": "Center coordinates for isochrone computation as [longitude, latitude] pairs. Maximum 5.",
      "minItems": 1,
      "maxItems": 5,
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        },
        "minItems": 2,
        "maxItems": 2
      },
      "examples": [
        [[8.681495, 49.41461]]
      ]
    },
    "range": {
      "type": "array",
      "description": "Maximum travel range values. For time-based: seconds. For distance-based: meters. Maximum 10 values.",
      "minItems": 1,
      "maxItems": 10,
      "items": {
        "type": "number",
        "minimum": 0
      },
      "examples": [
        [300, 600, 900]
      ]
    },
    "range_type": {
      "type": "string",
      "description": "Type of range measurement",
      "enum": ["time", "distance"],
      "default": "time"
    },
    "interval": {
      "type": "number",
      "description": "Interval for creating concentric isochrone rings within the maximum range",
      "minimum": 0
    },
    "units": {
      "type": "string",
      "description": "Units for distance-based range values",
      "enum": ["m", "km", "mi"],
      "default": "m"
    },
    "area_units": {
      "type": "string",
      "description": "Units for area computation in the response",
      "enum": ["m", "km", "mi"],
      "default": "m"
    },
    "attributes": {
      "type": "array",
      "description": "Additional attributes to compute and include in the response",
      "items": {
        "type": "string",
        "enum": ["area", "reachfactor", "total_pop"]
      }
    },
    "intersections": {
      "type": "boolean",
      "description": "Compute and return intersections between isochrone polygons",
      "default": false
    },
    "smoothing": {
      "type": "number",
      "description": "Smoothing factor for isochrone polygon edges (0 = no smoothing, 1 = maximum smoothing)",
      "minimum": 0,
      "maximum": 1
    },
    "avoid_features": {
      "type": "array",
      "description": "Road features to avoid when computing reachability",
      "items": {
        "type": "string",
        "enum": ["highways", "tollways", "ferries", "fords"]
      }
    },
    "avoid_borders": {
      "type": "string",
      "description": "Border crossing restrictions for reachability",
      "enum": ["all", "controlled", "none"]
    },
    "avoid_polygons": {
      "type": "object",
      "description": "GeoJSON Polygon or MultiPolygon defining areas to avoid"
    },
    "id": {
      "type": "string",
      "description": "Arbitrary identifier echoed back in the response"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/openrouteservice-isochrones-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.