Retrieve traffic signs restricted to the predefined area of the user
POST {{baseUrl}}/trafficsigns?page=<integer>&size=<integer>
This endpoint returns a set of traffic signs restricted to the predefined area of the user. The traffic signs data is returned in a paged response. If there are no traffic signs in the defined area, an empty list is returned. Note that missing fields in individual traffic sign data are returned as null values. 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 traffic signs data can also be filtered by the lonely sign, the confidence, the permanency, and the type of the traffic sign. 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. 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>"]}, "lonelySign"=>"<boolean>", "minConfidence"=>"<float>", "permanency"=>"<string>", "type"=>"<string>"}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
x-tracking-id | string | the request tracking ID | |
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"trafficSigns":[{"id":"\u003cuuid\u003e","latitude":"\u003cfloat\u003e","longitude":"\u003cfloat\u003e","heading":"\u003cinteger\u003e","confidence":"\u003cfloat\u003e","permanency":"DYNAMIC","signValue":"110","timestamp":"\u003clong\u003e","type":"MOTORWAY_START","lonelySign":"\u003cboolean\u003e"},{"id":"\u003cuuid\u003e","latitude":"\u003cfloat\u003e","longitude":"\u003cfloat\u003e","heading":"\u003cinteger\u003e","confidence":"\u003cfloat\u003e","permanency":"VARIABLE","signValue":"110","timestamp":"\u003clong\u003e","type":"NO_OVERTAKING_TRUCKS_END","lonelySign":"\u003cboolean\u003e"}],"page":{"size":"\u003cinteger\u003e","number":"\u003cinteger\u003e","totalPages":"\u003cinteger\u003e","totalElements":"\u003clong\u003e"}}