OpenWeatherMap Provider

The Weather API automatically appends the correct security credentials using the IMS token claims. JCI has a free subscription, so some endpoints are available.

OpenWeather Calls

Location format

Location format is {lat},{lon}.
The accuracy of coordinates affects the maximum distance for searching among available data entries around a specified location. More digits beyond decimal points means a shorter search distance.

Digits beyond decimal point to search radius

  • No decimal part ~78km
  • 1 digit ==> 7862 m
  • 2 digits ==> 786 m
  • 3 digits ==> 78 m
  • 4 digits ==> 8 m
  • 5 digits ==> 1 m

Date format

Date can be specified using either of two specifications.

ISO 8601

Searches for the latest available point within specified date (see examples below).
All dates are UTC-only. Using local time zones is not supported at the moment.

  • 2016-01-02T15:04:05Z ==> searches between 2016-01-02T15:04:05Z and 2016-01-02T15:04:05.9999Z
  • 2016-01-02T15:04Z ==> searches between 2016-01-02T15:04:00Z and 2016-01-02T15:04:59.9999Z
  • 2016-01-02T15Z ==> searches between 2016-01-02T15:00:00Z and 2016-01-02T15:59:59.9999Z
  • 2016-01-02Z ==> searches between 2016-01-02T00:00:00Z and 2016-01-02T23:59:59.9999Z
  • 2016-01Z ==> searches between 2016-01-01T00:00:00Z and 2016-12-31T23:59:59.9999Z
  • 2016Z ==> searches between 2016-01-01T00:00:00Z and 2016-12-31T23:59:99.9999Z