Summary Forecast Requests

This endpoint returns a summary weather forecast from an entire set of GPS coordinates. The returned forecast contains a single summary forecast, as well as the complete set of severe weather alerts (available in North America and Europe).

Data units are imperial (US) by default, but can be configured as metric (SI) units. Individual response parameters will indicate the units used by either of these configurations.

Query Parameters

`point`

A comma-separated latitude,longitude GPS coordinate string.

(required; multiple allowed)

`mode`

Desired mode of transit. Choice of transit will affect the scoring of the weather matrix.

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)

`max_days`

The maximum number of days for which to aggregate the summary across (starting today).

(optional; default=all)

`start_date`

The date at which to start aggregating the summary, in YYYY-mm-dd format. This parameter is used when you want to start aggregating the summary starting at a future date (for example, getting the summary starting 3 days from today).

Use of this parameter also requires use of the tz_offset parameter.

(optional; default=today)

`tz_offset`

The time zone offset from GMT for the requested date, offset in hours. Decimal values are allowed for time zone offsets that are not whole numbers.

Use of this parameter also requires use of the start_date parameter.

(optional; default=0)

Cost

15 points x the number of locations requested

Sample Query

GET https://api.weatherroute.io/v1/weather/forecast-summary?point=39.526,-119.813&point=39.256,-120.735&point=38.582,-121.494

Output

This request returns a ForecastSummary response object.

Sample output

{
  "summary": {
    "temperatureMax": 83.98,
    "temperatureMin": 57.3,
    "apparentTemperatureMax": 83.48,
    "apparentTemperatureMin": 57.79,
    "precipType": "none",
    "precipProbability": 0,
    "precipIntensity": 0,
    "precipIntensityMax": 0,
    "precipAccumulation": 0,
    "dewPoint": 28.94,
    "humidity": 0.25,
    "windSpeed": 5.89,
    "windGust": 23.12,
    "skyCover": 0.15,
    "visibility": 10,
  },
  "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