Retrieve road safety hotspots restricted to the predefined area of the user

GET {{baseUrl}}/roadsafetyhotspots?page=<integer>&size=<integer>&longitudePoint1=<number>&latitudePoint1=<number>&longitudePoint2=<number>&latitudePoint2=<number>&typeOfObjects=<string>&eventIntensity=<integer>&relativeSize=<string>

This endpoint returns a set of road safety hotspots restricted to the predefined area of the user. The road safety hotspot data is returned in a paged response. If there are no road safety hotspots in the restricted area, an empty list is returned. To additionally limit the returned data, a bounding box can be defined as geolocation filter. The bounding box is defined by two points, each represented by a longitude and a latitude coordinate. The first point is defined by the longitudePoint1 and latitudePoint1 query parameters. The second point is defined by the longitudePoint2 and latitudePoint2 query parameters. All four query parameters are optional, but if one of them is provided, all four must be provided to define a bounding box as geolocation filter. Besides the bounding box, 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

KeyDatatypeRequiredDescription
pagestringThe page number used for the pagination
sizestringThe 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.
longitudePoint1stringThe longitude coordinate (x-axis) of the first point defining a bounding box as geolocation filter. Valid values are between -180 and 180.
latitudePoint1stringThe latitude coordinate (y-axis) of the first point defining a bounding box as geolocation filter. Valid values are between -90 and 90.
longitudePoint2stringThe longitude coordinate (x-axis) of the second point defining a bounding box as geolocation filter. Valid values are between -180 and 180.
latitudePoint2stringThe latitude coordinate (y-axis) of the second point defining a bounding box as geolocation filter. Valid values are between -90 and 90.
typeOfObjectsstringFilters the road safety hotspots data by the type of objects. The filter is case-insensitive.
eventIntensitystringFilters the road safety hotspots data by the event intensity. Valid values are between 1 and 5.
relativeSizestringFilters the road safety hotspots data by the relative size. The filter is case-insensitive.

HEADERS

KeyDatatypeRequiredDescription
x-tracking-idstringthe request tracking ID
Acceptstring

RESPONSES

status: OK

{&quot;page&quot;:{&quot;size&quot;:&quot;\u003cinteger\u003e&quot;,&quot;number&quot;:&quot;\u003cinteger\u003e&quot;,&quot;totalPages&quot;:&quot;\u003cinteger\u003e&quot;,&quot;totalElements&quot;:&quot;\u003clong\u003e&quot;},&quot;roadSafetyHotspots&quot;:[{&quot;id&quot;:&quot;\u003cuuid\u003e&quot;,&quot;longitude&quot;:&quot;\u003cdouble\u003e&quot;,&quot;latitude&quot;:&quot;\u003cdouble\u003e&quot;,&quot;heading&quot;:&quot;\u003cinteger\u003e&quot;,&quot;relativeSize&quot;:&quot;\u003cstring\u003e&quot;,&quot;eventIntensity&quot;:&quot;\u003cinteger\u003e&quot;,&quot;roadType&quot;:&quot;\u003cstring\u003e&quot;,&quot;typeOfObjects&quot;:&quot;\u003cstring\u003e&quot;,&quot;nearInfrastructure&quot;:{&quot;publicTransport&quot;:&quot;\u003cinteger\u003e&quot;,&quot;school&quot;:&quot;\u003cinteger\u003e&quot;,&quot;publicServices&quot;:&quot;\u003cinteger\u003e&quot;,&quot;clinic&quot;:&quot;\u003cinteger\u003e&quot;,&quot;shop&quot;:&quot;\u003cinteger\u003e&quot;,&quot;restaurant&quot;:&quot;\u003cinteger\u003e&quot;},&quot;distributionOverTimeToCollision&quot;:{&quot;more2_2s&quot;:&quot;\u003cfloat\u003e&quot;,&quot;between1_6sAnd2_2s&quot;:&quot;\u003cfloat\u003e&quot;,&quot;between1_0sAnd1_6s&quot;:&quot;\u003cfloat\u003e&quot;,&quot;less1_0s&quot;:&quot;\u003cfloat\u003e&quot;},&quot;distributionOverWeek&quot;:{&quot;monday&quot;:&quot;\u003cfloat\u003e&quot;,&quot;tuesday&quot;:&quot;\u003cfloat\u003e&quot;,&quot;wednesday&quot;:&quot;\u003cfloat\u003e&quot;,&quot;thursday&quot;:&quot;\u003cfloat\u003e&quot;,&quot;friday&quot;:&quot;\u003cfloat\u003e&quot;,&quot;saturday&quot;:&quot;\u003cfloat\u003e&quot;,&quot;sunday&quot;:&quot;\u003cfloat\u003e&quot;},&quot;distributionOverDay&quot;:{&quot;10&quot;:&quot;\u003cfloat\u003e&quot;,&quot;11&quot;:&quot;\u003cfloat\u003e&quot;,&quot;12&quot;:&quot;\u003cfloat\u003e&quot;,&quot;13&quot;:&quot;\u003cfloat\u003e&quot;,&quot;14&quot;:&quot;\u003cfloat\u003e&quot;,&quot;15&quot;:&quot;\u003cfloat\u003e&quot;,&quot;16&quot;:&quot;\u003cfloat\u003e&quot;,&quot;17&quot;:&quot;\u003cfloat\u003e&quot;,&quot;18&quot;:&quot;\u003cfloat\u003e&quot;,&quot;19&quot;:&quot;\u003cfloat\u003e&quot;,&quot;20&quot;:&quot;\u003cfloat\u003e&quot;,&quot;21&quot;:&quot;\u003cfloat\u003e&quot;,&quot;22&quot;:&quot;\u003cfloat\u003e&quot;,&quot;23&quot;:&quot;\u003cfloat\u003e&quot;,&quot;00&quot;:&quot;\u003cfloat\u003e&quot;,&quot;01&quot;:&quot;\u003cfloat\u003e&quot;,&quot;02&quot;:&quot;\u003cfloat\u003e&quot;,&quot;03&quot;:&quot;\u003cfloat\u003e&quot;,&quot;04&quot;:&quot;\u003cfloat\u003e&quot;,&quot;05&quot;:&quot;\u003cfloat\u003e&quot;,&quot;06&quot;:&quot;\u003cfloat\u003e&quot;,&quot;07&quot;:&quot;\u003cfloat\u003e&quot;,&quot;08&quot;:&quot;\u003cfloat\u003e&quot;,&quot;09&quot;:&quot;\u003cfloat\u003e&quot;},&quot;riskScoreOverTime&quot;:[&quot;\u003cinteger\u003e&quot;,&quot;\u003cinteger\u003e&quot;],&quot;numberEventsOverTime&quot;:[&quot;\u003cinteger\u003e&quot;,&quot;\u003cinteger\u003e&quot;],&quot;totalNumberEvents&quot;:&quot;\u003cinteger\u003e&quot;,&quot;monthOverTime&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;categoryNumberOfPassingVehicles&quot;:&quot;\u003cstring\u003e&quot;,&quot;categoryNumberOfPassingVehiclesRange&quot;:[&quot;\u003cinteger\u003e&quot;,&quot;\u003cinteger\u003e&quot;],&quot;speedReduction&quot;:&quot;\u003cstring\u003e&quot;,&quot;objectClusters&quot;:{&quot;type&quot;:&quot;FeatureCollection&quot;,&quot;features&quot;:[{&quot;type&quot;:&quot;Feature&quot;,&quot;properties&quot;:{},&quot;geometry&quot;:{&quot;type&quot;:&quot;Polygon&quot;,&quot;coordinates&quot;:[[[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;]],[[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;]]]},&quot;id&quot;:&quot;\u003cnumber\u003e&quot;},{&quot;type&quot;:&quot;Feature&quot;,&quot;properties&quot;:{},&quot;geometry&quot;:{&quot;type&quot;:&quot;Polygon&quot;,&quot;coordinates&quot;:[[[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;]],[[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;]]]},&quot;id&quot;:&quot;\u003cnumber\u003e&quot;}]}},{&quot;id&quot;:&quot;\u003cuuid\u003e&quot;,&quot;longitude&quot;:&quot;\u003cdouble\u003e&quot;,&quot;latitude&quot;:&quot;\u003cdouble\u003e&quot;,&quot;heading&quot;:&quot;\u003cinteger\u003e&quot;,&quot;relativeSize&quot;:&quot;\u003cstring\u003e&quot;,&quot;eventIntensity&quot;:&quot;\u003cinteger\u003e&quot;,&quot;roadType&quot;:&quot;\u003cstring\u003e&quot;,&quot;typeOfObjects&quot;:&quot;\u003cstring\u003e&quot;,&quot;nearInfrastructure&quot;:{&quot;publicTransport&quot;:&quot;\u003cinteger\u003e&quot;,&quot;school&quot;:&quot;\u003cinteger\u003e&quot;,&quot;publicServices&quot;:&quot;\u003cinteger\u003e&quot;,&quot;clinic&quot;:&quot;\u003cinteger\u003e&quot;,&quot;shop&quot;:&quot;\u003cinteger\u003e&quot;,&quot;restaurant&quot;:&quot;\u003cinteger\u003e&quot;},&quot;distributionOverTimeToCollision&quot;:{&quot;more2_2s&quot;:&quot;\u003cfloat\u003e&quot;,&quot;between1_6sAnd2_2s&quot;:&quot;\u003cfloat\u003e&quot;,&quot;between1_0sAnd1_6s&quot;:&quot;\u003cfloat\u003e&quot;,&quot;less1_0s&quot;:&quot;\u003cfloat\u003e&quot;},&quot;distributionOverWeek&quot;:{&quot;monday&quot;:&quot;\u003cfloat\u003e&quot;,&quot;tuesday&quot;:&quot;\u003cfloat\u003e&quot;,&quot;wednesday&quot;:&quot;\u003cfloat\u003e&quot;,&quot;thursday&quot;:&quot;\u003cfloat\u003e&quot;,&quot;friday&quot;:&quot;\u003cfloat\u003e&quot;,&quot;saturday&quot;:&quot;\u003cfloat\u003e&quot;,&quot;sunday&quot;:&quot;\u003cfloat\u003e&quot;},&quot;distributionOverDay&quot;:{&quot;10&quot;:&quot;\u003cfloat\u003e&quot;,&quot;11&quot;:&quot;\u003cfloat\u003e&quot;,&quot;12&quot;:&quot;\u003cfloat\u003e&quot;,&quot;13&quot;:&quot;\u003cfloat\u003e&quot;,&quot;14&quot;:&quot;\u003cfloat\u003e&quot;,&quot;15&quot;:&quot;\u003cfloat\u003e&quot;,&quot;16&quot;:&quot;\u003cfloat\u003e&quot;,&quot;17&quot;:&quot;\u003cfloat\u003e&quot;,&quot;18&quot;:&quot;\u003cfloat\u003e&quot;,&quot;19&quot;:&quot;\u003cfloat\u003e&quot;,&quot;20&quot;:&quot;\u003cfloat\u003e&quot;,&quot;21&quot;:&quot;\u003cfloat\u003e&quot;,&quot;22&quot;:&quot;\u003cfloat\u003e&quot;,&quot;23&quot;:&quot;\u003cfloat\u003e&quot;,&quot;00&quot;:&quot;\u003cfloat\u003e&quot;,&quot;01&quot;:&quot;\u003cfloat\u003e&quot;,&quot;02&quot;:&quot;\u003cfloat\u003e&quot;,&quot;03&quot;:&quot;\u003cfloat\u003e&quot;,&quot;04&quot;:&quot;\u003cfloat\u003e&quot;,&quot;05&quot;:&quot;\u003cfloat\u003e&quot;,&quot;06&quot;:&quot;\u003cfloat\u003e&quot;,&quot;07&quot;:&quot;\u003cfloat\u003e&quot;,&quot;08&quot;:&quot;\u003cfloat\u003e&quot;,&quot;09&quot;:&quot;\u003cfloat\u003e&quot;},&quot;riskScoreOverTime&quot;:[&quot;\u003cinteger\u003e&quot;,&quot;\u003cinteger\u003e&quot;],&quot;numberEventsOverTime&quot;:[&quot;\u003cinteger\u003e&quot;,&quot;\u003cinteger\u003e&quot;],&quot;totalNumberEvents&quot;:&quot;\u003cinteger\u003e&quot;,&quot;monthOverTime&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;categoryNumberOfPassingVehicles&quot;:&quot;\u003cstring\u003e&quot;,&quot;categoryNumberOfPassingVehiclesRange&quot;:[&quot;\u003cinteger\u003e&quot;,&quot;\u003cinteger\u003e&quot;],&quot;speedReduction&quot;:&quot;\u003cstring\u003e&quot;,&quot;objectClusters&quot;:{&quot;type&quot;:&quot;FeatureCollection&quot;,&quot;features&quot;:[{&quot;type&quot;:&quot;Feature&quot;,&quot;properties&quot;:{},&quot;geometry&quot;:{&quot;type&quot;:&quot;Polygon&quot;,&quot;coordinates&quot;:[[[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;]],[[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;]]]},&quot;id&quot;:&quot;\u003cnumber\u003e&quot;},{&quot;type&quot;:&quot;Feature&quot;,&quot;properties&quot;:{},&quot;geometry&quot;:{&quot;type&quot;:&quot;Polygon&quot;,&quot;coordinates&quot;:[[[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;]],[[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;],[&quot;\u003cnumber\u003e&quot;,&quot;\u003cnumber\u003e&quot;]]]},&quot;id&quot;:&quot;\u003cnumber\u003e&quot;}]}}]}