Test commit for cirrus.

Bumps [jacoco-maven-plugin](https://github.com/jacoco/jacoco) from 0.8.7 to 0.8.8.
- [Release notes](https://github.com/jacoco/jacoco/releases)
- [Commits](https://github.com/jacoco/jacoco/compare/v0.8.7...v0.8.8)

---
updated-dependencies:
- dependency-name: org.jacoco:jacoco-maven-plugin
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

.cirrus.yml

@@ -0,0 +1,13 @@
+container:
+  image: gradle:jdk11
+
+check_task:
+  gradle_cache:
+    folder: ~/.gradle/caches
+  check_script: gradle check
+  cleanup_before_cache_script:
+    - rm -rf ~/.gradle/caches/$GRADLE_VERSION/
+    - rm -rf ~/.gradle/caches/transforms-1
+    - rm -rf ~/.gradle/caches/journal-1
+    - rm -rf ~/.gradle/caches/jars-3/*/buildSrc.jar
+    - find ~/.gradle/caches/ -name "*.lock" -type f -delete

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,31 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: "[BUG] Change me"
-labels: bug
-assignees: ''
-
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**Desktop (please complete the following information):**
- - OS: [e.g. iOS]
- - Version [e.g. 22]
-
-**Additional context**
-Add any other context about the problem here.

.github/ISSUE_TEMPLATE/custom.md

@@ -1,10 +0,0 @@
----
-name: Custom issue template
-about: Describe this issue template's purpose here.
-title: ''
-labels: ''
-assignees: ''
-
----
-
-

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: "[FEATURE] Change me"
-labels: enhancement
-assignees: ''
-
----
-
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
-
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
-
-**Additional context**
-Add any other context or screenshots about the feature request here.

.github/dependabot.yml

@@ -0,0 +1,9 @@
+version: 2
+updates:
+- package-ecosystem: maven
+  directory: "/"
+  schedule:
+    interval: daily
+    time: "03:00"
+  open-pull-requests-limit: 10
+  target-branch: dev

.github/workflows/codeql-analysis.yml

@@ -13,10 +13,10 @@ name: "CodeQL"
 
 on:
   push:
-    branches: [ master ]
+    branches: [ dev ]
   pull_request:
     # The branches below must be a subset of the branches above
-    branches: [ master ]
+    branches: [ dev ]
   schedule:
     - cron: '27 20 * * 1'
 

.gitignore

@@ -1,24 +1,5 @@
-# Compiled class file
-*.class
-
-# Log file
-*.log
-
-# BlueJ files
-*.ctxt
-
-# Package Files #
-*.jar
-*.war
-*.nar
-*.ear
-*.zip
-*.tar.gz
-*.rar
-
-# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
-hs_err_pid*
-
 *.iml
 .idea/
+.gradle
+build/
 target/

.travis.yml

@@ -1,11 +0,0 @@
-language: java
-
-jdk:
-  - openjdk8
-  - openjdk11
-
-install: mvn install -DskipTests -Dgpg.skip -B
-script: mvn test -Dmaven.skip.deploy=true -B
-
-after_success:
-  - bash <(curl -s https://codecov.io/bash)

CODE_OF_CONDUCT.md

@@ -1,128 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, religion, or sexual identity
-and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment for our
-community include:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
-  and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the
-  overall community
-
-Examples of unacceptable behavior include:
-
-* The use of sexualized language or imagery, and sexual attention or
-  advances of any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email
-  address, without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-Community leaders have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct, and will communicate reasons for moderation
-decisions when appropriate.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-Examples of representing our community include using an official e-mail address,
-posting via an official social media account, or acting as an appointed
-representative at an online or offline event.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement at
-alexey.zinchenko@protonmail.com.
-All complaints will be reviewed and investigated promptly and fairly.
-
-All community leaders are obligated to respect the privacy and security of the
-reporter of any incident.
-
-## Enforcement Guidelines
-
-Community leaders will follow these Community Impact Guidelines in determining
-the consequences for any action they deem in violation of this Code of Conduct:
-
-### 1. Correction
-
-**Community Impact**: Use of inappropriate language or other behavior deemed
-unprofessional or unwelcome in the community.
-
-**Consequence**: A private, written warning from community leaders, providing
-clarity around the nature of the violation and an explanation of why the
-behavior was inappropriate. A public apology may be requested.
-
-### 2. Warning
-
-**Community Impact**: A violation through a single incident or series
-of actions.
-
-**Consequence**: A warning with consequences for continued behavior. No
-interaction with the people involved, including unsolicited interaction with
-those enforcing the Code of Conduct, for a specified period of time. This
-includes avoiding interactions in community spaces as well as external channels
-like social media. Violating these terms may lead to a temporary or
-permanent ban.
-
-### 3. Temporary Ban
-
-**Community Impact**: A serious violation of community standards, including
-sustained inappropriate behavior.
-
-**Consequence**: A temporary ban from any sort of interaction or public
-communication with the community for a specified period of time. No public or
-private interaction with the people involved, including unsolicited interaction
-with those enforcing the Code of Conduct, is allowed during this period.
-Violating these terms may lead to a permanent ban.
-
-### 4. Permanent Ban
-
-**Community Impact**: Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior,  harassment of an
-individual, or aggression toward or disparagement of classes of individuals.
-
-**Consequence**: A permanent ban from any sort of public interaction within
-the community.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.0, available at
-https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
-
-Community Impact Guidelines were inspired by [Mozilla's code of conduct
-enforcement ladder](https://github.com/mozilla/diversity).
-
-[homepage]: https://www.contributor-covenant.org
-
-For answers to common questions about this code of conduct, see the FAQ at
-https://www.contributor-covenant.org/faq. Translations are available at
-https://www.contributor-covenant.org/translations.

README.md

@@ -29,14 +29,46 @@ Paid:
 <dependency>
     <groupId>com.github.prominence</groupId>
     <artifactId>openweathermap-api</artifactId>
-  <version>2.4.2</version>
+    <version>3.0.0-SNAPSHOT</version>
 </dependency>
 ```
 
+```xml
+<repositories>
+    ...
+    <!-- Repository for snapshot versions -->
+    <repository>
+        <id>oss.sonatype.org-snapshot</id>
+        <url>https://oss.sonatype.org/content/repositories/snapshots</url>
+        <releases>
+            <enabled>false</enabled>
+        </releases>
+        <snapshots>
+            <enabled>true</enabled>
+        </snapshots>
+    </repository>
+    ...
+</repositories>
+```
+
 ### Gradle coordinates:
 
 ```groovy
-implementation 'com.github.prominence:openweathermap-api:2.4.2'
+implementation 'com.github.prominence:openweathermap-api:3.0.0-SNAPSHOT'
+```
+
+```groovy
+repositories {
+    ...
+    // Repository for snapshot versions
+    maven {
+        url "https://oss.sonatype.org/content/repositories/snapshots"
+        mavenContent {
+            snapshotsOnly()
+        }
+    }
+    ...
+}
 ```
 
 ### Documentation
@@ -49,16 +81,14 @@ implementation 'com.github.prominence:openweathermap-api:2.4.2'
 * [OpenWeatherMap Java API - 2.1.1](docs/Release_2.1.1.md)
 * [OpenWeatherMap Java API - 2.2.0](docs/Release_2.2.0.md)
 * [OpenWeatherMap Java API - 2.3.0](docs/Release_2.3.0.md)
-* [OpenWeatherMap Java API - 2.4.0](docs/Release_2.4.0.md)
+* [OpenWeatherMap Java API - SNAPSHOT](docs/SNAPSHOT.md)
-* [OpenWeatherMap Java API - 2.4.1](docs/Release_2.4.1.md)
-* [OpenWeatherMap Java API - 2.4.2](docs/Release_2.4.2.md)
 
 ### License
 MIT
 
-[ci-shield]: https://travis-ci.org/Prominence/openweathermap-java-api.svg?branch=master
+[ci-shield]: https://travis-ci.org/Prominence/openweathermap-java-api.svg?branch=dev
 [ci-link]: https://travis-ci.org/Prominence/openweathermap-java-api
 
 
-[codecov-shield]: https://codecov.io/gh/Prominence/openweathermap-java-api/branch/master/graph/badge.svg
+[codecov-shield]: https://codecov.io/gh/Prominence/openweathermap-java-api/branch/dev/graph/badge.svg
 [codecov-link]: https://codecov.io/gh/Prominence/openweathermap-java-api

build.gradle

@@ -0,0 +1,96 @@
+plugins {
+    id 'java-library'
+    id 'maven-publish'
+    id 'signing'
+}
+
+repositories {
+    mavenLocal()
+    maven {
+        url = uri('https://repo.maven.apache.org/maven2/')
+    }
+}
+
+dependencies {
+    implementation 'com.fasterxml.jackson.core:jackson-databind:2.13.2.2'
+    implementation 'org.slf4j:slf4j-api:1.7.36'
+    testImplementation 'org.junit.platform:junit-platform-runner:1.8.2'
+    testImplementation 'org.junit.jupiter:junit-jupiter-engine:5.8.2'
+}
+
+group = 'com.github.prominence'
+version = '3.0.0-SNAPSHOT'
+description = 'Java OpenWeatherMap API'
+java.sourceCompatibility = JavaVersion.VERSION_11
+
+ext {
+    isReleaseVersion = !version.endsWith("SNAPSHOT")
+}
+
+java {
+    withSourcesJar()
+    withJavadocJar()
+}
+
+publishing {
+    publications {
+        mavenJava(MavenPublication) {
+            from components.java
+
+            pom {
+                name = 'Java OpenWeatherMap API'
+                description = 'Java API for OpenWeatherMap services.'
+                url = 'https://github.com/Prominence/openweathermap-java-api'
+
+                licenses {
+                    license {
+                        name = 'MIT License'
+                        url = 'https://www.opensource.org/licenses/mit-license.php'
+                    }
+                }
+                developers {
+                    developer {
+                        id = 'Prominence'
+                        name = 'Alexey Zinchenko'
+                        email = 'alexey.zinchenko@protonmail.com'
+                        url = 'https://github.com/prominence'
+                    }
+                }
+                scm {
+                    connection = 'scm:git:git://github.com/Prominence/openweathermap-java-api.git'
+                    developerConnection = 'scm:git:git@github.com:prominence/openweathermap-java-api.git'
+                    url = 'https://github.com/Prominence/openweathermap-java-api'
+                }
+                issueManagement {
+                    url = 'https://github.com/Prominence/openweathermap-java-api/issues'
+                    system = 'GitHub Issues'
+                }
+            }
+        }
+    }
+
+    repositories {
+        maven {
+            credentials {
+                username = project.findProperty('ossrhUsername')
+                password = project.findProperty('ossrhPassword')
+            }
+
+            url = isReleaseVersion ?
+                    'https://oss.sonatype.org/service/local/staging/deploy/maven2/' :
+                    'https://oss.sonatype.org/content/repositories/snapshots/'
+        }
+    }
+}
+
+signing {
+    sign publishing.publications.mavenJava
+}
+
+tasks.withType(JavaCompile) {
+    options.encoding = 'UTF-8'
+}
+
+tasks.withType(GenerateModuleMetadata) {
+    enabled = false
+}

docs/Release_2.4.1.md

@@ -1,566 +0,0 @@
-### Implemented features:
-* Current weather data
-* 5 day / 3-hour forecast
-* One Call API
-* One Call 3 API
-* Air Pollution
-
-
-Other:
-* Request timeout settings
-
-### Maven coordinates:
-
-```xml
-<dependency>
-  <groupId>com.github.prominence</groupId>
-  <artifactId>openweathermap-api</artifactId>
-  <version>2.4.1</version>
-</dependency>
-```
-
-### Gradle coordinates:
-
-```groovy
-compile('com.github.prominence:openweathermap-api:2.4.1')
-```
-
-### How to use:
-
-Firstly, you need to create the instance of `OpenWeatherMapClient` class:
-```java
-OpenWeatherMapClient openWeatherClient = new OpenWeatherMapClient(API_TOKEN);
-```
-where `API_TOKEN` is your token([you can get it here](https://home.openweathermap.org/api_keys)) as `String`.
-
-Currently, available APIs are:
-* `currentWeather()`
-* `forecast5Day3HourStep()`
-* `oneCall()`
-* `airPollution()`
-
-Also, it is possible to set timeouts for the requests on `openWeatherClient` object:
-```java
-openWeatherClient.setReadTimeout(1000);
-openWeatherClient.setConnectTimeout(1000);
-```
-Timeout settings are passed to the requesters as a copy.
-
-Default(more or less) customization points:
-```java
-...
-// response language
-.language(Language.RUSSIAN)
-...
-// response units of measure
-.unitSystem(UnitSystem.IMPERIAL)
-...
-```
-
-Available output forms:
-* `asJava()`
-* `asJSON()`
-
-Additional output forms, available for several APIs:
-* `asXML()`
-* `asHTML()`
-
-_All response forms can be in **sync** and **async** variants._
-
-#### Current weather data
-Examples:
-```java
-final String weatherJson = openWeatherClient
-        .currentWeather()
-        .single()
-        .byCityName("Minsk")
-        .language(Language.RUSSIAN)
-        .unitSystem(UnitSystem.IMPERIAL)
-        .retrieve()
-        .asJSON();
-```
-
-```java
-final Weather weather = openWeatherClient
-        .currentWeather()
-        .single()
-        .byCityName("Minsk")
-        .language(Language.RUSSIAN)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJava();
-```
-
-```java
-final List<Weather> weatherList = openWeatherClient
-        .currentWeather()
-        .multiple()
-        .byCitiesInCycle(Coordinate.of(55.5, 37.5))
-        .language(Language.GERMAN)
-        .unitSystem(UnitSystem.IMPERIAL)
-        .retrieve()
-        .asJava();
-```
-
-```java
-final CompletableFuture<String> weatherXmlFuture = openWeatherClient
-        .currentWeather()
-        .single()
-        .byZipCodeAndCountry("220015", "by")
-        .language(Language.RUSSIAN)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieveAsync()
-        .asXML();
-```
-
-You are able to set preferable options(via chain methods) and execute appropriate request.
-
-`com.github.prominence.openweathermap.api.model.weather.Weather`'s useful public methods(setters are not listed):
-
-| Method                    | Description                                                                                                                                                               |
-|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `getCalculationTime()`    | Returns `LocalDateTime` object with data calculation time.                                                                                                                |
-| `getWeatherState()`       | Returns `WeatherState` object with basic weather state information.                                                                                                       |
-| `getTemperature()`        | Returns `Temperature` instance that contains information about temperature. Available fields: `value`, `maxTemperature`, `minTemperature`, `feelsLike` and `unit`.        |
-| `getAtmosphericPressure()`| Returns `AtmosphericPressure` instance that contains information about atmospheric pressure. Available fields: `value`, `seaLevelValue`, `groundLevelValue` and `unit`.   |
-| `getHumidity()`           | Returns `Humidity` instance that contains humidity percentage information.                                                                                                |
-| `getWind()`               | Returns `Wind` instance that contains wind information: `speed`, `degrees`, `gust` and `unit`.                                                                            |
-| `getRain()`               | Returns `Rain` instance that contains information about rain volume for the last one hour and/or the last 3 hours. Can be absent in case of no data.                      |
-| `getSnow()`               | Returns `Snow` instance that contains information about snow volume for the last one hour and/or the last 3 hours. Can be absent in case of no data.                      |
-| `getClouds()`             | Returns `Clouds` instance that contains information about cloudiness percentage.                                                                                          |
-| `getLocation()`           | Returns `Location` object. Available fields: `id`, `name`, `countryCode`, `sunrise` and `sunset` time, `zoneOffset` and `coordinate`.                                     |
-| `toString()`              | Returns informative string for the whole available weather information.                                                                                                   |
-
-`toString()` output example:
-```
-Location: Minsk(BY), Weather: clear sky, -4.22 ℃, 1020.0 hPa, Clouds: 0%
-```
-
-#### 5 day / 3-hour forecast
-Examples:
-```java
-final Forecast forecast = openWeatherClient
-        .forecast5Day3HourStep()
-        .byCityName("Minsk")
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .count(15)
-        .retrieve()
-        .asJava();
-```
-
-```java
-final String forecastJson = getClient()
-        .forecast5Day3HourStep()
-        .byCityName("New York", "NY", "US")
-        .language(Language.SPANISH)
-        .unitSystem(UnitSystem.IMPERIAL)
-        .count(15)
-        .retrieve()
-        .asJSON();
-```
-
-```java
-CompletableFuture<String> forecastFuture = getClient()
-        .forecast5Day3HourStep()
-        .byCityId(350001514)
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .count(15)
-        .retrieveAsync()
-        .asXML();
-```
-
-```java
-final String forecastXml = getClient()
-        .forecast5Day3HourStep()
-        .byZipCodeInUSA("10005")
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asXML();
-```
-
-You are able to set preferable options(via chain methods) and execute appropriate request.
-
-`com.github.prominence.openweathermap.api.model.forecast.free.Forecast`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                                                                                                           |
-|-------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `getLocation()`               | Returns `Location` object. Available fields: `id`, `name`, `countryCode`, `sunrise` and `sunset` time, `zoneOffset`, `coordinate` and `population`.   |
-| `getWeatherForecasts()`       | Returns list of `WeatherForecast` objects with forecast information.                                                                                  |
-| `toString()`                  | Returns informative string for the whole available forecast information.                                                                              |
-
-`toString()` output example:
-```
-A forecast for Minsk with 15 timestamps.
-```
-
-`com.github.prominence.openweathermap.api.model.forecast.WeatherForecast`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                                                                                                                               |
-|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `getForecastTime()`           | Returns `LocalDateTime` object with weather forecast time.                                                                                                                |
-| `getWeatherState()`           | Returns `WeatherState` object with basic weather state information.                                                                                                       |
-| `getTemperature()`            | Returns `Temperature` instance that contains information about temperature. Available fields: `value`, `maxTemperature`, `minTemperature`, `feelsLike` and `unit`.        |
-| `getAtmosphericPressure()`    | Returns `AtmosphericPressure` instance that contains information about atmospheric pressure. Available fields: `value`, `seaLevelValue`, `groundLevelValue` and `unit`.   |
-| `getHumidity()`               | Returns `Humidity` instance that contains humidity percentage information.                                                                                                |
-| `getWind()`                   | Returns `Wind` instance that contains wind information: `speed`, `degrees` and `unit`.                                                                                    |
-| `getRain()`                   | Returns `Rain` instance that contains information about rain volume for the last 3 hours. Can be absent in case of no data.                                               |
-| `getSnow()`                   | Returns `Snow` instance that contains information about snow volume for the last 3 hours. Can be absent in case of no data.                                               |
-| `getClouds()`                 | Returns `Clouds` instance that contains information about cloudiness percentage.                                                                                          |
-| `getForecastTimeISO()`        | Returns String with time of data forecasted, ISO, UTC.                                                                                                                    |
-| `getDayTime()`                | Returns enumerations representing the part of day(day, night).                                                                                                            |
-| `toString()`                  | Returns informative string for the forecast of particular timestamp.                                                                                                      |
-
-#### One Call 3 API
-Examples:
-```java
-        final CurrentWeatherData currentWeatherData = getClient()
-        .oneCall3()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJava();
-```
-
-#### One Call API (Deprecated)
-Examples:
-```java
-final CurrentWeatherData currentWeatherData = openWeatherClient
-        .oneCall()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJava();
-```
-
-```java
-final CurrentWeatherData currentWeatherData = openWeatherClient
-        .oneCall()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .exclude(OneCallResultOptions.CURRENT, OneCallResultOptions.MINUTELY)
-        .retrieve()
-        .asJava();
-```
-
-```java
-final CompletableFuture<CurrentWeatherData> currentWeatherDataFuture = openWeatherClient
-        .oneCall()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieveAsync()
-        .asJava();
-```
-
-```java
-final String responseJson = openWeatherClient
-        .oneCall()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJSON();
-```
-
-```java
-final HistoricalWeatherData historicalWeatherData = openWeatherClient
-        .oneCall()
-        .historical()
-        .byCoordinateAndTimestamp(Coordinate.of(60.99, 30.9), LocalDateTime.now().minusDays(5).toEpochSecond(ZoneOffset.UTC))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJava();
-```
-
-```java
-final String responseJson = openWeatherClient
-        .oneCall()
-        .historical()
-        .byCoordinateAndTimestamp(Coordinate.of(60.99, 30.9), LocalDateTime.now().minusDays(5).toEpochSecond(ZoneOffset.UTC))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJSON();
-```
-
-```java
-final CompletableFuture<HistoricalWeatherData> historicalWeatherDataFuture = openWeatherClient
-        .oneCall()
-        .historical()
-        .byCoordinateAndTimestamp(Coordinate.of(60.99, 30.9), LocalDateTime.now().minusDays(5).toEpochSecond(ZoneOffset.UTC))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieveAsync()
-        .asJava();
-```
-
-```java
-final CompletableFuture<String> responseJsonFuture = openWeatherClient
-        .oneCall()
-        .historical()
-        .byCoordinateAndTimestamp(Coordinate.of(60.99, 30.9), LocalDateTime.now().minusDays(5).toEpochSecond(ZoneOffset.UTC))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieveAsync()
-        .asJSON();
-```
-
-You are able to set preferable options(via chain methods) and execute appropriate request.
-
-`com.github.prominence.openweathermap.api.model.onecall.current.CurrentWeatherData`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                                    |
-|-------------------------------|--------------------------------------------------------------------------------|
-| `getCoordinate()`             | Returns `Coordinate` object. Available fields: `latitude`, `longitude`.        |
-| `getTimezone()`               | Returns location timezone object.                                              |
-| `getTimezoneOffset()`         | Returns zone offset.                                                           |
-| `getCurrent()`                | Returns `Current` object with current weather state if available.              |
-| `getMinutelyList()`           | Returns list of `Minutely` objects if available.                               |
-| `getHourlyList()`             | Returns list of `Houlry` objects if available.                                 |
-| `getDailyList()`              | Returns list of `Daily` objects if available.                                  |
-| `getAlerts()`                 | Returns list of `Alert` objects if available.                                  |
-
-`com.github.prominence.openweathermap.api.model.onecall.Current`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                                                     |
-|-------------------------------|-------------------------------------------------------------------------------------------------|
-| `getForecastTime()`           | Returns `LocalDateTime` object with weather forecast time.                                      |
-| `getSunriseTime()`            | Returns `LocalDateTime` object with sunrise time.                                               |
-| `getSunsetTime()`             | Returns `LocalDateTime` object with sunset time.                                                |
-| `getWeatherState()`           | Returns `WeatherState` object with basic weather state information.                             |
-| `getTemperature()`            | Returns `Temperature` object. Available fields: `value`, `feelsLike`, `dewPoint` and `unit`.    |
-| `getAtmosphericPressure()`    | Returns `AtmosphericPressure` object. Available fields: `seaLevelValue`.                        |
-| `getHumidity()`               | Returns `Humidity` object. Available fields: `value` and `unit`.                                |
-| `getClouds()`                 | Returns `Clouds` object. Available fields: `value` and `unit`.                                  |
-| `getUvIndex()`                | Returns UV index value.                                                                         |
-| `getVisibilityInMetres()`     | Returns visibility in metres.                                                                   |
-| `getWind()`                   | Returns `Wind` object. Available fields: `speed`, `degrees`, `gust` and `unit`.                 |
-| `getRain()`                   | Returns `Rain` object. Available fields: `oneHourLevel` and `unit`.                             |
-| `getSnow()`                   | Returns `Snow` object. Available fields: `oneHourLevel` and `unit`.                             |
-
-`com.github.prominence.openweathermap.api.model.onecall.current.Minutely`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                   |
-|-------------------------------|---------------------------------------------------------------|
-| `getForecastTime()`           | Returns `LocalDateTime` object with weather forecast time.    |
-| `getPrecipitationVolume()`    | Returns precipitation volume.                                 |
-
-`com.github.prominence.openweathermap.api.model.onecall.current.Hourly`'s useful public methods(setters are not listed):
-
-| Method                                        | Description                                                                                       |
-|-----------------------------------------------|---------------------------------------------------------------------------------------------------|
-| `getForecastTime()`                           | Returns `LocalDateTime` object with weather forecast time.                                        |
-| `getWeatherState()`                           | Returns `WeatherState` object with basic weather state information.                               |
-| `getTemperature()`                            | Returns `Temperature` object. Available fields: `value`, `feelsLike`, `dewPoint` and `unit`.      |
-| `getAtmosphericPressure()`                    | Returns `AtmosphericPressure` object. Available fields: `seaLevelValue`.                          |
-| `getHumidity()`                               | Returns `Humidity` object. Available fields: `value` and `unit`.                                  |
-| `getClouds()`                                 | Returns `Clouds` object. Available fields: `value` and `unit`.                                    |
-| `getUvIndex()`                                | Returns UV index value.                                                                           |
-| `getVisibilityInMetres()`                     | Returns visibility in metres.                                                                     |
-| `getWind()`                                   | Returns `Wind` object. Available fields: `speed`, `degrees`, `gust` and `unit`.                   |
-| `getProbabilityOfPrecipitation()`             | Returns probability of precipitation(not percentage).                                             |
-| `getProbabilityOfPrecipitationPercentage()`   | Returns probability of precipitation percentage.                                                  |
-| `getRain()`                                   | Returns `Rain` object. Available fields: `oneHourLevel` and `unit`.                               |
-| `getSnow()`                                   | Returns `Snow` object. Available fields: `oneHourLevel` and `unit`.                               |
-
-`com.github.prominence.openweathermap.api.model.onecall.current.Daily`'s useful public methods(setters are not listed):
-
-| Method                                      | Description                                                                                       |
-|---------------------------------------------|---------------------------------------------------------------------------------------------------|
-| `getForecastTime()`                         | Returns `LocalDateTime` object with weather forecast time.                                        |
-| `getSunriseTime()`                          | Returns `LocalDateTime` object with sunrise time.                                                 |
-| `getSunsetTime()`                           | Returns `LocalDateTime` object with sunset time.                                                  |
-| `getMoonriseTime()`                         | Returns `LocalDateTime` object with moonrise time.                                                |
-| `getMoonsetTime()`                          | Returns `LocalDateTime` object with moonset time.                                                 |
-| `getMoonPhase()`                            | Returns `MoonPhase` object with `MoonType` info and value.                                        |
-| `getWeatherState()`                         | Returns `WeatherState` object with basic weather state information.                               |
-| `getTemperature()`                          | Returns `DailyTemperature` object. Available fields: `value`, `feelsLike`, `dewPoint` and `unit`. |
-| `getAtmosphericPressure()`                  | Returns `AtmosphericPressure` object. Available fields: `seaLevelValue`.                          |
-| `getHumidity()`                             | Returns `Humidity` object. Available fields: `value` and `unit`.                                  |
-| `getWind()`                                 | Returns `Wind` object. Available fields: `speed`, `degrees`, `gust` and `unit`.                   |
-| `getClouds()`                               | Returns `Clouds` object. Available fields: `value` and `unit`.                                    |
-| `getUvIndex()`                              | Returns UV index value.                                                                           |
-| `getProbabilityOfPrecipitation()`           | Returns probability of precipitation(not percentage).                                             |
-| `getProbabilityOfPrecipitationPercentage()` | Returns probability of precipitation percentage.                                                  |
-| `getRain()`                                 | Returns `DailyRain` object. Available fields: `value`.                                            |
-| `getSnow()`                                 | Returns `DailySnow` object. Available fields: `value`.                                            |
-
-`com.github.prominence.openweathermap.api.model.onecall.current.Alert`'s useful public methods(setters are not listed):
-
-| Method                       | Description                                            |
-|------------------------------|--------------------------------------------------------|
-| `getSenderName()`            | Returns alert sender name.                             |
-| `getEventName()`             | Returns alert event name.                              |
-| `getStartTime()`             | Returns `LocalDateTime` when event should start.       |
-| `getEndTime()`               | Returns `LocalDateTime` when event should end.         |
-| `getDescription()`           | Returns alert description.                             |
-
-`com.github.prominence.openweathermap.api.model.onecall.historical.HistoricalWeatherData`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                                   |
-|-------------------------------|-------------------------------------------------------------------------------|
-| `getCoordinate()`             | Returns `Coordinate` object. Available fields: `latitude`, `longitude`.       |
-| `getTimezone()`               | Returns location timezone object.                                             |
-| `getTimezoneOffset()`         | Returns zone offset.                                                          |
-| `getHistoricalWeather()`      | Returns `HistoricalWeather` object with historical weather state.             |
-| `getHourlyList()`             | Returns list of `HourlyHistorical` objects.                                   |
-
-`com.github.prominence.openweathermap.api.model.onecall.historical.HistoricalWeather`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                                                     |
-|-------------------------------|-------------------------------------------------------------------------------------------------|
-| `getForecastTime()`           | Returns `LocalDateTime` object with weather forecast time.                                      |
-| `getSunriseTime()`            | Returns `LocalDateTime` object with sunrise time.                                               |
-| `getSunsetTime()`             | Returns `LocalDateTime` object with sunset time.                                                |
-| `getWeatherState()`           | Returns `WeatherState` object with basic weather state information.                             |
-| `getTemperature()`            | Returns `Temperature` object. Available fields: `value`, `feelsLike`, `dewPoint` and `unit`.    |
-| `getAtmosphericPressure()`    | Returns `AtmosphericPressure` object. Available fields: `seaLevelValue`.                        |
-| `getHumidity()`               | Returns `Humidity` object. Available fields: `value` and `unit`.                                |
-| `getClouds()`                 | Returns `Clouds` object. Available fields: `value` and `unit`.                                  |
-| `getUvIndex()`                | Returns UV index value.                                                                         |
-| `getVisibilityInMetres()`     | Returns visibility in metres.                                                                   |
-| `getWind()`                   | Returns `Wind` object. Available fields: `speed`, `degrees`, `gust` and `unit`.                 |
-| `getRain()`                   | Returns `Rain` object. Available fields: `oneHourLevel` and `unit`.                             |
-| `getSnow()`                   | Returns `Snow` object. Available fields: `oneHourLevel` and `unit`.                             |
-
-`com.github.prominence.openweathermap.api.model.onecall.historical.HourlyHistorical`'s useful public methods(setters are not listed):
-
-| Method                            | Description                                                                                       |
-|-----------------------------------|---------------------------------------------------------------------------------------------------|
-| `getForecastTime()`               | Returns `LocalDateTime` object with weather forecast time.                                        |
-| `getWeatherState()`               | Returns `WeatherState` object with basic weather state information.                               |
-| `getTemperature()`                | Returns `Temperature` object. Available fields: `value`, `feelsLike`, `dewPoint` and `unit`.      |
-| `getAtmosphericPressure()`        | Returns `AtmosphericPressure` object. Available fields: `seaLevelValue`.                          |
-| `getHumidity()`                   | Returns `Humidity` object. Available fields: `value` and `unit`.                                  |
-| `getClouds()`                     | Returns `Clouds` object. Available fields: `value` and `unit`.                                    |
-| `getVisibilityInMetres()`         | Returns visibility in metres.                                                                     |
-| `getWind()`                       | Returns `Wind` object. Available fields: `speed`, `degrees`, `gust` and `unit`.                   |
-| `getRain()`                       | Returns `Rain` object. Available fields: `oneHourLevel` and `unit`.                               |
-| `getSnow()`                       | Returns `Snow` object. Available fields: `oneHourLevel` and `unit`.                               |
-
-#### Air Pollution API
-Examples:
-```java
-final AirPollutionDetails airPollutionDetails = openWeatherClient
-        .airPollution()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .retrieve()
-        .asJava();
-```
-
-```java
-final AirPollutionDetails airPollutionDetails = openWeatherClient
-        .airPollution()
-        .historical()
-        .byCoordinateAndPeriod(Coordinate.of(53.54, 27.34), 1606223802, 1606482999)
-        .retrieve()
-        .asJava();
-```
-
-`com.github.prominence.openweathermap.api.model.air.pollution.AirPollutionDetails`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                               |
-|-------------------------------|---------------------------------------------------------------------------|
-| `getCoordinate()`             | Returns `Coordinate` object. Available fields: `latitude`, `longitude`.   |
-| `getAirPollutionRecords()`    | Returns list of `AirPollutionRecord` objects.                             |
-
-`com.github.prominence.openweathermap.api.model.air.pollution.AirPollutionRecord`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                               |
-|-------------------------------|---------------------------------------------------------------------------|
-| `getForecastTime()`           | Returns `LocalDateTime` object with air pollution forecast time.          |
-| `getAirQualityIndex()`        | Returns `AirQualityIndex` object.                                         |
-| `getCO()`                     | Returns carbon monoxide concentration value in μg/m^3.s.                  |
-| `getCarbonMonoxide()`         | An alias for `getCO()` method.                                            |
-| `getNO()`                     | Returns nitrogen monoxide concentration value in μg/m^3.                  |
-| `getNitrogenMonoxide()`       | An alias for `getNO()` method.                                            |
-| `getNO2()`                    | Returns nitrogen dioxide concentration value in μg/m^3.                   |
-| `getNitrogenDioxide()`        | An alias for `getNO2()` method.                                           |
-| `getO3()`                     | Returns ozone concentration value in μg/m^3.                              |
-| `getOzone()`                  | An alias for `getO3()` method.                                            |
-| `getSO2()`                    | Returns sulphur dioxide concentration value in μg/m^3.                    |
-| `getSulphurDioxide()`         | An alias for `getSO2()` method.                                           |
-| `getPM2_5()`                  | Returns fine particles matter concentration value in μg/m^3.              |
-| `getFineParticlesMatter()`    | An alias for `getPM2_5()` method.                                         |
-| `getPM10()`                   | Returns coarse particulate matter concentration value in μg/m^3.          |
-| `getCoarseParticulateMatter()`| An alias for `getPM10()` method.                                          |
-| `getNH3()`                    | Returns ammonia concentration value in μg/m^3.                            |
-| `getAmmonia()`                | An alias for `getNH3()` method.                                           |
-
-### Constants and options
-
-#### Language
-| Constant                     | Description                   |
-|------------------------------|-------------------------------|
-| Language.AFRIKAANS           | Afrikaans language.           |
-| Language.ALBANIAN            | ALBANIAN language.            |
-| Language.ARABIC              | Arabic language.              |
-| Language.AZERBAIJANI         | Azerbaijani language.         |
-| Language.BULGARIAN           | Bulgarian language.           |
-| Language.CATALAN             | Catalan language.             |
-| Language.CZECH               | Czech language.               |
-| Language.DANISH              | Danish language.              |
-| Language.GERMAN              | German language.              |
-| Language.GREEK               | Greek language.               |
-| Language.ENGLISH             | English language.             |
-| Language.BASQUE              | Basque language.              |
-| Language.PERSIAN             | Persian (Farsi) language.     |
-| Language.FINNISH             | Finnish language.             |
-| Language.FRENCH              | French language.              |
-| Language.GALICIAN            | Galician language.            |
-| Language.HEBREW              | Hebrew language.              |
-| Language.HINDI               | Hindi language.               |
-| Language.CROATIAN            | Croatian language.            |
-| Language.HUNGARIAN           | Hungarian language.           |
-| Language.INDONESIAN          | Indonesian language.          |
-| Language.ITALIAN             | Italian language.             |
-| Language.JAPANESE            | Japanese language.            |
-| Language.KOREAN              | Korean language.              |
-| Language.LATVIAN             | Latvian language.             |
-| Language.LITHUANIAN          | Lithuanian language.          |
-| Language.MACEDONIAN          | Macedonian language.          |
-| Language.NORWEGIAN           | Norwegian language.           |
-| Language.DUTCH               | Dutch language.               |
-| Language.POLISH              | Polish language.              |
-| Language.PORTUGUESE          | Portuguese language.          |
-| Language.PORTUGUES_BRAZIL    | Português Brasil language.    |
-| Language.ROMANIAN            | Romanian language.            |
-| Language.RUSSIAN             | Russian language.             |
-| Language.SWEDISH             | Swedish language.             |
-| Language.SLOVAK              | Slovak language.              |
-| Language.SLOVENIAN           | Slovenian language.           |
-| Language.SPANISH             | Spanish language.             |
-| Language.SERBIAN             | Serbian language.             |
-| Language.THAI                | Thai language.                |
-| Language.TURKISH             | Turkish language.             |
-| Language.UKRAINIAN           | Ukrainian language.           |
-| Language.VIETNAMESE          | Vietnamese language.          |
-| Language.CHINESE_SIMPLIFIED  | Chinese Simplified language.  |
-| Language.CHINESE_TRADITIONAL | Chinese Traditional language. |
-| Language.ZULU                | Zulu language.                |
-
-#### Unit
-| Constant             | Description                                    |
-|----------------------|------------------------------------------------|
-| Unit.METRIC_SYSTEM   | Celsius, meter/sec, hPa, mm(rain, snow).       |
-| Unit.IMPERIAL_SYSTEM | Fahrenheit, miles/hour, hPa, mm(rain, snow).   |
-| Unit.STANDARD_SYSTEM | Kelvin, meter/sec, hPa, mm(rain, snow).        |
-
-### Dependencies
-* com.fasterxml.jackson.core:jackson-databind:2.13.4.2
-* org.slf4j:slf4j-api:1.7.36 (*compile*)
-* org.junit.jupiter:junit-jupiter-engine:5.8.2 (*test*)
-* org.junit.platform:junit-platform-runner:1.8.2 (*test*)

docs/Release_2.4.2.md

@@ -1,566 +0,0 @@
-### Implemented features:
-* Current weather data
-* 5 day / 3-hour forecast
-* One Call API
-* One Call 3 API
-* Air Pollution
-
-
-Other:
-* Request timeout settings
-
-### Maven coordinates:
-
-```xml
-<dependency>
-  <groupId>com.github.prominence</groupId>
-  <artifactId>openweathermap-api</artifactId>
-  <version>2.4.2</version>
-</dependency>
-```
-
-### Gradle coordinates:
-
-```groovy
-compile('com.github.prominence:openweathermap-api:2.4.2')
-```
-
-### How to use:
-
-Firstly, you need to create the instance of `OpenWeatherMapClient` class:
-```java
-OpenWeatherMapClient openWeatherClient = new OpenWeatherMapClient(API_TOKEN);
-```
-where `API_TOKEN` is your token([you can get it here](https://home.openweathermap.org/api_keys)) as `String`.
-
-Currently, available APIs are:
-* `currentWeather()`
-* `forecast5Day3HourStep()`
-* `oneCall()`
-* `airPollution()`
-
-Also, it is possible to set timeouts for the requests on `openWeatherClient` object:
-```java
-openWeatherClient.setReadTimeout(1000);
-openWeatherClient.setConnectTimeout(1000);
-```
-Timeout settings are passed to the requesters as a copy.
-
-Default(more or less) customization points:
-```java
-...
-// response language
-.language(Language.RUSSIAN)
-...
-// response units of measure
-.unitSystem(UnitSystem.IMPERIAL)
-...
-```
-
-Available output forms:
-* `asJava()`
-* `asJSON()`
-
-Additional output forms, available for several APIs:
-* `asXML()`
-* `asHTML()`
-
-_All response forms can be in **sync** and **async** variants._
-
-#### Current weather data
-Examples:
-```java
-final String weatherJson = openWeatherClient
-        .currentWeather()
-        .single()
-        .byCityName("Minsk")
-        .language(Language.RUSSIAN)
-        .unitSystem(UnitSystem.IMPERIAL)
-        .retrieve()
-        .asJSON();
-```
-
-```java
-final Weather weather = openWeatherClient
-        .currentWeather()
-        .single()
-        .byCityName("Minsk")
-        .language(Language.RUSSIAN)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJava();
-```
-
-```java
-final List<Weather> weatherList = openWeatherClient
-        .currentWeather()
-        .multiple()
-        .byCitiesInCycle(Coordinate.of(55.5, 37.5))
-        .language(Language.GERMAN)
-        .unitSystem(UnitSystem.IMPERIAL)
-        .retrieve()
-        .asJava();
-```
-
-```java
-final CompletableFuture<String> weatherXmlFuture = openWeatherClient
-        .currentWeather()
-        .single()
-        .byZipCodeAndCountry("220015", "by")
-        .language(Language.RUSSIAN)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieveAsync()
-        .asXML();
-```
-
-You are able to set preferable options(via chain methods) and execute appropriate request.
-
-`com.github.prominence.openweathermap.api.model.weather.Weather`'s useful public methods(setters are not listed):
-
-| Method                    | Description                                                                                                                                                               |
-|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `getCalculationTime()`    | Returns `LocalDateTime` object with data calculation time.                                                                                                                |
-| `getWeatherState()`       | Returns `WeatherState` object with basic weather state information.                                                                                                       |
-| `getTemperature()`        | Returns `Temperature` instance that contains information about temperature. Available fields: `value`, `maxTemperature`, `minTemperature`, `feelsLike` and `unit`.        |
-| `getAtmosphericPressure()`| Returns `AtmosphericPressure` instance that contains information about atmospheric pressure. Available fields: `value`, `seaLevelValue`, `groundLevelValue` and `unit`.   |
-| `getHumidity()`           | Returns `Humidity` instance that contains humidity percentage information.                                                                                                |
-| `getWind()`               | Returns `Wind` instance that contains wind information: `speed`, `degrees`, `gust` and `unit`.                                                                            |
-| `getRain()`               | Returns `Rain` instance that contains information about rain volume for the last one hour and/or the last 3 hours. Can be absent in case of no data.                      |
-| `getSnow()`               | Returns `Snow` instance that contains information about snow volume for the last one hour and/or the last 3 hours. Can be absent in case of no data.                      |
-| `getClouds()`             | Returns `Clouds` instance that contains information about cloudiness percentage.                                                                                          |
-| `getLocation()`           | Returns `Location` object. Available fields: `id`, `name`, `countryCode`, `sunrise` and `sunset` time, `zoneOffset` and `coordinate`.                                     |
-| `toString()`              | Returns informative string for the whole available weather information.                                                                                                   |
-
-`toString()` output example:
-```
-Location: Minsk(BY), Weather: clear sky, -4.22 ℃, 1020.0 hPa, Clouds: 0%
-```
-
-#### 5 day / 3-hour forecast
-Examples:
-```java
-final Forecast forecast = openWeatherClient
-        .forecast5Day3HourStep()
-        .byCityName("Minsk")
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .count(15)
-        .retrieve()
-        .asJava();
-```
-
-```java
-final String forecastJson = getClient()
-        .forecast5Day3HourStep()
-        .byCityName("New York", "NY", "US")
-        .language(Language.SPANISH)
-        .unitSystem(UnitSystem.IMPERIAL)
-        .count(15)
-        .retrieve()
-        .asJSON();
-```
-
-```java
-CompletableFuture<String> forecastFuture = getClient()
-        .forecast5Day3HourStep()
-        .byCityId(350001514)
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .count(15)
-        .retrieveAsync()
-        .asXML();
-```
-
-```java
-final String forecastXml = getClient()
-        .forecast5Day3HourStep()
-        .byZipCodeInUSA("10005")
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asXML();
-```
-
-You are able to set preferable options(via chain methods) and execute appropriate request.
-
-`com.github.prominence.openweathermap.api.model.forecast.free.Forecast`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                                                                                                           |
-|-------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `getLocation()`               | Returns `Location` object. Available fields: `id`, `name`, `countryCode`, `sunrise` and `sunset` time, `zoneOffset`, `coordinate` and `population`.   |
-| `getWeatherForecasts()`       | Returns list of `WeatherForecast` objects with forecast information.                                                                                  |
-| `toString()`                  | Returns informative string for the whole available forecast information.                                                                              |
-
-`toString()` output example:
-```
-A forecast for Minsk with 15 timestamps.
-```
-
-`com.github.prominence.openweathermap.api.model.forecast.WeatherForecast`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                                                                                                                               |
-|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `getForecastTime()`           | Returns `LocalDateTime` object with weather forecast time.                                                                                                                |
-| `getWeatherState()`           | Returns `WeatherState` object with basic weather state information.                                                                                                       |
-| `getTemperature()`            | Returns `Temperature` instance that contains information about temperature. Available fields: `value`, `maxTemperature`, `minTemperature`, `feelsLike` and `unit`.        |
-| `getAtmosphericPressure()`    | Returns `AtmosphericPressure` instance that contains information about atmospheric pressure. Available fields: `value`, `seaLevelValue`, `groundLevelValue` and `unit`.   |
-| `getHumidity()`               | Returns `Humidity` instance that contains humidity percentage information.                                                                                                |
-| `getWind()`                   | Returns `Wind` instance that contains wind information: `speed`, `degrees` and `unit`.                                                                                    |
-| `getRain()`                   | Returns `Rain` instance that contains information about rain volume for the last 3 hours. Can be absent in case of no data.                                               |
-| `getSnow()`                   | Returns `Snow` instance that contains information about snow volume for the last 3 hours. Can be absent in case of no data.                                               |
-| `getClouds()`                 | Returns `Clouds` instance that contains information about cloudiness percentage.                                                                                          |
-| `getForecastTimeISO()`        | Returns String with time of data forecasted, ISO, UTC.                                                                                                                    |
-| `getDayTime()`                | Returns enumerations representing the part of day(day, night).                                                                                                            |
-| `toString()`                  | Returns informative string for the forecast of particular timestamp.                                                                                                      |
-
-#### One Call 3 API
-Examples:
-```java
-        final CurrentWeatherData currentWeatherData = getClient()
-        .oneCall3()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJava();
-```
-
-#### One Call API (Deprecated)
-Examples:
-```java
-final CurrentWeatherData currentWeatherData = openWeatherClient
-        .oneCall()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJava();
-```
-
-```java
-final CurrentWeatherData currentWeatherData = openWeatherClient
-        .oneCall()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .exclude(OneCallResultOptions.CURRENT, OneCallResultOptions.MINUTELY)
-        .retrieve()
-        .asJava();
-```
-
-```java
-final CompletableFuture<CurrentWeatherData> currentWeatherDataFuture = openWeatherClient
-        .oneCall()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieveAsync()
-        .asJava();
-```
-
-```java
-final String responseJson = openWeatherClient
-        .oneCall()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJSON();
-```
-
-```java
-final HistoricalWeatherData historicalWeatherData = openWeatherClient
-        .oneCall()
-        .historical()
-        .byCoordinateAndTimestamp(Coordinate.of(60.99, 30.9), LocalDateTime.now().minusDays(5).toEpochSecond(ZoneOffset.UTC))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJava();
-```
-
-```java
-final String responseJson = openWeatherClient
-        .oneCall()
-        .historical()
-        .byCoordinateAndTimestamp(Coordinate.of(60.99, 30.9), LocalDateTime.now().minusDays(5).toEpochSecond(ZoneOffset.UTC))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJSON();
-```
-
-```java
-final CompletableFuture<HistoricalWeatherData> historicalWeatherDataFuture = openWeatherClient
-        .oneCall()
-        .historical()
-        .byCoordinateAndTimestamp(Coordinate.of(60.99, 30.9), LocalDateTime.now().minusDays(5).toEpochSecond(ZoneOffset.UTC))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieveAsync()
-        .asJava();
-```
-
-```java
-final CompletableFuture<String> responseJsonFuture = openWeatherClient
-        .oneCall()
-        .historical()
-        .byCoordinateAndTimestamp(Coordinate.of(60.99, 30.9), LocalDateTime.now().minusDays(5).toEpochSecond(ZoneOffset.UTC))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieveAsync()
-        .asJSON();
-```
-
-You are able to set preferable options(via chain methods) and execute appropriate request.
-
-`com.github.prominence.openweathermap.api.model.onecall.current.CurrentWeatherData`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                                    |
-|-------------------------------|--------------------------------------------------------------------------------|
-| `getCoordinate()`             | Returns `Coordinate` object. Available fields: `latitude`, `longitude`.        |
-| `getTimezone()`               | Returns location timezone object.                                              |
-| `getTimezoneOffset()`         | Returns zone offset.                                                           |
-| `getCurrent()`                | Returns `Current` object with current weather state if available.              |
-| `getMinutelyList()`           | Returns list of `Minutely` objects if available.                               |
-| `getHourlyList()`             | Returns list of `Houlry` objects if available.                                 |
-| `getDailyList()`              | Returns list of `Daily` objects if available.                                  |
-| `getAlerts()`                 | Returns list of `Alert` objects if available.                                  |
-
-`com.github.prominence.openweathermap.api.model.onecall.Current`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                                                     |
-|-------------------------------|-------------------------------------------------------------------------------------------------|
-| `getForecastTime()`           | Returns `LocalDateTime` object with weather forecast time.                                      |
-| `getSunriseTime()`            | Returns `LocalDateTime` object with sunrise time.                                               |
-| `getSunsetTime()`             | Returns `LocalDateTime` object with sunset time.                                                |
-| `getWeatherState()`           | Returns `WeatherState` object with basic weather state information.                             |
-| `getTemperature()`            | Returns `Temperature` object. Available fields: `value`, `feelsLike`, `dewPoint` and `unit`.    |
-| `getAtmosphericPressure()`    | Returns `AtmosphericPressure` object. Available fields: `seaLevelValue`.                        |
-| `getHumidity()`               | Returns `Humidity` object. Available fields: `value` and `unit`.                                |
-| `getClouds()`                 | Returns `Clouds` object. Available fields: `value` and `unit`.                                  |
-| `getUvIndex()`                | Returns UV index value.                                                                         |
-| `getVisibilityInMetres()`     | Returns visibility in metres.                                                                   |
-| `getWind()`                   | Returns `Wind` object. Available fields: `speed`, `degrees`, `gust` and `unit`.                 |
-| `getRain()`                   | Returns `Rain` object. Available fields: `oneHourLevel` and `unit`.                             |
-| `getSnow()`                   | Returns `Snow` object. Available fields: `oneHourLevel` and `unit`.                             |
-
-`com.github.prominence.openweathermap.api.model.onecall.current.Minutely`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                   |
-|-------------------------------|---------------------------------------------------------------|
-| `getForecastTime()`           | Returns `LocalDateTime` object with weather forecast time.    |
-| `getPrecipitationVolume()`    | Returns precipitation volume.                                 |
-
-`com.github.prominence.openweathermap.api.model.onecall.current.Hourly`'s useful public methods(setters are not listed):
-
-| Method                                        | Description                                                                                       |
-|-----------------------------------------------|---------------------------------------------------------------------------------------------------|
-| `getForecastTime()`                           | Returns `LocalDateTime` object with weather forecast time.                                        |
-| `getWeatherState()`                           | Returns `WeatherState` object with basic weather state information.                               |
-| `getTemperature()`                            | Returns `Temperature` object. Available fields: `value`, `feelsLike`, `dewPoint` and `unit`.      |
-| `getAtmosphericPressure()`                    | Returns `AtmosphericPressure` object. Available fields: `seaLevelValue`.                          |
-| `getHumidity()`                               | Returns `Humidity` object. Available fields: `value` and `unit`.                                  |
-| `getClouds()`                                 | Returns `Clouds` object. Available fields: `value` and `unit`.                                    |
-| `getUvIndex()`                                | Returns UV index value.                                                                           |
-| `getVisibilityInMetres()`                     | Returns visibility in metres.                                                                     |
-| `getWind()`                                   | Returns `Wind` object. Available fields: `speed`, `degrees`, `gust` and `unit`.                   |
-| `getProbabilityOfPrecipitation()`             | Returns probability of precipitation(not percentage).                                             |
-| `getProbabilityOfPrecipitationPercentage()`   | Returns probability of precipitation percentage.                                                  |
-| `getRain()`                                   | Returns `Rain` object. Available fields: `oneHourLevel` and `unit`.                               |
-| `getSnow()`                                   | Returns `Snow` object. Available fields: `oneHourLevel` and `unit`.                               |
-
-`com.github.prominence.openweathermap.api.model.onecall.current.Daily`'s useful public methods(setters are not listed):
-
-| Method                                      | Description                                                                                       |
-|---------------------------------------------|---------------------------------------------------------------------------------------------------|
-| `getForecastTime()`                         | Returns `LocalDateTime` object with weather forecast time.                                        |
-| `getSunriseTime()`                          | Returns `LocalDateTime` object with sunrise time.                                                 |
-| `getSunsetTime()`                           | Returns `LocalDateTime` object with sunset time.                                                  |
-| `getMoonriseTime()`                         | Returns `LocalDateTime` object with moonrise time.                                                |
-| `getMoonsetTime()`                          | Returns `LocalDateTime` object with moonset time.                                                 |
-| `getMoonPhase()`                            | Returns `MoonPhase` object with `MoonType` info and value.                                        |
-| `getWeatherState()`                         | Returns `WeatherState` object with basic weather state information.                               |
-| `getTemperature()`                          | Returns `DailyTemperature` object. Available fields: `value`, `feelsLike`, `dewPoint` and `unit`. |
-| `getAtmosphericPressure()`                  | Returns `AtmosphericPressure` object. Available fields: `seaLevelValue`.                          |
-| `getHumidity()`                             | Returns `Humidity` object. Available fields: `value` and `unit`.                                  |
-| `getWind()`                                 | Returns `Wind` object. Available fields: `speed`, `degrees`, `gust` and `unit`.                   |
-| `getClouds()`                               | Returns `Clouds` object. Available fields: `value` and `unit`.                                    |
-| `getUvIndex()`                              | Returns UV index value.                                                                           |
-| `getProbabilityOfPrecipitation()`           | Returns probability of precipitation(not percentage).                                             |
-| `getProbabilityOfPrecipitationPercentage()` | Returns probability of precipitation percentage.                                                  |
-| `getRain()`                                 | Returns `DailyRain` object. Available fields: `value`.                                            |
-| `getSnow()`                                 | Returns `DailySnow` object. Available fields: `value`.                                            |
-
-`com.github.prominence.openweathermap.api.model.onecall.current.Alert`'s useful public methods(setters are not listed):
-
-| Method                       | Description                                            |
-|------------------------------|--------------------------------------------------------|
-| `getSenderName()`            | Returns alert sender name.                             |
-| `getEventName()`             | Returns alert event name.                              |
-| `getStartTime()`             | Returns `LocalDateTime` when event should start.       |
-| `getEndTime()`               | Returns `LocalDateTime` when event should end.         |
-| `getDescription()`           | Returns alert description.                             |
-
-`com.github.prominence.openweathermap.api.model.onecall.historical.HistoricalWeatherData`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                                   |
-|-------------------------------|-------------------------------------------------------------------------------|
-| `getCoordinate()`             | Returns `Coordinate` object. Available fields: `latitude`, `longitude`.       |
-| `getTimezone()`               | Returns location timezone object.                                             |
-| `getTimezoneOffset()`         | Returns zone offset.                                                          |
-| `getHistoricalWeather()`      | Returns `HistoricalWeather` object with historical weather state.             |
-| `getHourlyList()`             | Returns list of `HourlyHistorical` objects.                                   |
-
-`com.github.prominence.openweathermap.api.model.onecall.historical.HistoricalWeather`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                                                     |
-|-------------------------------|-------------------------------------------------------------------------------------------------|
-| `getForecastTime()`           | Returns `LocalDateTime` object with weather forecast time.                                      |
-| `getSunriseTime()`            | Returns `LocalDateTime` object with sunrise time.                                               |
-| `getSunsetTime()`             | Returns `LocalDateTime` object with sunset time.                                                |
-| `getWeatherState()`           | Returns `WeatherState` object with basic weather state information.                             |
-| `getTemperature()`            | Returns `Temperature` object. Available fields: `value`, `feelsLike`, `dewPoint` and `unit`.    |
-| `getAtmosphericPressure()`    | Returns `AtmosphericPressure` object. Available fields: `seaLevelValue`.                        |
-| `getHumidity()`               | Returns `Humidity` object. Available fields: `value` and `unit`.                                |
-| `getClouds()`                 | Returns `Clouds` object. Available fields: `value` and `unit`.                                  |
-| `getUvIndex()`                | Returns UV index value.                                                                         |
-| `getVisibilityInMetres()`     | Returns visibility in metres.                                                                   |
-| `getWind()`                   | Returns `Wind` object. Available fields: `speed`, `degrees`, `gust` and `unit`.                 |
-| `getRain()`                   | Returns `Rain` object. Available fields: `oneHourLevel` and `unit`.                             |
-| `getSnow()`                   | Returns `Snow` object. Available fields: `oneHourLevel` and `unit`.                             |
-
-`com.github.prominence.openweathermap.api.model.onecall.historical.HourlyHistorical`'s useful public methods(setters are not listed):
-
-| Method                            | Description                                                                                       |
-|-----------------------------------|---------------------------------------------------------------------------------------------------|
-| `getForecastTime()`               | Returns `LocalDateTime` object with weather forecast time.                                        |
-| `getWeatherState()`               | Returns `WeatherState` object with basic weather state information.                               |
-| `getTemperature()`                | Returns `Temperature` object. Available fields: `value`, `feelsLike`, `dewPoint` and `unit`.      |
-| `getAtmosphericPressure()`        | Returns `AtmosphericPressure` object. Available fields: `seaLevelValue`.                          |
-| `getHumidity()`                   | Returns `Humidity` object. Available fields: `value` and `unit`.                                  |
-| `getClouds()`                     | Returns `Clouds` object. Available fields: `value` and `unit`.                                    |
-| `getVisibilityInMetres()`         | Returns visibility in metres.                                                                     |
-| `getWind()`                       | Returns `Wind` object. Available fields: `speed`, `degrees`, `gust` and `unit`.                   |
-| `getRain()`                       | Returns `Rain` object. Available fields: `oneHourLevel` and `unit`.                               |
-| `getSnow()`                       | Returns `Snow` object. Available fields: `oneHourLevel` and `unit`.                               |
-
-#### Air Pollution API
-Examples:
-```java
-final AirPollutionDetails airPollutionDetails = openWeatherClient
-        .airPollution()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .retrieve()
-        .asJava();
-```
-
-```java
-final AirPollutionDetails airPollutionDetails = openWeatherClient
-        .airPollution()
-        .historical()
-        .byCoordinateAndPeriod(Coordinate.of(53.54, 27.34), 1606223802, 1606482999)
-        .retrieve()
-        .asJava();
-```
-
-`com.github.prominence.openweathermap.api.model.air.pollution.AirPollutionDetails`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                               |
-|-------------------------------|---------------------------------------------------------------------------|
-| `getCoordinate()`             | Returns `Coordinate` object. Available fields: `latitude`, `longitude`.   |
-| `getAirPollutionRecords()`    | Returns list of `AirPollutionRecord` objects.                             |
-
-`com.github.prominence.openweathermap.api.model.air.pollution.AirPollutionRecord`'s useful public methods(setters are not listed):
-
-| Method                        | Description                                                               |
-|-------------------------------|---------------------------------------------------------------------------|
-| `getForecastTime()`           | Returns `LocalDateTime` object with air pollution forecast time.          |
-| `getAirQualityIndex()`        | Returns `AirQualityIndex` object.                                         |
-| `getCO()`                     | Returns carbon monoxide concentration value in μg/m^3.s.                  |
-| `getCarbonMonoxide()`         | An alias for `getCO()` method.                                            |
-| `getNO()`                     | Returns nitrogen monoxide concentration value in μg/m^3.                  |
-| `getNitrogenMonoxide()`       | An alias for `getNO()` method.                                            |
-| `getNO2()`                    | Returns nitrogen dioxide concentration value in μg/m^3.                   |
-| `getNitrogenDioxide()`        | An alias for `getNO2()` method.                                           |
-| `getO3()`                     | Returns ozone concentration value in μg/m^3.                              |
-| `getOzone()`                  | An alias for `getO3()` method.                                            |
-| `getSO2()`                    | Returns sulphur dioxide concentration value in μg/m^3.                    |
-| `getSulphurDioxide()`         | An alias for `getSO2()` method.                                           |
-| `getPM2_5()`                  | Returns fine particles matter concentration value in μg/m^3.              |
-| `getFineParticlesMatter()`    | An alias for `getPM2_5()` method.                                         |
-| `getPM10()`                   | Returns coarse particulate matter concentration value in μg/m^3.          |
-| `getCoarseParticulateMatter()`| An alias for `getPM10()` method.                                          |
-| `getNH3()`                    | Returns ammonia concentration value in μg/m^3.                            |
-| `getAmmonia()`                | An alias for `getNH3()` method.                                           |
-
-### Constants and options
-
-#### Language
-| Constant                     | Description                   |
-|------------------------------|-------------------------------|
-| Language.AFRIKAANS           | Afrikaans language.           |
-| Language.ALBANIAN            | ALBANIAN language.            |
-| Language.ARABIC              | Arabic language.              |
-| Language.AZERBAIJANI         | Azerbaijani language.         |
-| Language.BULGARIAN           | Bulgarian language.           |
-| Language.CATALAN             | Catalan language.             |
-| Language.CZECH               | Czech language.               |
-| Language.DANISH              | Danish language.              |
-| Language.GERMAN              | German language.              |
-| Language.GREEK               | Greek language.               |
-| Language.ENGLISH             | English language.             |
-| Language.BASQUE              | Basque language.              |
-| Language.PERSIAN             | Persian (Farsi) language.     |
-| Language.FINNISH             | Finnish language.             |
-| Language.FRENCH              | French language.              |
-| Language.GALICIAN            | Galician language.            |
-| Language.HEBREW              | Hebrew language.              |
-| Language.HINDI               | Hindi language.               |
-| Language.CROATIAN            | Croatian language.            |
-| Language.HUNGARIAN           | Hungarian language.           |
-| Language.INDONESIAN          | Indonesian language.          |
-| Language.ITALIAN             | Italian language.             |
-| Language.JAPANESE            | Japanese language.            |
-| Language.KOREAN              | Korean language.              |
-| Language.LATVIAN             | Latvian language.             |
-| Language.LITHUANIAN          | Lithuanian language.          |
-| Language.MACEDONIAN          | Macedonian language.          |
-| Language.NORWEGIAN           | Norwegian language.           |
-| Language.DUTCH               | Dutch language.               |
-| Language.POLISH              | Polish language.              |
-| Language.PORTUGUESE          | Portuguese language.          |
-| Language.PORTUGUES_BRAZIL    | Português Brasil language.    |
-| Language.ROMANIAN            | Romanian language.            |
-| Language.RUSSIAN             | Russian language.             |
-| Language.SWEDISH             | Swedish language.             |
-| Language.SLOVAK              | Slovak language.              |
-| Language.SLOVENIAN           | Slovenian language.           |
-| Language.SPANISH             | Spanish language.             |
-| Language.SERBIAN             | Serbian language.             |
-| Language.THAI                | Thai language.                |
-| Language.TURKISH             | Turkish language.             |
-| Language.UKRAINIAN           | Ukrainian language.           |
-| Language.VIETNAMESE          | Vietnamese language.          |
-| Language.CHINESE_SIMPLIFIED  | Chinese Simplified language.  |
-| Language.CHINESE_TRADITIONAL | Chinese Traditional language. |
-| Language.ZULU                | Zulu language.                |
-
-#### Unit
-| Constant             | Description                                    |
-|----------------------|------------------------------------------------|
-| Unit.METRIC_SYSTEM   | Celsius, meter/sec, hPa, mm(rain, snow).       |
-| Unit.IMPERIAL_SYSTEM | Fahrenheit, miles/hour, hPa, mm(rain, snow).   |
-| Unit.STANDARD_SYSTEM | Kelvin, meter/sec, hPa, mm(rain, snow).        |
-
-### Dependencies
-* com.fasterxml.jackson.core:jackson-databind:2.13.4.2
-* org.slf4j:slf4j-api:1.7.36 (*compile*)
-* org.junit.jupiter:junit-jupiter-engine:5.8.2 (*test*)
-* org.junit.platform:junit-platform-runner:1.8.2 (*test*)

docs/SNAPSHOT.md

@@ -2,7 +2,6 @@
 * Current weather data
 * 5 day / 3-hour forecast
 * One Call API
-* One Call 3 API
 * Air Pollution
 
 
@@ -15,14 +14,46 @@ Other:
 <dependency>
     <groupId>com.github.prominence</groupId>
     <artifactId>openweathermap-api</artifactId>
-  <version>2.4.0</version>
+    <version>3.0.0-SNAPSHOT</version>
 </dependency>
 ```
 
+```xml
+<repositories>
+    ...
+    <!-- Repository for snapshot versions -->
+    <repository>
+        <id>oss.sonatype.org-snapshot</id>
+        <url>https://oss.sonatype.org/content/repositories/snapshots</url>
+        <releases>
+            <enabled>false</enabled>
+        </releases>
+        <snapshots>
+            <enabled>true</enabled>
+        </snapshots>
+    </repository>
+    ...
+</repositories>
+```
+
 ### Gradle coordinates:
 
 ```groovy
-compile('com.github.prominence:openweathermap-api:2.4.0')
+implementation 'com.github.prominence:openweathermap-api:3.0.0-SNAPSHOT'
+```
+
+```groovy
+repositories {
+    ...
+    // Repository for snapshot versions
+    maven {
+        url "https://oss.sonatype.org/content/repositories/snapshots"
+        mavenContent {
+            snapshotsOnly()
+        }
+    }
+    ...
+}
 ```
 
 ### How to use:
@@ -213,20 +244,7 @@ A forecast for Minsk with 15 timestamps.
 | `getDayTime()`                | Returns enumerations representing the part of day(day, night).                                                                                                            |
 | `toString()`                  | Returns informative string for the forecast of particular timestamp.                                                                                                      |
 
-#### One Call 3 API
+#### One Call API
-Examples:
-```java
-        final CurrentWeatherData currentWeatherData = getClient()
-        .oneCall3()
-        .current()
-        .byCoordinate(Coordinate.of(53.54, 27.34))
-        .language(Language.ENGLISH)
-        .unitSystem(UnitSystem.METRIC)
-        .retrieve()
-        .asJava();
-```
-
-#### One Call API (Deprecated)
 Examples:
 ```java
 final CurrentWeatherData currentWeatherData = openWeatherClient
@@ -560,7 +578,7 @@ final AirPollutionDetails airPollutionDetails = openWeatherClient
 | Unit.STANDARD_SYSTEM | Kelvin, meter/sec, hPa, mm(rain, snow).        |
 
 ### Dependencies
-* com.fasterxml.jackson.core:jackson-databind:2.13.4.2
+* com.fasterxml.jackson.core:jackson-databind:2.13.2.2
 * org.slf4j:slf4j-api:1.7.36 (*compile*)
 * org.junit.jupiter:junit-jupiter-engine:5.8.2 (*test*)
 * org.junit.platform:junit-platform-runner:1.8.2 (*test*)

gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,5 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.4.2-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

gradlew

@@ -0,0 +1,234 @@
+#!/bin/sh
+
+#
+# Copyright © 2015-2021 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+##############################################################################
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
+done
+
+APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
+
+APP_NAME="Gradle"
+APP_BASE_NAME=${0##*/}
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+    echo "$*"
+} >&2
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD=$JAVA_HOME/jre/sh/java
+    else
+        JAVACMD=$JAVA_HOME/bin/java
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD=java
+    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
+    esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
+        fi
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
+    done
+fi
+
+# Collect all arguments for the java command;
+#   * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
+#     shell script including quotes and variable substitutions, so put them in
+#     double quotes to make sure that they get re-expanded; and
+#   * put everything else in single quotes, so that it's not re-expanded.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -classpath "$CLASSPATH" \
+        org.gradle.wrapper.GradleWrapperMain \
+        "$@"
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
+
+exec "$JAVACMD" "$@"

gradlew.bat

@@ -0,0 +1,89 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

pom.xml

@@ -1,185 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-    <modelVersion>4.0.0</modelVersion>
-
-    <groupId>com.github.prominence</groupId>
-    <artifactId>openweathermap-api</artifactId>
-    <version>2.4.2</version>
-    <packaging>jar</packaging>
-
-    <name>Java OpenWeatherMap API</name>
-    <description>Java API for OpenWeatherMap services.</description>
-    <url>https://github.com/Prominence/openweathermap-java-api</url>
-
-    <scm>
-        <url>https://github.com/Prominence/openweathermap-java-api</url>
-        <connection>scm:git:git://github.com/Prominence/openweathermap-java-api.git</connection>
-        <developerConnection>scm:git:git@github.com:prominence/openweathermap-java-api.git</developerConnection>
-    </scm>
-
-    <issueManagement>
-        <url>https://github.com/Prominence/openweathermap-java-api/issues</url>
-        <system>GitHub Issues</system>
-    </issueManagement>
-
-    <licenses>
-        <license>
-            <name>MIT License</name>
-            <url>https://www.opensource.org/licenses/mit-license.php</url>
-            <distribution>repo</distribution>
-        </license>
-    </licenses>
-
-    <developers>
-        <developer>
-            <email>alexey.zinchenko@protonmail.com</email>
-            <name>Alexey Zinchenko</name>
-            <url>https://github.com/prominence</url>
-            <id>Prominence</id>
-        </developer>
-    </developers>
-
-    <distributionManagement>
-        <snapshotRepository>
-            <id>ossrh</id>
-            <url>https://oss.sonatype.org/content/repositories/snapshots</url>
-        </snapshotRepository>
-        <repository>
-            <id>ossrh</id>
-            <url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
-        </repository>
-    </distributionManagement>
-
-    <properties>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
-
-    <build>
-        <plugins>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-compiler-plugin</artifactId>
-                <version>3.8.1</version>
-                <configuration>
-                    <source>8</source>
-                    <target>8</target>
-                </configuration>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-jar-plugin</artifactId>
-                <version>3.2.0</version>
-                <configuration>
-                    <excludes>
-                        <exclude>**/test/*</exclude>
-                    </excludes>
-                </configuration>
-            </plugin>
-            <plugin>
-                <groupId>org.sonatype.central</groupId>
-                <artifactId>central-publishing-maven-plugin</artifactId>
-                <version>0.9.0</version>
-                <extensions>true</extensions>
-                <configuration>
-                    <publishingServerId>central</publishingServerId>
-                </configuration>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-source-plugin</artifactId>
-                <version>3.2.1</version>
-                <executions>
-                    <execution>
-                        <id>attach-sources</id>
-                        <goals>
-                            <goal>jar-no-fork</goal>
-                        </goals>
-                    </execution>
-                </executions>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-javadoc-plugin</artifactId>
-                <version>3.3.0</version>
-                <configuration>
-                    <source>8</source>
-                </configuration>
-                <executions>
-                    <execution>
-                        <id>attach-javadocs</id>
-                        <goals>
-                            <goal>jar</goal>
-                        </goals>
-                    </execution>
-                </executions>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-gpg-plugin</artifactId>
-                <version>3.0.1</version>
-                <executions>
-                    <execution>
-                        <id>sign-artifacts</id>
-                        <phase>verify</phase>
-                        <goals>
-                            <goal>sign</goal>
-                        </goals>
-                    </execution>
-                </executions>
-            </plugin>
-            <plugin>
-                <groupId>org.jacoco</groupId>
-                <artifactId>jacoco-maven-plugin</artifactId>
-                <version>0.8.7</version>
-                <executions>
-                    <execution>
-                        <goals>
-                            <goal>prepare-agent</goal>
-                        </goals>
-                    </execution>
-                    <execution>
-                        <id>report</id>
-                        <phase>test</phase>
-                        <goals>
-                            <goal>report</goal>
-                        </goals>
-                    </execution>
-                </executions>
-            </plugin>
-
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-surefire-plugin</artifactId>
-                <version>2.22.2</version>
-            </plugin>
-        </plugins>
-    </build>
-
-    <dependencies>
-        <dependency>
-            <groupId>com.fasterxml.jackson.core</groupId>
-            <artifactId>jackson-databind</artifactId>
-            <version>2.22.0</version>
-        </dependency>
-        <dependency>
-            <groupId>org.slf4j</groupId>
-            <artifactId>slf4j-api</artifactId>
-            <version>1.7.36</version>
-            <scope>compile</scope>
-        </dependency>
-
-        <dependency>
-            <groupId>org.junit.jupiter</groupId>
-            <artifactId>junit-jupiter-engine</artifactId>
-            <version>5.8.2</version>
-            <scope>test</scope>
-        </dependency>
-        <dependency>
-            <groupId>org.junit.platform</groupId>
-            <artifactId>junit-platform-runner</artifactId>
-            <version>1.8.2</version>
-        </dependency>
-    </dependencies>
-</project>

settings.gradle

@@ -0,0 +1 @@
+rootProject.name = 'openweathermap-api'

src/main/java/com/github/prominence/openweathermap/api/OpenWeatherMapClient.java

@@ -31,7 +31,6 @@ import com.github.prominence.openweathermap.api.request.onecall.OneCallWeatherRe
 import com.github.prominence.openweathermap.api.request.weather.CurrentWeatherRequester;
 
 import static com.github.prominence.openweathermap.api.enums.SubscriptionPlan.ALL;
-import static com.github.prominence.openweathermap.api.enums.SubscriptionPlan.SPECIAL;
 
 /**
  * The main public API client to communicate with OpenWeatherMap services.
@@ -81,29 +80,10 @@ public class OpenWeatherMapClient {
      * @return requester for retrieving one call weather information.
      */
     @SubscriptionAvailability(plans = ALL)
-    @Deprecated
     public OneCallWeatherRequester oneCall() {
         return new OneCallWeatherRequester(new RequestSettings(apiKey, timeoutSettings));
     }
 
-    /**
-     * One Call 3 API <a href="https://openweathermap.org/api/one-call-3">API</a>.
-     * Includes a weather summary statement in addition to the information provided by {@link #oneCall()}
-     *
-     * Please note, that One Call API 3.0 is included in the "One Call by Call" subscription only.
-     * This separate subscription includes 1,000 calls/day for free and allows you to pay only for the number of API calls made to this product.
-     * Please note, that you do not need to subscribe to any other OpenWeather subscription plans to get access to the One Call API 3.0.
-     * Please find more details on the pricing page and FAQ or ask Ulla, OpenWeather AI assistant.
-     *
-     * @return requester for retrieving one call weather information for the OneCall 3 API.
-     */
-    @SubscriptionAvailability(plans = SPECIAL)
-    public OneCallWeatherRequester oneCall3() {
-        RequestSettings requestSettings = new RequestSettings(apiKey, timeoutSettings);
-        requestSettings.setUseApi3();
-        return new OneCallWeatherRequester(requestSettings);
-    }
-
     /**
      * Air Pollution <a href="https://openweathermap.org/api/air-pollution">API</a>.
      * Air Pollution API provides current, forecast and historical air pollution data for any coordinates on the globe.

src/main/java/com/github/prominence/openweathermap/api/enums/SubscriptionPlan.java

@@ -56,9 +56,4 @@ public enum SubscriptionPlan {
      * All existing subscription plans.
      */
     ALL,
-
-    /**
-     * Special subscription cases.
-     */
-    SPECIAL,
 }

src/main/java/com/github/prominence/openweathermap/api/mapper/OneCallWeatherResponseMapper.java

@@ -213,7 +213,6 @@ public class OneCallWeatherResponseMapper {
                 daily.setMoonPhase(new MoonPhase(moonPhaseNode.asDouble()));
             }
 
-            daily.setSummary(parseSummary(dailyNode));
             daily.setWeatherState(parseWeatherState(dailyNode.get("weather").get(0)));
             daily.setTemperature(parseDailyTemperature(dailyNode));
             daily.setAtmosphericPressure(parsePressure(dailyNode));
@@ -418,7 +417,7 @@ public class OneCallWeatherResponseMapper {
         if (snowNode != null) {
             final JsonNode OneHourNode = snowNode.get("1h");
             if (OneHourNode != null) {
-                return Snow.withOneHourLevelValue(OneHourNode.asDouble());
+                Rain.withOneHourLevelValue(OneHourNode.asDouble());
             }
         }
         return null;
@@ -440,12 +439,4 @@ public class OneCallWeatherResponseMapper {
 
         return null;
     }
-
-    private String parseSummary(JsonNode dailyNode) {
-        final JsonNode summaryNode = dailyNode.get("summary");
-        if(summaryNode != null) {
-            return summaryNode.asText();
-        }
-        return null;
-    }
 }

src/main/java/com/github/prominence/openweathermap/api/model/Humidity.java

@@ -44,13 +44,15 @@ public class Humidity {
     }
 
     /**
-     * Creates {@link Humidity} object with safeguard to have min 0 and max 100 as value
+     * Creates {@link Humidity} object with correctness check.
      * @param value humidity
      * @return created {@link Humidity} object
      */
     public static Humidity withValue(byte value) {
-        int v = Math.max(0, Math.min(100, value));
+        if (value < 0 || value > 100)  {
-        return new Humidity((byte) v);
+            throw new IllegalArgumentException("Humidity value must be in [0, 100] range.");
+        }
+        return new Humidity(value);
     }
 
     /**
@@ -66,10 +68,13 @@ public class Humidity {
      * Sets humidity percentage value.
      *
      * @param value new humidity value.
-     * Rounds to 0 or 100 if provided value isn't in allowed range.
+     * @throws IllegalArgumentException in case if provided value isn't in allowed range.
      */
     public void setValue(int value) {
-        this.value = Math.max(0, Math.min(100, value));
+        if (value < 0 || value > 100)  {
+            throw new IllegalArgumentException("Humidity value must be in [0, 100] range.");
+        }
+        this.value = value;
     }
 
     /**

src/main/java/com/github/prominence/openweathermap/api/model/onecall/current/Daily.java

@@ -43,7 +43,6 @@ public class Daily {
     private LocalDateTime moonsetTime;
     private MoonPhase moonPhase;
 
-    private String summary;
     private WeatherState weatherState;
     private DailyTemperature temperature;
     private AtmosphericPressure atmosphericPressure;
@@ -163,24 +162,6 @@ public class Daily {
         this.moonPhase = moonPhase;
     }
 
-    /**
-     * Gets summary.
-     *
-     * @return the summary
-     */
-    public String getSummary() {
-        return summary;
-    }
-
-    /**
-     * Sets summary.
-     *
-     * @param summary the summary
-     */
-    public void setSummary(String summary) {
-        this.summary = summary;
-    }
-
     /**
      * Gets weather state.
      *
@@ -454,5 +435,4 @@ public class Daily {
         }
         return stringBuilder.toString();
     }
-
 }

src/main/java/com/github/prominence/openweathermap/api/request/RequestSettings.java

@@ -45,7 +45,6 @@ public class RequestSettings {
 
     private Language language = Language.ENGLISH;
     private UnitSystem unitSystem = UnitSystem.STANDARD;
-    private boolean useApi3 = false;
 
     public RequestSettings(String apiKey, TimeoutSettings timeoutSettings) {
         this.putRequestParameter(API_KEY_PARAM_NAME, apiKey);
@@ -95,14 +94,6 @@ public class RequestSettings {
         urlAppenderBuilder.append(appendix);
     }
 
-    public void setUseApi3() {
-        this.useApi3 = true;
-    }
-
-    public boolean getUseApi3() {
-        return this.useApi3;
-    }
-
     public StringBuilder getUrlAppender() {
         return urlAppenderBuilder;
     }

src/main/java/com/github/prominence/openweathermap/api/utils/RequestUtils.java

@@ -29,11 +29,13 @@ import com.github.prominence.openweathermap.api.request.RequestSettings;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
-import java.io.*;
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
 import java.net.HttpURLConnection;
 import java.net.MalformedURLException;
 import java.net.URL;
-import java.net.URLEncoder;
 import java.nio.charset.StandardCharsets;
 import java.util.stream.Collectors;
 
@@ -42,8 +44,7 @@ import java.util.stream.Collectors;
  */
 public final class RequestUtils {
 
-    private static final String OWM_URL_BASE = "https://api.openweathermap.org/data/2.5/";
+    private static final String OWM_URL_BASE = "http://api.openweathermap.org/data/2.5/";
-    private static final String OWM_URL_BASE_3_0 = "https://api.openweathermap.org/data/3.0/";
 
     private static final Logger logger = LoggerFactory.getLogger(RequestUtils.class);
 
@@ -52,19 +53,10 @@ public final class RequestUtils {
 
     public static String getResponse(RequestSettings requestSettings) {
         StringBuilder requestUrlBuilder = new StringBuilder(OWM_URL_BASE);
-        if(requestSettings.getUseApi3()) {
-            requestUrlBuilder = new StringBuilder(OWM_URL_BASE_3_0);
-        }
         requestUrlBuilder.append(requestSettings.getUrlAppender());
         requestUrlBuilder.append('?');
         String parameters = requestSettings.getRequestParameters().entrySet().stream()
-                .map(entry -> {
+                .map(entry -> entry.getKey() + "=" + entry.getValue())
-                    try {
-                        return entry.getKey() + "=" + URLEncoder.encode(entry.getValue(), "UTF-8");
-                    } catch (UnsupportedEncodingException e) {
-                        throw new RuntimeException(e);
-                    }
-                })
                 .collect(Collectors.joining("&"));
         requestUrlBuilder.append(parameters);
 

src/test/java/com/github/prominence/openweathermap/api/model/HumidityUnitTest.java

@@ -37,15 +37,13 @@ public class HumidityUnitTest {
     }
 
     @Test
-    public void whenCreateHumidityByConstructorWithInvalidDataAboveHundred_thenValueIsMaxHundred() {
+    public void whenCreateHumidityByConstructorWithInvalidDataAboveHundred_thenThrowAnException() {
-        Humidity h = Humidity.withValue((byte) 112);
+        assertThrows(IllegalArgumentException.class, () -> Humidity.withValue((byte) 112));
-        assertEquals(100, h.getValue());
     }
 
     @Test
-    public void whenCreateHumidityByConstructorWithInvalidDataNegative_thenValueIsMinZero() {
+    public void whenCreateHumidityByConstructorWithInvalidDataNegative_thenThrowAnException() {
-        Humidity h = Humidity.withValue((byte) -33);
+        assertThrows(IllegalArgumentException.class, () -> Humidity.withValue((byte) -33));
-        assertEquals(0, h.getValue());
     }
 
     @Test
@@ -61,17 +59,15 @@ public class HumidityUnitTest {
     }
 
     @Test
-    public void whenCreateHumidityAndSetInvalidDataAboveHundred_thenValueIsMaxHundred() {
+    public void whenCreateHumidityAndSetInvalidDataAboveHundred_thenThrowAnException() {
         Humidity humidity = Humidity.withValue((byte) 12);
-        humidity.setValue(112);
+        assertThrows(IllegalArgumentException.class, () -> humidity.setValue((byte) 112));
-        assertEquals(100, humidity.getValue());
     }
 
     @Test
-    public void whenCreateHumidityAndSetInvalidDataNegative_thenValueIsMinZero() {
+    public void whenCreateHumidityAndSetInvalidDataNegative_thenThrowAnException() {
         Humidity humidity = Humidity.withValue((byte) 88);
-        humidity.setValue(-89);
+        assertThrows(IllegalArgumentException.class, () -> humidity.setValue((byte) -89));
-        assertEquals(0, humidity.getValue());
     }
 
     @Test

src/test/java/com/github/prominence/openweathermap/api/request/onecall/current/CurrentWeatherOneCallApi3IntegrationTest.java

@@ -1,136 +0,0 @@
-/*
- * Copyright (c) 2021 Alexey Zinchenko
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-package com.github.prominence.openweathermap.api.request.onecall.current;
-
-import com.github.prominence.openweathermap.api.ApiTest;
-import com.github.prominence.openweathermap.api.OpenWeatherMapClient;
-import com.github.prominence.openweathermap.api.enums.Language;
-import com.github.prominence.openweathermap.api.enums.OneCallResultOptions;
-import com.github.prominence.openweathermap.api.enums.UnitSystem;
-import com.github.prominence.openweathermap.api.exception.InvalidAuthTokenException;
-import com.github.prominence.openweathermap.api.exception.NoDataFoundException;
-import com.github.prominence.openweathermap.api.model.Coordinate;
-import com.github.prominence.openweathermap.api.model.onecall.current.CurrentWeatherData;
-import org.junit.jupiter.api.Test;
-
-import java.util.concurrent.CompletableFuture;
-import java.util.concurrent.ExecutionException;
-
-import static org.junit.jupiter.api.Assertions.*;
-
-public class CurrentWeatherOneCallApi3IntegrationTest extends ApiTest {
-    @Test
-    public void whenRetrieveCurrentOneCallResponseAsJava_thenOk() {
-        final CurrentWeatherData currentWeatherData = getClient()
-                .oneCall3()
-                .current()
-                .byCoordinate(Coordinate.of(53.54, 27.34))
-                .language(Language.ENGLISH)
-                .unitSystem(UnitSystem.METRIC)
-                .retrieve()
-                .asJava();
-
-        assertNotNull(currentWeatherData);
-        assertNotNull(currentWeatherData.getDailyList().get(0).getSummary());
-    }
-
-    @Test
-    public void whenRetrieveCurrentOneCallResponseAsJSON_thenOk() {
-        final String responseJson = getClient()
-                .oneCall3()
-                .current()
-                .byCoordinate(Coordinate.of(53.54, 27.34))
-                .language(Language.ENGLISH)
-                .unitSystem(UnitSystem.METRIC)
-                .retrieve()
-                .asJSON();
-
-        assertNotNull(responseJson);
-        assertNotEquals("", responseJson);
-    }
-
-    @Test
-    public void whenRetrieveCurrentOneCallResponseWithExclusionAsJava_thenOk() {
-        final CurrentWeatherData currentWeatherData = getClient()
-                .oneCall3()
-                .current()
-                .byCoordinate(Coordinate.of(53.54, 27.34))
-                .language(Language.ENGLISH)
-                .unitSystem(UnitSystem.METRIC)
-                .exclude(OneCallResultOptions.CURRENT, OneCallResultOptions.MINUTELY)
-                .retrieve()
-                .asJava();
-
-        assertNotNull(currentWeatherData);
-        assertNull(currentWeatherData.getCurrent());
-        assertNull(currentWeatherData.getMinutelyList());
-        assertNotNull(currentWeatherData.getDailyList().get(0).getSummary());
-    }
-
-    @Test
-    public void whenRetrieveCurrentOneCallAsyncResponseAsJava_thenOk() throws ExecutionException, InterruptedException {
-        final CompletableFuture<CurrentWeatherData> currentWeatherDataFuture = getClient()
-                .oneCall3()
-                .current()
-                .byCoordinate(Coordinate.of(53.54, 27.34))
-                .language(Language.ENGLISH)
-                .unitSystem(UnitSystem.METRIC)
-                .retrieveAsync()
-                .asJava();
-
-        assertNotNull(currentWeatherDataFuture);
-        assertNotNull(currentWeatherDataFuture.get());
-        assertNotNull(currentWeatherDataFuture.get().getDailyList().get(0).getSummary());
-    }
-
-    @Test
-    public void whenRetrieveCurrentOneCallAsyncResponseAsJSON_thenOk() throws ExecutionException, InterruptedException {
-        final CompletableFuture<String> responseJsonFuture = getClient()
-                .oneCall3()
-                .current()
-                .byCoordinate(Coordinate.of(53.54, 27.34))
-                .language(Language.ENGLISH)
-                .unitSystem(UnitSystem.METRIC)
-                .retrieveAsync()
-                .asJSON();
-
-        assertNotNull(responseJsonFuture);
-        final String responseJson = responseJsonFuture.get();
-        assertNotNull(responseJson);
-    }
-
-    @Test
-    public void whenRequestOnecallWithInvalidApiKey_thenThrowAnException() {
-        OpenWeatherMapClient client = new OpenWeatherMapClient("invalidKey");
-        assertThrows(InvalidAuthTokenException.class, () ->
-                client
-                        .oneCall3()
-                        .current()
-                        .byCoordinate(Coordinate.of(53.54, 27.34))
-                        .language(Language.ENGLISH)
-                        .unitSystem(UnitSystem.METRIC)
-                        .retrieve()
-                        .asJSON()
-        );
-    }
-}