Endpoint for roads (read-only).

Query parameters

id: Numerical filter on the id field.

code: Text filter on the code field. All text field filter methods, like startswith, endswith, icontains are supported,

start/end: Both query parameters can be used to filter the roads. They define an interval [start, end) and should be either in ISO 8601 YYYY-MM-DDThh:mm:ssZ format or in milliseconds since the epoch. Available lookups are gt, gte, lt, lte, isnull.

valid_at: Return only roads that are present at given timestamp. If multiple buildings with the same code and organisation are present, only the one with the latest start is returned.

geom_within: Spatial filter on geometry, filter operator is ST_within. Supports WKT, HEXEWKB, and GeoJSON.

geom_intersects: Spatial filter on geometry, filter operator is ST_intersects. Supports WKT, HEXEWKB, and GeoJSON.

in_bbox: Spatial filter on geometry. The bounding box format is: min Lat, min Lon, max Lat, max Lon. Includes assets that overlap the bounding box.

region: Filter on region. All text field filter methods, like startswith, endswith, icontains are supported, e.g. ?region__name__startswith=HH returns Roads within the region whose name starts with 'HH'.

boundary_id: Filter on geometry of the region with the id boundary_id.

boundary_code: Filter on geometry of the region with the id boundary_code.

boundary_type: Spatial filter on geometry, whereby geometry is specified by an region object (see below) and filter operator is ST_Intersects. Available types are COUNTRY, PROVINCE, WATER_BOARD, MUNICIPALITY, CATCHMENT, POLDER, FIXED_DRAINAGE_LEVEL_AREA, PUMPED_DRAINAGE_AREA, MAIN_PUMPED_DRAINAGE_AREA, DISTRICT, NEIGHBOURHOOD, CADASTRE, PLANTATION, FIELD, CITY, and CUSTOM

boundary_name: Filter on name of the region with the name boundary_name. Requires boundary_type.

simplify: Simplify the query geometries (in WGS84) using this value as tolerance. A higher value may result in a better response time for detailed geometries. Defaults to 0.00001 degrees (approx. 1 meter). NB: Returned geometries are unaffected.

Examples

?code=27234

?start__gt=1900-01-01T00:00:00Z

?start=2019-01-01T02:03:04Z

?start__gt=1900-01-01T00:00:00Z&end__lt=2000-01-01T00:00:00Z

?start__gt=2015-01-01T00:00:00Z&end__isnull=true

?geom_within=POLYGON((4.87 52.73, 4.87 52.79, 4.98 52.79,
4.98 52.73, 4.87 52.73))

?geom_intersects=POLYGON((4.87 52.73, 4.87 52.79, 4.98 52.79,
4.98 52.73, 4.87 52.73))

?region_name__startswith=HH

?boundary_id=198

?boundary_code=NL_GM0344

?boundary_type=PROVINCE&boundary_name=Utrecht

?in_bbox=4.8,52.7,4.9,52.8
GET /api/v3/roads/
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "count": 0,
    "next": null,
    "previous": null,
    "results": []
}