Weather API
  1. customer
Weather API
  • customer
    • Weather API - General Information
    • Weather API - Variables
    • Weather API - Timesteps
    • Weather API - /wthr/ endpoints usability improvements
    • Weather API - VariableAlias.json
    • Weather API - WeatherVariablesDefaults.json
    • Weather API - weatherMap - parameters
    • Weather API - weatherTiles - general, zoom
    • Weather API - weatherTiles - weather variables
    • Weather API - weatherTiles - timesteps
    • /
      GET
    • /wthr/list/ForecastModels
      GET
    • /wthr/list/WeatherVariables
      GET
    • /wthr/list/Timesteps
      GET
    • /wthr/list/TileTimesteps
      GET
    • /wthr/svar/NearestGridData
      GET
    • /wthr/svar/InterpolatedData
      GET
    • /wthr/svar/AreaForcast
      GET
    • /wthr/mvar/PointForcast
      POST
    • /wthr/calc/AstroData
      GET
    • /wthr/graphic/Meteogram
      GET
    • /wthr/graphic/WeatherMap
      GET
    • /wthr/graphic/Tile
      GET
  1. customer

/wthr/graphic/WeatherMap

GET
weather.openportguide.org/api/wthr/graphic/WeatherMap
Last modified:2025-06-24 15:57:41
Maintainer:tkws
OperationId:wthr_graphic_weatherMap

Individual and highly configurable forecast maps can be requested. They are very useful for integration in web pages, software or apps.

A detailed explanation of the parameters for the configuation you can find here: Weather API - weatherMap - parameters

The individual forecasts are available for the following variables:

wind_stream

wind_barb

wind_vector

gust

air_temperature

surface_pressure

cloud_cover

relative_humidity

precipitation

significant_wave_height

primary_wave_height_direction

primary_wave_period

wind_wave_height_direction

wind_wave_period

swell_height_direction

swell_period

sea_surface_current

sea_surface_temperature

sea_ice_coverage

sea_ice_thickness

wind_stream:

Visualisation of the average wind speed in 10m height.

The direction of the strem lines is in downwind direction. The color shows the wind intensity in the desired unit.

Example:

wind_barb:

Visualisation of the average wind speed in 10m height.

The direction of the barb is in upwind direction. The color shows the wind intensity in the desired unit.

Example:

wind_vector:

Visualisation of the average wind speed in 10m height.

The direction of the arrow is in downwind direction. The color and the lenght of the arrow are showing the wind intensity in the desired unit

Example:

gust:

Visualisation of the gust speed.

The color shows the gust intensity in the desired unit.

Example:

air_temperature:

Visualisation of the temperature in 2m height.

The color specifies the value of the temperature in the desired unit.

Example:

surface_pressure:

Visualization of the atmospheric pressure by isobars in the desired unit.
The isobars are lines with the same atmospheric pressure.
The color indicates the atmospheric pressure in the desired unit.

Example:

cloud_cover:

Visualization of the cloud cover.

The color indicates the value of the cloud cover in %.

Example:

relative_humidity:

Visualization of the relative humidity.

The color indicates the value of the relative humidity in %.

Example:

precipitation:

Visualization of the precipitation.

The color indicates the value of the precipitation in the desired unit.

Example:

significant_wave_height:

Visualization of the significant wave height.

The color indicates the value of the significant wave height in the desired unit.

Example:

primary_wave_height_direction:

Visualization of the significant wave height and direction.

The direction of the arrows points into the moving direction of the wave, the color indicates the value of the significant wave height in the desired unit.

Example:

primary_wave_period:

Visualization of the significant wave period.

The color of the shading indicates the period time of the significant waves.

Example:

wind_wave_height_direction:

Visualization of the wind wave height and direction.

The direction of the arrows points into the moving direction of the wind waves, the color indicates the value of the wind waves height in the desired unit.

Example:

wind_wave_period:

Visualization of the significant wave period.

The color of the shading indicates the period time of the wind waves.

Example:

swell_height_direction:

Visualization of the swell height and direction.

The direction of the arrows points into the moving direction of the swell, the color indicates the value of the swell height and direction in the desired unit.

Example:

swell_period:

Visualization of the swell period.

The color of the shading indicates the period time of the swell.

Example:

sea_surface_current:

Visualization of the Sea surface current.

The color of the shading indicates the speed of the current.

Limitation: The calculated grafic must not contain the 180° line, otherwise one side of the line is not calculated.

Example:

sea_surface_temperature:

Visualization of the Sea surface temperature.

The color of the stream lines indicates the sea surface temperature.

Limitation: The calculated grafic must not contain the 180° line, otherwise one side of the line is not calculated.

Example:

sea_ice_coverage:

Visualization of the Sea ice coverage.

The color of the shading indicates the sea surface caverage.

Limitation: The calculated grafic must not contain the 180° line, otherwise one side of the line is not calculated. The ice covered area is calculated only by the influence of the energy balance of the ocean (Wind and currents are ignored.) and can be partly significantly different compared with the reality.

Example:

sea_ice_thickness:

Visualization of the Sea ice thickness.

The color of the shading indicates sea ice thickness.

Limitation: The calculated grafic must not contain the 180° line, otherwise one side of the line is not calculated. The ice thickness of the ice is calculated only by the influence of the energy balance of the ocean (Wind and currents are ignored.) and can be partly significantly different compared with the reality.

Example:

Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'weather.openportguide.org/api/wthr/graphic/WeatherMap?var=airTemperature&lat=54&lon=9&latrange=10&lonrange=14&t=0&duration=1&label=Meldorf&nx=1000&ny=800&backgroundColor=black&mapColor=white&labelColor=red&scale=fixed&projection=latlon&displayType=contour&unit=metric&lang=en&apiKey={{api-key}}' \
--header 'Host: {{BASE_URL}}'
Response Response Example
200 - Success
image.png

Request

Query Params

Header Params

Responses

🟢200OK
application/octet-stream
Body

🟠401Unauthorized
Modified at 2025-06-24 15:57:41
Previous
/wthr/graphic/Meteogram
Next
/wthr/graphic/Tile
Built with