Changelog v3.1 → v4.0

Changelog

There have been many changes and upgrades between v3.1 and v4.0 to improve the user experience and provide more relevant, and accurate forecasts.

To get started with transitioning over from v3.1 to v4.0, you can start by replacing the v3_1 in the URLs with v4_0 and comparing the outputs.

From:

curl --location 'https://forecast.meteonomiqs.com/v3_1/forecast/48.1374/10.5753/' \
--header 'x-api-key: <api-token>' \
--header 'Accept-Language: de-de'

To:

curl --location 'https://forecast.meteonomiqs.com/v4_0/forecast/48.1374/10.5753/' \
--header 'x-api-key: <api-token>' \
--header 'Accept-Language: de-de'

Or, if you’re using the API without specifying a version number, add the number after the https://forecast.meteonomiqs.com part of the URL.

From:

curl --location 'https://forecast.meteonomiqs.com/forecast/48.1374/10.5753/' \
--header 'x-api-key: <api-token>' \
--header 'Accept-Language: de-de'

To:

curl --location 'https://forecast.meteonomiqs.com/v4_0/forecast/48.1374/10.5753/' \
--header 'x-api-key: <api-token>' \
--header 'Accept-Language: de-de'

Please note: effort was made to make sure that the v4.0 endpoints matched the v3.1 endpoints as closely as possible. However, there are still some breaking changes between the versions. Please refer to this changelog and test all applications with the new endpoints thoroughly before deployment to ensure that no key functionality is missing.

Overview

Starting with a basic overview of major changes.

Tag Old name New name
Forecast “Get Forecast” (with latitude and longitude) “Get forecast by coordinates”
Forecast “Get Forecast” (with countryCode and postCode) “Get forecast by location”
Forecast “Get Forecast Summary” “Get forecast summary by coordinates”
Forecast “Get Forecast Spaces” “Get forecast spaces by coordinates”
Forecast “Get Forecast Hourly” “Get hourly forecast by coordinates”
Forecast2 “Get Forecast” “Get forecast2 by coordinates”
Warnings “Warnings endpoints” “Get active warnings by coordinates”
Nowcast “Get observation with realtime weather, precipitation risk and station data when available” “Get nowcast weather forecast by coordinates”
Locations “Location by coordinates” “Get nearby location by coordinates”
Tag Endpoint Reason
Warnings “Warnings regions endpoints” Redundant, information already supplied by “Get active warnings by coordinates”
Warnings “Warnings ID endpoints” Redundant, information already supplied by “Get active warnings by coordinates”
Hood (all endpoints) New backend data structure means output would have been identical to Pollen and Forecast endpoints. Have been replaced with those endpoints. Station data is also no longer returned. Realtime data is supplied by the Nowcast endpoint
Nowcast “Get pollen forecast” New backend data structure means output would have been identical to Pollen endpoints. Has been replaced with that endpoint
Tag Endpoint Description
Warnings “Get warning details by warning ID” Retrieves individual warning information for a given warning ID
Warnings “Get active warnings by warncell ID” Retrieves warnings for a given warncell (national classification for the given area, country dependent)
Locations “Search locations” Searches for locations and returns a number of results based on the search query string

Full Changes

Below is a more detailed list about the changes to the API endpoints.

Get forecast by coordinates (and location): GET /forecast/{latitude}/{longitude} (GET /forecast/byLocation/{countryCode}/{postCode})

Each of the changes in summary, spaces, and hourly are the same as in their respective limited API endpoints.

summary

Renamed:

Changed: - Changed highestWarning to null - deprecated, use warnings endpoints instead

Removed:

spaces

Forecast for spaces has been extended from 10 to 16 days.

Renamed:

Changed: - Changed highestWarning to null - deprecated, use warnings endpoints instead

Removed:

hourly

Added:

Changed:

Renamed:

Removed:

Get forecast summary by coordinates: GET /forecast/{latitude}/{longitude}/summary

Renamed:

Changed: - Changed highestWarning to null - deprecated, use warnings endpoints instead

Removed:

Get hourly forecast by coordinates: GET /forecast/{latitude}/{longitude}/hourly

Added:

Changed:

Renamed:

Removed:

Get forecast spaces by coordinates: GET /forecast/{latitude}/{longitude}/spaces

Forecast for spaces has been extended from 10 to 16 days.

Renamed:

Changed: - Changed highestWarning to null - deprecated, use warnings endpoints instead

Removed:

Get nearby location by coordinates: GET /locations/nearby/{latitude}/{longitude}

Fixed:

Renamed:

Removed:

Get nowcast weather by coordinates: GET /nowcast/weather/{latitude}/{longitude}

Added:

Changed:

Removed:

Get pollen forecast by coordinates (and location): GET /pollen/byCoordinates/{latitude}/{longitude} (GET /pollen/byLocation/{countryCode}/{postCode})

Changed:

Renamed:

Removed:

Get active warnings by coordinates: GET /warnings/{latitude}/{longitude}

Added:

Changed:

Removed:

Get forecast2 by coordinates: GET /forecast2/{latitude}/{longitude}

Added:

Changed:

Renamed:

Removed: