OpenWeatherMap Java API

https://github.com/xsavikx/openweathermap-java-api
Admin
A Java library that provides easy access to the OpenWeatherMap API for retrieving current weather...
Tokens:3,220
Snippets:14
Trust Score:9.1
License:Apache-2.0
Update:10 months ago
Show doc for...
Tokens:
Raw
### Get Current Weather for Multiple Locations using Java

Source: https://context7.com/xsavikx/openweathermap-java-api/llms.txt

This code example shows how to fetch current weather data for multiple locations within a specified geographic area using the OpenWeatherMap Java API. It demonstrates querying weather for cities within a cycle around given coordinates. The process involves initializing the client, constructing a query for multiple locations, executing it, and then iterating through the returned list of weather data. Dependencies include the OpenWeatherMap API client library.

```java
import org.openweathermap.api.DataWeatherClient;
import org.openweathermap.api.UrlConnectionDataWeatherClient;
import org.openweathermap.api.common.Coordinate;
import org.openweathermap.api.model.currentweather.CurrentWeather;
import org.openweathermap.api.query.Language;
import org.openweathermap.api.query.QueryBuilderPicker;
import org.openweathermap.api.query.UnitFormat;
import org.openweathermap.api.query.currentweather.InCycle;
import java.util.List;

// Initialize client
DataWeatherClient client = new UrlConnectionDataWeatherClient("YOUR_API_KEY");

// Query weather for 5 closest cities to coordinates
InCycle query = QueryBuilderPicker.pick()
    .currentWeather()
    .multipleLocations()
    .inCycle(new Coordinate("36.230383", "49.9935"), 5)
    .language(Language.ENGLISH)
    .unitFormat(UnitFormat.METRIC)
    .build();

// Execute query returns list
List<CurrentWeather> weatherList = client.getCurrentWeather(query);

// Process results
for (CurrentWeather weather : weatherList) {
    System.out.printf("%s: %.1f °C, Humidity: %.1f%%%n",
        weather.getCityName(),
        weather.getMainParameters().getTemperature(),
        weather.getMainParameters().getHumidity());
}
```

--------------------------------

### Query Weather by ZIP Code in Java

Source: https://context7.com/xsavikx/openweathermap-java-api/llms.txt

Fetches current weather data using a ZIP code and country code. This example queries for '10001' in the 'US' and uses imperial units. The output displays the city name, country, and temperature in Fahrenheit.

```java
import org.openweathermap.api.DataWeatherClient;
import org.openweathermap.api.UrlConnectionDataWeatherClient;
import org.openweathermap.api.model.currentweather.CurrentWeather;
import org.openweathermap.api.query.*;
import org.openweathermap.api.query.currentweather.CurrentWeatherOneLocationQuery;

// Initialize client
DataWeatherClient client = new UrlConnectionDataWeatherClient("YOUR_API_KEY");

// Query by ZIP code
CurrentWeatherOneLocationQuery query = QueryBuilderPicker.pick()
    .currentWeather()
    .oneLocation()
    .byZipCode("10001", "US")  // ZIP code and country code
    .language(Language.ENGLISH)
    .responseFormat(ResponseFormat.JSON)
    .unitFormat(UnitFormat.IMPERIAL)  // US units
    .build();

// Execute query
CurrentWeather weather = client.getCurrentWeather(query);

// Access weather data
System.out.printf("Location: %s, %s%n",
    weather.getCityName(),
    weather.getSystemParameters().getCountry());
System.out.printf("Temperature: %.1f °F%n", weather.getMainParameters().getTemperature());
```

--------------------------------

### Get Daily Weather Forecast - Java

Source: https://context7.com/xsavikx/openweathermap-java-api/llms.txt

Retrieves a 16-day daily weather forecast for a specified city. This method allows for configuring units and language. The output includes the date and temperature ranges for each day.

```java
import org.openweathermap.api.DataWeatherClient;
import org.openweathermap.api.UrlConnectionDataWeatherClient;
import org.openweathermap.api.model.forecast.ForecastInformation;
import org.openweathermap.api.model.forecast.daily.DailyForecast;
import org.openweathermap.api.query.Language;
import org.openweathermap.api.query.QueryBuilderPicker;
import org.openweathermap.api.query.UnitFormat;
import org.openweathermap.api.query.forecast.daily.ByCityName;

// Initialize client
DataWeatherClient client = new UrlConnectionDataWeatherClient("YOUR_API_KEY");

// Build daily forecast query
ByCityName query = QueryBuilderPicker.pick()
    .forecast()
    .daily()
    .byCityName("Kharkiv")
    .countryCode("UA")
    .unitFormat(UnitFormat.METRIC)
    .language(Language.ENGLISH)
    .build();

// Execute query
ForecastInformation<DailyForecast> forecastInfo = client.getForecastInformation(query);

// Access daily forecasts
System.out.println("Daily forecast for " + forecastInfo.getCity());
for (DailyForecast forecast : forecastInfo.getForecasts()) {
    System.out.printf("Date: %s%n", forecast.getDateTime());
    System.out.printf("Temperature: %s%n%n", forecast.getTemperature());
}
```

--------------------------------

### Get Current Weather for Single Location using Java

Source: https://context7.com/xsavikx/openweathermap-java-api/llms.txt

This snippet demonstrates how to retrieve current weather conditions for a single location (city by name) using the OpenWeatherMap Java API. It initializes a client, builds a query with specific parameters like city name, country code, language, response format, and unit system, executes the query, and then accesses the weather data. Dependencies include the OpenWeatherMap API client library.

```java
import org.openweathermap.api.DataWeatherClient;
import org.openweathermap.api.UrlConnectionDataWeatherClient;
import org.openweathermap.api.model.currentweather.CurrentWeather;
import org.openweathermap.api.query.*;
import org.openweathermap.api.query.currentweather.CurrentWeatherOneLocationQuery;

// Initialize client with API key
DataWeatherClient client = new UrlConnectionDataWeatherClient("YOUR_API_KEY");

// Build query using fluent API
CurrentWeatherOneLocationQuery query = QueryBuilderPicker.pick()
    .currentWeather()
    .oneLocation()
    .byCityName("Kharkiv")
    .countryCode("UA")
    .type(Type.ACCURATE)
    .language(Language.ENGLISH)
    .responseFormat(ResponseFormat.JSON)
    .unitFormat(UnitFormat.METRIC)
    .build();

// Execute query
CurrentWeather weather = client.getCurrentWeather(query);

// Access weather data
System.out.printf("Temperature: %.1f °C%n", weather.getMainParameters().getTemperature());
System.out.printf("Humidity: %.1f %%%n", weather.getMainParameters().getHumidity());
System.out.printf("Pressure: %.1f hPa%n", weather.getMainParameters().getPressure());
System.out.printf("City: %s (%s)%n", weather.getCityName(),
    weather.getSystemParameters().getCountry());
```

--------------------------------

### Get Hourly Weather Forecast - Java

Source: https://context7.com/xsavikx/openweathermap-java-api/llms.txt

Retrieves a 5-day hourly weather forecast (in 3-hour intervals) for a specified city. It requires an API key and allows for setting units, language, and the number of forecast entries. The output includes date, time, temperature, humidity, and pressure.

```java
import org.openweathermap.api.DataWeatherClient;
import org.openweathermap.api.UrlConnectionDataWeatherClient;
import org.openweathermap.api.model.forecast.ForecastInformation;
import org.openweathermap.api.model.forecast.hourly.HourlyForecast;
import org.openweathermap.api.query.Language;
import org.openweathermap.api.query.QueryBuilderPicker;
import org.openweathermap.api.query.UnitFormat;
import org.openweathermap.api.query.forecast.hourly.ByCityName;

// Initialize client
DataWeatherClient client = new UrlConnectionDataWeatherClient("YOUR_API_KEY");

// Build hourly forecast query
ByCityName query = QueryBuilderPicker.pick()
    .forecast()
    .hourly()
    .byCityName("Kharkiv")
    .countryCode("UA")
    .unitFormat(UnitFormat.METRIC)
    .language(Language.ENGLISH)
    .count(5)  // Limit to 5 forecast entries
    .build();

// Execute query
ForecastInformation<HourlyForecast> forecastInfo = client.getForecastInformation(query);

// Access forecast data
System.out.println("Forecasts for " + forecastInfo.getCity() + ":");
for (HourlyForecast forecast : forecastInfo.getForecasts()) {
    System.out.printf("Time: %s%n", forecast.getDateTime());
    System.out.printf("Temperature: %.1f °C%n", forecast.getMainParameters().getTemperature());
    System.out.printf("Humidity: %.1f %%%n", forecast.getMainParameters().getHumidity());
    System.out.printf("Pressure: %.1f hPa%n%n", forecast.getMainParameters().getPressure());
}
```

--------------------------------

### Get Current UV Index - Java

Source: https://context7.com/xsavikx/openweathermap-java-api/llms.txt

Fetches the current UV index for specific geographic coordinates. This requires an API key and allows setting units and language. The output is the current UV index value.

```java
import org.openweathermap.api.DataWeatherClient;
import org.openweathermap.api.UrlConnectionDataWeatherClient;
import org.openweathermap.api.common.Coordinate;
import org.openweathermap.api.model.uvi.Uvi;
import org.openweathermap.api.query.Language;
import org.openweathermap.api.query.UnitFormat;
import org.openweathermap.api.query.uvi.UviQuery;
import org.openweathermap.api.query.uvi.current.ByGeographicCoordinates;

// Initialize client
DataWeatherClient client = new UrlConnectionDataWeatherClient("YOUR_API_KEY");

// Build UV index query with coordinates
Coordinate coordinate = new Coordinate("36.230383", "49.9935");
ByGeographicCoordinates query = UviQuery.Current.byGeographicCoordinates(coordinate)
    .language(Language.ENGLISH)
    .unitFormat(UnitFormat.METRIC)
    .build();

// Execute query
Uvi result = client.getCurrentUvi(query);

// Display UV index
System.out.println("Current UV Index: " + result);
```

--------------------------------

### Query Weather by City ID in Java

Source: https://context7.com/xsavikx/openweathermap-java-api/llms.txt

Retrieves current weather data using a specific city ID. The example uses city ID '706483' for Kharkiv. It configures the query for English language, JSON response, and metric units. The output includes city ID, name, and temperature.

```java
import org.openweathermap.api.DataWeatherClient;
import org.openweathermap.api.UrlConnectionDataWeatherClient;
import org.openweathermap.api.model.currentweather.CurrentWeather;
import org.openweathermap.api.query.*;
import org.openweathermap.api.query.currentweather.CurrentWeatherOneLocationQuery;

// Initialize client
DataWeatherClient client = new UrlConnectionDataWeatherClient("YOUR_API_KEY");

// Query by city ID (e.g., 706483 is Kharkiv)
CurrentWeatherOneLocationQuery query = QueryBuilderPicker.pick()
    .currentWeather()
    .oneLocation()
    .byCityId("706483")
    .language(Language.ENGLISH)
    .responseFormat(ResponseFormat.JSON)
    .unitFormat(UnitFormat.METRIC)
    .build();

// Execute query
CurrentWeather weather = client.getCurrentWeather(query);

// Access weather data
System.out.printf("City ID: %d%n", weather.getCityId());
System.out.printf("City: %s%n", weather.getCityName());
System.out.printf("Temperature: %.1f °C%n", weather.getMainParameters().getTemperature());
```

--------------------------------

### Query Weather Data in Multiple Languages (Java)

Source: https://context7.com/xsavikx/openweathermap-java-api/llms.txt

This Java code snippet demonstrates how to use the OpenWeatherMap Java API to retrieve current weather data for a specified city in different languages. It initializes the API client, constructs queries specifying the language (e.g., SPANISH, GERMAN), and processes the weather data. The library handles HTTP requests and JSON parsing.

```java
import org.openweathermap.api.DataWeatherClient;
import org.openweathermap.api.UrlConnectionDataWeatherClient;
import org.openweathermap.api.model.currentweather.CurrentWeather;
import org.openweathermap.api.query.*;
import org.openweathermap.api.query.currentweather.CurrentWeatherOneLocationQuery;

// Initialize client
DataWeatherClient client = new UrlConnectionDataWeatherClient("YOUR_API_KEY");

// Query in Spanish
CurrentWeatherOneLocationQuery queryES = QueryBuilderPicker.pick()
    .currentWeather()
    .oneLocation()
    .byCityName("Madrid")
    .countryCode("ES")
    .language(Language.SPANISH)
    .responseFormat(ResponseFormat.JSON)
    .unitFormat(UnitFormat.METRIC)
    .build();

CurrentWeather weatherES = client.getCurrentWeather(queryES);
System.out.println("Spanish: " + weatherES.getCityName());

// Query in German
CurrentWeatherOneLocationQuery queryDE = QueryBuilderPicker.pick()
    .currentWeather()
    .oneLocation()
    .byCityName("Berlin")
    .language(Language.GERMAN)
    .unitFormat(UnitFormat.METRIC)
    .build();

CurrentWeather weatherDE = client.getCurrentWeather(queryDE);
System.out.println("German: " + weatherDE.getCityName());

// Available languages: ENGLISH, RUSSIAN, ITALIAN, SPANISH, UKRAINIAN, GERMAN,
// PORTUGUESE, ROMANIAN, POLISH, FINNISH, DUTCH, FRENCH, BULGARIAN, SWEDISH,
// CHINESE_TRADITIONAL, CHINESE_SIMPLIFIED, TURKISH, CROATIAN, CATALAN
```

--------------------------------

### Query Weather by Geographic Coordinates in Java

Source: https://context7.com/xsavikx/openweathermap-java-api/llms.txt

Fetches current weather data using latitude and longitude. Requires an API key and specifies language, response format, and unit system (METRIC). Outputs city name, coordinates, and temperature.

```java
import org.openweathermap.api.DataWeatherClient;
import org.openweathermap.api.UrlConnectionDataWeatherClient;
import org.openweathermap.api.common.Coordinate;
import org.openweathermap.api.model.currentweather.CurrentWeather;
import org.openweathermap.api.query.*;
import org.openweathermap.api.query.currentweather.CurrentWeatherOneLocationQuery;

// Initialize client
DataWeatherClient client = new UrlConnectionDataWeatherClient("YOUR_API_KEY");

// Create coordinate (latitude, longitude)
Coordinate coordinate = new Coordinate("49.9935", "36.230383");

// Build query with coordinates
CurrentWeatherOneLocationQuery query = QueryBuilderPicker.pick()
    .currentWeather()
    .oneLocation()
    .byGeographicCoordinates(coordinate)
    .language(Language.ENGLISH)
    .responseFormat(ResponseFormat.JSON)
    .unitFormat(UnitFormat.METRIC)
    .build();

// Execute query
CurrentWeather weather = client.getCurrentWeather(query);

// Access weather data
System.out.printf("Location: %s%n", weather.getCityName());
System.out.printf("Coordinates: lat=%.4f, lon=%.4f%n",
    Double.parseDouble(weather.getCoordinate().getLatitude()),
    Double.parseDouble(weather.getCoordinate().getLongitude()));
System.out.printf("Temperature: %.1f °C%n", weather.getMainParameters().getTemperature());
```
Tokens:
Raw