Routing

Turn-by-turn directions, travel-time matrices, and reachable-area isochrones.

Reachable-area polygons.

POST

https://api.rijwind.com

/v1/isochrone

Compute reachable-area polygons (isochrones) from one or more origins. Each contour is a time or distance band, returned as a GeoJSON Feature.

Quota cost: 5 × L × C units per call (L = locations, C = contours). Capped at L × C ≤ 4; requests beyond that return 400.

Reachable-area polygons. › Request Body

IsochroneRequest

IsochroneContour[] · minItems: 1 · maxItems: 4 · required

One contour per reachable-area band. The product len(locations) × len(contours) must not exceed 4.

costing

Costing · enum · required

Routing profile. auto (car), bicycle, or pedestrian (foot).

Enum values:

auto

bicycle

pedestrian

LngLat[] · minItems: 1 · maxItems: 4 · required

polygons

boolean | null

Return polygons instead of GeoJSON LineStrings.

Reachable-area polygons. › Responses

Isochrone response.

GeoJSON FeatureCollection with one feature per contour.

IsochroneResponse

IsochroneFeature[] · required

type

string · required

POST/v1/isochrone

curl --request POST \
  --url https://api.rijwind.com/v1/isochrone \
  --header 'Content-Type: application/json' \
  --data '
{
  "contours": [
    {
      "color": "ff0000",
      "distance": 0,
      "time": 15
    }
  ],
  "costing": "auto",
  "locations": [
    {
      "lat": 52.3676,
      "lon": 4.9041
    }
  ],
  "polygons": true
}
'

Example Request Body

{
  "contours": [
    {
      "color": "ff0000",
      "distance": 0,
      "time": 15
    }
  ],
  "costing": "auto",
  "locations": [
    {
      "lat": 52.3676,
      "lon": 4.9041
    }
  ],
  "polygons": true
}

json

Example Responses

{
  "features": [
    {
      "geometry": {},
      "properties": {
        "color": "color",
        "contour": 0,
        "metric": "metric"
      },
      "type": "type"
    }
  ],
  "type": "type"
}

json

application/json

Travel-time matrix.

POST

https://api.rijwind.com

/v1/matrix

Calculate the travel time and distance between every source and every target — the cost grows with M × N, the number of pairs.

Quota cost: M × N units per call (M = sources, N = targets). Capped at M × N ≤ 2500; requests beyond that return 400 without charging quota.

Travel-time matrix. › Request Body

MatrixRequest

costing

Costing · enum · required

Routing profile. auto (car), bicycle, or pedestrian (foot).

Enum values:

auto

bicycle

pedestrian

LngLat[] · minItems: 1 · required

Travel-time matrix. › Responses

Matrix response.

Matrix response. Outer array indexes sources, inner array indexes targets — `M × N` cells in row-major order.

MatrixResponse

array[] · required

units

string · required

POST/v1/matrix

curl --request POST \
  --url https://api.rijwind.com/v1/matrix \
  --header 'Content-Type: application/json' \
  --data '
{
  "costing": "auto",
  "sources": [
    {
      "lat": 52.3676,
      "lon": 4.9041
    }
  ],
  "targets": [
    {
      "lat": 52.3676,
      "lon": 4.9041
    }
  ],
  "units": "kilometers"
}
'

Example Request Body

{
  "costing": "auto",
  "sources": [
    {
      "lat": 52.3676,
      "lon": 4.9041
    }
  ],
  "targets": [
    {
      "lat": 52.3676,
      "lon": 4.9041
    }
  ],
  "units": "kilometers"
}

json

Example Responses

{
  "sources_to_targets": [
    [
      {
        "distance": 60.4,
        "from_index": 0,
        "time": 4810,
        "to_index": 0
      }
    ]
  ],
  "units": "units"
}

json

application/json

Turn-by-turn directions.

POST

https://api.rijwind.com

/v1/route

Calculate a route between two or more waypoints.

Quota cost: 1 unit per call.

Turn-by-turn directions. › Request Body

RouteRequest

costing

Costing · enum · required

Routing profile. auto (car), bicycle, or pedestrian (foot).

Enum values:

auto

bicycle

pedestrian

LngLat[] · minItems: 2 · required

Two or more ordered waypoints. The first is the origin, the last is the destination.

Turn-by-turn directions. › Responses

Route response.

Route response. The interesting fields are `trip.summary` (totals) and `trip.legs[i].shape` (an encoded polyline ready to render).

RouteResponse

Trip · required

POST/v1/route

curl --request POST \
  --url https://api.rijwind.com/v1/route \
  --header 'Content-Type: application/json' \
  --data '
{
  "costing": "auto",
  "directions_options": {
    "language": "en-US"
  },
  "locations": [
    {
      "lat": 52.3676,
      "lon": 4.9041
    }
  ],
  "units": "kilometers"
}
'

Example Request Body

{
  "costing": "auto",
  "directions_options": {
    "language": "en-US"
  },
  "locations": [
    {
      "lat": 52.3676,
      "lon": 4.9041
    }
  ],
  "units": "kilometers"
}

json

Example Responses

{
  "trip": {
    "language": "en-US",
    "legs": [
      {
        "maneuvers": [
          {
            "begin_shape_index": 0,
            "end_shape_index": 0,
            "instruction": "Head north on Damrak.",
            "length": 0,
            "time": 0
          }
        ],
        "shape": "shape",
        "summary": {
          "length": 60.4,
          "max_lat": 0,
          "max_lon": 0,
          "min_lat": 0,
          "min_lon": 0,
          "time": 4810
        }
      }
    ],
    "status": 0,
    "status_message": "Found route between points",
    "summary": {
      "length": 60.4,
      "max_lat": 0,
      "max_lon": 0,
      "min_lat": 0,
      "min_lon": 0,
      "time": 4810
    },
    "units": "kilometers"
  }
}

json

application/json

Geocoding

Reachable-area polygons.

POST

https://api.rijwind.com

/v1/isochrone

Compute reachable-area polygons (isochrones) from one or more origins. Each contour is a time or distance band, returned as a GeoJSON Feature.

Quota cost: 5 × L × C units per call (L = locations, C = contours). Capped at L × C ≤ 4; requests beyond that return 400.

Reachable-area polygons. › Request Body

IsochroneRequest

IsochroneContour[] · minItems: 1 · maxItems: 4 · required

One contour per reachable-area band. The product len(locations) × len(contours) must not exceed 4.

costing

Costing · enum · required

Routing profile. auto (car), bicycle, or pedestrian (foot).

Enum values:

auto

bicycle

pedestrian

LngLat[] · minItems: 1 · maxItems: 4 · required

polygons

boolean | null

Return polygons instead of GeoJSON LineStrings.

Reachable-area polygons. › Responses

Isochrone response.

GeoJSON FeatureCollection with one feature per contour.

IsochroneResponse

IsochroneFeature[] · required

type

string · required

Travel-time matrix.

POST

https://api.rijwind.com

/v1/matrix

Calculate the travel time and distance between every source and every target — the cost grows with M × N, the number of pairs.

Quota cost: M × N units per call (M = sources, N = targets). Capped at M × N ≤ 2500; requests beyond that return 400 without charging quota.

Travel-time matrix. › Request Body

MatrixRequest

costing

Costing · enum · required

Routing profile. auto (car), bicycle, or pedestrian (foot).

Enum values:

auto

bicycle

pedestrian

LngLat[] · minItems: 1 · required

Travel-time matrix. › Responses

Matrix response.

Matrix response. Outer array indexes sources, inner array indexes targets — `M × N` cells in row-major order.

MatrixResponse

array[] · required

units

string · required

Turn-by-turn directions.

POST

https://api.rijwind.com

/v1/route

Calculate a route between two or more waypoints.

Quota cost: 1 unit per call.

Turn-by-turn directions. › Request Body

RouteRequest

costing

Costing · enum · required

Routing profile. auto (car), bicycle, or pedestrian (foot).

Enum values:

auto

bicycle

pedestrian

LngLat[] · minItems: 2 · required

Two or more ordered waypoints. The first is the origin, the last is the destination.

Turn-by-turn directions. › Responses

Route response.

Route response. The interesting fields are `trip.summary` (totals) and `trip.legs[i].shape` (an encoded polyline ready to render).

RouteResponse

Trip · required