Weather alerts for a single car location resource

This resource provides information about weather alerts for a single location (car position) and width (circular area).

Method	URL format
`GET`	`https://{base_url}/weather/2.0/alerts`

You can find more details on the applicable query and path parameters in the sections below. The base_url will be provided during the process of obtaining credentials.

Authorization

Each request is authenticated and requires a valid bearer token to be included in HTTP Authorization header:

Authorization: Bearer <token>

For more information about obtaining credentials, see the Identity and Access Management Developer Guide.

Query parameters

The table below documents the query parameters.

Parameter	Required	Description
`lat`	Yes	Latitude of car position
`lon`	Yes	Longitude of car position
`width`	No	Width of circular area around car position in meters. Optional. Default 50 000 (app. 31 miles). Minimum value 1000 meters, maximum 100 km

Response

On success, the response status is 200 OK and the response payload contains the weather alerts that affect the specified car position area.

The response is in GeoJSON format (specified in RFC 7946). Each GeoJSON feature in the response describes one or multiple weather alerts. The feature geometry is defined as a polygon or a multi-polygon and describes the affected area.

Weather alerts update frequency

Minimal time between updates is 10 minutes. In practice, the update frequency depends on how national weather institutes update the data.

Example

Response is the same as for weather alerts along the route.

On failure, the response has a different status code and may include additional information about the error. You can use this additional information to troubleshoot this issue. For more information see Response Status Codes