Segment attributes describe the physical and legal characteristics of road segments returned by the MapMatching API. These attributes provide additional context for interpreting the matched segments, such as whether a segment is part of a bridge, located in a built-up area, or subject to a specific speed limit.
Not all attributes are available for every segment. Availability depends on the nature of the road and the underlying map data.
Available Attributes
| Attribute Name | Type | Description |
| roadCategory | integer | Classification of the road type, from 1 (Motorway) to 8 (Pathway). See Road Category. |
| bridge | boolean | Indicates that the segment is part of a bridge. |
| tunnel | boolean | Indicates that the segment is part of a tunnel. |
| ramp | boolean | Indicates that the segment is part of a ramp. |
| frontage | boolean | Indicates that the segment is part of a frontage road. |
| paved | boolean | Indicates that the segment has a solid surface (e.g., asphalt, concrete, cobblestone). |
| requiresFourWheelDrive | boolean | Indicates that the segment is only suitable for vehicles with four-wheel drive. |
| privatelyManaged | boolean | Indicates that the segment is part of a privately held or maintained road. |
| publicAccess | boolean | Indicates that the segment is publicly accessible. |
| parkingLot | boolean | Indicates that the segment is part of a parking lot. |
| priorityRoad | boolean | Indicates that the segment is part of a road where traffic has priority over incoming roads. |
| builtUpArea | boolean | Indicates that the segment is located within a built-up urban area. |
| speedLimit | integer | Legal speed limit on the road segment in kilometers per hour (km/h). If no heading is specified in the request, the lower of the two possible directions is returned. |
Road Category
The roadCategory attribute provides a simplified classification of road segments based on their general role in the road network. This classification enables filtering, analysis, and visualization of matched segments by road type.
| Value | Category Name | Description |
| 1 | Motorway | Major roads designed for fast, long-distance travel, such as autobahns or freeways. |
| 2 | Highway | Important regional roads, often with multiple lanes and higher speed limits. |
| 3 | Trunk Road | Roads connecting cities and towns, typically with moderate traffic. |
| 4 | Country Road | Rural roads linking smaller towns and villages, often scenic and quieter. |
| 5 | City Road | Roads within urban areas, used for local traffic and public transport. |
| 6 | Residential Road | Roads in residential neighborhoods, usually with lower speed limits. |
| 7 | Special Access Road | Roads that are technically drivable but typically restricted or blocked. |
| 8 | Pedestrian & Cycle Path | Cycle lanes, walkways, and other paths for non-motorized traffic. |