analytics (16)
GET/analytics/area/esa/worldcover — ESA WorldCover Land Use Data (analytics)
The SAMRoute API integrates ESA WorldCover land use data to provide detailed and dynamic insights into the physical material that covers the Earth's surface near roads, points of interest, and within defined boundaries. This API leverages the European Space Agency's advanced satellite imagery to offer comprehensive land cover information, including vegetation, urban structures, bare ground, and water bodies. It helps enhance road safety analyses, urban planning, and environmental research by allowing users to visualize land use near roads or points of interest.
Parameters (4)
ne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/area/nasa/gpw — NASA GPW estimates of population data (analytics)
The SAMRoute API provides global population estimates from NASA's Gridded Population of the World (GPW) project, offering accurate and spatially detailed population density maps for every country. It is useful for urban planning and development.
Parameters (6)
ne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitudevalue_gte (query) required — Filter to include values greater than or equal to this valuevalue_lte (query) required — Filter to include values less than or equal to this value
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/poi/elderly-homes — FR / elderly homes (analytics)
elderly-homes
Parameters (5)
elderly_homes_buffer_in_m (query) required — Radius in meters around the POIne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/poi/gtfs — GTFS (analytics)
The SAMRoute GTFS API showcases transit stops managed by various authorities, primarily focusing on France, with additional data available upon request. Alongside other assets from SAMRoute, this API helps review routes and stops situated in potentially hazardous locations, such as near high-speed, multi-lane roads, or where accidents have historically occurred. This enables more informed decision-making for enhancing transit safety and efficiency.
Parameters (4)
ne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/poi/level-crossings — Railroad crossings (analytics)
The level crossings API provides geolocation data for all level crossings in France (complete coverage). Additional data for level crossings in other countries is available upon request, subject to each country's open data policies. This API, in conjunction with other SAMRoute API assets, facilitates the identification of crossings in hazardous locations. It enables authorities and planners to objectively review the safety of level crossings by cross-referencing nearby transit routes, bus stops, and other relevant infrastructure, ensuring comprehensive safety assessments and strategic planning enhancements.
Parameters (7)
level_crossings_types (query) required — Full text search string to match against level crossing namelevel_crossings_search (query) required — Full text search string to match against level crossing namelevel_crossings_buffer_in_m (query) required — Radius in meters around the POI (school)ne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/poi/radars — FR / Radars (analytics)
Radars in France
Parameters (5)
radars_buffer_in_m (query) required — Radius in meters around the trace or POIne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/poi/school — Schools (analytics)
The Schools API provides geolocation data for all schools in France (complete coverage). Additional data for schools in other countries is available upon request, subject to each country's open data policies. This API, in conjunction with other SAMRoute API assets, facilitates the identification of schools in hazardous locations. It enables authorities and planners to objectively review school safety by cross-referencing nearby transit routes, bus stops, and other relevant infrastructure, ensuring comprehensive safety assessments and strategic planning enhancements.
Parameters (6)
school_search (query) required — Full text search string to match against school name and address fieldsschool_buffer_in_m (query) required — Radius in meters around the POI (school)ne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/road/annotation — Mappilary Road Annotation (analytics)
The SAMRoute Road Annotations API provides geolocation data for road annotations sourced from META's Mapillary, currently covering France, New York State, and California. This API, used in conjunction with other road assets on SAMRoute, helps road safety analysis by offering detailed contextual information. It assists in reviewing and understanding the safety conditions of roads, supporting thorough and informed safety assessments and planning.
Parameters (4)
ne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/road/fsi — Road FSI (analytics)
The Road FSI (Fatal and Serious Injuries) API from SAMRoute provides geolocated road accident data across multiple countries including France (FR), the Netherlands (NL), the United Kingdom (UK), and the United States (US). This API allows users to filter accident data based on severity, such as fatal or serious injuries, and the type of road user involved, including motorists, cyclists, or pedestrians. Useful for organizations and developers needing to analyze road safety patterns or integrate accident data into navigation tools.
Parameters (4)
ne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/road/intersection — Road Intersection (analytics)
The Road Intersection API from SAMRoute provides comprehensive geolocation data for every intersection within a road network, identifying where road segments diverge, such as through median separators. This API includes ontological classification of intersections, ranging from roundabouts to traffic bridges. It is designed to work in conjunction with other SAMRoute API assets to offer a view of road layouts and intersection types.
Parameters (5)
intersection_buffer_in_m (query) required — Radius in meters around the intersectionne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/road/score/{version}/{time}/{roaduser} — Risk Score (analytics)
The SAMRoute Risk Score API provides comprehensive risk assessments across approximately 100 million kilometers of roads globally, segmented at every 100 meters. This API, currently in version 3, calculates risk scores for four types of road users, automobiles, motorcycles, bicycles, and pedestrians. We use a diverse array of data sources, including OpenStreetMap (OSM), Meta's Mapillary, historical accident data, GTFS, and other custom sources to evaluate the risk. Scores are updated to reflect the latest conditions and insights. This API supports continuous improvement in road safety strategies and infrastructure planning.
Parameters (10)
version (path) required — the version (use 'v3')time (path) required — the time of calculation (choose 'latest')roadUser (path) required — the type of road user to retrieveroadTypes (query) required — a comma separated list of road types in {highways,primary,secondary,tertiary,residential,unclassified}quantiles (query) required — a comma separated list of quantiles in {1,2,3,4,5}polygonids (query) required — limit search to given polygon idsne_lat (query) required — north east latitude (bbox corner)ne_lng (query) required — north east longitude (bbox corner)sw_lat (query) required — south west latitude (bbox corner)sw_lng (query) required — south west longitude (bbox corner)
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/road/view — Mapillary Road View (analytics)
This SAMRoute API provides road view imagery in France, New York State, and California, based on Meta's Mapillary service. Integrated with other assets from the SAMRoute API, it enriches analysis with images of the roads, helping contextualize and assess road conditions.
Parameters (4)
ne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/trace/aso/tdf — ASO's Tour de France (22, 23, 24) (analytics)
The SAMRoute API details the traces of the Tour de France from 2022 to 2024, encompassing routes, departures, and finishes. Combined with other road data, this API enhances cyclist safety by identifying areas at higher risk of accidents and critical points along the route. It supports local governments in race preparation, provides organizers with richer road context, aids in developing emergency access routes, and helps minimize disruptions to transit lines.
Parameters (4)
ne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/trace/gtfs — GTFS (analytics)
The SAMRoute GTFS API showcases transportation lines managed by various authorities, primarily focusing on France, with additional data available upon request. Alongside other assets from SAMRoute, this API helps review routes and stops situated in potentially hazardous locations, such as near high-speed, multi-lane roads, or where accidents have historically occurred. This enables more informed decision-making for enhancing transit safety and efficiency.
Parameters (4)
ne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/trace/oversized-transports — Oversized transports (analytics)
Oversized transports [TODO]
Parameters (5)
polygonids (query) required — limit search to given polygon idsne_lat (query) required — north east latitude (bbox corner)ne_lng (query) required — north east longitude (bbox corner)sw_lat (query) required — south west latitude (bbox corner)sw_lng (query) required — south west longitude (bbox corner)
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/analytics/trace/train-tracks — Train tracks (analytics)
Train tracks [TODO]
Parameters (6)
train_track_cats (query) required — limit search to given train track categoriespolygonids (query) required — limit search to given polygon idsne_lat (query) required — north east latitude (bbox corner)ne_lng (query) required — north east longitude (bbox corner)sw_lat (query) required — south west latitude (bbox corner)sw_lng (query) required — south west longitude (bbox corner)
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
features (6)
GET/features/poi/elderly-homes — FR / elderly homes (features)
elderly-homes
Parameters (8)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tileelderly_homes_buffer_in_m (query) required — Radius in meters around the POIne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/features/poi/gtfs — GTFS (features)
The SAMRoute GTFS API showcases transit stops managed by various authorities, primarily focusing on France, with additional data available upon request. Alongside other assets from SAMRoute, this API helps review routes and stops situated in potentially hazardous locations, such as near high-speed, multi-lane roads, or where accidents have historically occurred. This enables more informed decision-making for enhancing transit safety and efficiency.
Parameters (7)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tilene_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/features/poi/level-crossings — Railroad crossings (features)
The level crossings API provides geolocation data for all level crossings in France (complete coverage). Additional data for level crossings in other countries is available upon request, subject to each country's open data policies. This API, in conjunction with other SAMRoute API assets, facilitates the identification of crossings in hazardous locations. It enables authorities and planners to objectively review the safety of level crossings by cross-referencing nearby transit routes, bus stops, and other relevant infrastructure, ensuring comprehensive safety assessments and strategic planning enhancements.
Parameters (10)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tilelevel_crossings_types (query) required — Full text search string to match against level crossing namelevel_crossings_search (query) required — Full text search string to match against level crossing namelevel_crossings_buffer_in_m (query) required — Radius in meters around the POI (school)ne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/features/poi/radars — FR / Radars (features)
Radars in France
Parameters (8)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tileradars_buffer_in_m (query) required — Radius in meters around the trace or POIne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/features/poi/school — Schools (features)
The Schools API provides geolocation data for all schools in France (complete coverage). Additional data for schools in other countries is available upon request, subject to each country's open data policies. This API, in conjunction with other SAMRoute API assets, facilitates the identification of schools in hazardous locations. It enables authorities and planners to objectively review school safety by cross-referencing nearby transit routes, bus stops, and other relevant infrastructure, ensuring comprehensive safety assessments and strategic planning enhancements.
Parameters (9)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tileschool_search (query) required — Full text search string to match against school name and address fieldsschool_buffer_in_m (query) required — Radius in meters around the POI (school)ne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/features/road/intersection — Road Intersection (features)
The Road Intersection API from SAMRoute provides comprehensive geolocation data for every intersection within a road network, identifying where road segments diverge, such as through median separators. This API includes ontological classification of intersections, ranging from roundabouts to traffic bridges. It is designed to work in conjunction with other SAMRoute API assets to offer a view of road layouts and intersection types.
Parameters (8)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tileintersection_buffer_in_m (query) required — Radius in meters around the intersectionne_lat (query) required — North East latitudene_lng (query) required — North East longitudesw_lat (query) required — South West latitudesw_lng (query) required — South West longitude
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
mvt (16)
GET/@/{z}/{x}/{y}/area/esa/worldcover — ESA WorldCover Land Use Data (mvt)
The SAMRoute API integrates ESA WorldCover land use data to provide detailed and dynamic insights into the physical material that covers the Earth's surface near roads, points of interest, and within defined boundaries. This API leverages the European Space Agency's advanced satellite imagery to offer comprehensive land cover information, including vegetation, urban structures, bare ground, and water bodies. It helps enhance road safety analyses, urban planning, and environmental research by allowing users to visualize land use near roads or points of interest.
Parameters (3)
z (path) required — Zoom levelx (path) required — X tile indexy (path) required — Y tile index
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/area/nasa/gpw — NASA GPW estimates of population data (mvt)
The SAMRoute API provides global population estimates from NASA's Gridded Population of the World (GPW) project, offering accurate and spatially detailed population density maps for every country. It is useful for urban planning and development.
Parameters (5)
z (path) required — Zoom levelx (path) required — X tile indexy (path) required — Y tile indexvalue_gte (query) required — Filter to include values greater than or equal to this valuevalue_lte (query) required — Filter to include values less than or equal to this value
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/poi/elderly-homes — FR / elderly homes (mvt)
elderly-homes
Parameters (4)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tileelderly_homes_buffer_in_m (query) required — Radius in meters around the POI
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/poi/gtfs — GTFS (mvt)
The SAMRoute GTFS API showcases transit stops managed by various authorities, primarily focusing on France, with additional data available upon request. Alongside other assets from SAMRoute, this API helps review routes and stops situated in potentially hazardous locations, such as near high-speed, multi-lane roads, or where accidents have historically occurred. This enables more informed decision-making for enhancing transit safety and efficiency.
Parameters (3)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tile
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/poi/level-crossings — Railroad crossings (mvt)
The level crossings API provides geolocation data for all level crossings in France (complete coverage). Additional data for level crossings in other countries is available upon request, subject to each country's open data policies. This API, in conjunction with other SAMRoute API assets, facilitates the identification of crossings in hazardous locations. It enables authorities and planners to objectively review the safety of level crossings by cross-referencing nearby transit routes, bus stops, and other relevant infrastructure, ensuring comprehensive safety assessments and strategic planning enhancements.
Parameters (6)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tilelevel_crossings_types (query) required — Full text search string to match against level crossing namelevel_crossings_search (query) required — Full text search string to match against level crossing namelevel_crossings_buffer_in_m (query) required — Radius in meters around the POI (school)
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/poi/radars — FR / Radars (mvt)
Radars in France
Parameters (4)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tileradars_buffer_in_m (query) required — Radius in meters around the trace or POI
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/poi/school — Schools (mvt)
The Schools API provides geolocation data for all schools in France (complete coverage). Additional data for schools in other countries is available upon request, subject to each country's open data policies. This API, in conjunction with other SAMRoute API assets, facilitates the identification of schools in hazardous locations. It enables authorities and planners to objectively review school safety by cross-referencing nearby transit routes, bus stops, and other relevant infrastructure, ensuring comprehensive safety assessments and strategic planning enhancements.
Parameters (5)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tileschool_search (query) required — Full text search string to match against school name and address fieldsschool_buffer_in_m (query) required — Radius in meters around the POI (school)
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/road/annotation — Mappilary Road Annotation (mvt)
The SAMRoute Road Annotations API provides geolocation data for road annotations sourced from META's Mapillary, currently covering France, New York State, and California. This API, used in conjunction with other road assets on SAMRoute, helps road safety analysis by offering detailed contextual information. It assists in reviewing and understanding the safety conditions of roads, supporting thorough and informed safety assessments and planning.
Parameters (3)
z (path) required — zoom levelx (path) required — x coordinate of tiley (path) required — y coordinate of tile
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/road/fsi — Road FSI (mvt)
The Road FSI (Fatal and Serious Injuries) API from SAMRoute provides geolocated road accident data across multiple countries including France (FR), the Netherlands (NL), the United Kingdom (UK), and the United States (US). This API allows users to filter accident data based on severity, such as fatal or serious injuries, and the type of road user involved, including motorists, cyclists, or pedestrians. Useful for organizations and developers needing to analyze road safety patterns or integrate accident data into navigation tools.
Parameters (3)
z (path) required — zoom levelx (path) required — x coordinate of tiley (path) required — y coordinate of tile
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/road/intersection — Road Intersection (mvt)
The Road Intersection API from SAMRoute provides comprehensive geolocation data for every intersection within a road network, identifying where road segments diverge, such as through median separators. This API includes ontological classification of intersections, ranging from roundabouts to traffic bridges. It is designed to work in conjunction with other SAMRoute API assets to offer a view of road layouts and intersection types.
Parameters (4)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tileintersection_buffer_in_m (query) required — Radius in meters around the intersection
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/road/score/{version}/{time}/{roaduser} — Risk Score (mvt)
The SAMRoute Risk Score API provides comprehensive risk assessments across approximately 100 million kilometers of roads globally, segmented at every 100 meters. This API, currently in version 3, calculates risk scores for four types of road users, automobiles, motorcycles, bicycles, and pedestrians. We use a diverse array of data sources, including OpenStreetMap (OSM), Meta's Mapillary, historical accident data, GTFS, and other custom sources to evaluate the risk. Scores are updated to reflect the latest conditions and insights. This API supports continuous improvement in road safety strategies and infrastructure planning.
Parameters (9)
z (path) required — zoom levelx (path) required — x coordinate of tiley (path) required — y coordinate of tileversion (path) required — the version (use 'v3')time (path) required — the time of calculation (choose 'latest')roadUser (path) required — the type of road user to retrieveroadTypes (query) required — a comma separated list of road types in {highways,primary,secondary,tertiary,residential,unclassified}quantiles (query) required — a comma separated list of quantiles in {1,2,3,4,5}polygonids (query) required — limit search to given polygon ids
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/road/view — Mapillary Road View (mvt)
This SAMRoute API provides road view imagery in France, New York State, and California, based on Meta's Mapillary service. Integrated with other assets from the SAMRoute API, it enriches analysis with images of the roads, helping contextualize and assess road conditions.
Parameters (3)
z (path) required — zoom levelx (path) required — x coordinate of tiley (path) required — y coordinate of tile
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/trace/aso/tdf — ASO's Tour de France (22, 23, 24) (mvt)
The SAMRoute API details the traces of the Tour de France from 2022 to 2024, encompassing routes, departures, and finishes. Combined with other road data, this API enhances cyclist safety by identifying areas at higher risk of accidents and critical points along the route. It supports local governments in race preparation, provides organizers with richer road context, aids in developing emergency access routes, and helps minimize disruptions to transit lines.
Parameters (3)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tile
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/trace/gtfs — GTFS (mvt)
The SAMRoute GTFS API showcases transportation lines managed by various authorities, primarily focusing on France, with additional data available upon request. Alongside other assets from SAMRoute, this API helps review routes and stops situated in potentially hazardous locations, such as near high-speed, multi-lane roads, or where accidents have historically occurred. This enables more informed decision-making for enhancing transit safety and efficiency.
Parameters (3)
z (path) required — Zoom levelx (path) required — X-coordinate of tiley (path) required — Y-coordinate of tile
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/trace/oversized-transports — Oversized transports (mvt)
Oversized transports [TODO]
Parameters (4)
z (path) required — zoom levelx (path) required — x coordinate of tiley (path) required — y coordinate of tilepolygonids (query) required — limit search to given polygon ids
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)
GET/@/{z}/{x}/{y}/trace/train-tracks — Train tracks (mvt)
Train tracks [TODO]
Parameters (5)
z (path) required — zoom levelx (path) required — x coordinate of tiley (path) required — y coordinate of tiletrain_track_cats (query) required — limit search to given train track categoriespolygonids (query) required — limit search to given polygon ids
Responses
200 — Successfully retrieved the resource403 — Unauthorized (set 'Authorization' header key, with a 'Bearer TOKEN' value)500 — Server side error (most likely SQL)