Retrieve road safety hotspots data
POST {{baseUrl}}/roadsafetyhotspots?page=<integer>&size=<integer>
This endpoint returns the road safety hotspots limited to the area defined by the GeoJSON referenced in the header. The road safety hotspots is returned in a paged response. If there is no road safety hotspots in the defined area, an empty list is returned. To additionally limit the returned data, a GeoJSON polygon or multi-polygon can be defined as geolocation filter. The GeoJSON filter geometry is defined in the request body. The provided geometry is validated, e.g., it must be a valid GeoJSON polygon or multi-polygon with valid coordinate values. Also, requests containing too complex geometries are rejected for performance reasons. Besides the GeoJSON filter, the road safety hotspots data can also be filtered by the type of objects, the event intensity, and the relative size. If more than one filter is provided, the filters are combined with a logical AND.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
page | string | The page number used for the pagination | |
size | string | The size of the response page used for the pagination. The size is given in number of hotspots. If the requested page size exceeds the maximum allowed page size, a validation error is returned. | |
Request Body
{"geoJson"=>{"type"=>"Polygon", "coordinates"=>[[["<number>", "<number>"], ["<number>", "<number>"], ["<number>", "<number>"], ["<number>", "<number>"]], [["<number>", "<number>"], ["<number>", "<number>"], ["<number>", "<number>"], ["<number>", "<number>"]]], "bbox"=>["<number>", "<number>", "<number>", "<number>"]}, "typeOfObjects"=>"<string>", "eventIntensity"=>"<integer>", "relativeSize"=>"<string>"}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
x-tracking-id | string | the request tracking ID | |
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"page":{"size":"\u003cinteger\u003e","number":"\u003cinteger\u003e","totalPages":"\u003cinteger\u003e","totalElements":"\u003clong\u003e"},"roadSafetyHotspots":[{"id":"\u003cuuid\u003e","longitude":"\u003cdouble\u003e","latitude":"\u003cdouble\u003e","heading":"\u003cinteger\u003e","relativeSize":"\u003cstring\u003e","eventIntensity":"\u003cinteger\u003e","roadType":"\u003cstring\u003e","typeOfObjects":"\u003cstring\u003e","nearInfrastructure":{"publicTransport":"\u003cinteger\u003e","school":"\u003cinteger\u003e","publicServices":"\u003cinteger\u003e","clinic":"\u003cinteger\u003e","shop":"\u003cinteger\u003e","restaurant":"\u003cinteger\u003e"},"distributionOverTimeToCollision":{"more2_2s":"\u003cfloat\u003e","between1_6sAnd2_2s":"\u003cfloat\u003e","between1_0sAnd1_6s":"\u003cfloat\u003e","less1_0s":"\u003cfloat\u003e"},"distributionOverWeek":{"monday":"\u003cfloat\u003e","tuesday":"\u003cfloat\u003e","wednesday":"\u003cfloat\u003e","thursday":"\u003cfloat\u003e","friday":"\u003cfloat\u003e","saturday":"\u003cfloat\u003e","sunday":"\u003cfloat\u003e"},"distributionOverDay":{"10":"\u003cfloat\u003e","11":"\u003cfloat\u003e","12":"\u003cfloat\u003e","13":"\u003cfloat\u003e","14":"\u003cfloat\u003e","15":"\u003cfloat\u003e","16":"\u003cfloat\u003e","17":"\u003cfloat\u003e","18":"\u003cfloat\u003e","19":"\u003cfloat\u003e","20":"\u003cfloat\u003e","21":"\u003cfloat\u003e","22":"\u003cfloat\u003e","23":"\u003cfloat\u003e","00":"\u003cfloat\u003e","01":"\u003cfloat\u003e","02":"\u003cfloat\u003e","03":"\u003cfloat\u003e","04":"\u003cfloat\u003e","05":"\u003cfloat\u003e","06":"\u003cfloat\u003e","07":"\u003cfloat\u003e","08":"\u003cfloat\u003e","09":"\u003cfloat\u003e"},"riskScoreOverTime":["\u003cinteger\u003e","\u003cinteger\u003e"],"numberEventsOverTime":["\u003cinteger\u003e","\u003cinteger\u003e"],"totalNumberEvents":"\u003cinteger\u003e","monthOverTime":["\u003cstring\u003e","\u003cstring\u003e"],"categoryNumberOfPassingVehicles":"\u003cstring\u003e","categoryNumberOfPassingVehiclesRange":["\u003cinteger\u003e","\u003cinteger\u003e"],"speedReduction":"\u003cstring\u003e","objectClusters":{"type":"FeatureCollection","features":[{"type":"Feature","properties":{},"geometry":{"type":"Polygon","coordinates":[[["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"]],[["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"]]]},"id":"\u003cnumber\u003e"},{"type":"Feature","properties":{},"geometry":{"type":"Polygon","coordinates":[[["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"]],[["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"]]]},"id":"\u003cnumber\u003e"}]}},{"id":"\u003cuuid\u003e","longitude":"\u003cdouble\u003e","latitude":"\u003cdouble\u003e","heading":"\u003cinteger\u003e","relativeSize":"\u003cstring\u003e","eventIntensity":"\u003cinteger\u003e","roadType":"\u003cstring\u003e","typeOfObjects":"\u003cstring\u003e","nearInfrastructure":{"publicTransport":"\u003cinteger\u003e","school":"\u003cinteger\u003e","publicServices":"\u003cinteger\u003e","clinic":"\u003cinteger\u003e","shop":"\u003cinteger\u003e","restaurant":"\u003cinteger\u003e"},"distributionOverTimeToCollision":{"more2_2s":"\u003cfloat\u003e","between1_6sAnd2_2s":"\u003cfloat\u003e","between1_0sAnd1_6s":"\u003cfloat\u003e","less1_0s":"\u003cfloat\u003e"},"distributionOverWeek":{"monday":"\u003cfloat\u003e","tuesday":"\u003cfloat\u003e","wednesday":"\u003cfloat\u003e","thursday":"\u003cfloat\u003e","friday":"\u003cfloat\u003e","saturday":"\u003cfloat\u003e","sunday":"\u003cfloat\u003e"},"distributionOverDay":{"10":"\u003cfloat\u003e","11":"\u003cfloat\u003e","12":"\u003cfloat\u003e","13":"\u003cfloat\u003e","14":"\u003cfloat\u003e","15":"\u003cfloat\u003e","16":"\u003cfloat\u003e","17":"\u003cfloat\u003e","18":"\u003cfloat\u003e","19":"\u003cfloat\u003e","20":"\u003cfloat\u003e","21":"\u003cfloat\u003e","22":"\u003cfloat\u003e","23":"\u003cfloat\u003e","00":"\u003cfloat\u003e","01":"\u003cfloat\u003e","02":"\u003cfloat\u003e","03":"\u003cfloat\u003e","04":"\u003cfloat\u003e","05":"\u003cfloat\u003e","06":"\u003cfloat\u003e","07":"\u003cfloat\u003e","08":"\u003cfloat\u003e","09":"\u003cfloat\u003e"},"riskScoreOverTime":["\u003cinteger\u003e","\u003cinteger\u003e"],"numberEventsOverTime":["\u003cinteger\u003e","\u003cinteger\u003e"],"totalNumberEvents":"\u003cinteger\u003e","monthOverTime":["\u003cstring\u003e","\u003cstring\u003e"],"categoryNumberOfPassingVehicles":"\u003cstring\u003e","categoryNumberOfPassingVehiclesRange":["\u003cinteger\u003e","\u003cinteger\u003e"],"speedReduction":"\u003cstring\u003e","objectClusters":{"type":"FeatureCollection","features":[{"type":"Feature","properties":{},"geometry":{"type":"Polygon","coordinates":[[["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"]],[["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"]]]},"id":"\u003cnumber\u003e"},{"type":"Feature","properties":{},"geometry":{"type":"Polygon","coordinates":[[["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"]],[["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"],["\u003cnumber\u003e","\u003cnumber\u003e"]]]},"id":"\u003cnumber\u003e"}]}}]}