Normals
https://data.api.xweather.com/normals/Max Limits:
plimit:31
Requests
Every request to the endpoint must include one of the supported actions in the url.
https://data.api.xweather.com/normals/{action}?client_id={client_id}&client_secret={client_secret}&{params}Supported Actions
The following actions are supported with the /normals endpoint:
| Action | Description |
|---|---|
| :id | Type: stringTypically used for passing a geographical location name or identifier such as city name, lat/long, or even US and Canadian postal codes. Learn more. |
| closest | Type: stringBased on a location search, the results will be returned in order from closest to farthest. Learn more. |
| within | Type: stringUses a circle or polygon, define an area to search for results. Learn more. |
| search | Type: stringA generalized action that is determined with the endpoints query parameters. Learn more. |
| route | Type: stringAllows you to pass several coordinates along a custom route to return data points at each location. Learn more. |
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.
Properties
id (string)
The co-op/station ID that the normal is based on.
dataSource (string)
The data source of the record.
loc (object)
The location of the record.
loc.long (number)
The place or nearest place to the record.
loc.lat (number)
The latitude coordinate of the record.
place (object)
Object containing information about the place or nearest place to the record.
place.name (string)
The place or nearest place to the record.
place.state (string)
The state abbreviation in which the response is located. This may be null or an empty string depending on the country.
place.country (string)
The 2 letter ISO-3166 country abbreviation in which the response is located.
periods (array)
Array of objects containing information about the periods.
periods.#.type (string)
Type of normal:
- daily
- monthly
- annual
periods.#.mon (number)
The number of the month the normal is for, from 1 - 12. Will be null for an annual summary (filter=annual).
periods.#.day (number)
The numeric day of the month, from 1 - 31. Will be null for both a monthly and annual summary (filter=monthly or filter=annual).
periods.#.timestamp (number)
UNIX timestamp of the normals valid time.
periods.#.dateTimeISO (string)
The date and time of the normals valid time, formatted in ISO-8601 format.
periods.#.temp (object)
Object containing information about the normal temperature.
periods.#.temp.maxF (number)
The normal maximum temperature for the period, in degrees Fahrenheit.
periods.#.temp.maxC (number)
The normal maximum temperature for the period, in degrees Celsius.
periods.#.temp.minF (number)
The normal minimum temperature for the period, in degrees Fahrenheit.
periods.#.temp.minC (number)
The normal minimum temperature for the period, in degrees Celsius.
periods.#.temp.avgF (number)
The normal average temperature for the period, in degrees Fahrenheit.
periods.#.temp.avgC (number)
The normal average temperature for the period, in degrees Celsius.
periods.#.prcp (object)
Object containing information about the normal precipitation.
periods.#.prcp.ytdIN (number)
The normal year-to-date precipitation for the period, in inches.
periods.#.prcp.ytdCM (number)
The normal year-to-date precipitation for the period, in centimeters.
periods.#.prcp.mtdIN (number)
The normal month-to-date precipitation for the period, in inches.
periods.#.prcp.mtdCM (number)
The normal month-to-date precipitation for the period, in centimeters.
periods.#.snow (object)
Object containing information about the normal snowfall.
periods.#.snow.ytdIN (number)
The normal year-to-date snowfall for the period, in inches.
periods.#.snow.ytdCM (number)
The normal year-to-date snowfall for the period, in centimeters.
periods.#.snow.mtdIN (number)
The normal month-to-date snowfall for the period, in inches.
periods.#.snow.mtdCM (number)
The normal month-to-date snowfall for the period, in centimeters.
periods.#.hdd (number)
The normal heating degree days for the period. This is the number of degrees that a day"s average temperature is below 65 degrees Fahrenheit. This value is only returned for daily normals.
periods.#.cdd (number)
The normal cooling degree days for the period. This is the number of degrees that a day"s average temperature is above 65 degrees Fahrenheit. This value is only returned for daily normals.
profile (object)
Object containing information about the location or event.
profile.tz (string)
Timezone name of the location, such as America/New_York.
relativeTo (object)
Object containing information about the location used for the request compared to the record"s actual location.
relativeTo.lat (number)
Latitude coordinate of the location used for the request. This may be different than the record"s loc.lat value if there was no record exactly at the request location.
relativeTo.long (number)
Longitude coordinate of the location used for the request. This may be different than the record"s loc.long value if there was no record exactly at the request location.
relativeTo.bearing (number)
Bearing in degrees of the record"s location relative to the location used for the request.
relativeTo.bearingENG (string)
Cardinal direction of the record relative to the location used for the request.
relativeTo.distanceKM (number)
Distance, in kilometers, from the requested location to the record"s actual location.
relativeTo.distanceMI (number)
Distance, in miles, from the requested location to the record"s actual location.
{
"id": "usc00214884",
"dataSource": "NOAA",
"loc": {
"long": -93.2469,
"lat": 44.9783
},
"place": {
"name": "lower st anthony falls",
"state": "mn",
"country": "us"
},
"periods": [
{
"type": "daily",
"mon": 12,
"day": 14,
"timestamp": 1702512000,
"dateTimeISO": "2023-12-14T00:00:00+00:00",
"temp": {
"maxF": 27.3,
"maxC": -2.61,
"minF": 15.5,
"minC": -9.17,
"avgF": 21.4,
"avgC": -5.89
},
"prcp": {
"ytdIN": 33.69,
"ytdCM": 855.7,
"mtdIN": 0.6,
"mtdCM": 15.2
},
"snow": null,
"hdd": 43.6,
"cdd": 0
}
],
"profile": {
"tz": "America/Chicago"
},
"relativeTo": {
"lat": 44.97997,
"long": -93.26384,
"bearing": 98,
"bearingENG": "E",
"distanceKM": 1.345,
"distanceMI": 0.836
}
}