/openweathermap-java-api

Java API to access openweathermap.org API

Primary LanguageJavaApache License 2.0Apache-2.0

openweathermap-java-api Build Status Download codecov

To use the OpenweatherMap API, you need to obtain an API key. Sign up here.

Features

Current weather queries

Call current weather data for one location

  • By city name
  • By city ID
  • By ZIP code
  • By geographic coordinates

Call current weather data for several cities

  • Cities within a rectangle zone
  • Cities in cycle
  • Call for several city IDs

Forecast queries

Call 5 day / 3 hour forecast data

  • By city name
  • By city ID
  • By geographic coordinates

Call 16 day / daily forecast data

  • By city name
  • By city ID
  • By geographic coordinates

Supported Languages

ENGLISH("en"), RUSSIAN("ru"), ITALIAN("it"), SPANISH("sp"), UKRAINIAN("ua"), GERMAN("de"), PORTUGUESE("pt"), ROMANIAN("ro"), POLISH("pl"), FINNISH("fi"), DUTCH("nl"), FRENCH("fr"), BULGARIAN("bg"), SWEDISH("sv"), CHINESE_TRADITIONAL("zh_tw"), CHINESE_SIMPLIFIED("zh_cn"), TURKISH("tr"), CROATIAN("hr"), CATALAN("ca");

Supported formats

  • JSON (result as String or as WeatherInfo object)
  • XML (result only as String now)
  • HTML (result only as String)

Supported Units format

  • Standard
  • Metric
  • Imperial

More information about weather parameters and unit can be found here.

Examples

Take a look at examples module