Roads

The Road type (RoadDatasetDTO) exposes the roads found within the coverage of our H3 cells, enriched with metadata about the parking catalogued along each road.

Description

Each road comes from OpenStreetMap and is associated with aggregated parking density information. The data lets you analyze parking on a linear basis, by street or by road type.

Structure

Road (e.g. "Rue des Lilas")
│
├── OpenStreetMap attributes (osm_ prefix)
│   ├── osm_name: Street name
│   ├── osm_highway_type: Road type
│   ├── osm_maxspeed: Speed limit
│   └── osm_is_roundabout, osm_junction
│
├── geometry: LineString (full path)
│
└── Aggregated statistics
    ├── total_spots: Number of spots
    ├── total_length_meters: Length
    ├── visited_segments_count / total_segments_count
    └── avg_fit_score: Confidence score

Properties

Identification

Property	Type	Description	Example
id	string	Unique identifier (= osm_id)	way/123456789
layer_type	string	Document type	roads
osm_id	string	OpenStreetMap identifier	way/123456789
h3_index	string	Parent H3 cell	893b0c6a9a7ffff
h3_resolution	integer	H3 resolution (always 9)	9

OpenStreetMap attributes

Property	Type	Description	Example
osm_name	string	Street name	Rue des Lilas
osm_highway_type	string	OSM road type	residential
osm_maxspeed	string	Speed limit	50
osm_is_roundabout	boolean	Is a roundabout	false
osm_junction	string	Junction type	roundabout

Road types (osm_highway_type)

Value	Description
primary	Primary road
secondary	Secondary road
tertiary	Tertiary road
residential	Residential street
service	Service road
unclassified	Unclassified road
living_street	Living street

Parking statistics

Property	Type	Description
total_spots	integer	Total number of spots on the road
total_length_meters	number	Road length in meters
visited_segments_count	integer	Number of analyzed segments
total_segments_count	integer	Total number of segments
avg_fit_score	number	Average confidence score (0-1)

Geometry

Property	Type	Description
geometry	LineString	Full road path (GeoJSON)

Use cases

Analysis by street

Identify the streets best equipped with parking:

• Filter by osm_highway_type to target a specific road type
• Sort by total_spots to find the streets with the most spots
• Compute a spots-per-meter ratio to compare provision

Urban planning

Use the data to:

• Identify streets under-equipped with parking
• Compare provision across neighborhoods
• Plan new developments

Map visualization

Display roads with a color code based on:

• Parking density (total_spots / total_length_meters)
• Road type
• Confidence score

Recommended QGIS style

Roads are displayed in purple by default:

1. Download the QGIS style file: roads.qml
2. In QGIS: right-click the layer → Properties → Symbology
3. Style → Load Style → select the .qml file

Download and styles guide →

GeoJSON example

{
  "type": "Feature",
  "properties": {
    "id": "way/123456789",
    "layer_type": "roads",
    "osm_id": "way/123456789",
    "h3_index": "893b0c6a9a7ffff",
    "h3_resolution": 9,
    "osm_name": "Rue des Lilas",
    "osm_highway_type": "residential",
    "osm_maxspeed": "30",
    "osm_is_roundabout": false,
    "total_spots": 24,
    "total_length_meters": 187.5,
    "visited_segments_count": 4,
    "total_segments_count": 4,
    "avg_fit_score": 0.78
  },
  "geometry": {
    "type": "LineString",
    "coordinates": [[55.47, -21.12], [55.48, -21.13]]
  }
}

Relation to other types

Type	Relation
Road segments	A road contains several segments
H3 cells	Each road belongs to an H3 cell
Parking areas	Areas are attached to roads

Coverage

Roads come from the OpenStreetMap database and are filtered to include only the roads where on-street parking is possible. Motorways, railways and footpaths are excluded.

OpenStreetMap data

The OSM attributes (name, type, speed) come directly from OpenStreetMap. To report an error in these attributes, contribute on openstreetmap.org.