DocumentationExamplesResourcesTrial

Logo

API Documentation

AuthorizationForecastsMapsClimateWarningsMarineSkiUsage
Logo

Foreca Weather API

Foreca Weather API standard package includes access to point forecasts and weather maps.

API add-ons (Warning API, Marine API, Climate API, Ski API) can be added to the service for an additional fee. If you are interested in API add-ons, please contact our sales team for more information.

Learn more about Foreca’s different weather solutions at corporate.foreca.com.

Attribution

Customer shall display in its weather service the Foreca logo. In case displaying the logo is not possible due to technical reasons, the text ”Foreca” shall be displayed in customer’s weather service in connection with the content referring to the source of information. Customer agrees to cease use of the logo and name ”Foreca” in case requested by Foreca, and also to follow Foreca’s reasonable instructions in using the logo, trade name or other trademarks of Foreca.

https://corporate.foreca.com/en/logo

Third Party Attributions

Customer’s application must show attribution as given in API response. For example, the Capabilities endpoint in Weather Map API responds with layer info telling the required attribution text.

Currently the following organisations must be attributed if their data is used:

Radar data: Aemet, BOM, DMI, DWD, EC, FMI, InMet, JMA, KMI, KNMI, MET, Eireann, MeteoSchweiz, MF, Met Office, MET Norway, NWS, Protezione Civile, SMHI, SMN, ZAMG

Satellite data: EUMETSAT

Authorization

Authorization endpoint is used to fetch tokens for API access. Tokens are disposable, and should only be used for a single session. User and password must be kept secret and this request must be performed from a trusted source. Token lifetime in seconds is given in the authorization response.

Token

  • user

    Application key username

  • password

    Application key password

  • expire_hours (optional)

    Expiry time in hours (default 1, maximum 168)

POST
/authorize/token
{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9mbnc2LmZvcmVjYS5jb21cL2F1dGhvcml6ZVwvdG9rZW4iLCJpYXQiOjE1MjYzMDAzODAsImV4cCI6MTUyNjMwMzk4MCwibmJmIjoxNTI2MzAwMzgwLCJqdGkiOiJxSXl3WVlQNjc1NkczejBEIiwic3ViIjoibFFHa1Y4Z2pIeGUyZU1ibndUUUs4NktqVTY3RXJlS2htenY1IiwicHJ2IjoiYWY3YTAzOThkZGNiNWE3YTUzN2Q3YzdkMjU2NWEyZjgxZGM4ZTQxNCJ9.V8xg6L9yrY9__VH-jdrL_CqXisEpgcfdUa0NoxlGz0k",
  "expires_in": 3600,
  "token_type": "bearer"
}

Forecasts

Weather API exposes an HTTP interface, providing global weather point forecasts.

Location search

Locations and associated identifiers matching a search query. Can be used as alternatives to coordinates.

  • query

    Search query

  • lang (optional)

    Language (ISO 639-1 codes). Options: de, en, es, fr, it, pl, ru, fi, sv, nl, ko, pt, th, tr, zh, zh_TW (Chinese in Taiwan), zh_CN (Chinese in China). (default en)

  • country (optional)

    Limit search to a given country (ISO 3166-1 alpha-2 codes)

GET
/api/v1/location/search/:query
{
  "locations": [
    {
      "id": 102643743,
      "name": "London",
      "country": "United Kingdom",
      "timezone": "Europe/London",
      "adminArea": "England",
      "lon": -0.125532746,
      "lat": 51.508415222
    },
    {
      "id": 103458449,
      "name": "Londrina",
      "country": "Brazil",
      "timezone": "America/Sao_Paulo",
      "adminArea": "Estado do Parana",
      "lon": -51.162776947,
      "lat": -23.310277939
    },
    {
      "id": 106058560,
      "name": "London",
      "country": "Canada",
      "timezone": "America/Toronto",
      "adminArea": "Ontario",
      "lon": -81.233039856,
      "lat": 42.983390808
    }
  ]
}
  • id • number

    Identifier to be used with weather queries

  • name • string

    Location name eg. London

  • country • string

    Location country name eg. United Kingdom

  • state • string

    U.S. state abbreviation (if applicable)

  • timezone • string

    Location timezone eg. Europe/London

  • adminArea • string

    Administrative region name (if applicable)

  • lon • number

    Location longitude

  • lat • number

    Location latitude

    • Location info

    Location metadata.

    • location

      "Longitude,latitude" or location identifier (id) from the location endpoint

    • lang (optional)

      Language (ISO 639-1 codes). Options: de, en, es, fr, it, pl, ru, fi, sv, nl, ko, pt, th, tr, zh, zh_TW (Chinese in Taiwan), zh_CN (Chinese in China). (default en)

    GET
    /api/v1/location/:location
    {
  "id": 102643743,
  "name": "London",
  "country": "United Kingdom",
  "timezone": "Europe/London",
  "adminArea": "England",
  "lon": -0.125532746,
  "lat": 51.508415222
}
  • id • number

    Identifier to be used with weather queries

  • name • string

    Location name eg. London

  • country • string

    Location country name eg. United Kingdom

  • state • string

    U.S. state abbreviation (if applicable)

  • adminArea • string

    Administrative region name (if applicable)

  • timezone • string

    Location timezone eg. Europe/London

  • lon • number

    Location longitude

  • lat • number

    Location latitude

    • Observations

    Observations from a nearby representative weather station.

    • location

      "Longitude,latitude" or location identifier (id) from the location endpoint

    • tz (optional)

      Time zone of returned times (IANA time zone database names)

    • stations (optional)

      Amount of stations (default 3, maximum 6)

    • tempunit (optional)

      Temperature unit: "C", "F" (default "C")

    • windunit (optional)

      Wind unit: "MS" (m/s), "KTS" (knots), "KMH" (km/h), or "MPH" (mph) (default m/s)

    GET
    /api/v1/observation/latest/:location
    {
  "observations": [
    {
      "station": "Espoo Tapiola",
      "distance": "21 km N",
      "time": "2020-03-16T14:30:00+02:00",
      "temperature": 5,
      "feelsLikeTemp": 2,
      "symbol": "d400",
      "windDirString": "NW",
      "windDir": 315,
      "windSpeed": 4,
      "windGust": 6,
      "pressure": 1007.9,
      "relHumidity": 80,
      "visibility": 48992
    },
    {
      "station": "Helsinki Kaisaniemi",
      "distance": "24 km NE",
      "time": "2020-03-16T14:30:00+02:00",
      "temperature": 5,
      "feelsLikeTemp": 2,
      "symbol": "d400",
      "windDirString": "NW",
      "windDir": 336,
      "windSpeed": 4,
      "windGust": 6,
      "pressure": 1007.8,
      "relHumidity": 77,
      "visibility": 50000
    },
    {
      "station": "Helsinki Kumpula",
      "distance": "27 km NE",
      "time": "2020-03-16T14:30:00+02:00",
      "temperature": 5,
      "feelsLikeTemp": 2,
      "symbol": "d400",
      "windDirString": "NW",
      "windDir": 300,
      "windSpeed": 4,
      "windGust": 6,
      "pressure": 1007.8,
      "relHumidity": 79,
      "visibility": 50000
    }
  ]
}
  • station • string

    Name of the obsveration station

  • distance • string

    Distance from the location to the station eg. 13 km E

  • time • string

    ISO 8601 date and time for the observation parameters

  • temperature • number

    Temperature (°C or requested unit)

  • feelsLikeTemp • number

    Feels like temperature (°C or requested unit)

  • symbol • string

    Weather symbol code

  • windDirString • string

    Wind direction (N, NE, E, SE, S, SW, W, NW)

  • windDir • number

    Wind direction in degrees

  • windSpeed • number

    Wind speed (m/s or requested unit)

  • windGust • number

    Wind gust speed (m/s or requested unit)

  • pressure • number

    Atmospheric pressure normalized to sea level (hPa)

  • relHumidity • number

    Relative humidity (%)

  • visibility • number

    visibility in meters, e.g. "10000" for 10 km

    • Current

    Current weather estimate.

    • location

      "Longitude,latitude" or location identifier (id) from the location endpoint

    • alt (optional)

      Altitude in meters

    • tempunit (optional)

      Temperature unit

    • windunit (optional)

      Wind unit: "MS" (m/s), "KTS" (knots), "KMH" (km/h), or "MPH" (mph) (default m/s)

    • tz (optional)

      Time zone of returned times (IANA time zone database names)

    • lang (optional)

      Language (ISO 639-1 codes). Options: de, en, es, fr, it, pl, ru, fi, sv, nl, ko, pt, th, tr, zh, zh_TW (Chinese in Taiwan), zh_CN (Chinese in China). (default en)

    GET
    /api/v1/current/:location
    {
  "current": {
    "time": "2020-06-02T04:17-06:00",
    "symbol": "n200",
    "symbolPhrase": "partly cloudy",
    "temperature": 19,
    "feelsLikeTemp": 19,
    "relHumidity": 50,
    "dewPoint": 8,
    "windSpeed": 1,
    "windDirString": "SW",
    "windGust": 4,
    "precipProb": 1,
    "precipRate": 0,
    "cloudiness": 61,
    "thunderProb": 0,
    "uvIndex": 0,
    "pressure": 1011.46,
    "visibility": 33516
  }
}
  • time • string

    ISO 8601 date and time

  • symbol • string

    Weather symbol code

  • symbolPhrase • string

    Description of weather symbol

  • temperature • number

    Temperature (°C or requested unit)

  • feelsLikeTemp • number

    Feels like temperature (°C or requested unit)

  • relHumidity • number

    Relative humidity (%)

  • dewPoint • number

    Dew point (°C or requested unit)

  • windSpeed • number

    Wind speed (m/s or requested unit)

  • windDirString • string

    Wind direction (N, NE, E, SE, S, SW, W, NW)

  • windGust • number

    Wind gust (m/s or requested unit)

  • precipProb • number

    Probability of precipitation (%)

  • precipRate • number

    Intensity of precipitation rate (mm/h)

  • cloudiness • number

    Cloudiness (%)

  • thunderProb • number

    Probability of thunder nearby (%)

  • uvIndex • number

    UV index

  • pressure • number

    Atmospheric pressure normalized to sea level (hPa)

  • visibility • number

    Visibility (m)

    • Nowcast

    3-hour forecast in 15-minute time steps. The values represent the conditions at the associated timestamp unless otherwise specified.

    • location

      "Longitude,latitude" or location identifier (id) from the location endpoint

    • periods (optional)

      Number of time steps (default 8, maximum 12)

    • alt (optional)

      Altitude in meters

    • tempunit (optional)

      Temperature unit: "C", "F" (default "C")

    • windunit (optional)

      Wind unit: "MS" (m/s), "KTS" (knots), "KMH" (km/h), or "MPH" (mph) (default m/s)

    • tz (optional)

      Time zone of returned times (IANA time zone database names)

    • dataset (optional)

      Variable set: "standard" or "full" (default "standard")

    GET
    /api/v1/forecast/15minutely/:location
    {
  "forecast": [
    {
      "time": "2020-03-16T16:00+02:00",
      "symbol": "d240",
      "temperature": 29,
      "feelsLikeTemp": 33,
      "windDir": 292,
      "windGust": 8,
      "windSpeed": 1,
      "windDirString": "W",
      "precipProb": 68,
      "precipRate": 0.374569
    },
    {
      "time": "2020-03-16T16:15+02:00",
      "symbol": "d240",
      "temperature": 28,
      "feelsLikeTemp": 32,
      "windDir": 290,
      "windGust": 8,
      "windSpeed": 2,
      "windDirString": "W",
      "precipProb": 74,
      "precipRate": 0.374569
    },
    {
      "time": "2020-03-16T16:30+02:00",
      "symbol": "d240",
      "temperature": 28,
      "feelsLikeTemp": 31,
      "windDir": 289,
      "windGust": 9,
      "windSpeed": 2,
      "windDirString": "W",
      "precipProb": 81,
      "precipRate": 0.374569
    }
  ]
}
  • time • string

    ISO 8601 date and time

  • symbol • string

    Weather symbol code

  • symbolPhrase • string

    Weather description

  • temperature • number

    Temperature (°C)

  • feelsLikeTemp • number

    Feels like temperature (°C)

  • relHumidity • number

    Relative humidity (%) (dataset=full)

  • windDir • number

    Wind direction in degrees

  • windGust • number

    Wind gust speed (m/s or requested unit)

  • windSpeed • number

    Wind speed (m/s or requested unit)

  • windDirString • string

    Wind direction (N, NE, E, SE, S, SW, W, NW)

  • precipProb • number

    Probability of precipitation (%)

  • precipRate • number

    Intensity of precipitation rate (mm/h)

  • cloudiness • number

    Cloudiness (%)

  • thunderProb • number

    Thunder probability (%)

  • uvIndex • number

    Ultraviolet index

  • pressure • number

    Atmospheric pressure extrapolated to sea level (%)

    • Hourly

    Hourly forecasts. The values represent the conditions at the associated timestamp unless otherwise specified.

    • location

      "Longitude,latitude" or location identifier (id) from the location endpoint

    • periods (optional)

      Number of time steps (default 24, maximum 168)

    • alt (optional)

      Altitude in meters

    • tempunit (optional)

      Temperature unit: "C", "F" (default "C")

    • windunit (optional)

      Wind unit: "MS" (m/s), "KTS" (knots), "KMH" (km/h), or "MPH" (mph) (default m/s)

    • tz (optional)

      Time zone of returned times (IANA time zone database names)

    • dataset (optional)

      Variable set: "standard" or "full" (default "standard")

    • history (optional)

      History: whether to include past 24 hours (1 or 0, default 0)

    GET
    /api/v1/forecast/hourly/:location
    {
  "forecast": [
    {
      "time": "2020-03-16T14:00+01:00",
      "symbol": "d410",
      "temperature": 14,
      "feelsLikeTemp": 14,
      "windSpeed": 4,
      "windGust": 12,
      "windDir": 54,
      "windDirString": "NE",
      "precipProb": 76,
      "precipAccum": 0.04
    },
    {
      "time": "2020-03-16T15:00+01:00",
      "symbol": "d410",
      "temperature": 15,
      "feelsLikeTemp": 15,
      "windSpeed": 4,
      "windGust": 12,
      "windDir": 56,
      "windDirString": "NE",
      "precipProb": 69,
      "precipAccum": 0.04
    },
    {
      "time": "2020-03-16T16:00+01:00",
      "symbol": "d410",
      "temperature": 15,
      "feelsLikeTemp": 15,
      "windSpeed": 4,
      "windGust": 13,
      "windDir": 59,
      "windDirString": "NE",
      "precipProb": 62,
      "precipAccum": 0.07
    }
  ]
}
  • time • string

    ISO 8601 date and time

  • symbol • string

    Weather symbol code

  • symbolPhrase • string

    Description of weather (dataset=full)

  • temperature • number

    Temperature (°C or requested unit)

  • feelsLikeTemp • number

    Feels like temperature (°C or requested unit)

  • relHumidity • number

    Relative humidity (%) (dataset=full)

  • dewPoint • number

    Dew point (°C or requested unit) (dataset=full)

  • windSpeed • number

    Wind speed (m/s or requested unit)

  • windGust • number

    Wind gust speed (m/s or requested unit)

  • windDir • number

    Wind direction in degrees

  • windDirString • string

    Wind direction (N, NE, E, SE, S, SW, W, NW)

  • precipProb • number

    Probability of precipitation in the 1 hour period ending at the timestamp (%)

  • precipAccum • number

    Accumulated 1 hour precipitation up until the timestamp (as liquid water, mm).

  • cloudiness • number

    Cloudiness (%) (dataset=full)

  • thunderProb • number

    Thunder probability (%) (dataset=full)

  • uvIndex • number

    Ultraviolet index (dataset=full)

  • pressure • string

    Pressure (hPa) (dataset=full)

  • visibility • number

    Visibility (m) (dataset=full)

    • Three-hourly

    Forecast at 3 hour intervals, up to 14 days. The values represent the conditions at the associated timestamp unless otherwise specified. Precipitation sums are for three-hour periods.

    • location

      "Longitude,latitude" or location identifier (id) from the location endpoint

    • periods (optional)

      Number of time steps (default 24, maximum 168)

    • alt (optional)

      Altitude in meters

    • tempunit (optional)

      Temperature unit: "C", "F" (default "C")

    • windunit (optional)

      Wind unit: "MS" (m/s), "KTS" (knots), "KMH" (km/h), or "MPH" (mph) (default m/s)

    • tz (optional)

      Time zone of returned times (IANA time zone database names)

    • dataset (optional)

      Variable set: "standard" or "full" (default "standard")

    • history (optional)

      History: whether to include past 24 hours (1 or 0, default 0)

    GET
    /api/v1/forecast/3hourly/:location
    {
  "forecast": [
    {
      "time": "2021-09-07T14:00+02:00",
      "symbol": "d210",
      "temperature": 30,
      "feelsLikeTemp": 30,
      "windSpeed": 2,
      "windGust": 7,
      "windDir": 26,
      "windDirString": "NE",
      "precipProb": 9,
      "precipAccum": 0.1
    },
    {
      "time": "2021-09-07T17:00+02:00",
      "symbol": "d100",
      "temperature": 28,
      "feelsLikeTemp": 28,
      "windSpeed": 6,
      "windGust": 10,
      "windDir": 24,
      "windDirString": "NE",
      "precipProb": 20,
      "precipAccum": 0.39
    },
    {
      "time": "2021-09-07T20:00+02:00",
      "symbol": "n100",
      "temperature": 23,
      "feelsLikeTemp": 23,
      "windSpeed": 6,
      "windGust": 11,
      "windDir": 22,
      "windDirString": "N",
      "precipProb": 2,
      "precipAccum": 0
    }
  ]
}
  • time • string

    ISO 8601 date and time

  • symbol • string

    Weather symbol code

  • symbolPhrase • string

    Description of weather (dataset=full)

  • temperature • number

    Temperature (°C or requested unit)

  • feelsLikeTemp • number

    Feels like temperature (°C or requested unit)

  • relHumidity • number

    Relative humidity (%) (dataset=full)

  • dewPoint • number

    Dew point (°C or requested unit) (dataset=full)

  • windSpeed • number

    Wind speed (m/s or requested unit)

  • windGust • number

    Wind gust speed (m/s or requested unit)

  • windDir • number

    Wind direction in degrees

  • windDirString • string

    Wind direction (N, NE, E, SE, S, SW, W, NW)

  • precipProb • number

    Probability of precipitation in the 3 hour period ending at the timestamp (%)

  • precipAccum • number

    Accumulated 3 hour precipitation up until the timestamp (as liquid water, mm).

  • cloudiness • number

    Cloudiness (%) (dataset=full)

  • thunderProb • number

    Thunder probability (%) (dataset=full)

  • uvIndex • number

    Ultraviolet index (dataset=full)

  • pressure • string

    Pressure (hPa) (dataset=full)

  • visibility • number

    Visibility (m) (dataset=full)

    • Daily

    Daily forecasts.

    • location

      "Longitude,latitude" or location identifier (id) from the location endpoint

    • periods (optional)

      Number of time steps (default 7, maximum 14)

    • alt (optional)

      Altitude in meters

    • tempunit (optional)

      Temperature unit: "C", "F" (default "C")

    • windunit (optional)

      Wind unit: "MS" (m/s), "KTS" (knots), "KMH" (km/h), or "MPH" (mph) (default m/s)

    • dataset (optional)

      Variable set: "standard" or "full" (default "standard")

    GET
    /api/v1/forecast/daily/:location
    {
  "forecast": [
    {
      "date": "2020-03-16",
      "symbol": "d320",
      "maxTemp": 16,
      "minTemp": 12,
      "precipAccum": 12.34,
      "maxWindSpeed": 4,
      "windDir": 51
    },
    {
      "date": "2020-03-17",
      "symbol": "d320",
      "maxTemp": 17,
      "minTemp": 13,
      "precipAccum": 9.54,
      "maxWindSpeed": 5,
      "windDir": 40
    },
    {
      "date": "2020-03-18",
      "symbol": "d000",
      "maxTemp": 19,
      "minTemp": 11,
      "precipAccum": 0.01,
      "maxWindSpeed": 4,
      "windDir": 71
    }
  ]
}
  • date • string

    ISO 8601 date

  • symbol • string

    Weather symbol code representing daytime conditions (7am to 7pm local time)

  • symbolPhrase • string

    Description of weather during the day (dataset=full)

  • maxTemp • number

    24h maximum temperature (°C)

  • minTemp • number

    24h minimum temperature (°C)

  • maxFeelsLikeTemp • number

    24h maximum feels-like temperature (°C) (dataset=full)

  • minFeelsLikeTemp • number

    24h minimum feels-like temperature (°C) (dataset=full)

  • maxRelHumidity • number

    24h maximum relative humidity (°C) (dataset=full)

  • minRelHumidity • number

    24h minimum relative humidity (°C) (dataset=full)

  • maxDewPoint • number

    maximum dew point (°C) (dataset=full)

  • minDewPoint • number

    minimum dew point (°C) (dataset=full)

  • precipAccum • number

    Accumulated precipitation (as liquid water, mm)

  • maxWindSpeed • number

    Maximum wind speed (m/s or requested unit)

  • windDir • number

    Wind direction at maximum wind speed (degrees)

  • maxWindGust • number

    Maximum wind gust speed (m/s or requested unit) (dataset=full)

  • precipProb • number

    Precipitation probability during the day (%) (dataset=full)

  • cloudiness • number

    Daytime cloudiness average (%) (dataset=full)

  • sunrise • string

    Sunrise time of day in local time (dataset=full)

  • sunset • string

    Sunset time of day in local time (dataset=full)

  • sunriseEpoch • number

    Sunrise time in Unix time (dataset=full)

  • sunsetEpoch • number

    Sunset time in Unix time (dataset=full)

  • moonrise • string

    Moonrise time of day in local time (dataset=full)

  • moonset • string

    Moonset time of day in local time (dataset=full)

  • moonPhase • number

    Phase of moon at midday (degrees) (dataset=full)

  • uvIndex • number

    Maximum ultraviolet index (dataset=full)

  • minVisibility • number

    Minimum visibility (m) (dataset=full)

  • pressure • number

    Daytime average sea level pressure (hPa) (dataset=full)

    • Maps

    Weather Map API provides global weather forecast, radar and satellite data as map tiles compatible with commonly used map services such as Open Street Maps or Google Maps. All required and optional parameters are given as path and query parameters respectively. To obtain images one must first request an access token using valid credentials. The access token can then be used to fetch capabilities-response, which contains information on how to fetch images.

    Capabilities

    Capabilities endpoint is used to fetch layer metadata. This metadata is used to perform image queries. Capabilities-response provides layer information such as description, temporal and spatial extents as well as available color schemes. Images are layers renderable to image formats such as png or svg. The current data property in time element is the index to the most recent available time. Image products may have additional color schemes which can be optionally specified.

    • token

      Access token as provided by authorization endpoint

    GET
    /api/v1/capabilities
    {
  "images": [
    {
      "title": "Cell simulated precipitation",
      "description": "Precipitation with more intricate convection visualization",
      "formats": [
        "image/png"
      ],
      "colorschemes": [
        "default",
        "csdata-blue"
      ],
      "extent": {
        "minLat": -79.171,
        "maxLat": 79.171,
        "minLon": -180,
        "maxLon": 180,
        "maxZoom": 11,
        "minZoom": 3
      },
      "times": {
        "updated": "2017-01-01T00:00:00Z",
        "available": [
          "2017-09-01T03:00:00Z",
          "2017-09-01T06:00:00Z"
        ],
        "current": 1
      },
      "id": 1
    },
    {
      "title": "Wind symbol",
      "description": "Traditional wind symbol",
      "formats": [
        "image/svg+xml"
      ],
      "colorschemes": [
        "default",
        "data-pt"
      ],
      "extent": {
        "minLat": -79.171,
        "maxLat": 79.171,
        "minLon": -180,
        "maxLon": 180,
        "maxZoom": 11,
        "minZoom": 3
      },
      "times": {
        "updated": "2017-01-01T00:00:00Z",
        "available": [
          "2017-09-18T06:00:00Z",
          "2017-09-18T07:00:00Z"
        ],
        "current": 0
      },
      "id": 2
    }
  ]
}

    Tile

    Tile endpoint is used to obtain weather map tiles for the given layer and color scheme

    • id

      Layer id

    • x

      X index of the requested tile

    • y

      Y index of the requested tile

    • z

      Zoom level of the requested tile

    • time

      UTC timestamp value for the data to retrieve in ISO 8601 format. Must appear in the available times list

    • token

      Access token as provided by authorization endpoint

    • colorscheme (optional)

      Layer color scheme. Must appear in the color scheme list returned by capabilities endpoint

    GET
    /api/v1/image/tile/:z/:x/:y/:time/:id
    tile_example.png

    Legend

    Legend endpoint is used to obtain legend image for a color scheme

    • colorscheme

      Color scheme id. Must appear in the color scheme list returned by capabilities endpoint

    • id

      Layer id

    • token

      Access token as provided by authorization endpoint

    GET
    /api/v1/legend/:colorscheme/:id
    legend_example.png

    Climate

    Add-on

    Weather statistics.

    Monthly climate

    Averages and other summary weather statistics, by month. The values are based on a 30-year period 1991--2020.

    • location

      "Longitude,latitude" or location identifier (id) from the location endpoint

    • tempunit (optional)

      Temperature unit: "C", "F" (default "C")

    GET
    /api/v1/climate/monthly/:location
    {
  "climate": [
    {
      "month": "01",
      "dayMaxTemp": -0.76,
      "dayMinTemp": -5.68,
      "dayAvgTemp": -3.2,
      "precipSum": 55.17,
      "dailyPrecip": 1.78,
      "rainDays": 19.09,
      "frostDays": 26.42
    },
    {
      "month": "02",
      "dayMaxTemp": -1.09,
      "dayMinTemp": -6.64,
      "dayAvgTemp": -3.86,
      "precipSum": 38.34,
      "dailyPrecip": 1.37,
      "rainDays": 14.62,
      "frostDays": 24.6
    },
    {
      "month": "03",
      "dayMaxTemp": 2.62,
      "dayMinTemp": -4.01,
      "dayAvgTemp": -0.69,
      "precipSum": 37.21,
      "dailyPrecip": 1.2,
      "rainDays": 13.68,
      "frostDays": 24.75
    }
  ]
}
  • month • string

    Month of year

  • dayMaxTemp • number

    Daily maximum temperature

  • dayMinTemp • number

    Daily minimum temperature

  • dayAvgTemp • number

    Daily average temperature

  • precipSum • number

    Precipitation sum (mm/h)

  • dailyPrecip • number

    Precipitation accumulation during a day (mm/h)

  • rainDays • number

    Number of rain days in month (≥0.1 mm of precipitation)

  • frostDays • number

    Number of frost days in month

    • Warnings

    Add-on

    Governmental severe weather warnings are currently delivered from: Australia, Austria, Belgium, Canada, Denmark, Estonia, Finland, France, Germany, Ireland, Italy, Japan, Latvia, Luxembourg, Netherlands, Norway, Poland, Portugal, Spain, Sweden, Switzerland, United Kingdom and United States.

    Point warnings

    • location

      "Longitude,latitude" or location identifier (id) from the location endpoint

    • future (optional)

      Whether to return warnings starting more than 24 hours from now (boolean: default 0)

    GET
    /api/v1/warning/:location
    {
  "warnings": [
    {
      "type": "FO",
      "significance": "Y",
      "attribution": null,
      "validFrom": "2021-01-08T10:17:00Z",
      "validUntil": "2021-01-08T17:00:00Z",
      "description": [
        {
          "lang": "en",
          "text": "Dense Fog Advisory issued January 08 at 4:17AM CST until January 08 at 11:00AM CST by NWS Minneapolis&10;&10;Anoka; Benton; Blue Earth; Brown; Carver; Chippewa; Chisago; Douglas; Hennepin; Isanti; Kanabec; Kandiyohi; Lac Qui Parle; Le Sueur; Martin; McLeod; Meeker; Mille Lacs; Morrison; Nicollet; Pope; Ramsey; Redwood; Renville; Scott; Sherburne; Sibley; Stearns; Stevens; Swift; Todd; Watonwan; Wright; Yellow Medicine&10;&10;...DENSE FOG ADVISORY REMAINS IN EFFECT UNTIL 11 AM CST THIS&10;MORNING...&10;* WHAT...Visibility one quarter mile or less in dense fog.&10;* WHERE...Portions of central, east central, south central,&10;southwest and west central Minnesota.&10;* WHEN...Until 11 AM CST Friday.&10;* IMPACTS...Hazardous driving conditions due to low visibility.&10;* ADDITIONAL DETAILS...Slick spots on roads, overpasses, and&10;sidewalks are also possible as the fog freezes on exposed&10;surfaces.&10;&10;If driving, slow down, use your headlights, and leave plenty of&10;distance ahead of you."
        }
      ],
      "attributionUrl": null,
      "link": "https://alerts.weather.gov/cap/wwacapget.php?x=MN126188507444.DenseFogAdvisory.126188517F10MN.MPXNPWMPX.6f0fa4bac3937d8409b5648ff85e9eea",
      "sent": "2021-01-08T10:17:00Z",
      "name": "Fog",
      "significanceDescription": "Potentially dangerous"
    }
  ]
}
  • type • string

    Warning ID

  • significance • string

    One of: Y (yellow), O (orange), R (red), P (purple)

  • attribution • string

    Attribution: organization abbreviations

  • attributionUrl • string

    Attribution URL

  • validFrom • string

    ISO 8601 date and time

  • validUntil • string

    ISO 8601 date and time

  • lang • string

    Language of warning description (ISO 639-1 codes)

  • text • string

    Description of the particular warning in the associated language

  • significanceDescription • string

    Description of significance level

  • link • string

    Link to warning description provided by source (if applicable)

  • sent • string

    ISO 8601 date and time of warning sent

    • Warning type names

    Metadata for all warning types.

      GET
      /api/v1/warning/types
      {
  "AQ": {
    "name": "Air quality"
  },
  "AS": {
    "name": "Volcanic ashfall"
  },
  "AV": {
    "name": "Avalanche"
  },
  "CD": {
    "name": "Civil danger"
  },
  "CE": {
    "name": "Coastal event"
  }
}
    • name • string

      Name of warning type

      • Marine

      Add-on

      Marine forecasts of waves and sea temperatures.

      Hourly

      Hourly marine forecasts.

      • location

        "Longitude,latitude" or location identifier (id) from the location endpoint

      • periods (optional)

        Number of time steps (default 24, maximum 168)

      • tempunit (optional)

        Temperature unit: "C", "F" (default "C")

      • tz (optional)

        Time zone of returned times (IANA time zone database names)

      GET
      /api/v1/marine/forecast/hourly/:location
      {
  "forecast": [
    {
      "time": "2020-07-03T11:00",
      "sigWaveHeight": 0.95,
      "waveDir": 225,
      "sigSwellHeight": 0.02,
      "seaTemp": 18,
      "swimTemp": 18
    },
    {
      "time": "2020-07-03T12:00",
      "sigWaveHeight": 1.01,
      "waveDir": 225,
      "sigSwellHeight": 0.02,
      "seaTemp": 18,
      "swimTemp": 18
    },
    {
      "time": "2020-07-03T13:00",
      "sigWaveHeight": 1,
      "waveDir": 225,
      "sigSwellHeight": 0.02,
      "seaTemp": 18,
      "swimTemp": 18
    }
  ]
}
    • time • string

      ISO 8601 date and time

    • sigWaveHeight • number

      Significant wave height (m)

    • waveDir • number

      Mean wave direction (degrees)

    • sigSwellHeight • number

      Significant swell wave height (m)

    • seaTemp • number

      Sea temperature

    • swimTemp • number

      Sea temperature in swimming locations

      • Daily

      Daily marine forecasts.

      • location

        "Longitude,latitude" or location identifier (id) from the location endpoint

      • periods (optional)

        Number of time steps (default 24, maximum 168)

      • tempunit (optional)

        Temperature unit: "C", "F" (default "C")

      GET
      /api/v1/marine/forecast/daily/:location
      {
  "forecast": [
    {
      "date": "2020-07-03",
      "maxSigWaveHeight": 1.01,
      "maxSwellHeight": 0.05,
      "maxSeaTemp": 19,
      "maxSwimTemp": 18
    },
    {
      "date": "2020-07-04",
      "maxSigWaveHeight": 1.18,
      "maxSwellHeight": 0.18,
      "maxSeaTemp": 18,
      "maxSwimTemp": 17
    },
    {
      "date": "2020-07-05",
      "maxSigWaveHeight": 0.99,
      "maxSwellHeight": 0.99,
      "maxSeaTemp": 18,
      "maxSwimTemp": 18
    }
  ]
}
    • date • string

      ISO 8601 date

    • maxSigWaveHeight • number

      Maximum significant wave height (m)

    • maxSwellHeight • number

      Maximum swell wave height (m)

    • maxSeaTemp • number

      Maximum sea temperature

    • maxSwimTemp • number

      Maximum sea temperature in swimming locations

      • Ski

      Add-on

      Ski resort weather conditions and site information.

      Current

      Ski resort conditions.

      • location

        "Longitude,latitude" or location identifier (id) from the location endpoint

      • sites (optional)

        Number of ski sites (default 1, maximum 5)

      • radius (optional)

        Maximum distance to ski site (default 500 km)

      GET
      /api/v1/ski/current/:location
      {
  "locations": [
    {
      "name": "Lake Louise",
      "countryCode": "ca",
      "countryName": "Canada",
      "state": "Alberta",
      "city": "Lake Louise, AB",
      "postalCode": "T0L 1E0",
      "street": "Banff National Park",
      "houseNumber": null,
      "address": "Banff National Park, Lake Louise, AB, T0L 1E0",
      "longitude": -116.159228,
      "latitude": 51.439332,
      "openFrom": "08:30",
      "openUntil": "16:00",
      "isOpen": true,
      "altitudeBase": 1646,
      "altitudePeak": 2637,
      "primarySurfaceCondition": "Gripping snow",
      "liftsOpen": 2,
      "lifts": 7,
      "hasSkiing": true,
      "kmNordic": null,
      "kmPistes": 139,
      "kmOpen": 7,
      "hasValleyRun": true,
      "valleyRunOpen": "true",
      "hasTobogganRuns": false,
      "kmTobogganRuns": null,
      "lastSnowDate": "2020-11-01",
      "lastSnowAmount": null,
      "nightSkiing": false,
      "snowDepthPeak": 52,
      "snowDepthBase": 43,
      "hasFunPark": true,
      "funParkOpen": true,
      "updated": "2020-11-05T00:00:00Z"
    },
    {
      "name": "Sunshine Village",
      "countryCode": "ca",
      "countryName": "Canada",
      "state": "Alberta",
      "city": "Banff",
      "postalCode": "T0L 0C0",
      "street": "Banff-Nationalpark",
      "houseNumber": null,
      "address": "Banff-Nationalpark, Banff, T0L 0C0",
      "longitude": -115.761005,
      "latitude": 51.113248,
      "openFrom": "08:30",
      "openUntil": "16:00",
      "isOpen": false,
      "altitudeBase": 1660,
      "altitudePeak": 2730,
      "primarySurfaceCondition": null,
      "liftsOpen": 0,
      "lifts": 10,
      "hasSkiing": false,
      "kmNordic": null,
      "kmPistes": 109,
      "kmOpen": 0,
      "hasValleyRun": true,
      "valleyRunOpen": "false",
      "hasTobogganRuns": true,
      "kmTobogganRuns": null,
      "lastSnowDate": null,
      "lastSnowAmount": null,
      "nightSkiing": false,
      "snowDepthPeak": null,
      "snowDepthBase": null,
      "hasFunPark": true,
      "funParkOpen": false,
      "updated": "2020-11-05T00:00:00Z"
    }
  ]
}
    • name • string

      Site name

    • countryCode • string

      Country code (ISO 3166-1 alpha-2)

    • countryName • string

      Country name

    • state • string

      State (if applicable)

    • city • string

      City

    • postalCode • string

      Postal code

    • street • string

      Street

    • houseNumber • string

      House number

    • address • string

      Address

    • longitude • string

      longitude

    • latitude • string

      latitude

    • openFrom • string

      Opening time (HH:MM)

    • openUntil • string

      Open until time of day (HH:MM)

    • isOpen • boolean

      Open status

    • altitudeBase • number

      Altitude at base

    • altitudePeak • string

      Altitude at peak

    • primarySurfaceCondition • string

      Surface condition description

    • liftsOpen • number

      Number of lifts open

    • lifts • number

      Total number of lifts

    • hasSkiing • boolean

      Skiing available

    • kmNordic • number

      Nordic skiing length (km)

    • kmPistes • number

      Pistes length (km)

    • kmOpen • number

      Total open (km)

    • hasValleyRun • boolean

      Valley run available

    • valleyRunOpen • string

      Valley run status ("true", "false", "conditional")

    • hasTobogganRuns • boolean

      Toboggan runs available

    • kmTobogganRuns • number

      Length of toboggan runs

    • lastSnowDate • string

      Date of last new snow

    • lastSnowAmount • string

      Amount of new snow last time

    • nightSkiing • boolean

      Night skiing available

    • snowDepthPeak • number

      Depth of snow at peak

    • snowDepthBase • number

      Depth of snow at base

    • hasFunPark • boolean

      Fun park available

    • funParkOpen • boolean

      Fun park open

    • updated • string

      Date and time of last update (ISO 8601)

      • Usage

      Monitor your API usage.

      Month's usage

      Given month's hit sums by API

      • month

        Month (e.g. "2020-03")

      • user

        Username

      • password

        Administrative password

      GET
      /usage/month/:month
      {
  "apis": [
    {
      "name": "Weather API",
      "hits": 3252
    },
    {
      "name": "Map API",
      "hits": 2
    },
    {
      "name": "Administrative",
      "hits": 136
    }
  ],
  "hits": 3390
}

      Day's usage

      Given day's hit sums by API

      • day

        Day (e.g. "2020-03-15")

      • user

        Username

      • password

        Administrative password

      GET
      /usage/day/:day
      {
  "apis": [
    {
      "name": "Weather API",
      "hits": 156
    },
    {
      "name": "Map API",
      "hits": 2
    },
    {
      "name": "Administrative",
      "hits": 0
    }
  ],
  "hits": 158
}