Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

GISMapApp

OpenWeather

  • Last UpdatedFeb 27, 2025
  • 2 minute read

Shows weather images provided by OpenWeather.

An API key is required to use OpenWeather services. For more information about obtaining an API key, see the OpenWeather website- https://openweathermap.org/appid.

The following table describes various layers that can be selected:

Layer

Meaning

Units

PAC0

Convective precipitation

mm

PR0

Precipitation intensity

mm/s

PA0

Accumulated precipitation

mm

PAR0

Accumulated precipitation - rain

mm

PAS0

Accumulated precipitation - snow

mm

SD0

Depth of snow

m

WS0

Wind speed at an altitude of 0 meters

m/s

WND

Joint display of speed wind (color) and wind direction (arrows), received by U and V components

m/s

APM

Atmospheric pressure on mean sea level

hPa

TA

Air temperature at a height of meters

°C

TD

Temperature of a dew point

°C

TS0

Soil temperature 0-0 сm

K

TS0

Soil temperature >0 сm

K

HRD0

Relative humidity

%

CL

Cloudiness

%

To change the image style (color gradient), set the palette option as described in Weather Map 2 API.

Another important configuration available is the time property, which can be used to get a historical or forecast maps (current weather is used when not specified).

Other parameters that are part of the OpenWeather api can also be used. For more information, check the Weather Map API- https://openweathermap.org/api/weather-map-2.

The following table provides the specific configurable options available for this layer:

Property

Type

Description

appid

String

Provides API key to access OpenWeather services.

arrow_step [Optional]

Number

Step of values for drawing wind arrows, specified in pixels. Parameter are used only for wind layers (WND).

  • Default: 32

fill_bound [Optional]

Boolean

If true, then all weather values outside the specified set of values is filled by color corresponding to the nearest specified value.

layer

Layer

A weather map layer.

  • Values: "PAC0" | "PR0" | "PA0" | "PAR0" | "PAS0" | "SD0" | "WS10" | "WND" | "APM" | "TA2" | "TD2" | "TS0" | "TS10" | "HRD0" | "CL"

For more information, refer https://openweathermap.org/api/weather-map-2#layers.

opacity [Optional]

Number

Defines the degree of layer opacity.

  • Min: 0

  • Max: 1

  • Default: 0.8

  • Overrides CommonOptions.Opacity

palette [Optional]

String

Defines the color palette. You can use custom palettes for each layer.

You can also create a palette for yourself and pass it to the URL as follows {value}:{HEX color};..;{value}:{HEX color}.

time [Optional]

Time

Time for historical or forecast layers.

  • Time

    • TimeNumber (Number): Number of Milliseconds since 1970-1-1.

    • TimeString (String): Represents date and time in ISO 8601 format. Other formats might be supported depending on the browser used.

type

openweather

A type of Layer.

use_norm [Optional]

Boolean

If true, then the length of the arrows is normalizing. Parameter only for wind layers (WND).

Examples of OpenWeather

Below is an example of a "Depth of snow" weather layer:

  • Configuration and map preview

    OpenWeather configuration and map preview

  • JSON string configuration

    {

    "appid": "{APPID}",

    "layer": "SD0",

    "title": "Weather - Depth of snow",

    "type": "openweather",

    "isBaseMap": false

    }

Related Links
TitleResults for “How to create a CRG?”Also Available in