Worst Forecast Requests

This endpoint scans a subset of a complete weather matrix and returns the "worst" hourly forecast found within the time and distance parameters provided. The response provided will be similar to, but a subset of, the Single Forecast response.

This endpoint is primarily useful for estimating the worst possible conditions within some variance of space and time, starting from the present. In particular, this can be of value when you are estimating the weather around a vehicle that you do not have a precise position for, or if cell/network reliability is unreliable and you want to get a worst-case estimate.

Query Parameters

`point`

A comma-separated latitude,longitude GPS coordinate string. (required, multiple expected)

`time_inc`

The expected time of transit between provided points, in minutes. (optional; default=60)

`max_time`

Maximum time range to scan, in minutes. (optional; default=600)

`mode`

Desired mode of transit. Choice of transit will affect the scoring of the weather matrix, potentially selecting a different "worst" forecast than another transit mode.

Available transit modes:

car - Default routing and weather responses
truck - Routing avoids small roads; weather results are sensitive to high winds
motorcycle - No impact on routing; weather results are sensitive to precipitation
bicycle - No impact on routing; weather results are sensitive to precipitation

(optional; default=car)

`units`

The preferred units of the response.

Available units:

imperial - Imperial units (Fahrenheit and/or miles)
metric - Metric units (Celsius and/or kilometers)

(optional; default=imperial)

Cost

15 points x the number of locations requested

Sample Query

GET https://api.weatherroute.io/v1/weather/forecast-worst?point=39.526,-119.813&point=39.256,-120.735&point=38.582,-121.494&max_time=90&time_inc=30&mode=car

Output

This request returns a WorstForecast response object.

The output will be a slight modification of the Single Forecast result.

The latitude and longitude returned with this response will indicate the location of the "worst" forecast selected within the specifications of the query parameters.

The differences in this response from the "single forecast" response are:

No daily elements will be returned.
Only a single hourly element will be returned and it will be named worstHourlyForecast. The time of this result may be the current hour or it may be a future hour from within the time window provided by the max_time parameter.

Sample output

{
  "latitude": 39.526,
  "longitude": -119.813,
  "worstHourlyForecast": {
    "time": 1632682800,
    "summary": "Clear",
    "icon": "clear-day",
    "temperature": 81.6,
    "apparentTemperature": 81.6,
    "precipType": "none",
    "precipProbability": 0,
    "precipIntensity": 0,
    "precipAccumulation": 0,
    "dewPoint": 29.73,
    "humidity": 0.15,
    "pressure": 1013.1,
    "windSpeed": 5.48,
    "windGust": 10.99,
    "windBearing": 198,
    "skyCover": 0.11,
    "visibility": 10,
    "score": 0
  },
  "alerts": [
    {
      "latitude": 39.526,
      "longitude": -119.813,
      "title": "Red Flag Warning",
      "areaDesc": [
        "Northern Sierra Front - Carson City/Douglas/Storey/Southern Washoe/Eastern Lyon/Far Southern Lassen Counties",
        "Southern Sierra Front - Alpine/Northern Mono/Southern Lyon/Western Mineral Counties"
      ],
      "severity": "warning",
      "timeStart": 1632765600,
      "timeExpires": 1632830400,
      "description": "...RED FLAG WARNING IN EFFECT FROM 11 AM MONDAY TO 5 AM PDT TUESDAY FOR GUSTY WINDS AND LOW HUMIDITY FOR THE SIERRA FRONT... The National Weather Service in Reno has issued a Red Flag Warning for gusty winds and low humidity, which is in effect from 11 AM Monday to 5 AM PDT Tuesday. The Fire Weather Watch is no longer in effect. * Changes...Upgraded the Fire Weather Watch. Extended timing. * Affected Area...Fire Zone 420 Northern Sierra Front including Carson City, Douglas, Storey, Southern Washoe, Western Lyon, and Far Southern Lassen Counties, Fire Zone 421 Southern Sierra Front including Alpine, Northern Mono, Southern Lyon and and Western Mineral Counties. * Winds...Southwest to West 15 to 25 mph with gusts up to 40 mph. Wind prone areas could see gusts up to 50 mph Monday night. * Humidity...10-15% along and east of US-395. 15-20% west of US- 395. RH will increase Monday night to near 40%. * Duration...3 to 7 hours of critical conditions Monday afternoon. Gusty winds will last for over 18 hours. * Impacts...The combination of gusty winds and low humidity can cause fire to rapidly grow in size and intensity before first responders can contain them.",
      "uri": "https://alerts.weather.gov/cap/wwacapget.php?x=NV1261B9131370.RedFlagWarning.1261B930F0C0NV.REVRFWREV.0d02ac2ef7a3bbad215e02f9784626b5"
    },
    ...
  ]
}

Join our newsletter to receive the latest Weather Route updates

SERVICES

SERVICES