Isolines Request | Symbols Request | Compatibility with ArcGIS online

Vector Tile Server

Vector tiles contain geo-data packed in vector format to be efficiently transmit over the web, they are delivered together with a style file that tells the web client how to render them. We serve the geo-data as Mapbox Vector tiles encoded as Google Protobufs (PBF). Vector data is a better alternative to raster data in terms of both quality and efficiency when displaying text, line geometry, and symbols.

Isolines Request

We offer official styles that you can use in your client to visualise isolines, you only need to specify this URL in your client and it will automatically know what other URLs request for other resources such as fonts, symbols, and vector tiles:

https://api.meteomatics.com/mvt/isolines/<parameter>/style.json?<optionals>

Note that it is both possible to separate the <parameter>'s name and unit with a colon or a slash, e.g. the result shown below also works with setting the parameter to msl_pressure/hPa instead of msl_pressure:hPa.

For example, below is the result for https://api.meteomatics.com/mvt/isolines/msl_pressure:hPa/style.json?datetime=now at Esri online:

If necessary you can also download and customize our official style file to your needs. You can host the modified style and use it in your own application. Furthermore, some web-interfaces such as Maputnik allow for easy style modifications (width/color of the lines, etc) and display of the results in real-time. For example, the result of using Maputnik to change the isolines' color to blue:

Mandatory Fields

FieldDescriptionValueExample
parameterParameter from the available parameters in the API you want to retrieve isolines for.String with the parameter name and unit separated by either a colon or a slash.msl_pressure:hPa, msl_pressure/hPa

Optional Fields

Optional fields can be attached to the query string as follows:

https://...?option_name=<option_value>&...

The following table describes all optional parameters:

FieldDescriptionValueExample
datetimeDate for which the vector data is retrieved.A single point in time (UTC) as specified in the section Date/Time Description. datetime always refers to validdatetime. The default setting is now.datetime=2018-04-12T12:45Z
modelThis parameter is used to select a specific source for weather data.String. Default: model=mixecmwf-ifs, ncep-gfs, ukmo-um10, etc.
isoline_rangeDefine an interval for which isolines shall be generated. The structure is as follows: start,end,spacing.List of integers.isoline_range=-40,40,5
isoline_valuesDefine a single value or a list of values for which isolines shall be generated. If isoline_values=5 is set for temperature, then only the 5 °C-isotherm is generated.List of doubles.isoline_values=0,0.5,1,1.5,2,2.5,3
radius_median_filterSmoothing of isolines.Integer between 0-10.radius_median_filter=1
radius_gaussian_filterSmoothing of isolines.Integer between 0-10.radius_gaussian_filter=3
isoline_min_pointsMinimum number of points per isolines. Must be at least 2.Single integer.isoline_min_points=2
access_tokenInstead of basic authentication, you can opt to use OAuth authentication as described here: OAuth AuthentificationString.eyJhbGciOicCI6IkpXVC J9.eyJzdWIwIiwibmF
tZSI6IkpoxNTE2M
jM5MDIy2QT4fwpMeJ
f36POk6yJV_adQssw5c

Symbols Request

You only need to specify this style URL in your client and it will automatically know what other URLs request for other resources such as vector tiles and weather symbol icons:

https://api.meteomatics.com/mvt/symbols/<parameter>/style.json?<optionals>

For example: https://api.meteomatics.com/mvt/symbols/weather_symbol_1h:idx/style.json?datetime=todayT0Z

Mandatory Fields

FieldDescriptionValueExample
parameterThe parameter for which you want to retrieve the symbols. Available is weather_symbol_<interval>:idx with intervals 20min, 30min, 1h,3h, 6h, 12h, 24h.String with the parameter name and unit separated by either a colon or a slash.weather_symbol_1h:idx, weather_symbol_1h/idx

Optional Fields

Optional fields can be attached to the query string as follows:

https://...?option_name=<option_value>&...

The following table describes all optional parameters:

FieldDescriptionValueExample
validdatetimeDate for which the vector data is retrieved.Date and times (UTC) as specified in the section Date/Time Description. datetime always refers to validdatetime. The default setting is now.datetime=2022-05-28T12:00Z
modelThis parameter is used to select a specific source for weather data.String. Default: model=mixecmwf-ifs, ncep-gfs, ukmo-um10, etc.
resolutionControls the density of weather symbols per tile.Two doubles or two integer: <resolution_lat>,<resolution_lon> or <number_lons>x<number_lats>resolution=0.1,0.1, resolution=400x300
access_tokenInstead of basic authentication, you can opt to use OAuth authentication as described here: OAuth AuthentificationString.eyJhbGciOicCI6IkpXVC
J9.eyJzdWIwIiwibmF
tZSI6IkpoxNTE2M
jM5MDIy2QT4fwpMeJ
f36POk6yJV_adQssw5c

Compatibility with ArcGIS online

You can specify the style URL for your request in a VectorTileLayer as shown below, make sure to also include your access token in the customParameters argument. An access token is the only method of authentication compatible with the ArcGIS JavaScript API.

const vtlLayer = new VectorTileLayer({
 url: "https://api.meteomatics.com/mvt/isolines/msl_pressure:hPa/style.json"
 customParameters: {access_token: "eyJ0...PGw", datetime: "2021-01-01T0Z", model: "ecmwf-ifs", radius_median_filter: 2}
});

A full example is available at code-pen Meteomatics Isolines Demo. You will need to update the token variable that you can obtain by login with your Meteomatics account into https://login.meteomatics.com/api/v1/token.