Phrases API - Impacts

The Impacts endpoint provides a detailed description of all immediate and short-term weather risks and alerts for an activity at a particular location. Currently, this supports the activities: general (i.e. outdoor activities - which covers the widest range of use cases), roadway_trucking, maritime_large_vessel, and maritime_small_craft

This endpoint utilizes the weather variables from the classic Impacts  endpoint to evaluate the level of risk they pose for the given activity, allowing for more accurate planning and informed decision making about when to engage in the activity. The alerts, if any, will always be present in the output regardless of the minimum severity selected. For more information about the types of base risks available, please refer to the linked classic Impacts endpoint.

Note: The impacts activities offered by this endpoint may not directly use the same activity name values offered in the classic endpoint.

Requests

Every request to the endpoint must include one of the supported actions in the url.

https://phrases.api.xweather.com/impacts/:activity/{action}?client_id={client_id}&client_secret={client_secret}&{params}

Response

The following is an example of what each object in the response will consist of. Depending on your requested action, the response may contain multiple instances of this object within an array.

{
  "response": "The current weather conditions in Wayzata, MN, present significant risks for outdoor activities due to feels-like temperatures of -20.5°C (-4°F). These extreme cold conditions can lead to frostbite and hypothermia in a short amount of time, making prolonged outdoor exposure dangerous. It is advisable to limit outdoor activities and ensure proper clothing and precautions if venturing outside."
}