Implemented first part of Road Risk API.

Improved coverage reports generation.
Updated docs.
Moved logic out of large mappers into small deserializers.
Implemented Geocoding API functionality.
Implemented Hourly forecast functionality.
Implemented Daily forecast functionality.
Renamed Coordinate class.
Reimplemented Current Weather API: removed multiple locations requests. Marked officially deprecated methods as @Deprecated.
Updated tests.

.cirrus.yml

@@ -0,0 +1,13 @@
+container:
+  image: gradle:jdk17
+
+testCoverage_task:
+  gradle_cache:
+    folder: ~/.gradle/caches
+  testCoverage_script: gradle jacocoTestReport && bash <(curl -s https://codecov.io/bash)
+  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/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

@@ -0,0 +1,67 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ dev ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ dev ]
+  schedule:
+    - cron: '27 20 * * 1'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'java' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python' ]
+        # Learn more:
+        # https://docs.github.com/en/free-pro-team@latest/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v1
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v1
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v1

.gitignore

@@ -1,25 +1,6 @@
-# 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/
+.idea
-target/
+.gradle
-**/ApplicationTest.java
+build
+target
+out

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2018 Alexey Zinchenko
+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

README.md

@@ -1,34 +1,106 @@
-# OpenWeatherMap Java API
+# OpenWeatherMap Java API [![Build Status][ci-shield]][ci-link] [![codecov][codecov-shield]][codecov-link] [![FOSSA Status][FOSSA-shield]][FOSSA-link]
 Java API for OpenWeatherMap services.
 
 ### Implemented features:
+Free: 
 * Current weather data
-* 5 day / 3 hour forecast
+* 5 day / 3-hour forecast
+* One Call API
+* Air pollution
+* Geocoding API
+
+Paid:
+* Hourly Forecast 4 days
+* Daily Forecast 16 days
+* Climatic 30 days
+* Solar Radiation API
+* Road Risk API
+
+Other:
+* Request timeout settings
 
 ### Will be implemented later:
-* 16 day / daily forecast
+
-* UV Index(beta)
+Free:
-* Air pollution(beta)
+* Weather Stations
+* Weather Triggers
+  
+Paid:
+* Climatic Forecast 30 days
+* Bulk Downloading
+* Solar Radiation API
+* Global Weather Alerts / Push notifications
+* Road Risk API
 
 ### Maven coordinates:
 
 ```xml
 <dependency>
-  <groupId>com.github.prominence</groupId>
+    <groupId>com.github.prominence</groupId>
-  <artifactId>openweathermap-api</artifactId>
+    <artifactId>openweathermap-api</artifactId>
-  <version>1.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:1.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()
+        }
+    }
+    ...
+}
 ```
 
 ### Documentation
 * [OpenWeatherMap Java API - 1.0](docs/Release_1.0.md)
+* [OpenWeatherMap Java API - 1.1](docs/Release_1.1.md)
+* [OpenWeatherMap Java API - 1.2](docs/Release_1.2.md)
+* [OpenWeatherMap Java API - 2.0.0](docs/Release_2.0.0.md)
+* [OpenWeatherMap Java API - 2.0.1](docs/Release_2.0.1.md)
+* [OpenWeatherMap Java API - 2.1.0](docs/Release_2.1.0.md)
+* [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 - SNAPSHOT](docs/SNAPSHOT.md)
 
 ### License
 MIT
+
+[ci-shield]: https://api.cirrus-ci.com/github/Prominence/openweathermap-java-api.svg?branch=dev
+[ci-link]: https://api.cirrus-ci.com/github/Prominence/openweathermap-java-api
+
+
+[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
+
+[FOSSA-shield]: https://app.fossa.com/api/projects/git%2Bgithub.com%2FProminence%2Fopenweathermap-java-api.svg?type=shield
+[FOSSA-link]: https://app.fossa.com/projects/git%2Bgithub.com%2FProminence%2Fopenweathermap-java-api?ref=badge_shield

build.gradle

@@ -0,0 +1,122 @@
+plugins {
+    id 'java-library'
+    id 'maven-publish'
+    id 'signing'
+    id 'jacoco'
+}
+
+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'
+
+    annotationProcessor 'com.github.bsideup.jabel:jabel-javac-plugin:0.4.2'
+}
+
+group = 'com.github.prominence'
+version = '3.0.0-SNAPSHOT'
+description = 'Java OpenWeatherMap API'
+
+configure([tasks.compileJava]) {
+    sourceCompatibility = 17 // for the IDE support
+    options.release = 8
+
+    javaCompiler = javaToolchains.compilerFor {
+        languageVersion = JavaLanguageVersion.of(17)
+    }
+}
+
+ext {
+    isReleaseVersion = !version.endsWith("SNAPSHOT")
+}
+
+java {
+    withSourcesJar()
+    withJavadocJar()
+}
+
+test {
+    useJUnitPlatform()
+}
+
+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
+}
+
+jacocoTestReport {
+    dependsOn test // tests are required to run before generating the report
+    reports {
+        csv.required = false
+        xml.required = true
+        xml.outputLocation = layout.buildDirectory.file('reports/jacoco/report.xml')
+        html.outputLocation = layout.buildDirectory.dir('jacocoHtml')
+    }
+}
+

docs/Release_1.0.md

@@ -15,7 +15,7 @@
 ### Gradle coordinates:
 
 ```groovy
-compile('com.github.prominence:openweathermap-api:1.0')
+implementation 'com.github.prominence:openweathermap-api:1.0'
 ```
 
 ### How to use:
@@ -62,7 +62,7 @@ Available requests:
 | `getCoordinates()`        | Returns `Coordinates` instance that contains *latitude* and *longitude* information.                                                                            |
 | `getWeatherStates()`      | Returns list of `WeatherState` instances with the only `getDescription` useful method.                                                                          |
 | `getBase()`               | Returns `String` with some internal information. Example: `cmc stations` - from official documentation.                                                         |
-| `getWeatherInfo()`        | Returns `Weather.WeatherInfo` instance that contains information about temperature, pressure and humidity.                                                      |
+| `getWeatherInfo()`        | Returns `Weather.WeatherInfo` instance that contains information about temperature, atmosphericPressure and humidity.                                                      |
 | `getWind()`               | Returns `Wind` instance that contains information about speed and degree.                                                                                       |
 | `getClouds()`             | Returns `Clouds` instance that contains *cloudiness* percentage information.                                                                                    |
 | `getRain()`               | Returns `Rain` instance that contains information about rain volume for the last 3 hours.                                                                       |
@@ -134,11 +134,11 @@ Available requests:
 | `getMaximumTemperature()`   | Returns maximum temperature from forecasts.                                                |
 | `getByMinimumTemperature()` | Returns `HourlyForecast.Forecast` for the time where temperature is minimal.               |
 | `getByMaximumTemperature()` | Returns `HourlyForecast.Forecast` for the time where temperature is maximal.               |
-| `getAveragePressure()`      | Returns average pressure from forecasts.                                                   |
+| `getAveragePressure()`      | Returns average atmosphericPressure from forecasts.                                                   |
-| `getMinimumPressure()`      | Returns minimum pressure from forecasts.                                                   |
+| `getMinimumPressure()`      | Returns minimum atmosphericPressure from forecasts.                                                   |
-| `getMaximumPressure()`      | Returns maximum pressure from forecasts.                                                   |
+| `getMaximumPressure()`      | Returns maximum atmosphericPressure from forecasts.                                                   |
-| `getByMinimumPressure()`    | Returns `HourlyForecast.Forecast` for the time where pressure is minimal.                  |
+| `getByMinimumPressure()`    | Returns `HourlyForecast.Forecast` for the time where atmosphericPressure is minimal.                  |
-| `getByMaximumPressure()`    | Returns `HourlyForecast.Forecast` for the time where pressure is maximal.                  |
+| `getByMaximumPressure()`    | Returns `HourlyForecast.Forecast` for the time where atmosphericPressure is maximal.                  |
 | `toString()`                | Returns pretty string for the whole available forecast information.                        |
 
 `toString()` output example:
@@ -146,46 +146,46 @@ Available requests:
 City: Pruzhany(622997). Coordinates: latitude=52.5582, longitude=24.4567
 Country: BY
 Forecasts:
-    Time: Tue Jul 17 00:00:00 MSK 2018. Weather: light rain. Temperature: 16.24 ℃. Minimum temperature: 16.24 ℃. Maximum temperature: 17.36 ℃. Pressure: 997.38 hPa. Sea-level pressure: 1018.59 hPa. Ground-level pressure: 997.38 hPa. Humidity: 99%. Cloudiness: 80%. Wind: 2.85 meter/sec, 324 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 00:00:00 MSK 2018. Weather: light rain. Temperature: 16.24 ℃. Minimum temperature: 16.24 ℃. Maximum temperature: 17.36 ℃. Pressure: 997.38 hPa. Sea-level atmosphericPressure: 1018.59 hPa. Ground-level atmosphericPressure: 997.38 hPa. Humidity: 99%. Cloudiness: 80%. Wind: 2.85 meter/sec, 324 degrees. Rain(last 3 hrs): 0 mm
-    Time: Tue Jul 17 03:00:00 MSK 2018. Weather: moderate rain. Temperature: 16.0 ℃. Minimum temperature: 16.0 ℃. Maximum temperature: 16.83 ℃. Pressure: 996.88 hPa. Sea-level pressure: 1017.86 hPa. Ground-level pressure: 996.88 hPa. Humidity: 99%. Cloudiness: 80%. Wind: 1.86 meter/sec, 349 degrees. Rain(last 3 hrs): 3 mm
+    Time: Tue Jul 17 03:00:00 MSK 2018. Weather: moderate rain. Temperature: 16.0 ℃. Minimum temperature: 16.0 ℃. Maximum temperature: 16.83 ℃. Pressure: 996.88 hPa. Sea-level atmosphericPressure: 1017.86 hPa. Ground-level atmosphericPressure: 996.88 hPa. Humidity: 99%. Cloudiness: 80%. Wind: 1.86 meter/sec, 349 degrees. Rain(last 3 hrs): 3 mm
-    Time: Tue Jul 17 06:00:00 MSK 2018. Weather: light rain. Temperature: 15.76 ℃. Minimum temperature: 15.76 ℃. Maximum temperature: 16.31 ℃. Pressure: 996.7 hPa. Sea-level pressure: 1017.72 hPa. Ground-level pressure: 996.7 hPa. Humidity: 94%. Cloudiness: 76%. Wind: 1.62 meter/sec, 113 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 06:00:00 MSK 2018. Weather: light rain. Temperature: 15.76 ℃. Minimum temperature: 15.76 ℃. Maximum temperature: 16.31 ℃. Pressure: 996.7 hPa. Sea-level atmosphericPressure: 1017.72 hPa. Ground-level atmosphericPressure: 996.7 hPa. Humidity: 94%. Cloudiness: 76%. Wind: 1.62 meter/sec, 113 degrees. Rain(last 3 hrs): 0 mm
-    Time: Tue Jul 17 09:00:00 MSK 2018. Weather: light rain. Temperature: 18.23 ℃. Minimum temperature: 18.23 ℃. Maximum temperature: 18.51 ℃. Pressure: 997.17 hPa. Sea-level pressure: 1018.18 hPa. Ground-level pressure: 997.17 hPa. Humidity: 100%. Cloudiness: 76%. Wind: 2.11 meter/sec, 107 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 09:00:00 MSK 2018. Weather: light rain. Temperature: 18.23 ℃. Minimum temperature: 18.23 ℃. Maximum temperature: 18.51 ℃. Pressure: 997.17 hPa. Sea-level atmosphericPressure: 1018.18 hPa. Ground-level atmosphericPressure: 997.17 hPa. Humidity: 100%. Cloudiness: 76%. Wind: 2.11 meter/sec, 107 degrees. Rain(last 3 hrs): 0 mm
-    Time: Tue Jul 17 12:00:00 MSK 2018. Weather: light rain. Temperature: 21.0 ℃. Minimum temperature: 21.0 ℃. Maximum temperature: 21.0 ℃. Pressure: 997.6 hPa. Sea-level pressure: 1018.5 hPa. Ground-level pressure: 997.6 hPa. Humidity: 100%. Cloudiness: 68%. Wind: 2.51 meter/sec, 82 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 12:00:00 MSK 2018. Weather: light rain. Temperature: 21.0 ℃. Minimum temperature: 21.0 ℃. Maximum temperature: 21.0 ℃. Pressure: 997.6 hPa. Sea-level atmosphericPressure: 1018.5 hPa. Ground-level atmosphericPressure: 997.6 hPa. Humidity: 100%. Cloudiness: 68%. Wind: 2.51 meter/sec, 82 degrees. Rain(last 3 hrs): 0 mm
-    Time: Tue Jul 17 15:00:00 MSK 2018. Weather: light rain. Temperature: 21.78 ℃. Minimum temperature: 21.78 ℃. Maximum temperature: 21.78 ℃. Pressure: 997.73 hPa. Sea-level pressure: 1018.66 hPa. Ground-level pressure: 997.73 hPa. Humidity: 92%. Cloudiness: 88%. Wind: 4.05 meter/sec, 78 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 15:00:00 MSK 2018. Weather: light rain. Temperature: 21.78 ℃. Minimum temperature: 21.78 ℃. Maximum temperature: 21.78 ℃. Pressure: 997.73 hPa. Sea-level atmosphericPressure: 1018.66 hPa. Ground-level atmosphericPressure: 997.73 hPa. Humidity: 92%. Cloudiness: 88%. Wind: 4.05 meter/sec, 78 degrees. Rain(last 3 hrs): 0 mm
-    Time: Tue Jul 17 18:00:00 MSK 2018. Weather: light rain. Temperature: 22.9 ℃. Minimum temperature: 22.9 ℃. Maximum temperature: 22.9 ℃. Pressure: 997.66 hPa. Sea-level pressure: 1018.55 hPa. Ground-level pressure: 997.66 hPa. Humidity: 93%. Cloudiness: 68%. Wind: 3.06 meter/sec, 67 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 18:00:00 MSK 2018. Weather: light rain. Temperature: 22.9 ℃. Minimum temperature: 22.9 ℃. Maximum temperature: 22.9 ℃. Pressure: 997.66 hPa. Sea-level atmosphericPressure: 1018.55 hPa. Ground-level atmosphericPressure: 997.66 hPa. Humidity: 93%. Cloudiness: 68%. Wind: 3.06 meter/sec, 67 degrees. Rain(last 3 hrs): 0 mm
-    Time: Tue Jul 17 21:00:00 MSK 2018. Weather: light rain. Temperature: 23.04 ℃. Minimum temperature: 23.04 ℃. Maximum temperature: 23.04 ℃. Pressure: 996.89 hPa. Sea-level pressure: 1017.99 hPa. Ground-level pressure: 996.89 hPa. Humidity: 83%. Cloudiness: 88%. Wind: 3.17 meter/sec, 16 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 21:00:00 MSK 2018. Weather: light rain. Temperature: 23.04 ℃. Minimum temperature: 23.04 ℃. Maximum temperature: 23.04 ℃. Pressure: 996.89 hPa. Sea-level atmosphericPressure: 1017.99 hPa. Ground-level atmosphericPressure: 996.89 hPa. Humidity: 83%. Cloudiness: 88%. Wind: 3.17 meter/sec, 16 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 00:00:00 MSK 2018. Weather: moderate rain. Temperature: 18.5 ℃. Minimum temperature: 18.5 ℃. Maximum temperature: 18.5 ℃. Pressure: 997.33 hPa. Sea-level pressure: 1018.34 hPa. Ground-level pressure: 997.33 hPa. Humidity: 97%. Cloudiness: 44%. Wind: 3.56 meter/sec, 31 degrees. Rain(last 3 hrs): 7 mm
+    Time: Wed Jul 18 00:00:00 MSK 2018. Weather: moderate rain. Temperature: 18.5 ℃. Minimum temperature: 18.5 ℃. Maximum temperature: 18.5 ℃. Pressure: 997.33 hPa. Sea-level atmosphericPressure: 1018.34 hPa. Ground-level atmosphericPressure: 997.33 hPa. Humidity: 97%. Cloudiness: 44%. Wind: 3.56 meter/sec, 31 degrees. Rain(last 3 hrs): 7 mm
-    Time: Wed Jul 18 03:00:00 MSK 2018. Weather: few clouds. Temperature: 18.57 ℃. Minimum temperature: 18.57 ℃. Maximum temperature: 18.57 ℃. Pressure: 996.91 hPa. Sea-level pressure: 1017.87 hPa. Ground-level pressure: 996.91 hPa. Humidity: 95%. Cloudiness: 24%. Wind: 5.26 meter/sec, 44 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 03:00:00 MSK 2018. Weather: few clouds. Temperature: 18.57 ℃. Minimum temperature: 18.57 ℃. Maximum temperature: 18.57 ℃. Pressure: 996.91 hPa. Sea-level atmosphericPressure: 1017.87 hPa. Ground-level atmosphericPressure: 996.91 hPa. Humidity: 95%. Cloudiness: 24%. Wind: 5.26 meter/sec, 44 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 06:00:00 MSK 2018. Weather: few clouds. Temperature: 18.94 ℃. Minimum temperature: 18.94 ℃. Maximum temperature: 18.94 ℃. Pressure: 997.07 hPa. Sea-level pressure: 1018.06 hPa. Ground-level pressure: 997.07 hPa. Humidity: 95%. Cloudiness: 20%. Wind: 4.8 meter/sec, 45 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 06:00:00 MSK 2018. Weather: few clouds. Temperature: 18.94 ℃. Minimum temperature: 18.94 ℃. Maximum temperature: 18.94 ℃. Pressure: 997.07 hPa. Sea-level atmosphericPressure: 1018.06 hPa. Ground-level atmosphericPressure: 997.07 hPa. Humidity: 95%. Cloudiness: 20%. Wind: 4.8 meter/sec, 45 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 09:00:00 MSK 2018. Weather: light rain. Temperature: 20.6 ℃. Minimum temperature: 20.6 ℃. Maximum temperature: 20.6 ℃. Pressure: 997.8 hPa. Sea-level pressure: 1018.66 hPa. Ground-level pressure: 997.8 hPa. Humidity: 97%. Cloudiness: 48%. Wind: 5.56 meter/sec, 54 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 09:00:00 MSK 2018. Weather: light rain. Temperature: 20.6 ℃. Minimum temperature: 20.6 ℃. Maximum temperature: 20.6 ℃. Pressure: 997.8 hPa. Sea-level atmosphericPressure: 1018.66 hPa. Ground-level atmosphericPressure: 997.8 hPa. Humidity: 97%. Cloudiness: 48%. Wind: 5.56 meter/sec, 54 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 12:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.87 ℃. Minimum temperature: 23.87 ℃. Maximum temperature: 23.87 ℃. Pressure: 998.06 hPa. Sea-level pressure: 1019.05 hPa. Ground-level pressure: 998.06 hPa. Humidity: 88%. Cloudiness: 32%. Wind: 5.86 meter/sec, 52 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 12:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.87 ℃. Minimum temperature: 23.87 ℃. Maximum temperature: 23.87 ℃. Pressure: 998.06 hPa. Sea-level atmosphericPressure: 1019.05 hPa. Ground-level atmosphericPressure: 998.06 hPa. Humidity: 88%. Cloudiness: 32%. Wind: 5.86 meter/sec, 52 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 24.67 ℃. Minimum temperature: 24.67 ℃. Maximum temperature: 24.67 ℃. Pressure: 998.51 hPa. Sea-level pressure: 1019.33 hPa. Ground-level pressure: 998.51 hPa. Humidity: 84%. Cloudiness: 36%. Wind: 5.63 meter/sec, 51 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 24.67 ℃. Minimum temperature: 24.67 ℃. Maximum temperature: 24.67 ℃. Pressure: 998.51 hPa. Sea-level atmosphericPressure: 1019.33 hPa. Ground-level atmosphericPressure: 998.51 hPa. Humidity: 84%. Cloudiness: 36%. Wind: 5.63 meter/sec, 51 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 18:00:00 MSK 2018. Weather: scattered clouds. Temperature: 25.15 ℃. Minimum temperature: 25.15 ℃. Maximum temperature: 25.15 ℃. Pressure: 998.79 hPa. Sea-level pressure: 1019.64 hPa. Ground-level pressure: 998.79 hPa. Humidity: 78%. Cloudiness: 44%. Wind: 5.47 meter/sec, 38 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 18:00:00 MSK 2018. Weather: scattered clouds. Temperature: 25.15 ℃. Minimum temperature: 25.15 ℃. Maximum temperature: 25.15 ℃. Pressure: 998.79 hPa. Sea-level atmosphericPressure: 1019.64 hPa. Ground-level atmosphericPressure: 998.79 hPa. Humidity: 78%. Cloudiness: 44%. Wind: 5.47 meter/sec, 38 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 21:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.23 ℃. Minimum temperature: 23.23 ℃. Maximum temperature: 23.23 ℃. Pressure: 999.08 hPa. Sea-level pressure: 1020.04 hPa. Ground-level pressure: 999.08 hPa. Humidity: 75%. Cloudiness: 48%. Wind: 4.62 meter/sec, 25 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 21:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.23 ℃. Minimum temperature: 23.23 ℃. Maximum temperature: 23.23 ℃. Pressure: 999.08 hPa. Sea-level atmosphericPressure: 1020.04 hPa. Ground-level atmosphericPressure: 999.08 hPa. Humidity: 75%. Cloudiness: 48%. Wind: 4.62 meter/sec, 25 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 00:00:00 MSK 2018. Weather: scattered clouds. Temperature: 20.79 ℃. Minimum temperature: 20.79 ℃. Maximum temperature: 20.79 ℃. Pressure: 999.67 hPa. Sea-level pressure: 1020.68 hPa. Ground-level pressure: 999.67 hPa. Humidity: 76%. Cloudiness: 48%. Wind: 4.29 meter/sec, 13 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 00:00:00 MSK 2018. Weather: scattered clouds. Temperature: 20.79 ℃. Minimum temperature: 20.79 ℃. Maximum temperature: 20.79 ℃. Pressure: 999.67 hPa. Sea-level atmosphericPressure: 1020.68 hPa. Ground-level atmosphericPressure: 999.67 hPa. Humidity: 76%. Cloudiness: 48%. Wind: 4.29 meter/sec, 13 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 03:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.45 ℃. Minimum temperature: 19.45 ℃. Maximum temperature: 19.45 ℃. Pressure: 999.95 hPa. Sea-level pressure: 1021.02 hPa. Ground-level pressure: 999.95 hPa. Humidity: 80%. Cloudiness: 48%. Wind: 4.22 meter/sec, 17 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 03:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.45 ℃. Minimum temperature: 19.45 ℃. Maximum temperature: 19.45 ℃. Pressure: 999.95 hPa. Sea-level atmosphericPressure: 1021.02 hPa. Ground-level atmosphericPressure: 999.95 hPa. Humidity: 80%. Cloudiness: 48%. Wind: 4.22 meter/sec, 17 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 06:00:00 MSK 2018. Weather: light rain. Temperature: 18.9 ℃. Minimum temperature: 18.9 ℃. Maximum temperature: 18.9 ℃. Pressure: 1000.6 hPa. Sea-level pressure: 1021.62 hPa. Ground-level pressure: 1000.6 hPa. Humidity: 83%. Cloudiness: 92%. Wind: 4.43 meter/sec, 10 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 06:00:00 MSK 2018. Weather: light rain. Temperature: 18.9 ℃. Minimum temperature: 18.9 ℃. Maximum temperature: 18.9 ℃. Pressure: 1000.6 hPa. Sea-level atmosphericPressure: 1021.62 hPa. Ground-level atmosphericPressure: 1000.6 hPa. Humidity: 83%. Cloudiness: 92%. Wind: 4.43 meter/sec, 10 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 09:00:00 MSK 2018. Weather: light rain. Temperature: 21.37 ℃. Minimum temperature: 21.37 ℃. Maximum temperature: 21.37 ℃. Pressure: 1000.95 hPa. Sea-level pressure: 1022.01 hPa. Ground-level pressure: 1000.95 hPa. Humidity: 87%. Cloudiness: 0%. Wind: 4.36 meter/sec, 6 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 09:00:00 MSK 2018. Weather: light rain. Temperature: 21.37 ℃. Minimum temperature: 21.37 ℃. Maximum temperature: 21.37 ℃. Pressure: 1000.95 hPa. Sea-level atmosphericPressure: 1022.01 hPa. Ground-level atmosphericPressure: 1000.95 hPa. Humidity: 87%. Cloudiness: 0%. Wind: 4.36 meter/sec, 6 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 12:00:00 MSK 2018. Weather: clear sky. Temperature: 23.92 ℃. Minimum temperature: 23.92 ℃. Maximum temperature: 23.92 ℃. Pressure: 1001.5 hPa. Sea-level pressure: 1022.43 hPa. Ground-level pressure: 1001.5 hPa. Humidity: 77%. Cloudiness: 0%. Wind: 5.66 meter/sec, 12 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 12:00:00 MSK 2018. Weather: clear sky. Temperature: 23.92 ℃. Minimum temperature: 23.92 ℃. Maximum temperature: 23.92 ℃. Pressure: 1001.5 hPa. Sea-level atmosphericPressure: 1022.43 hPa. Ground-level atmosphericPressure: 1001.5 hPa. Humidity: 77%. Cloudiness: 0%. Wind: 5.66 meter/sec, 12 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 15:00:00 MSK 2018. Weather: broken clouds. Temperature: 23.7 ℃. Minimum temperature: 23.7 ℃. Maximum temperature: 23.7 ℃. Pressure: 1001.75 hPa. Sea-level pressure: 1022.72 hPa. Ground-level pressure: 1001.75 hPa. Humidity: 72%. Cloudiness: 56%. Wind: 5.87 meter/sec, 349 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 15:00:00 MSK 2018. Weather: broken clouds. Temperature: 23.7 ℃. Minimum temperature: 23.7 ℃. Maximum temperature: 23.7 ℃. Pressure: 1001.75 hPa. Sea-level atmosphericPressure: 1022.72 hPa. Ground-level atmosphericPressure: 1001.75 hPa. Humidity: 72%. Cloudiness: 56%. Wind: 5.87 meter/sec, 349 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 18:00:00 MSK 2018. Weather: broken clouds. Temperature: 23.82 ℃. Minimum temperature: 23.82 ℃. Maximum temperature: 23.82 ℃. Pressure: 1001.55 hPa. Sea-level pressure: 1022.59 hPa. Ground-level pressure: 1001.55 hPa. Humidity: 72%. Cloudiness: 68%. Wind: 5.47 meter/sec, 340 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 18:00:00 MSK 2018. Weather: broken clouds. Temperature: 23.82 ℃. Minimum temperature: 23.82 ℃. Maximum temperature: 23.82 ℃. Pressure: 1001.55 hPa. Sea-level atmosphericPressure: 1022.59 hPa. Ground-level atmosphericPressure: 1001.55 hPa. Humidity: 72%. Cloudiness: 68%. Wind: 5.47 meter/sec, 340 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 21:00:00 MSK 2018. Weather: broken clouds. Temperature: 22.22 ℃. Minimum temperature: 22.22 ℃. Maximum temperature: 22.22 ℃. Pressure: 1001.82 hPa. Sea-level pressure: 1022.93 hPa. Ground-level pressure: 1001.82 hPa. Humidity: 67%. Cloudiness: 76%. Wind: 4.12 meter/sec, 333 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 21:00:00 MSK 2018. Weather: broken clouds. Temperature: 22.22 ℃. Minimum temperature: 22.22 ℃. Maximum temperature: 22.22 ℃. Pressure: 1001.82 hPa. Sea-level atmosphericPressure: 1022.93 hPa. Ground-level atmosphericPressure: 1001.82 hPa. Humidity: 67%. Cloudiness: 76%. Wind: 4.12 meter/sec, 333 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 00:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.76 ℃. Minimum temperature: 19.76 ℃. Maximum temperature: 19.76 ℃. Pressure: 1001.98 hPa. Sea-level pressure: 1023.13 hPa. Ground-level pressure: 1001.98 hPa. Humidity: 76%. Cloudiness: 32%. Wind: 4.11 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 00:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.76 ℃. Minimum temperature: 19.76 ℃. Maximum temperature: 19.76 ℃. Pressure: 1001.98 hPa. Sea-level atmosphericPressure: 1023.13 hPa. Ground-level atmosphericPressure: 1001.98 hPa. Humidity: 76%. Cloudiness: 32%. Wind: 4.11 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 03:00:00 MSK 2018. Weather: clear sky. Temperature: 17.53 ℃. Minimum temperature: 17.53 ℃. Maximum temperature: 17.53 ℃. Pressure: 1001.93 hPa. Sea-level pressure: 1023.13 hPa. Ground-level pressure: 1001.93 hPa. Humidity: 87%. Cloudiness: 8%. Wind: 4.21 meter/sec, 309 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 03:00:00 MSK 2018. Weather: clear sky. Temperature: 17.53 ℃. Minimum temperature: 17.53 ℃. Maximum temperature: 17.53 ℃. Pressure: 1001.93 hPa. Sea-level atmosphericPressure: 1023.13 hPa. Ground-level atmosphericPressure: 1001.93 hPa. Humidity: 87%. Cloudiness: 8%. Wind: 4.21 meter/sec, 309 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 06:00:00 MSK 2018. Weather: scattered clouds. Temperature: 16.83 ℃. Minimum temperature: 16.83 ℃. Maximum temperature: 16.83 ℃. Pressure: 1001.79 hPa. Sea-level pressure: 1022.99 hPa. Ground-level pressure: 1001.79 hPa. Humidity: 91%. Cloudiness: 44%. Wind: 3.65 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 06:00:00 MSK 2018. Weather: scattered clouds. Temperature: 16.83 ℃. Minimum temperature: 16.83 ℃. Maximum temperature: 16.83 ℃. Pressure: 1001.79 hPa. Sea-level atmosphericPressure: 1022.99 hPa. Ground-level atmosphericPressure: 1001.79 hPa. Humidity: 91%. Cloudiness: 44%. Wind: 3.65 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 09:00:00 MSK 2018. Weather: light rain. Temperature: 19.57 ℃. Minimum temperature: 19.57 ℃. Maximum temperature: 19.57 ℃. Pressure: 1001.34 hPa. Sea-level pressure: 1022.41 hPa. Ground-level pressure: 1001.34 hPa. Humidity: 85%. Cloudiness: 8%. Wind: 4.38 meter/sec, 305 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 09:00:00 MSK 2018. Weather: light rain. Temperature: 19.57 ℃. Minimum temperature: 19.57 ℃. Maximum temperature: 19.57 ℃. Pressure: 1001.34 hPa. Sea-level atmosphericPressure: 1022.41 hPa. Ground-level atmosphericPressure: 1001.34 hPa. Humidity: 85%. Cloudiness: 8%. Wind: 4.38 meter/sec, 305 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 12:00:00 MSK 2018. Weather: clear sky. Temperature: 23.5 ℃. Minimum temperature: 23.5 ℃. Maximum temperature: 23.5 ℃. Pressure: 1001.0 hPa. Sea-level pressure: 1021.99 hPa. Ground-level pressure: 1001.0 hPa. Humidity: 85%. Cloudiness: 8%. Wind: 5.36 meter/sec, 299 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 12:00:00 MSK 2018. Weather: clear sky. Temperature: 23.5 ℃. Minimum temperature: 23.5 ℃. Maximum temperature: 23.5 ℃. Pressure: 1001.0 hPa. Sea-level atmosphericPressure: 1021.99 hPa. Ground-level atmosphericPressure: 1001.0 hPa. Humidity: 85%. Cloudiness: 8%. Wind: 5.36 meter/sec, 299 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 25.14 ℃. Minimum temperature: 25.14 ℃. Maximum temperature: 25.14 ℃. Pressure: 1000.5 hPa. Sea-level pressure: 1021.51 hPa. Ground-level pressure: 1000.5 hPa. Humidity: 73%. Cloudiness: 32%. Wind: 6.72 meter/sec, 305 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 25.14 ℃. Minimum temperature: 25.14 ℃. Maximum temperature: 25.14 ℃. Pressure: 1000.5 hPa. Sea-level atmosphericPressure: 1021.51 hPa. Ground-level atmosphericPressure: 1000.5 hPa. Humidity: 73%. Cloudiness: 32%. Wind: 6.72 meter/sec, 305 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 18:00:00 MSK 2018. Weather: overcast clouds. Temperature: 23.56 ℃. Minimum temperature: 23.56 ℃. Maximum temperature: 23.56 ℃. Pressure: 1000.7 hPa. Sea-level pressure: 1021.58 hPa. Ground-level pressure: 1000.7 hPa. Humidity: 66%. Cloudiness: 88%. Wind: 6.57 meter/sec, 317 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 18:00:00 MSK 2018. Weather: overcast clouds. Temperature: 23.56 ℃. Minimum temperature: 23.56 ℃. Maximum temperature: 23.56 ℃. Pressure: 1000.7 hPa. Sea-level atmosphericPressure: 1021.58 hPa. Ground-level atmosphericPressure: 1000.7 hPa. Humidity: 66%. Cloudiness: 88%. Wind: 6.57 meter/sec, 317 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 21:00:00 MSK 2018. Weather: broken clouds. Temperature: 22.41 ℃. Minimum temperature: 22.41 ℃. Maximum temperature: 22.41 ℃. Pressure: 1000.64 hPa. Sea-level pressure: 1021.67 hPa. Ground-level pressure: 1000.64 hPa. Humidity: 68%. Cloudiness: 64%. Wind: 4.31 meter/sec, 326 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 21:00:00 MSK 2018. Weather: broken clouds. Temperature: 22.41 ℃. Minimum temperature: 22.41 ℃. Maximum temperature: 22.41 ℃. Pressure: 1000.64 hPa. Sea-level atmosphericPressure: 1021.67 hPa. Ground-level atmosphericPressure: 1000.64 hPa. Humidity: 68%. Cloudiness: 64%. Wind: 4.31 meter/sec, 326 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 00:00:00 MSK 2018. Weather: broken clouds. Temperature: 20.92 ℃. Minimum temperature: 20.92 ℃. Maximum temperature: 20.92 ℃. Pressure: 1001.06 hPa. Sea-level pressure: 1022.14 hPa. Ground-level pressure: 1001.06 hPa. Humidity: 78%. Cloudiness: 68%. Wind: 3.42 meter/sec, 327 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 00:00:00 MSK 2018. Weather: broken clouds. Temperature: 20.92 ℃. Minimum temperature: 20.92 ℃. Maximum temperature: 20.92 ℃. Pressure: 1001.06 hPa. Sea-level atmosphericPressure: 1022.14 hPa. Ground-level atmosphericPressure: 1001.06 hPa. Humidity: 78%. Cloudiness: 68%. Wind: 3.42 meter/sec, 327 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 03:00:00 MSK 2018. Weather: broken clouds. Temperature: 20.28 ℃. Minimum temperature: 20.28 ℃. Maximum temperature: 20.28 ℃. Pressure: 1001.04 hPa. Sea-level pressure: 1022.13 hPa. Ground-level pressure: 1001.04 hPa. Humidity: 78%. Cloudiness: 76%. Wind: 4.27 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 03:00:00 MSK 2018. Weather: broken clouds. Temperature: 20.28 ℃. Minimum temperature: 20.28 ℃. Maximum temperature: 20.28 ℃. Pressure: 1001.04 hPa. Sea-level atmosphericPressure: 1022.13 hPa. Ground-level atmosphericPressure: 1001.04 hPa. Humidity: 78%. Cloudiness: 76%. Wind: 4.27 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 06:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.11 ℃. Minimum temperature: 19.11 ℃. Maximum temperature: 19.11 ℃. Pressure: 1001.13 hPa. Sea-level pressure: 1022.28 hPa. Ground-level pressure: 1001.13 hPa. Humidity: 74%. Cloudiness: 32%. Wind: 4.96 meter/sec, 308 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 06:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.11 ℃. Minimum temperature: 19.11 ℃. Maximum temperature: 19.11 ℃. Pressure: 1001.13 hPa. Sea-level atmosphericPressure: 1022.28 hPa. Ground-level atmosphericPressure: 1001.13 hPa. Humidity: 74%. Cloudiness: 32%. Wind: 4.96 meter/sec, 308 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 09:00:00 MSK 2018. Weather: few clouds. Temperature: 20.16 ℃. Minimum temperature: 20.16 ℃. Maximum temperature: 20.16 ℃. Pressure: 1001.43 hPa. Sea-level pressure: 1022.62 hPa. Ground-level pressure: 1001.43 hPa. Humidity: 86%. Cloudiness: 20%. Wind: 5.16 meter/sec, 308 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 09:00:00 MSK 2018. Weather: few clouds. Temperature: 20.16 ℃. Minimum temperature: 20.16 ℃. Maximum temperature: 20.16 ℃. Pressure: 1001.43 hPa. Sea-level atmosphericPressure: 1022.62 hPa. Ground-level atmosphericPressure: 1001.43 hPa. Humidity: 86%. Cloudiness: 20%. Wind: 5.16 meter/sec, 308 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 12:00:00 MSK 2018. Weather: few clouds. Temperature: 22.37 ℃. Minimum temperature: 22.37 ℃. Maximum temperature: 22.37 ℃. Pressure: 1001.53 hPa. Sea-level pressure: 1022.62 hPa. Ground-level pressure: 1001.53 hPa. Humidity: 88%. Cloudiness: 20%. Wind: 5.56 meter/sec, 307 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 12:00:00 MSK 2018. Weather: few clouds. Temperature: 22.37 ℃. Minimum temperature: 22.37 ℃. Maximum temperature: 22.37 ℃. Pressure: 1001.53 hPa. Sea-level atmosphericPressure: 1022.62 hPa. Ground-level atmosphericPressure: 1001.53 hPa. Humidity: 88%. Cloudiness: 20%. Wind: 5.56 meter/sec, 307 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 22.85 ℃. Minimum temperature: 22.85 ℃. Maximum temperature: 22.85 ℃. Pressure: 1001.63 hPa. Sea-level pressure: 1022.65 hPa. Ground-level pressure: 1001.63 hPa. Humidity: 81%. Cloudiness: 44%. Wind: 5.46 meter/sec, 314 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 22.85 ℃. Minimum temperature: 22.85 ℃. Maximum temperature: 22.85 ℃. Pressure: 1001.63 hPa. Sea-level atmosphericPressure: 1022.65 hPa. Ground-level atmosphericPressure: 1001.63 hPa. Humidity: 81%. Cloudiness: 44%. Wind: 5.46 meter/sec, 314 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 18:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.79 ℃. Minimum temperature: 23.79 ℃. Maximum temperature: 23.79 ℃. Pressure: 1001.53 hPa. Sea-level pressure: 1022.53 hPa. Ground-level pressure: 1001.53 hPa. Humidity: 72%. Cloudiness: 32%. Wind: 5.56 meter/sec, 313 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 18:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.79 ℃. Minimum temperature: 23.79 ℃. Maximum temperature: 23.79 ℃. Pressure: 1001.53 hPa. Sea-level atmosphericPressure: 1022.53 hPa. Ground-level atmosphericPressure: 1001.53 hPa. Humidity: 72%. Cloudiness: 32%. Wind: 5.56 meter/sec, 313 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 21:00:00 MSK 2018. Weather: scattered clouds. Temperature: 22.56 ℃. Minimum temperature: 22.56 ℃. Maximum temperature: 22.56 ℃. Pressure: 1001.72 hPa. Sea-level pressure: 1022.7 hPa. Ground-level pressure: 1001.72 hPa. Humidity: 66%. Cloudiness: 48%. Wind: 3.96 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 21:00:00 MSK 2018. Weather: scattered clouds. Temperature: 22.56 ℃. Minimum temperature: 22.56 ℃. Maximum temperature: 22.56 ℃. Pressure: 1001.72 hPa. Sea-level atmosphericPressure: 1022.7 hPa. Ground-level atmosphericPressure: 1001.72 hPa. Humidity: 66%. Cloudiness: 48%. Wind: 3.96 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
 ```
 
 `Forecast`'s useful public methods(setters are not listed):
@@ -194,7 +194,7 @@ Forecasts:
 |-----------------------------|------------------------------------------------------------------------------------------------------------------|
 | `getDataCalculationTime()`  | Returns `long` value that represents data calculation timestamp.                                                 |
 | `getDataCalculationDate()`  | Returns data calculation time in `Date` representation.                                                          |
-| `getWeatherInfo()`          | Returns `HourlyForecast.WeatherInfo` instance that contains information about temperature, pressure and humidity.|
+| `getWeatherInfo()`          | Returns `HourlyForecast.WeatherInfo` instance that contains information about temperature, atmosphericPressure and humidity.|
 | `getWeatherStates()`        | Returns list of `WeatherState` instances with the only `getDescription` useful method.                           |
 | `getClouds()`               | Returns `Clouds` instance that contains *cloudiness* percentage information.                                     |
 | `getWind()`                 | Returns `Wind` instance that contains information about speed and degree.                                        |

docs/Release_1.1.md

@@ -0,0 +1,390 @@
+### Implemented features:
+* Current weather data
+* 5 day / 3 hour forecast
+* 16 day / daily forecast
+* UV Index
+* Air Pollution
+
+### Maven coordinates:
+
+```xml
+<dependency>
+  <groupId>com.github.prominence</groupId>
+  <artifactId>openweathermap-api</artifactId>
+  <version>1.1</version>
+</dependency>
+```
+
+### Gradle coordinates:
+
+```groovy
+implementation 'com.github.prominence:openweathermap-api:1.1'
+```
+
+### How to use:
+
+Firstly, you need to create the instance of `OpenWeatherMapManager` class:
+```java
+OpenWeatherMapManager openWeatherManager = new OpenWeatherMapManager(API_TOKEN);
+```
+where `API_TOKEN` is your token([you can get it here](https://home.openweathermap.org/api_keys)) as `String`.
+
+Currently available methods:
+* `getWeatherRequester()`
+* `getHourlyForecastRequester()`
+* `getDailyForecastRequester()`
+* `getUltravioletIndexRequester()`
+* `getAirPollutionRequester()`
+
+#### Current weather data
+First step is retrieving `WeatherRequester` instance:
+```java
+OpenWeatherMapManager openWeatherManager = new OpenWeatherMapManager(API_TOKEN);
+WeatherRequester weatherRequester = openWeatherManager.getWeatherRequester();
+```
+after you are able to set preferable options(via chain methods) and execute appropriate request:
+```
+Weather weatherResponse = weatherRequester
+    .setLanguage(Language.ENGLISH)
+    .setUnitSystem(Unit.METRIC_SYSTEM)
+    .setAccuracy(Accuracy.ACCURATE)
+    .getByCityName("Minsk");
+```
+*Language*, *UnitSystem* and *Accuracy* settings will be described below.
+
+Available requests:
+* `getByCityId(String cityId)`
+* `getByCityName(String cityName)`
+* `getByCoordinates(double latitude, double longitude)`
+* `getByCoordinates(Coordinates coordinates)`
+* `getByZIPCode(String zipCode, String countryCode)`
+
+`Weather`'s useful public methods(setters are not listed):
+
+| Method                    | Description                                                                                                                                                     |
+|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `getCityId()`             | Returns city ID. Example: `625144` for Minsk.                                                                                                                   |
+| `getCityName()`           | Returns city name. Example: `Minsk`.                                                                                                                            |
+| `getCoordinates()`        | Returns `Coordinates` instance that contains *latitude* and *longitude* information.                                                                            |
+| `getWeatherStates()`      | Returns list of `WeatherState` instances with the only `getDescription` useful method.                                                                          |
+| `getBase()`               | Returns `String` with some internal information. Example: `cmc stations` - from official documentation.                                                         |
+| `getWeatherInfo()`        | Returns `Weather.WeatherInfo` instance that contains information about temperature, atmosphericPressure and humidity.                                                      |
+| `getWind()`               | Returns `Wind` instance that contains information about speed and degree.                                                                                       |
+| `getClouds()`             | Returns `Clouds` instance that contains *cloudiness* percentage information.                                                                                    |
+| `getRain()`               | Returns `Rain` instance that contains information about rain volume for the last 3 hours.                                                                       |
+| `getSnow()`               | Returns `Snow` instance that contains information about snow volume for the last 3 hours.                                                                       |
+| `getDataCalculationTime()`| Returns `long` value that represents data calculation timestamp.                                                                                                |
+| `getWeatherSystemInfo()`  | Returns `Weather.WeatherSystemInfo` instance that contains internal information. There is also an information about country, sunrise and sunset time.           |
+| `getResponseCode()`       | Returns OpenWeatherMap response code. Internal information.                                                                                                     |
+| `getCountry()`            | An alias for `getWeatherSystemInfo().getCountry()`.                                                                                                             |
+| `getWeatherDescription()` | An alias for `getWeatherStates.get(0).getDescription()`.                                                                                                        |
+| `getDataCalculationDate()`| Returns data calculation time in `Date` representation.                                                                                                         |
+| `getTemperature()`        | An alias for `getWeatherInfo().getTemperature()`.                                                                                                               |
+| `getTemperatureUnit()`    | An alias for `getWeatherInfo().getTemperatureUnit()`.                                                                                                           |
+| `getPressure()`           | An alias for `getWeatherInfo().getPressure()`.                                                                                                                  |
+| `getPressureUnit()`       | An alias for `getWeatherInfo().getPressureUnit()`.                                                                                                              |
+| `getHumidityPercentage()` | An alias for `getWeatherInfo().getHumidity()`.                                                                                                                  |
+| `toString()`              | Returns pretty string for the whole available weather information.                                                                                              |
+
+`toString()` output example:
+```
+City: Minsk(625144). Coordinates: latitude=53.9, longitude=27.56
+Country: BY
+Sunrise: Sun Jul 15 04:58:27 MSK 2018
+Sunset: Sun Jul 15 21:32:19 MSK 2018
+Weather: light intensity shower rain
+Temperature: 17.0 ℃. Minimum temparature: 17.0 ℃. Maximum temperature: 17.0 ℃
+Humidity: 93%
+Pressure: 1008 hPa
+Wind: 2.0 meter/sec, 20 degrees
+Cloudiness: 75%
+Data calculation time: Mon Jul 16 00:00:00 MSK 2018
+```
+
+#### 5 day / 3 hour forecast
+First step is retrieving `HourlyForecastRequester` instance:
+```java
+OpenWeatherMapManager openWeatherManager = new OpenWeatherMapManager(API_TOKEN);
+HourlyForecastRequester forecastRequester = openWeatherManager.getHourlyForecastRequester();
+```
+after you are able to set preferable options(via chain methods) and execute appropriate request:
+```
+HourlyForecast forecastResponse = forecastRequester
+    .setLanguage(Language.ENGLISH)
+    .setUnitSystem(Unit.METRIC_SYSTEM)
+    .setAccuracy(Accuracy.ACCURATE)
+    .getByCityName("Pruzhany");
+```
+*Language*, *UnitSystem* and *Accuracy* settings will be described below.
+
+Available requests:
+* `getByCityId(String cityId)`
+* `getByCityName(String cityName)`
+* `getByCoordinates(double latitude, double longitude)`
+* `getByCoordinates(Coordinates coordinates)`
+* `getByZIPCode(String zipCode, String countryCode)`
+
+`HourlyForecast`'s useful public methods(setters are not listed):
+
+| Method                      | Description                                                                                |
+|-----------------------------|--------------------------------------------------------------------------------------------|
+| `getCityId()`               | Returns city ID. Example: `625144` for Minsk.                                              |
+| `getCityName()`             | Returns city name. Example: `Minsk`.                                                       |
+| `getCoordinates()`          | Returns `Coordinates` instance that contains *latitude* and *longitude* information.       |
+| `getCityInfo()`             | Returns `CityInfo` instance that contains information about city.                          |
+| `getResponseCode()`         | Returns OpenWeatherMap response code. Internal information.                                |
+| `getCountry()`              | An alias for `getCityInfo().getCountry()`.                                                 |
+| `getForecasts()`            | Returns `List<HourlyForecast.Forecast>` collection with all forecast information.          |
+| `getAverageTemperature()`   | Returns average temperature from forecasts.                                                |
+| `getMinimumTemperature()`   | Returns minimum temperature from forecasts.                                                |
+| `getMaximumTemperature()`   | Returns maximum temperature from forecasts.                                                |
+| `getByMinimumTemperature()` | Returns `HourlyForecast.Forecast` for the time where temperature is minimal.               |
+| `getByMaximumTemperature()` | Returns `HourlyForecast.Forecast` for the time where temperature is maximal.               |
+| `getAveragePressure()`      | Returns average atmosphericPressure from forecasts.                                                   |
+| `getMinimumPressure()`      | Returns minimum atmosphericPressure from forecasts.                                                   |
+| `getMaximumPressure()`      | Returns maximum atmosphericPressure from forecasts.                                                   |
+| `getByMinimumPressure()`    | Returns `HourlyForecast.Forecast` for the time where atmosphericPressure is minimal.                  |
+| `getByMaximumPressure()`    | Returns `HourlyForecast.Forecast` for the time where atmosphericPressure is maximal.                  |
+| `toString()`                | Returns pretty string for the whole available forecast information.                        |
+
+`toString()` output example:
+```
+City: Pruzhany(622997). Coordinates: latitude=52.5582, longitude=24.4567
+Country: BY
+Forecasts:
+    Time: Tue Jul 17 00:00:00 MSK 2018. Weather: light rain. Temperature: 16.24 ℃. Minimum temperature: 16.24 ℃. Maximum temperature: 17.36 ℃. Pressure: 997.38 hPa. Sea-level atmosphericPressure: 1018.59 hPa. Ground-level atmosphericPressure: 997.38 hPa. Humidity: 99%. Cloudiness: 80%. Wind: 2.85 meter/sec, 324 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 03:00:00 MSK 2018. Weather: moderate rain. Temperature: 16.0 ℃. Minimum temperature: 16.0 ℃. Maximum temperature: 16.83 ℃. Pressure: 996.88 hPa. Sea-level atmosphericPressure: 1017.86 hPa. Ground-level atmosphericPressure: 996.88 hPa. Humidity: 99%. Cloudiness: 80%. Wind: 1.86 meter/sec, 349 degrees. Rain(last 3 hrs): 3 mm
+    Time: Tue Jul 17 06:00:00 MSK 2018. Weather: light rain. Temperature: 15.76 ℃. Minimum temperature: 15.76 ℃. Maximum temperature: 16.31 ℃. Pressure: 996.7 hPa. Sea-level atmosphericPressure: 1017.72 hPa. Ground-level atmosphericPressure: 996.7 hPa. Humidity: 94%. Cloudiness: 76%. Wind: 1.62 meter/sec, 113 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 09:00:00 MSK 2018. Weather: light rain. Temperature: 18.23 ℃. Minimum temperature: 18.23 ℃. Maximum temperature: 18.51 ℃. Pressure: 997.17 hPa. Sea-level atmosphericPressure: 1018.18 hPa. Ground-level atmosphericPressure: 997.17 hPa. Humidity: 100%. Cloudiness: 76%. Wind: 2.11 meter/sec, 107 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 12:00:00 MSK 2018. Weather: light rain. Temperature: 21.0 ℃. Minimum temperature: 21.0 ℃. Maximum temperature: 21.0 ℃. Pressure: 997.6 hPa. Sea-level atmosphericPressure: 1018.5 hPa. Ground-level atmosphericPressure: 997.6 hPa. Humidity: 100%. Cloudiness: 68%. Wind: 2.51 meter/sec, 82 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 15:00:00 MSK 2018. Weather: light rain. Temperature: 21.78 ℃. Minimum temperature: 21.78 ℃. Maximum temperature: 21.78 ℃. Pressure: 997.73 hPa. Sea-level atmosphericPressure: 1018.66 hPa. Ground-level atmosphericPressure: 997.73 hPa. Humidity: 92%. Cloudiness: 88%. Wind: 4.05 meter/sec, 78 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 18:00:00 MSK 2018. Weather: light rain. Temperature: 22.9 ℃. Minimum temperature: 22.9 ℃. Maximum temperature: 22.9 ℃. Pressure: 997.66 hPa. Sea-level atmosphericPressure: 1018.55 hPa. Ground-level atmosphericPressure: 997.66 hPa. Humidity: 93%. Cloudiness: 68%. Wind: 3.06 meter/sec, 67 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 21:00:00 MSK 2018. Weather: light rain. Temperature: 23.04 ℃. Minimum temperature: 23.04 ℃. Maximum temperature: 23.04 ℃. Pressure: 996.89 hPa. Sea-level atmosphericPressure: 1017.99 hPa. Ground-level atmosphericPressure: 996.89 hPa. Humidity: 83%. Cloudiness: 88%. Wind: 3.17 meter/sec, 16 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 00:00:00 MSK 2018. Weather: moderate rain. Temperature: 18.5 ℃. Minimum temperature: 18.5 ℃. Maximum temperature: 18.5 ℃. Pressure: 997.33 hPa. Sea-level atmosphericPressure: 1018.34 hPa. Ground-level atmosphericPressure: 997.33 hPa. Humidity: 97%. Cloudiness: 44%. Wind: 3.56 meter/sec, 31 degrees. Rain(last 3 hrs): 7 mm
+    Time: Wed Jul 18 03:00:00 MSK 2018. Weather: few clouds. Temperature: 18.57 ℃. Minimum temperature: 18.57 ℃. Maximum temperature: 18.57 ℃. Pressure: 996.91 hPa. Sea-level atmosphericPressure: 1017.87 hPa. Ground-level atmosphericPressure: 996.91 hPa. Humidity: 95%. Cloudiness: 24%. Wind: 5.26 meter/sec, 44 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 06:00:00 MSK 2018. Weather: few clouds. Temperature: 18.94 ℃. Minimum temperature: 18.94 ℃. Maximum temperature: 18.94 ℃. Pressure: 997.07 hPa. Sea-level atmosphericPressure: 1018.06 hPa. Ground-level atmosphericPressure: 997.07 hPa. Humidity: 95%. Cloudiness: 20%. Wind: 4.8 meter/sec, 45 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 09:00:00 MSK 2018. Weather: light rain. Temperature: 20.6 ℃. Minimum temperature: 20.6 ℃. Maximum temperature: 20.6 ℃. Pressure: 997.8 hPa. Sea-level atmosphericPressure: 1018.66 hPa. Ground-level atmosphericPressure: 997.8 hPa. Humidity: 97%. Cloudiness: 48%. Wind: 5.56 meter/sec, 54 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 12:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.87 ℃. Minimum temperature: 23.87 ℃. Maximum temperature: 23.87 ℃. Pressure: 998.06 hPa. Sea-level atmosphericPressure: 1019.05 hPa. Ground-level atmosphericPressure: 998.06 hPa. Humidity: 88%. Cloudiness: 32%. Wind: 5.86 meter/sec, 52 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 24.67 ℃. Minimum temperature: 24.67 ℃. Maximum temperature: 24.67 ℃. Pressure: 998.51 hPa. Sea-level atmosphericPressure: 1019.33 hPa. Ground-level atmosphericPressure: 998.51 hPa. Humidity: 84%. Cloudiness: 36%. Wind: 5.63 meter/sec, 51 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 18:00:00 MSK 2018. Weather: scattered clouds. Temperature: 25.15 ℃. Minimum temperature: 25.15 ℃. Maximum temperature: 25.15 ℃. Pressure: 998.79 hPa. Sea-level atmosphericPressure: 1019.64 hPa. Ground-level atmosphericPressure: 998.79 hPa. Humidity: 78%. Cloudiness: 44%. Wind: 5.47 meter/sec, 38 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 21:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.23 ℃. Minimum temperature: 23.23 ℃. Maximum temperature: 23.23 ℃. Pressure: 999.08 hPa. Sea-level atmosphericPressure: 1020.04 hPa. Ground-level atmosphericPressure: 999.08 hPa. Humidity: 75%. Cloudiness: 48%. Wind: 4.62 meter/sec, 25 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 00:00:00 MSK 2018. Weather: scattered clouds. Temperature: 20.79 ℃. Minimum temperature: 20.79 ℃. Maximum temperature: 20.79 ℃. Pressure: 999.67 hPa. Sea-level atmosphericPressure: 1020.68 hPa. Ground-level atmosphericPressure: 999.67 hPa. Humidity: 76%. Cloudiness: 48%. Wind: 4.29 meter/sec, 13 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 03:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.45 ℃. Minimum temperature: 19.45 ℃. Maximum temperature: 19.45 ℃. Pressure: 999.95 hPa. Sea-level atmosphericPressure: 1021.02 hPa. Ground-level atmosphericPressure: 999.95 hPa. Humidity: 80%. Cloudiness: 48%. Wind: 4.22 meter/sec, 17 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 06:00:00 MSK 2018. Weather: light rain. Temperature: 18.9 ℃. Minimum temperature: 18.9 ℃. Maximum temperature: 18.9 ℃. Pressure: 1000.6 hPa. Sea-level atmosphericPressure: 1021.62 hPa. Ground-level atmosphericPressure: 1000.6 hPa. Humidity: 83%. Cloudiness: 92%. Wind: 4.43 meter/sec, 10 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 09:00:00 MSK 2018. Weather: light rain. Temperature: 21.37 ℃. Minimum temperature: 21.37 ℃. Maximum temperature: 21.37 ℃. Pressure: 1000.95 hPa. Sea-level atmosphericPressure: 1022.01 hPa. Ground-level atmosphericPressure: 1000.95 hPa. Humidity: 87%. Cloudiness: 0%. Wind: 4.36 meter/sec, 6 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 12:00:00 MSK 2018. Weather: clear sky. Temperature: 23.92 ℃. Minimum temperature: 23.92 ℃. Maximum temperature: 23.92 ℃. Pressure: 1001.5 hPa. Sea-level atmosphericPressure: 1022.43 hPa. Ground-level atmosphericPressure: 1001.5 hPa. Humidity: 77%. Cloudiness: 0%. Wind: 5.66 meter/sec, 12 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 15:00:00 MSK 2018. Weather: broken clouds. Temperature: 23.7 ℃. Minimum temperature: 23.7 ℃. Maximum temperature: 23.7 ℃. Pressure: 1001.75 hPa. Sea-level atmosphericPressure: 1022.72 hPa. Ground-level atmosphericPressure: 1001.75 hPa. Humidity: 72%. Cloudiness: 56%. Wind: 5.87 meter/sec, 349 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 18:00:00 MSK 2018. Weather: broken clouds. Temperature: 23.82 ℃. Minimum temperature: 23.82 ℃. Maximum temperature: 23.82 ℃. Pressure: 1001.55 hPa. Sea-level atmosphericPressure: 1022.59 hPa. Ground-level atmosphericPressure: 1001.55 hPa. Humidity: 72%. Cloudiness: 68%. Wind: 5.47 meter/sec, 340 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 21:00:00 MSK 2018. Weather: broken clouds. Temperature: 22.22 ℃. Minimum temperature: 22.22 ℃. Maximum temperature: 22.22 ℃. Pressure: 1001.82 hPa. Sea-level atmosphericPressure: 1022.93 hPa. Ground-level atmosphericPressure: 1001.82 hPa. Humidity: 67%. Cloudiness: 76%. Wind: 4.12 meter/sec, 333 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 00:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.76 ℃. Minimum temperature: 19.76 ℃. Maximum temperature: 19.76 ℃. Pressure: 1001.98 hPa. Sea-level atmosphericPressure: 1023.13 hPa. Ground-level atmosphericPressure: 1001.98 hPa. Humidity: 76%. Cloudiness: 32%. Wind: 4.11 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 03:00:00 MSK 2018. Weather: clear sky. Temperature: 17.53 ℃. Minimum temperature: 17.53 ℃. Maximum temperature: 17.53 ℃. Pressure: 1001.93 hPa. Sea-level atmosphericPressure: 1023.13 hPa. Ground-level atmosphericPressure: 1001.93 hPa. Humidity: 87%. Cloudiness: 8%. Wind: 4.21 meter/sec, 309 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 06:00:00 MSK 2018. Weather: scattered clouds. Temperature: 16.83 ℃. Minimum temperature: 16.83 ℃. Maximum temperature: 16.83 ℃. Pressure: 1001.79 hPa. Sea-level atmosphericPressure: 1022.99 hPa. Ground-level atmosphericPressure: 1001.79 hPa. Humidity: 91%. Cloudiness: 44%. Wind: 3.65 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 09:00:00 MSK 2018. Weather: light rain. Temperature: 19.57 ℃. Minimum temperature: 19.57 ℃. Maximum temperature: 19.57 ℃. Pressure: 1001.34 hPa. Sea-level atmosphericPressure: 1022.41 hPa. Ground-level atmosphericPressure: 1001.34 hPa. Humidity: 85%. Cloudiness: 8%. Wind: 4.38 meter/sec, 305 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 12:00:00 MSK 2018. Weather: clear sky. Temperature: 23.5 ℃. Minimum temperature: 23.5 ℃. Maximum temperature: 23.5 ℃. Pressure: 1001.0 hPa. Sea-level atmosphericPressure: 1021.99 hPa. Ground-level atmosphericPressure: 1001.0 hPa. Humidity: 85%. Cloudiness: 8%. Wind: 5.36 meter/sec, 299 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 25.14 ℃. Minimum temperature: 25.14 ℃. Maximum temperature: 25.14 ℃. Pressure: 1000.5 hPa. Sea-level atmosphericPressure: 1021.51 hPa. Ground-level atmosphericPressure: 1000.5 hPa. Humidity: 73%. Cloudiness: 32%. Wind: 6.72 meter/sec, 305 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 18:00:00 MSK 2018. Weather: overcast clouds. Temperature: 23.56 ℃. Minimum temperature: 23.56 ℃. Maximum temperature: 23.56 ℃. Pressure: 1000.7 hPa. Sea-level atmosphericPressure: 1021.58 hPa. Ground-level atmosphericPressure: 1000.7 hPa. Humidity: 66%. Cloudiness: 88%. Wind: 6.57 meter/sec, 317 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 21:00:00 MSK 2018. Weather: broken clouds. Temperature: 22.41 ℃. Minimum temperature: 22.41 ℃. Maximum temperature: 22.41 ℃. Pressure: 1000.64 hPa. Sea-level atmosphericPressure: 1021.67 hPa. Ground-level atmosphericPressure: 1000.64 hPa. Humidity: 68%. Cloudiness: 64%. Wind: 4.31 meter/sec, 326 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 00:00:00 MSK 2018. Weather: broken clouds. Temperature: 20.92 ℃. Minimum temperature: 20.92 ℃. Maximum temperature: 20.92 ℃. Pressure: 1001.06 hPa. Sea-level atmosphericPressure: 1022.14 hPa. Ground-level atmosphericPressure: 1001.06 hPa. Humidity: 78%. Cloudiness: 68%. Wind: 3.42 meter/sec, 327 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 03:00:00 MSK 2018. Weather: broken clouds. Temperature: 20.28 ℃. Minimum temperature: 20.28 ℃. Maximum temperature: 20.28 ℃. Pressure: 1001.04 hPa. Sea-level atmosphericPressure: 1022.13 hPa. Ground-level atmosphericPressure: 1001.04 hPa. Humidity: 78%. Cloudiness: 76%. Wind: 4.27 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 06:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.11 ℃. Minimum temperature: 19.11 ℃. Maximum temperature: 19.11 ℃. Pressure: 1001.13 hPa. Sea-level atmosphericPressure: 1022.28 hPa. Ground-level atmosphericPressure: 1001.13 hPa. Humidity: 74%. Cloudiness: 32%. Wind: 4.96 meter/sec, 308 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 09:00:00 MSK 2018. Weather: few clouds. Temperature: 20.16 ℃. Minimum temperature: 20.16 ℃. Maximum temperature: 20.16 ℃. Pressure: 1001.43 hPa. Sea-level atmosphericPressure: 1022.62 hPa. Ground-level atmosphericPressure: 1001.43 hPa. Humidity: 86%. Cloudiness: 20%. Wind: 5.16 meter/sec, 308 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 12:00:00 MSK 2018. Weather: few clouds. Temperature: 22.37 ℃. Minimum temperature: 22.37 ℃. Maximum temperature: 22.37 ℃. Pressure: 1001.53 hPa. Sea-level atmosphericPressure: 1022.62 hPa. Ground-level atmosphericPressure: 1001.53 hPa. Humidity: 88%. Cloudiness: 20%. Wind: 5.56 meter/sec, 307 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 22.85 ℃. Minimum temperature: 22.85 ℃. Maximum temperature: 22.85 ℃. Pressure: 1001.63 hPa. Sea-level atmosphericPressure: 1022.65 hPa. Ground-level atmosphericPressure: 1001.63 hPa. Humidity: 81%. Cloudiness: 44%. Wind: 5.46 meter/sec, 314 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 18:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.79 ℃. Minimum temperature: 23.79 ℃. Maximum temperature: 23.79 ℃. Pressure: 1001.53 hPa. Sea-level atmosphericPressure: 1022.53 hPa. Ground-level atmosphericPressure: 1001.53 hPa. Humidity: 72%. Cloudiness: 32%. Wind: 5.56 meter/sec, 313 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 21:00:00 MSK 2018. Weather: scattered clouds. Temperature: 22.56 ℃. Minimum temperature: 22.56 ℃. Maximum temperature: 22.56 ℃. Pressure: 1001.72 hPa. Sea-level atmosphericPressure: 1022.7 hPa. Ground-level atmosphericPressure: 1001.72 hPa. Humidity: 66%. Cloudiness: 48%. Wind: 3.96 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
+```
+
+`HourlyForecast.Forecast`'s useful public methods(setters are not listed):
+
+| Method                      | Description                                                                                                      |
+|-----------------------------|------------------------------------------------------------------------------------------------------------------|
+| `getDataCalculationTime()`  | Returns `long` value that represents data calculation timestamp.                                                 |
+| `getDataCalculationDate()`  | Returns data calculation time in `Date` representation.                                                          |
+| `getWeatherInfo()`          | Returns `HourlyForecast.WeatherInfo` instance that contains information about temperature, atmosphericPressure and humidity.|
+| `getWeatherStates()`        | Returns list of `WeatherState` instances with the only `getDescription` useful method.                           |
+| `getClouds()`               | Returns `Clouds` instance that contains *cloudiness* percentage information.                                     |
+| `getWind()`                 | Returns `Wind` instance that contains information about speed and degree.                                        |
+| `getSnow()`                 | Returns `Snow` instance that contains information about snow volume for the last 3 hours.                        |
+| `getRain()`                 | Returns `Rain` instance that contains information about rain volume for the last 3 hours.                        |
+| `getSystemInfo()`           | Returns `HourlyForecast.ForecastSystemInfo` instance with internal information.                                  |
+| `getDt_txt()`               | Returns `String` value that represents data calculation time.                                                    |
+| `toString()`                | Returns pretty string for the whole available forecast information.                                              |
+
+#### 16 day / daily forecast
+First step is retrieving `DailyForecastRequester` instance:
+```java
+OpenWeatherMapManager openWeatherManager = new OpenWeatherMapManager(API_TOKEN);
+DailyForecastRequester forecastRequester = openWeatherManager.getDailyForecastRequester();
+```
+after you are able to set preferable options(via chain methods) and execute appropriate request:
+```
+DailyForecast forecastResponse = forecastRequester
+    .setLanguage(Language.ENGLISH)
+    .setUnitSystem(Unit.METRIC_SYSTEM)
+    .setAccuracy(Accuracy.ACCURATE)
+    .getByCityName("Pruzhany");
+```
+*Language*, *UnitSystem* and *Accuracy* settings will be described below.
+
+Available requests:
+* `getByCityId(String cityId)`
+* `getByCityName(String cityName)`
+* `getByCoordinates(double latitude, double longitude)`
+* `getByCoordinates(Coordinates coordinates)`
+* `getByZIPCode(String zipCode, String countryCode)`
+
+`DailyForecast`'s useful public methods(setters are not listed):
+
+| Method                      | Description                                                                                |
+|-----------------------------|--------------------------------------------------------------------------------------------|
+| `getCityId()`               | Returns city ID. Example: `625144` for Minsk.                                              |
+| `getCityName()`             | Returns city name. Example: `Minsk`.                                                       |
+| `getCoordinates()`          | Returns `Coordinates` instance that contains *latitude* and *longitude* information.       |
+| `getCityInfo()`             | Returns `CityInfo` instance that contains information about city.                          |
+| `getResponseCode()`         | Returns OpenWeatherMap response code. Internal information.                                |
+| `getCountry()`              | An alias for `getCityInfo().getCountry()`.                                                 |
+| `getForecasts()`            | Returns `List<HourlyForecast.Forecast>` collection with all forecast information.          |
+| `toString()`                | Returns pretty string for the whole available forecast information.                        |
+
+`DailyForecast.Forecast`'s useful public methods(setters are not listed):
+
+| Method                      | Description                                                                                                      |
+|-----------------------------|------------------------------------------------------------------------------------------------------------------|
+| `getDataCalculationTime()`  | Returns `long` value that represents data calculation timestamp.                                                 |
+| `getDataCalculationDate()`  | Returns data calculation time in `Date` representation.                                                          |
+| `getTemperature()`          | Returns `DailyForecast.Forecast.Temperature` instance that contains information about temperature(avg, min, max).|
+| `getWeatherStates()`        | Returns list of `WeatherState` instances with the only `getDescription` useful method.                           |
+| `getCloudiness()`           | Returns *cloudiness* percentage information.                                                                     |
+| `getHumidity()`             | Returns *humidity* percentage information.                                                                       |
+| `getWindSpeed()`            | Returns wind's speed.                                                                                            |
+| `getWindDegrees()`          | Returns wind's degree.                                                                                           |
+| `getWindUnit()`             | Returns wind's unit.                                                                                             |
+| `getPressure()`             | Returns atmosphericPressure value.                                                                                          |
+| `getPressureUnit()`         | Returns atmosphericPressure's unit.                                                                                         |
+| `toString()`                | Returns pretty string for the whole available forecast information.                                              |
+
+#### UV Index
+
+First step is retrieving `UltravioletIndexRequester` instance:
+```java
+OpenWeatherMapManager openWeatherMapManager = new OpenWeatherMapManager(API_TOKEN);
+UltravioletIndexRequester requester = openWeatherMapManager.getUltravioletIndexRequester();
+```
+after you need to set coordinates and execute appropriate request:
+```
+UltravioletIndex uvResponse = requester
+    .setCoodrinates(55.33f, 24.27f)
+    .getCurrentUVIndex();
+```
+
+Available requests:
+* `getCurrentUVIndex()`
+* `getUVIndexForecast(int amountOfDays)`
+* `getUVIndexByPeriod(Date from, Date to)`
+
+`UltravioletIndex`'s useful public methods(setters are not listed):
+
+| Method                    | Description                                                   |
+|---------------------------|---------------------------------------------------------------|
+| `getLatitude()`           | Returns latitude.                                             |
+| `getLongitude()`          | Returns longitude.                                            |
+| `getDateISO()`            | Returns ISO date in String representation.                    |
+| `getDateTimestamp()`      | Returns date timestamp.                                       |
+| `getValue()`              | Returns UV value.                                             |
+| `getCalculationDate()`    | Returns date in Date representation`.                         |
+| `toString()`              | Returns pretty string for the whole available UV information. |
+
+`toString()` output example:
+```
+Date: Tue Jul 31 15:00:00 MSK 2018, Ultraviolet value: 6.230000
+```
+
+#### Air pollution
+
+First step is retrieving `AirPollutionRequester` instance:
+```java
+OpenWeatherMapManager openWeatherMapManager = new OpenWeatherMapManager(API_TOKEN);
+AirPollutionRequester requester = openWeatherMapManager.getAirPollutionRequester();
+```
+after you need to set coordinates, time frame, date and execute appropriate request:
+```
+AirPollution airPollutionResponse = forecastRequester
+    .setCoordinates(0.0f, 10.0f)
+    .setTimeFrame(TimeFrame.YEAR)
+    .setDate(new Date())
+    .retrieve();
+```
+
+Available requests:
+* `retrieve()`
+
+`AirPollution`'s useful public methods(setters are not listed):
+
+| Method                    | Description                                                               |
+|---------------------------|---------------------------------------------------------------------------|
+| `getCoordinates()`        | Returns `Coordinates` instance.                                           |
+| `getLongitude()`          | Returns longitude.                                                        |
+| `airPollutionInfo()`      | Returns list of `AirPollution.AirPollutionInfo` instances.                |
+| `toString()`              | Returns pretty string for the whole available air pollution information.  |
+
+`toString()` output example:
+```
+AirPollution[Date: Tue Jul 24 01:04:40 MSK 2018; Coordinates: latitude=0.0, longitude=9.9955]
+[Value: 8.0347114E-8, Value: 9.5041536E-8, Value: 7.7667146E-8, Value: 7.251491E-8, Value: 5.899763E-8, Value: 1.9186361E-8, Value: 1.729535E-8, Value: 1.25645805E-8, Value: 3.0852514E-9]
+```
+
+### Constants and options
+
+#### Accuracy
+| Constant           | Description      |
+|--------------------|------------------|
+| Accuracy.LIKE      | Close result.    |
+| Accuracy.ACCURATE  | Accurate result. |
+
+#### Language
+| Constant                          | Description                   |
+|-----------------------------------|-------------------------------|
+| Language.ARABIC                   | Arabic language.              |
+| Language.BULGARIAN                | Bulgarian language.           |
+| Language.CATALAN                  | Catalan language.             |
+| Language.CZECH                    | Czech language.               |
+| Language.GERMAN                   | German language.              |
+| Language.GREEK                    | Greek language.               |
+| Language.ENGLISH                  | English language.             |
+| Language.PERSIAN                  | Persian (Farsi) language.     |
+| Language.FINNISH                  | Finnish language.             |
+| Language.FRENCH                   | French language.              |
+| Language.GALICIAN                 | Galician language.            |
+| Language.CROATIAN                 | Croatian language.            |
+| Language.HUNGARIAN                | Hungarian 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.DUTCH                    | Dutch language.               |
+| Language.POLISH                   | Polish language.              |
+| Language.PORTUGUESE               | Portuguese 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.TURKISH                  | Turkish language.             |
+| Language.UKRANIAN                 | Ukrainian language.           |
+| Language.VIETNAMESE               | Vietnamese language.          |
+| Language.CHINESE_SIMPLIFIED       | Chinese Simplified language.  |
+| Language.CHINESE_TRADITIONAL      | Chinese Traditional 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.alibaba:fastjson:1.2.44
+* org.projectlombok:lombok:1.18.0 (*provided*)

docs/Release_1.2.md

@@ -0,0 +1,402 @@
+### Implemented features:
+* Current weather data
+* 5 day / 3 hour forecast
+* 16 day / daily forecast
+* UV Index
+* Air Pollution
+
+### Maven coordinates:
+
+```xml
+<dependency>
+  <groupId>com.github.prominence</groupId>
+  <artifactId>openweathermap-api</artifactId>
+  <version>1.2</version>
+</dependency>
+```
+
+### Gradle coordinates:
+
+```groovy
+implementation 'com.github.prominence:openweathermap-api:1.2'
+```
+
+### How to use:
+
+Firstly, you need to create the instance of `OpenWeatherMapManager` class:
+```java
+OpenWeatherMapManager openWeatherManager = new OpenWeatherMapManager(API_TOKEN);
+```
+where `API_TOKEN` is your token([you can get it here](https://home.openweathermap.org/api_keys)) as `String`.
+
+Currently available methods:
+* `getWeatherRequester()`
+* `getHourlyForecastRequester()`
+* `getDailyForecastRequester()`
+* `getUltravioletIndexRequester(...)`
+* `getAirPollutionRequester(...)`
+
+#### Current weather data
+First step is retrieving `WeatherRequester` instance:
+```java
+OpenWeatherMapManager openWeatherManager = new OpenWeatherMapManager(API_TOKEN);
+WeatherRequester weatherRequester = openWeatherManager.getWeatherRequester();
+```
+after you are able to set preferable options(via chain methods) and execute appropriate request:
+```
+Weather weatherResponse = weatherRequester
+    .setLanguage(Language.ENGLISH)
+    .setUnitSystem(Unit.METRIC_SYSTEM)
+    .setAccuracy(Accuracy.ACCURATE)
+    .getByCityName("Minsk");
+```
+*Language*, *UnitSystem* and *Accuracy* settings will be described below.
+
+Available requests:
+* `getByCityId(String cityId)`
+* `getByCityName(String cityName)`
+* `getByCoordinates(double latitude, double longitude)`
+* `getByCoordinates(Coordinates coordinates)`
+* `getByZIPCode(String zipCode, String countryCode)`
+
+`Weather`'s useful public methods(setters are not listed):
+
+| Method                    | Description                                                                                                                                                     |
+|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `getCityId()`             | Returns city ID. Example: `625144` for Minsk.                                                                                                                   |
+| `getCityName()`           | Returns city name. Example: `Minsk`.                                                                                                                            |
+| `getCoordinates()`        | Returns `Coordinates` instance that contains *latitude* and *longitude* information.                                                                            |
+| `getWeatherStates()`      | Returns list of `WeatherState` instances with the only `getDescription` useful method.                                                                          |
+| `getBase()`               | Returns `String` with some internal information. Example: `cmc stations` - from official documentation.                                                         |
+| `getWeatherInfo()`        | Returns `Weather.WeatherInfo` instance that contains information about temperature, atmosphericPressure and humidity.                                                      |
+| `getWind()`               | Returns `Wind` instance that contains information about speed and degree.                                                                                       |
+| `getClouds()`             | Returns `Clouds` instance that contains *cloudiness* percentage information.                                                                                    |
+| `getRain()`               | Returns `Rain` instance that contains information about rain volume for the last 3 hours.                                                                       |
+| `getSnow()`               | Returns `Snow` instance that contains information about snow volume for the last 3 hours.                                                                       |
+| `getDataCalculationTime()`| Returns `long` value that represents data calculation timestamp.                                                                                                |
+| `getWeatherSystemInfo()`  | Returns `Weather.WeatherSystemInfo` instance that contains internal information. There is also an information about country, sunrise and sunset time.           |
+| `getResponseCode()`       | Returns OpenWeatherMap response code. Internal information.                                                                                                     |
+| `getCountry()`            | An alias for `getWeatherSystemInfo().getCountry()`.                                                                                                             |
+| `getWeatherDescription()` | An alias for `getWeatherStates.get(0).getDescription()`.                                                                                                        |
+| `getDataCalculationDate()`| Returns data calculation time in `Date` representation.                                                                                                         |
+| `getTemperature()`        | An alias for `getWeatherInfo().getTemperature()`.                                                                                                               |
+| `getTemperatureUnit()`    | An alias for `getWeatherInfo().getTemperatureUnit()`.                                                                                                           |
+| `getPressure()`           | An alias for `getWeatherInfo().getPressure()`.                                                                                                                  |
+| `getPressureUnit()`       | An alias for `getWeatherInfo().getPressureUnit()`.                                                                                                              |
+| `getHumidityPercentage()` | An alias for `getWeatherInfo().getHumidity()`.                                                                                                                  |
+| `toString()`              | Returns pretty string for the whole available weather information.                                                                                              |
+
+`toString()` output example:
+```
+City: Minsk(625144). Coordinates: latitude=53.9, longitude=27.56
+Country: BY
+Sunrise: Sun Jul 15 04:58:27 MSK 2018
+Sunset: Sun Jul 15 21:32:19 MSK 2018
+Weather: light intensity shower rain
+Temperature: 17.0 ℃. Minimum temparature: 17.0 ℃. Maximum temperature: 17.0 ℃
+Humidity: 93%
+Pressure: 1008 hPa
+Wind: 2.0 meter/sec, 20 degrees
+Cloudiness: 75%
+Data calculation time: Mon Jul 16 00:00:00 MSK 2018
+```
+
+#### 5 day / 3 hour forecast
+First step is retrieving `HourlyForecastRequester` instance:
+```java
+OpenWeatherMapManager openWeatherManager = new OpenWeatherMapManager(API_TOKEN);
+HourlyForecastRequester forecastRequester = openWeatherManager.getHourlyForecastRequester();
+```
+after you are able to set preferable options(via chain methods) and execute appropriate request:
+```
+HourlyForecast forecastResponse = forecastRequester
+    .setLanguage(Language.ENGLISH)
+    .setUnitSystem(Unit.METRIC_SYSTEM)
+    .setAccuracy(Accuracy.ACCURATE)
+    .getByCityName("Pruzhany");
+```
+*Language*, *UnitSystem* and *Accuracy* settings will be described below.
+
+Available requests:
+* `getByCityId(String cityId)`
+* `getByCityName(String cityName)`
+* `getByCoordinates(double latitude, double longitude)`
+* `getByCoordinates(Coordinates coordinates)`
+* `getByZIPCode(String zipCode, String countryCode)`
+
+`HourlyForecast`'s useful public methods(setters are not listed):
+
+| Method                      | Description                                                                                |
+|-----------------------------|--------------------------------------------------------------------------------------------|
+| `getCityId()`               | Returns city ID. Example: `625144` for Minsk.                                              |
+| `getCityName()`             | Returns city name. Example: `Minsk`.                                                       |
+| `getCoordinates()`          | Returns `Coordinates` instance that contains *latitude* and *longitude* information.       |
+| `getCityInfo()`             | Returns `CityInfo` instance that contains information about city.                          |
+| `getResponseCode()`         | Returns OpenWeatherMap response code. Internal information.                                |
+| `getCountry()`              | An alias for `getCityInfo().getCountry()`.                                                 |
+| `getForecasts()`            | Returns `List<HourlyForecast.Forecast>` collection with all forecast information.          |
+| `getAverageTemperature()`   | Returns average temperature from forecasts.                                                |
+| `getMinimumTemperature()`   | Returns minimum temperature from forecasts.                                                |
+| `getMaximumTemperature()`   | Returns maximum temperature from forecasts.                                                |
+| `getByMinimumTemperature()` | Returns `HourlyForecast.Forecast` for the time where temperature is minimal.               |
+| `getByMaximumTemperature()` | Returns `HourlyForecast.Forecast` for the time where temperature is maximal.               |
+| `getAveragePressure()`      | Returns average atmosphericPressure from forecasts.                                                   |
+| `getMinimumPressure()`      | Returns minimum atmosphericPressure from forecasts.                                                   |
+| `getMaximumPressure()`      | Returns maximum atmosphericPressure from forecasts.                                                   |
+| `getByMinimumPressure()`    | Returns `HourlyForecast.Forecast` for the time where atmosphericPressure is minimal.                  |
+| `getByMaximumPressure()`    | Returns `HourlyForecast.Forecast` for the time where atmosphericPressure is maximal.                  |
+| `toString()`                | Returns pretty string for the whole available forecast information.                        |
+
+`toString()` output example:
+```
+City: Pruzhany(622997). Coordinates: latitude=52.5582, longitude=24.4567
+Country: BY
+Forecasts:
+    Time: Tue Jul 17 00:00:00 MSK 2018. Weather: light rain. Temperature: 16.24 ℃. Minimum temperature: 16.24 ℃. Maximum temperature: 17.36 ℃. Pressure: 997.38 hPa. Sea-level atmosphericPressure: 1018.59 hPa. Ground-level atmosphericPressure: 997.38 hPa. Humidity: 99%. Cloudiness: 80%. Wind: 2.85 meter/sec, 324 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 03:00:00 MSK 2018. Weather: moderate rain. Temperature: 16.0 ℃. Minimum temperature: 16.0 ℃. Maximum temperature: 16.83 ℃. Pressure: 996.88 hPa. Sea-level atmosphericPressure: 1017.86 hPa. Ground-level atmosphericPressure: 996.88 hPa. Humidity: 99%. Cloudiness: 80%. Wind: 1.86 meter/sec, 349 degrees. Rain(last 3 hrs): 3 mm
+    Time: Tue Jul 17 06:00:00 MSK 2018. Weather: light rain. Temperature: 15.76 ℃. Minimum temperature: 15.76 ℃. Maximum temperature: 16.31 ℃. Pressure: 996.7 hPa. Sea-level atmosphericPressure: 1017.72 hPa. Ground-level atmosphericPressure: 996.7 hPa. Humidity: 94%. Cloudiness: 76%. Wind: 1.62 meter/sec, 113 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 09:00:00 MSK 2018. Weather: light rain. Temperature: 18.23 ℃. Minimum temperature: 18.23 ℃. Maximum temperature: 18.51 ℃. Pressure: 997.17 hPa. Sea-level atmosphericPressure: 1018.18 hPa. Ground-level atmosphericPressure: 997.17 hPa. Humidity: 100%. Cloudiness: 76%. Wind: 2.11 meter/sec, 107 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 12:00:00 MSK 2018. Weather: light rain. Temperature: 21.0 ℃. Minimum temperature: 21.0 ℃. Maximum temperature: 21.0 ℃. Pressure: 997.6 hPa. Sea-level atmosphericPressure: 1018.5 hPa. Ground-level atmosphericPressure: 997.6 hPa. Humidity: 100%. Cloudiness: 68%. Wind: 2.51 meter/sec, 82 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 15:00:00 MSK 2018. Weather: light rain. Temperature: 21.78 ℃. Minimum temperature: 21.78 ℃. Maximum temperature: 21.78 ℃. Pressure: 997.73 hPa. Sea-level atmosphericPressure: 1018.66 hPa. Ground-level atmosphericPressure: 997.73 hPa. Humidity: 92%. Cloudiness: 88%. Wind: 4.05 meter/sec, 78 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 18:00:00 MSK 2018. Weather: light rain. Temperature: 22.9 ℃. Minimum temperature: 22.9 ℃. Maximum temperature: 22.9 ℃. Pressure: 997.66 hPa. Sea-level atmosphericPressure: 1018.55 hPa. Ground-level atmosphericPressure: 997.66 hPa. Humidity: 93%. Cloudiness: 68%. Wind: 3.06 meter/sec, 67 degrees. Rain(last 3 hrs): 0 mm
+    Time: Tue Jul 17 21:00:00 MSK 2018. Weather: light rain. Temperature: 23.04 ℃. Minimum temperature: 23.04 ℃. Maximum temperature: 23.04 ℃. Pressure: 996.89 hPa. Sea-level atmosphericPressure: 1017.99 hPa. Ground-level atmosphericPressure: 996.89 hPa. Humidity: 83%. Cloudiness: 88%. Wind: 3.17 meter/sec, 16 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 00:00:00 MSK 2018. Weather: moderate rain. Temperature: 18.5 ℃. Minimum temperature: 18.5 ℃. Maximum temperature: 18.5 ℃. Pressure: 997.33 hPa. Sea-level atmosphericPressure: 1018.34 hPa. Ground-level atmosphericPressure: 997.33 hPa. Humidity: 97%. Cloudiness: 44%. Wind: 3.56 meter/sec, 31 degrees. Rain(last 3 hrs): 7 mm
+    Time: Wed Jul 18 03:00:00 MSK 2018. Weather: few clouds. Temperature: 18.57 ℃. Minimum temperature: 18.57 ℃. Maximum temperature: 18.57 ℃. Pressure: 996.91 hPa. Sea-level atmosphericPressure: 1017.87 hPa. Ground-level atmosphericPressure: 996.91 hPa. Humidity: 95%. Cloudiness: 24%. Wind: 5.26 meter/sec, 44 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 06:00:00 MSK 2018. Weather: few clouds. Temperature: 18.94 ℃. Minimum temperature: 18.94 ℃. Maximum temperature: 18.94 ℃. Pressure: 997.07 hPa. Sea-level atmosphericPressure: 1018.06 hPa. Ground-level atmosphericPressure: 997.07 hPa. Humidity: 95%. Cloudiness: 20%. Wind: 4.8 meter/sec, 45 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 09:00:00 MSK 2018. Weather: light rain. Temperature: 20.6 ℃. Minimum temperature: 20.6 ℃. Maximum temperature: 20.6 ℃. Pressure: 997.8 hPa. Sea-level atmosphericPressure: 1018.66 hPa. Ground-level atmosphericPressure: 997.8 hPa. Humidity: 97%. Cloudiness: 48%. Wind: 5.56 meter/sec, 54 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 12:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.87 ℃. Minimum temperature: 23.87 ℃. Maximum temperature: 23.87 ℃. Pressure: 998.06 hPa. Sea-level atmosphericPressure: 1019.05 hPa. Ground-level atmosphericPressure: 998.06 hPa. Humidity: 88%. Cloudiness: 32%. Wind: 5.86 meter/sec, 52 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 24.67 ℃. Minimum temperature: 24.67 ℃. Maximum temperature: 24.67 ℃. Pressure: 998.51 hPa. Sea-level atmosphericPressure: 1019.33 hPa. Ground-level atmosphericPressure: 998.51 hPa. Humidity: 84%. Cloudiness: 36%. Wind: 5.63 meter/sec, 51 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 18:00:00 MSK 2018. Weather: scattered clouds. Temperature: 25.15 ℃. Minimum temperature: 25.15 ℃. Maximum temperature: 25.15 ℃. Pressure: 998.79 hPa. Sea-level atmosphericPressure: 1019.64 hPa. Ground-level atmosphericPressure: 998.79 hPa. Humidity: 78%. Cloudiness: 44%. Wind: 5.47 meter/sec, 38 degrees. Rain(last 3 hrs): 0 mm
+    Time: Wed Jul 18 21:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.23 ℃. Minimum temperature: 23.23 ℃. Maximum temperature: 23.23 ℃. Pressure: 999.08 hPa. Sea-level atmosphericPressure: 1020.04 hPa. Ground-level atmosphericPressure: 999.08 hPa. Humidity: 75%. Cloudiness: 48%. Wind: 4.62 meter/sec, 25 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 00:00:00 MSK 2018. Weather: scattered clouds. Temperature: 20.79 ℃. Minimum temperature: 20.79 ℃. Maximum temperature: 20.79 ℃. Pressure: 999.67 hPa. Sea-level atmosphericPressure: 1020.68 hPa. Ground-level atmosphericPressure: 999.67 hPa. Humidity: 76%. Cloudiness: 48%. Wind: 4.29 meter/sec, 13 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 03:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.45 ℃. Minimum temperature: 19.45 ℃. Maximum temperature: 19.45 ℃. Pressure: 999.95 hPa. Sea-level atmosphericPressure: 1021.02 hPa. Ground-level atmosphericPressure: 999.95 hPa. Humidity: 80%. Cloudiness: 48%. Wind: 4.22 meter/sec, 17 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 06:00:00 MSK 2018. Weather: light rain. Temperature: 18.9 ℃. Minimum temperature: 18.9 ℃. Maximum temperature: 18.9 ℃. Pressure: 1000.6 hPa. Sea-level atmosphericPressure: 1021.62 hPa. Ground-level atmosphericPressure: 1000.6 hPa. Humidity: 83%. Cloudiness: 92%. Wind: 4.43 meter/sec, 10 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 09:00:00 MSK 2018. Weather: light rain. Temperature: 21.37 ℃. Minimum temperature: 21.37 ℃. Maximum temperature: 21.37 ℃. Pressure: 1000.95 hPa. Sea-level atmosphericPressure: 1022.01 hPa. Ground-level atmosphericPressure: 1000.95 hPa. Humidity: 87%. Cloudiness: 0%. Wind: 4.36 meter/sec, 6 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 12:00:00 MSK 2018. Weather: clear sky. Temperature: 23.92 ℃. Minimum temperature: 23.92 ℃. Maximum temperature: 23.92 ℃. Pressure: 1001.5 hPa. Sea-level atmosphericPressure: 1022.43 hPa. Ground-level atmosphericPressure: 1001.5 hPa. Humidity: 77%. Cloudiness: 0%. Wind: 5.66 meter/sec, 12 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 15:00:00 MSK 2018. Weather: broken clouds. Temperature: 23.7 ℃. Minimum temperature: 23.7 ℃. Maximum temperature: 23.7 ℃. Pressure: 1001.75 hPa. Sea-level atmosphericPressure: 1022.72 hPa. Ground-level atmosphericPressure: 1001.75 hPa. Humidity: 72%. Cloudiness: 56%. Wind: 5.87 meter/sec, 349 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 18:00:00 MSK 2018. Weather: broken clouds. Temperature: 23.82 ℃. Minimum temperature: 23.82 ℃. Maximum temperature: 23.82 ℃. Pressure: 1001.55 hPa. Sea-level atmosphericPressure: 1022.59 hPa. Ground-level atmosphericPressure: 1001.55 hPa. Humidity: 72%. Cloudiness: 68%. Wind: 5.47 meter/sec, 340 degrees. Rain(last 3 hrs): 0 mm
+    Time: Thu Jul 19 21:00:00 MSK 2018. Weather: broken clouds. Temperature: 22.22 ℃. Minimum temperature: 22.22 ℃. Maximum temperature: 22.22 ℃. Pressure: 1001.82 hPa. Sea-level atmosphericPressure: 1022.93 hPa. Ground-level atmosphericPressure: 1001.82 hPa. Humidity: 67%. Cloudiness: 76%. Wind: 4.12 meter/sec, 333 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 00:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.76 ℃. Minimum temperature: 19.76 ℃. Maximum temperature: 19.76 ℃. Pressure: 1001.98 hPa. Sea-level atmosphericPressure: 1023.13 hPa. Ground-level atmosphericPressure: 1001.98 hPa. Humidity: 76%. Cloudiness: 32%. Wind: 4.11 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 03:00:00 MSK 2018. Weather: clear sky. Temperature: 17.53 ℃. Minimum temperature: 17.53 ℃. Maximum temperature: 17.53 ℃. Pressure: 1001.93 hPa. Sea-level atmosphericPressure: 1023.13 hPa. Ground-level atmosphericPressure: 1001.93 hPa. Humidity: 87%. Cloudiness: 8%. Wind: 4.21 meter/sec, 309 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 06:00:00 MSK 2018. Weather: scattered clouds. Temperature: 16.83 ℃. Minimum temperature: 16.83 ℃. Maximum temperature: 16.83 ℃. Pressure: 1001.79 hPa. Sea-level atmosphericPressure: 1022.99 hPa. Ground-level atmosphericPressure: 1001.79 hPa. Humidity: 91%. Cloudiness: 44%. Wind: 3.65 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 09:00:00 MSK 2018. Weather: light rain. Temperature: 19.57 ℃. Minimum temperature: 19.57 ℃. Maximum temperature: 19.57 ℃. Pressure: 1001.34 hPa. Sea-level atmosphericPressure: 1022.41 hPa. Ground-level atmosphericPressure: 1001.34 hPa. Humidity: 85%. Cloudiness: 8%. Wind: 4.38 meter/sec, 305 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 12:00:00 MSK 2018. Weather: clear sky. Temperature: 23.5 ℃. Minimum temperature: 23.5 ℃. Maximum temperature: 23.5 ℃. Pressure: 1001.0 hPa. Sea-level atmosphericPressure: 1021.99 hPa. Ground-level atmosphericPressure: 1001.0 hPa. Humidity: 85%. Cloudiness: 8%. Wind: 5.36 meter/sec, 299 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 25.14 ℃. Minimum temperature: 25.14 ℃. Maximum temperature: 25.14 ℃. Pressure: 1000.5 hPa. Sea-level atmosphericPressure: 1021.51 hPa. Ground-level atmosphericPressure: 1000.5 hPa. Humidity: 73%. Cloudiness: 32%. Wind: 6.72 meter/sec, 305 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 18:00:00 MSK 2018. Weather: overcast clouds. Temperature: 23.56 ℃. Minimum temperature: 23.56 ℃. Maximum temperature: 23.56 ℃. Pressure: 1000.7 hPa. Sea-level atmosphericPressure: 1021.58 hPa. Ground-level atmosphericPressure: 1000.7 hPa. Humidity: 66%. Cloudiness: 88%. Wind: 6.57 meter/sec, 317 degrees. Rain(last 3 hrs): 0 mm
+    Time: Fri Jul 20 21:00:00 MSK 2018. Weather: broken clouds. Temperature: 22.41 ℃. Minimum temperature: 22.41 ℃. Maximum temperature: 22.41 ℃. Pressure: 1000.64 hPa. Sea-level atmosphericPressure: 1021.67 hPa. Ground-level atmosphericPressure: 1000.64 hPa. Humidity: 68%. Cloudiness: 64%. Wind: 4.31 meter/sec, 326 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 00:00:00 MSK 2018. Weather: broken clouds. Temperature: 20.92 ℃. Minimum temperature: 20.92 ℃. Maximum temperature: 20.92 ℃. Pressure: 1001.06 hPa. Sea-level atmosphericPressure: 1022.14 hPa. Ground-level atmosphericPressure: 1001.06 hPa. Humidity: 78%. Cloudiness: 68%. Wind: 3.42 meter/sec, 327 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 03:00:00 MSK 2018. Weather: broken clouds. Temperature: 20.28 ℃. Minimum temperature: 20.28 ℃. Maximum temperature: 20.28 ℃. Pressure: 1001.04 hPa. Sea-level atmosphericPressure: 1022.13 hPa. Ground-level atmosphericPressure: 1001.04 hPa. Humidity: 78%. Cloudiness: 76%. Wind: 4.27 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 06:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.11 ℃. Minimum temperature: 19.11 ℃. Maximum temperature: 19.11 ℃. Pressure: 1001.13 hPa. Sea-level atmosphericPressure: 1022.28 hPa. Ground-level atmosphericPressure: 1001.13 hPa. Humidity: 74%. Cloudiness: 32%. Wind: 4.96 meter/sec, 308 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 09:00:00 MSK 2018. Weather: few clouds. Temperature: 20.16 ℃. Minimum temperature: 20.16 ℃. Maximum temperature: 20.16 ℃. Pressure: 1001.43 hPa. Sea-level atmosphericPressure: 1022.62 hPa. Ground-level atmosphericPressure: 1001.43 hPa. Humidity: 86%. Cloudiness: 20%. Wind: 5.16 meter/sec, 308 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 12:00:00 MSK 2018. Weather: few clouds. Temperature: 22.37 ℃. Minimum temperature: 22.37 ℃. Maximum temperature: 22.37 ℃. Pressure: 1001.53 hPa. Sea-level atmosphericPressure: 1022.62 hPa. Ground-level atmosphericPressure: 1001.53 hPa. Humidity: 88%. Cloudiness: 20%. Wind: 5.56 meter/sec, 307 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 22.85 ℃. Minimum temperature: 22.85 ℃. Maximum temperature: 22.85 ℃. Pressure: 1001.63 hPa. Sea-level atmosphericPressure: 1022.65 hPa. Ground-level atmosphericPressure: 1001.63 hPa. Humidity: 81%. Cloudiness: 44%. Wind: 5.46 meter/sec, 314 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 18:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.79 ℃. Minimum temperature: 23.79 ℃. Maximum temperature: 23.79 ℃. Pressure: 1001.53 hPa. Sea-level atmosphericPressure: 1022.53 hPa. Ground-level atmosphericPressure: 1001.53 hPa. Humidity: 72%. Cloudiness: 32%. Wind: 5.56 meter/sec, 313 degrees. Rain(last 3 hrs): 0 mm
+    Time: Sat Jul 21 21:00:00 MSK 2018. Weather: scattered clouds. Temperature: 22.56 ℃. Minimum temperature: 22.56 ℃. Maximum temperature: 22.56 ℃. Pressure: 1001.72 hPa. Sea-level atmosphericPressure: 1022.7 hPa. Ground-level atmosphericPressure: 1001.72 hPa. Humidity: 66%. Cloudiness: 48%. Wind: 3.96 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
+```
+
+`HourlyForecast.Forecast`'s useful public methods(setters are not listed):
+
+| Method                      | Description                                                                                                      |
+|-----------------------------|------------------------------------------------------------------------------------------------------------------|
+| `getDataCalculationTime()`  | Returns `long` value that represents data calculation timestamp.                                                 |
+| `getDataCalculationDate()`  | Returns data calculation time in `Date` representation.                                                          |
+| `getWeatherInfo()`          | Returns `HourlyForecast.WeatherInfo` instance that contains information about temperature, atmosphericPressure and humidity.|
+| `getWeatherStates()`        | Returns list of `WeatherState` instances with the only `getDescription` useful method.                           |
+| `getClouds()`               | Returns `Clouds` instance that contains *cloudiness* percentage information.                                     |
+| `getWind()`                 | Returns `Wind` instance that contains information about speed and degree.                                        |
+| `getSnow()`                 | Returns `Snow` instance that contains information about snow volume for the last 3 hours.                        |
+| `getRain()`                 | Returns `Rain` instance that contains information about rain volume for the last 3 hours.                        |
+| `getSystemInfo()`           | Returns `HourlyForecast.ForecastSystemInfo` instance with internal information.                                  |
+| `getDt_txt()`               | Returns `String` value that represents data calculation time.                                                    |
+| `toString()`                | Returns pretty string for the whole available forecast information.                                              |
+
+#### 16 day / daily forecast
+First step is retrieving `DailyForecastRequester` instance:
+```java
+OpenWeatherMapManager openWeatherManager = new OpenWeatherMapManager(API_TOKEN);
+DailyForecastRequester forecastRequester = openWeatherManager.getDailyForecastRequester();
+```
+after you are able to set preferable options(via chain methods) and execute appropriate request:
+```
+DailyForecast forecastResponse = forecastRequester
+    .setLanguage(Language.ENGLISH)
+    .setUnitSystem(Unit.METRIC_SYSTEM)
+    .setAccuracy(Accuracy.ACCURATE)
+    .getByCityName("Pruzhany");
+```
+*Language*, *UnitSystem* and *Accuracy* settings will be described below.
+
+Available requests:
+* `getByCityId(String cityId)`
+* `getByCityName(String cityName)`
+* `getByCoordinates(double latitude, double longitude)`
+* `getByCoordinates(Coordinates coordinates)`
+* `getByZIPCode(String zipCode, String countryCode)`
+
+`DailyForecast`'s useful public methods(setters are not listed):
+
+| Method                      | Description                                                                                |
+|-----------------------------|--------------------------------------------------------------------------------------------|
+| `getCityId()`               | Returns city ID. Example: `625144` for Minsk.                                              |
+| `getCityName()`             | Returns city name. Example: `Minsk`.                                                       |
+| `getCoordinates()`          | Returns `Coordinates` instance that contains *latitude* and *longitude* information.       |
+| `getCityInfo()`             | Returns `CityInfo` instance that contains information about city.                          |
+| `getResponseCode()`         | Returns OpenWeatherMap response code. Internal information.                                |
+| `getCountry()`              | An alias for `getCityInfo().getCountry()`.                                                 |
+| `getForecasts()`            | Returns `List<HourlyForecast.Forecast>` collection with all forecast information.          |
+| `toString()`                | Returns pretty string for the whole available forecast information.                        |
+
+`DailyForecast.Forecast`'s useful public methods(setters are not listed):
+
+| Method                      | Description                                                                                                      |
+|-----------------------------|------------------------------------------------------------------------------------------------------------------|
+| `getDataCalculationTime()`  | Returns `long` value that represents data calculation timestamp.                                                 |
+| `getDataCalculationDate()`  | Returns data calculation time in `Date` representation.                                                          |
+| `getTemperature()`          | Returns `DailyForecast.Forecast.Temperature` instance that contains information about temperature(avg, min, max).|
+| `getWeatherStates()`        | Returns list of `WeatherState` instances with the only `getDescription` useful method.                           |
+| `getCloudiness()`           | Returns *cloudiness* percentage information.                                                                     |
+| `getHumidity()`             | Returns *humidity* percentage information.                                                                       |
+| `getWindSpeed()`            | Returns wind's speed.                                                                                            |
+| `getWindDegrees()`          | Returns wind's degree.                                                                                           |
+| `getWindUnit()`             | Returns wind's unit.                                                                                             |
+| `getPressure()`             | Returns atmosphericPressure value.                                                                                          |
+| `getPressureUnit()`         | Returns atmosphericPressure's unit.                                                                                         |
+| `toString()`                | Returns pretty string for the whole available forecast information.                                              |
+
+#### UV Index
+
+First step is retrieving `UltravioletIndexRequester` instance:
+```java
+OpenWeatherMapManager openWeatherMapManager = new OpenWeatherMapManager(API_TOKEN);
+UltravioletIndexRequester requester = openWeatherMapManager.getUltravioletIndexRequester(34.23f, -22.45f);
+```
+or
+```java
+OpenWeatherMapManager openWeatherMapManager = new OpenWeatherMapManager(API_TOKEN);
+Coordinates coordinates = new Coordinates(34.23f, -22.45f);
+UltravioletIndexRequester requester = openWeatherMapManager.getUltravioletIndexRequester(coordinates);
+```
+
+after you need to execute appropriate request:
+```
+UltravioletIndex uvResponse = requester.getCurrentUVIndex();
+```
+
+You can change required coordinates via: `requester.setCoordinates(Coordinates coordinates);` or `requester.setCoordinates(float latitude, float longitude);`
+
+Available requests:
+* `getCurrentUVIndex()`
+* `getUVIndexForecast(int amountOfDays)`
+* `getUVIndexByPeriod(Date from, Date to)`
+
+`UltravioletIndex`'s useful public methods(setters are not listed):
+
+| Method                    | Description                                                   |
+|---------------------------|---------------------------------------------------------------|
+| `getLatitude()`           | Returns latitude.                                             |
+| `getLongitude()`          | Returns longitude.                                            |
+| `getDateISO()`            | Returns ISO date in String representation.                    |
+| `getDateTimestamp()`      | Returns date timestamp.                                       |
+| `getValue()`              | Returns UV value.                                             |
+| `getCalculationDate()`    | Returns date in Date representation`.                         |
+| `toString()`              | Returns pretty string for the whole available UV information. |
+
+`toString()` output example:
+```
+Date: Tue Jul 31 15:00:00 MSK 2018, Ultraviolet value: 6.230000
+```
+
+#### Air pollution
+
+First step is retrieving `AirPollutionRequester` instance:
+```java
+OpenWeatherMapManager openWeatherMapManager = new OpenWeatherMapManager(API_TOKEN);
+AirPollutionRequester requester = openWeatherMapManager.getAirPollutionRequester(0f, 10f, new Date(), TimeFrame.DAY);
+```
+after you need to execute appropriate request:
+```
+AirPollution airPolutionResponse = requester.retrieve();
+```
+
+You can modify parameters anytime:
+```java
+requester.setCoordinates(Coordinates coordinates);
+requester.setCoordinates(float latitude, float longitude);
+requester.setTimeFrame(TimeFrame timeFrame);
+requester.setDate(Date date);
+```
+
+Available requests:
+* `retrieve()`
+
+`AirPollution`'s useful public methods(setters are not listed):
+
+| Method                    | Description                                                               |
+|---------------------------|---------------------------------------------------------------------------|
+| `getCoordinates()`        | Returns `Coordinates` instance.                                           |
+| `getLongitude()`          | Returns longitude.                                                        |
+| `airPollutionInfo()`      | Returns list of `AirPollution.AirPollutionInfo` instances.                |
+| `toString()`              | Returns pretty string for the whole available air pollution information.  |
+
+`toString()` output example:
+```
+AirPollution[Date: Tue Jul 24 01:04:40 MSK 2018; Coordinates: latitude=0.0, longitude=9.9955]
+[Value: 8.0347114E-8, Value: 9.5041536E-8, Value: 7.7667146E-8, Value: 7.251491E-8, Value: 5.899763E-8, Value: 1.9186361E-8, Value: 1.729535E-8, Value: 1.25645805E-8, Value: 3.0852514E-9]
+```
+
+### Constants and options
+
+#### Accuracy
+| Constant           | Description      |
+|--------------------|------------------|
+| Accuracy.LIKE      | Close result.    |
+| Accuracy.ACCURATE  | Accurate result. |
+
+#### Language
+| Constant                          | Description                   |
+|-----------------------------------|-------------------------------|
+| Language.ARABIC                   | Arabic language.              |
+| Language.BULGARIAN                | Bulgarian language.           |
+| Language.CATALAN                  | Catalan language.             |
+| Language.CZECH                    | Czech language.               |
+| Language.GERMAN                   | German language.              |
+| Language.GREEK                    | Greek language.               |
+| Language.ENGLISH                  | English language.             |
+| Language.PERSIAN                  | Persian (Farsi) language.     |
+| Language.FINNISH                  | Finnish language.             |
+| Language.FRENCH                   | French language.              |
+| Language.GALICIAN                 | Galician language.            |
+| Language.CROATIAN                 | Croatian language.            |
+| Language.HUNGARIAN                | Hungarian 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.DUTCH                    | Dutch language.               |
+| Language.POLISH                   | Polish language.              |
+| Language.PORTUGUESE               | Portuguese 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.TURKISH                  | Turkish language.             |
+| Language.UKRANIAN                 | Ukrainian language.           |
+| Language.VIETNAMESE               | Vietnamese language.          |
+| Language.CHINESE_SIMPLIFIED       | Chinese Simplified language.  |
+| Language.CHINESE_TRADITIONAL      | Chinese Traditional 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.alibaba:fastjson:1.2.44
+* org.projectlombok:lombok:1.18.0 (*provided*)
+* junit:junit:4.12 (*test*)

docs/Release_2.0.0.md

@@ -0,0 +1,253 @@
+### Implemented features:
+* Current weather data
+* 5 day / 3-hour forecast
+
+### Maven coordinates:
+
+```xml
+<dependency>
+  <groupId>com.github.prominence</groupId>
+  <artifactId>openweathermap-api</artifactId>
+  <version>2.0.0</version>
+</dependency>
+```
+
+### Gradle coordinates:
+
+```groovy
+implementation 'com.github.prominence:openweathermap-api:2.0.0'
+```
+
+### 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()`
+
+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                                                                                                                                                               |
+|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `getState()`              | Returns short weather description. Example: `Clear`.                                                                                                                      |
+| `getDescription()`        | Returns weather description. Example: `clear sky`.                                                                                                                        |
+| `getWeatherIconUrl()`     | Returns a link to weather icon hosted on https://openweathermap.org website.                                                                                              |
+| `getCalculatedOn()`       | Returns `LocalDateTime` object with data calculation time.                                                                                                                |
+| `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.request.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                                                                                                                                                               |
+|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `getState()`                  | Returns short weather description. Example: `Clear`.                                                                                                                      |
+| `getDescription()`            | Returns weather description. Example: `clear sky`.                                                                                                                        |
+| `getWeatherIconUrl()`         | Returns a link to weather icon hosted on https://openweathermap.org website.                                                                                              |
+| `getForecastTime()`           | Returns `LocalDateTime` object with weather forecast time.                                                                                                                |
+| `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.                                                                                                      |
+
+### Constants and options
+
+#### Language
+| Constant                          | Description                   |
+|-----------------------------------|-------------------------------|
+| Language.ARABIC                   | Arabic language.              |
+| Language.BULGARIAN                | Bulgarian language.           |
+| Language.CATALAN                  | Catalan language.             |
+| Language.CZECH                    | Czech language.               |
+| Language.GERMAN                   | German language.              |
+| Language.GREEK                    | Greek language.               |
+| Language.ENGLISH                  | English language.             |
+| Language.PERSIAN                  | Persian (Farsi) language.     |
+| Language.FINNISH                  | Finnish language.             |
+| Language.FRENCH                   | French language.              |
+| Language.GALICIAN                 | Galician language.            |
+| Language.CROATIAN                 | Croatian language.            |
+| Language.HUNGARIAN                | Hungarian 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.DUTCH                    | Dutch language.               |
+| Language.POLISH                   | Polish language.              |
+| Language.PORTUGUESE               | Portuguese 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.TURKISH                  | Turkish language.             |
+| Language.UKRANIAN                 | Ukrainian language.           |
+| Language.VIETNAMESE               | Vietnamese language.          |
+| Language.CHINESE_SIMPLIFIED       | Chinese Simplified language.  |
+| Language.CHINESE_TRADITIONAL      | Chinese Traditional 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.12.2
+* org.slf4j:slf4j-api:1.7.30 (*compile*)
+* junit:junit:4.13.1 (*test*)

docs/Release_2.0.1.md

@@ -0,0 +1,253 @@
+### Implemented features:
+* Current weather data
+* 5 day / 3-hour forecast
+
+### Maven coordinates:
+
+```xml
+<dependency>
+  <groupId>com.github.prominence</groupId>
+  <artifactId>openweathermap-api</artifactId>
+  <version>2.0.1</version>
+</dependency>
+```
+
+### Gradle coordinates:
+
+```groovy
+implementation 'com.github.prominence:openweathermap-api:2.0.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()`
+
+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                                                                                                                                                               |
+|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `getState()`              | Returns short weather description. Example: `Clear`.                                                                                                                      |
+| `getDescription()`        | Returns weather description. Example: `clear sky`.                                                                                                                        |
+| `getWeatherIconUrl()`     | Returns a link to weather icon hosted on https://openweathermap.org website.                                                                                              |
+| `getCalculatedOn()`       | Returns `LocalDateTime` object with data calculation time.                                                                                                                |
+| `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.request.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                                                                                                                                                               |
+|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `getState()`                  | Returns short weather description. Example: `Clear`.                                                                                                                      |
+| `getDescription()`            | Returns weather description. Example: `clear sky`.                                                                                                                        |
+| `getWeatherIconUrl()`         | Returns a link to weather icon hosted on https://openweathermap.org website.                                                                                              |
+| `getForecastTime()`           | Returns `LocalDateTime` object with weather forecast time.                                                                                                                |
+| `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.                                                                                                      |
+
+### Constants and options
+
+#### Language
+| Constant                          | Description                   |
+|-----------------------------------|-------------------------------|
+| Language.ARABIC                   | Arabic language.              |
+| Language.BULGARIAN                | Bulgarian language.           |
+| Language.CATALAN                  | Catalan language.             |
+| Language.CZECH                    | Czech language.               |
+| Language.GERMAN                   | German language.              |
+| Language.GREEK                    | Greek language.               |
+| Language.ENGLISH                  | English language.             |
+| Language.PERSIAN                  | Persian (Farsi) language.     |
+| Language.FINNISH                  | Finnish language.             |
+| Language.FRENCH                   | French language.              |
+| Language.GALICIAN                 | Galician language.            |
+| Language.CROATIAN                 | Croatian language.            |
+| Language.HUNGARIAN                | Hungarian 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.DUTCH                    | Dutch language.               |
+| Language.POLISH                   | Polish language.              |
+| Language.PORTUGUESE               | Portuguese 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.TURKISH                  | Turkish language.             |
+| Language.UKRANIAN                 | Ukrainian language.           |
+| Language.VIETNAMESE               | Vietnamese language.          |
+| Language.CHINESE_SIMPLIFIED       | Chinese Simplified language.  |
+| Language.CHINESE_TRADITIONAL      | Chinese Traditional 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.12.2
+* org.slf4j:slf4j-api:1.7.30 (*compile*)
+* junit:junit:4.13.1 (*test*)

docs/Release_2.1.0.md

@@ -0,0 +1,484 @@
+### Implemented features:
+* Current weather data
+* 5 day / 3-hour forecast
+* One Call API
+
+### Maven coordinates:
+
+```xml
+<dependency>
+  <groupId>com.github.prominence</groupId>
+  <artifactId>openweathermap-api</artifactId>
+  <version>2.1.0</version>
+</dependency>
+```
+
+### Gradle coordinates:
+
+```groovy
+implementation 'com.github.prominence:openweathermap-api:2.1.0'
+```
+
+### 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()`
+
+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 API
+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).                                             |
+| `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.                                                  |
+| `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).                                             |
+| `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`.                               |
+
+### 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.UKRANIAN                 | 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.12.2
+* org.slf4j:slf4j-api:1.7.30 (*compile*)
+* org.junit.jupiter:junit-jupiter-engine:5.7.1 (*test*)
+* org.junit.platform:junit-platform-runner:1.7.1 (*test*)

docs/Release_2.1.1.md

@@ -0,0 +1,486 @@
+### Implemented features:
+* Current weather data
+* 5 day / 3-hour forecast
+* One Call API
+
+### Maven coordinates:
+
+```xml
+<dependency>
+  <groupId>com.github.prominence</groupId>
+  <artifactId>openweathermap-api</artifactId>
+  <version>2.1.1</version>
+</dependency>
+```
+
+### Gradle coordinates:
+
+```groovy
+implementation 'com.github.prominence:openweathermap-api:2.1.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()`
+
+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 API
+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.                                                  |
+| `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`.                               |
+
+### 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.UKRANIAN                 | 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.12.2
+* org.slf4j:slf4j-api:1.7.30 (*compile*)
+* org.junit.jupiter:junit-jupiter-engine:5.7.1 (*test*)
+* org.junit.platform:junit-platform-runner:1.7.1 (*test*)

docs/Release_2.2.0.md

@@ -0,0 +1,538 @@
+### Implemented features:
+* Current weather data
+* 5 day / 3-hour forecast
+* One Call API
+* Air Pollution
+
+### Maven coordinates:
+
+```xml
+<dependency>
+  <groupId>com.github.prominence</groupId>
+  <artifactId>openweathermap-api</artifactId>
+  <version>2.2.0</version>
+</dependency>
+```
+
+### Gradle coordinates:
+
+```groovy
+implementation 'com.github.prominence:openweathermap-api:2.2.0'
+```
+
+### 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()`
+
+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 API
+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.                                                  |
+| `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.UKRANIAN                 | 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.12.2
+* org.slf4j:slf4j-api:1.7.30 (*compile*)
+* org.junit.jupiter:junit-jupiter-engine:5.7.1 (*test*)
+* org.junit.platform:junit-platform-runner:1.7.1 (*test*)

docs/Release_2.3.0.md

@@ -0,0 +1,552 @@
+### Implemented features:
+* Current weather data
+* 5 day / 3-hour forecast
+* One Call API
+* Air Pollution
+
+
+Other:
+* Request timeout settings
+
+### Maven coordinates:
+
+```xml
+<dependency>
+  <groupId>com.github.prominence</groupId>
+  <artifactId>openweathermap-api</artifactId>
+  <version>2.3.0</version>
+</dependency>
+```
+
+### Gradle coordinates:
+
+```groovy
+implementation 'com.github.prominence:openweathermap-api:2.3.0'
+```
+
+### 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 API
+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.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*)

docs/SNAPSHOT.md

@@ -1,389 +1,589 @@
 ### Implemented features:
 * Current weather data
-* 5 day / 3 hour forecast
+* Hourly forecast
-* 16 day / daily forecast
+* One Call API
-* UV Index
+* Daily forecast
+* Solar Radiation API
+* 5 day / 3-hour forecast
+* Road Risk API
 * Air Pollution
+* Geocoding API
+
+
+Other:
+* Request timeout settings
 
 ### Maven coordinates:
 
 ```xml
 <dependency>
-  <groupId>com.github.prominence</groupId>
+    <groupId>com.github.prominence</groupId>
-  <artifactId>openweathermap-api</artifactId>
+    <artifactId>openweathermap-api</artifactId>
-  <version>1.0-SNAPSHOT</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:1.0-SNAPSHOT')
+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:
 
-Firstly, you need to create the instance of `OpenWeatherMapManager` class:
+Firstly, you need to create the instance of `OpenWeatherMapClient` class:
 ```java
-OpenWeatherMapManager openWeatherManager = new OpenWeatherMapManager(API_TOKEN);
+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 methods:
+Currently, available APIs are:
-* `getWeatherRequester()`
+* `currentWeather()`
-* `getHourlyForecastRequester()`
+* `forecast5Day3HourStep()`
-* `getDailyForecastRequester()`
+* `oneCall()`
-* `getUltravioletIndexRequester()`
+* `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
-First step is retrieving `WeatherRequester` instance:
+Examples:
 ```java
-OpenWeatherMapManager openWeatherManager = new OpenWeatherMapManager(API_TOKEN);
+final String weatherJson = openWeatherClient
-WeatherRequester weatherRequester = openWeatherManager.getWeatherRequester();
+        .currentWeather()
+        .single()
+        .byCityName("Minsk")
+        .language(Language.RUSSIAN)
+        .unitSystem(UnitSystem.IMPERIAL)
+        .retrieve()
+        .asJSON();
 ```
-after you are able to set preferable options(via chain methods) and execute appropriate request:
+
+```java
+final Weather weather = openWeatherClient
+        .currentWeather()
+        .single()
+        .byCityName("Minsk")
+        .language(Language.RUSSIAN)
+        .unitSystem(UnitSystem.METRIC)
+        .retrieve()
+        .asJava();
 ```
-Weather weatherResponse = weatherRequester
+
-    .setLanguage(Language.ENGLISH)
+```java
-    .setUnitSystem(Unit.METRIC_SYSTEM)
+final List<Weather> weatherList = openWeatherClient
-    .setAccuracy(Accuracy.ACCURATE)
+        .currentWeather()
-    .getByCityName("Minsk");
+        .multiple()
+        .byCitiesInCycle(Coordinate.of(55.5, 37.5))
+        .language(Language.GERMAN)
+        .unitSystem(UnitSystem.IMPERIAL)
+        .retrieve()
+        .asJava();
 ```
-*Language*, *UnitSystem* and *Accuracy* settings will be described below.
 
-Available requests:
+```java
-* `getByCityId(String cityId)`
+final CompletableFuture<String> weatherXmlFuture = openWeatherClient
-* `getByCityName(String cityName)`
+        .currentWeather()
-* `getByCoordinates(double latitude, double longitude)`
+        .single()
-* `getByCoordinates(Coordinates coordinates)`
+        .byZipCodeAndCountry("220015", "by")
-* `getByZIPCode(String zipCode, String countryCode)`
+        .language(Language.RUSSIAN)
+        .unitSystem(UnitSystem.METRIC)
+        .retrieveAsync()
+        .asXML();
+```
 
-`Weather`'s useful public methods(setters are not listed):
+You are able to set preferable options(via chain methods) and execute appropriate request.
 
-| Method                    | Description                                                                                                                                                     |
+`com.github.prominence.openweathermap.api.model.weather.Weather`'s useful public methods(setters are not listed):
-|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
+
-| `getCityId()`             | Returns city ID. Example: `625144` for Minsk.                                                                                                                   |
+| Method                    | Description                                                                                                                                                               |
-| `getCityName()`           | Returns city name. Example: `Minsk`.                                                                                                                            |
+|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `getCoordinates()`        | Returns `Coordinates` instance that contains *latitude* and *longitude* information.                                                                            |
+| `getCalculationTime()`    | Returns `LocalDateTime` object with data calculation time.                                                                                                                |
-| `getWeatherStates()`      | Returns list of `WeatherState` instances with the only `getDescription` useful method.                                                                          |
+| `getWeatherState()`       | Returns `WeatherState` object with basic weather state information.                                                                                                       |
-| `getBase()`               | Returns `String` with some internal information. Example: `cmc stations` - from official documentation.                                                         |
+| `getTemperature()`        | Returns `Temperature` instance that contains information about temperature. Available fields: `value`, `maxTemperature`, `minTemperature`, `feelsLike` and `unit`.        |
-| `getWeatherInfo()`        | Returns `Weather.WeatherInfo` instance that contains information about temperature, pressure and humidity.                                                      |
+| `getAtmosphericPressure()`| Returns `AtmosphericPressure` instance that contains information about atmospheric pressure. Available fields: `value`, `seaLevelValue`, `groundLevelValue` and `unit`.   |
-| `getWind()`               | Returns `Wind` instance that contains information about speed and degree.                                                                                       |
+| `getHumidity()`           | Returns `Humidity` instance that contains humidity percentage information.                                                                                                |
-| `getClouds()`             | Returns `Clouds` instance that contains *cloudiness* 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 3 hours.                                                                       |
+| `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 3 hours.                                                                       |
+| `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.                      |
-| `getDataCalculationTime()`| Returns `long` value that represents data calculation timestamp.                                                                                                |
+| `getClouds()`             | Returns `Clouds` instance that contains information about cloudiness percentage.                                                                                          |
-| `getWeatherSystemInfo()`  | Returns `Weather.WeatherSystemInfo` instance that contains internal information. There is also an information about country, sunrise and sunset time.           |
+| `getLocation()`           | Returns `Location` object. Available fields: `id`, `name`, `countryCode`, `sunrise` and `sunset` time, `zoneOffset` and `coordinates`.                                     |
-| `getResponseCode()`       | Returns OpenWeatherMap response code. Internal information.                                                                                                     |
+| `toString()`              | Returns informative string for the whole available weather information.                                                                                                   |
-| `getCountry()`            | An alias for `getWeatherSystemInfo().getCountry()`.                                                                                                             |
-| `getWeatherDescription()` | An alias for `getWeatherStates.get(0).getDescription()`.                                                                                                        |
-| `getDataCalculationDate()`| Returns data calculation time in `Date` representation.                                                                                                         |
-| `getTemperature()`        | An alias for `getWeatherInfo().getTemperature()`.                                                                                                               |
-| `getTemperatureUnit()`    | An alias for `getWeatherInfo().getTemperatureUnit()`.                                                                                                           |
-| `getPressure()`           | An alias for `getWeatherInfo().getPressure()`.                                                                                                                  |
-| `getPressureUnit()`       | An alias for `getWeatherInfo().getPressureUnit()`.                                                                                                              |
-| `getHumidityPercentage()` | An alias for `getWeatherInfo().getHumidity()`.                                                                                                                  |
-| `toString()`              | Returns pretty string for the whole available weather information.                                                                                              |
 
 `toString()` output example:
 ```
-City: Minsk(625144). Coordinates: latitude=53.9, longitude=27.56
+Location: Minsk(BY), Weather: clear sky, -4.22 ℃, 1020.0 hPa, Clouds: 0%
-Country: BY
-Sunrise: Sun Jul 15 04:58:27 MSK 2018
-Sunset: Sun Jul 15 21:32:19 MSK 2018
-Weather: light intensity shower rain
-Temperature: 17.0 ℃. Minimum temparature: 17.0 ℃. Maximum temperature: 17.0 ℃
-Humidity: 93%
-Pressure: 1008 hPa
-Wind: 2.0 meter/sec, 20 degrees
-Cloudiness: 75%
-Data calculation time: Mon Jul 16 00:00:00 MSK 2018
 ```
 
-#### 5 day / 3 hour forecast
+#### 5 day / 3-hour forecast
-First step is retrieving `HourlyForecastRequester` instance:
+Examples:
 ```java
-OpenWeatherMapManager openWeatherManager = new OpenWeatherMapManager(API_TOKEN);
+final Forecast forecast = openWeatherClient
-HourlyForecastRequester forecastRequester = openWeatherManager.getHourlyForecastRequester();
+        .forecast5Day3HourStep()
+        .byCityName("Minsk")
+        .language(Language.ENGLISH)
+        .unitSystem(UnitSystem.METRIC)
+        .count(15)
+        .retrieve()
+        .asJava();
 ```
-after you are able to set preferable options(via chain methods) and execute appropriate request:
+
+```java
+final String forecastJson = getClient()
+        .forecast5Day3HourStep()
+        .byCityName("New York", "NY", "US")
+        .language(Language.SPANISH)
+        .unitSystem(UnitSystem.IMPERIAL)
+        .count(15)
+        .retrieve()
+        .asJSON();
 ```
-HourlyForecast forecastResponse = forecastRequester
+
-    .setLanguage(Language.ENGLISH)
+```java
-    .setUnitSystem(Unit.METRIC_SYSTEM)
+CompletableFuture<String> forecastFuture = getClient()
-    .setAccuracy(Accuracy.ACCURATE)
+        .forecast5Day3HourStep()
-    .getByCityName("Pruzhany");
+        .byCityId(350001514)
+        .language(Language.ENGLISH)
+        .unitSystem(UnitSystem.METRIC)
+        .count(15)
+        .retrieveAsync()
+        .asXML();
 ```
-*Language*, *UnitSystem* and *Accuracy* settings will be described below.
 
-Available requests:
+```java
-* `getByCityId(String cityId)`
+final String forecastXml = getClient()
-* `getByCityName(String cityName)`
+        .forecast5Day3HourStep()
-* `getByCoordinates(double latitude, double longitude)`
+        .byZipCodeInUSA("10005")
-* `getByCoordinates(Coordinates coordinates)`
+        .language(Language.ENGLISH)
-* `getByZIPCode(String zipCode, String countryCode)`
+        .unitSystem(UnitSystem.METRIC)
+        .retrieve()
+        .asXML();
+```
 
-`HourlyForecast`'s useful public methods(setters are not listed):
+You are able to set preferable options(via chain methods) and execute appropriate request.
 
-| Method                      | Description                                                                                |
+`com.github.prominence.openweathermap.api.model.forecast.free.Forecast`'s useful public methods(setters are not listed):
-|-----------------------------|--------------------------------------------------------------------------------------------|
+
-| `getCityId()`               | Returns city ID. Example: `625144` for Minsk.                                              |
+| Method                        | Description                                                                                                                                           |
-| `getCityName()`             | Returns city name. Example: `Minsk`.                                                       |
+|-------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `getCoordinates()`          | Returns `Coordinates` instance that contains *latitude* and *longitude* information.       |
+| `getLocation()`               | Returns `Location` object. Available fields: `id`, `name`, `countryCode`, `sunrise` and `sunset` time, `zoneOffset`, `coordinates` and `population`.   |
-| `getCityInfo()`             | Returns `CityInfo` instance that contains information about city.                          |
+| `getWeatherForecasts()`       | Returns list of `WeatherForecast` objects with forecast information.                                                                                  |
-| `getResponseCode()`         | Returns OpenWeatherMap response code. Internal information.                                |
+| `toString()`                  | Returns informative string for the whole available forecast information.                                                                              |
-| `getCountry()`              | An alias for `getCityInfo().getCountry()`.                                                 |
-| `getForecasts()`            | Returns `List<HourlyForecast.Forecast>` collection with all forecast information.          |
-| `getAverageTemperature()`   | Returns average temperature from forecasts.                                                |
-| `getMinimumTemperature()`   | Returns minimum temperature from forecasts.                                                |
-| `getMaximumTemperature()`   | Returns maximum temperature from forecasts.                                                |
-| `getByMinimumTemperature()` | Returns `HourlyForecast.Forecast` for the time where temperature is minimal.               |
-| `getByMaximumTemperature()` | Returns `HourlyForecast.Forecast` for the time where temperature is maximal.               |
-| `getAveragePressure()`      | Returns average pressure from forecasts.                                                   |
-| `getMinimumPressure()`      | Returns minimum pressure from forecasts.                                                   |
-| `getMaximumPressure()`      | Returns maximum pressure from forecasts.                                                   |
-| `getByMinimumPressure()`    | Returns `HourlyForecast.Forecast` for the time where pressure is minimal.                  |
-| `getByMaximumPressure()`    | Returns `HourlyForecast.Forecast` for the time where pressure is maximal.                  |
-| `toString()`                | Returns pretty string for the whole available forecast information.                        |
 
 `toString()` output example:
 ```
-City: Pruzhany(622997). Coordinates: latitude=52.5582, longitude=24.4567
+A forecast for Minsk with 15 timestamps.
-Country: BY
-Forecasts:
-    Time: Tue Jul 17 00:00:00 MSK 2018. Weather: light rain. Temperature: 16.24 ℃. Minimum temperature: 16.24 ℃. Maximum temperature: 17.36 ℃. Pressure: 997.38 hPa. Sea-level pressure: 1018.59 hPa. Ground-level pressure: 997.38 hPa. Humidity: 99%. Cloudiness: 80%. Wind: 2.85 meter/sec, 324 degrees. Rain(last 3 hrs): 0 mm
-    Time: Tue Jul 17 03:00:00 MSK 2018. Weather: moderate rain. Temperature: 16.0 ℃. Minimum temperature: 16.0 ℃. Maximum temperature: 16.83 ℃. Pressure: 996.88 hPa. Sea-level pressure: 1017.86 hPa. Ground-level pressure: 996.88 hPa. Humidity: 99%. Cloudiness: 80%. Wind: 1.86 meter/sec, 349 degrees. Rain(last 3 hrs): 3 mm
-    Time: Tue Jul 17 06:00:00 MSK 2018. Weather: light rain. Temperature: 15.76 ℃. Minimum temperature: 15.76 ℃. Maximum temperature: 16.31 ℃. Pressure: 996.7 hPa. Sea-level pressure: 1017.72 hPa. Ground-level pressure: 996.7 hPa. Humidity: 94%. Cloudiness: 76%. Wind: 1.62 meter/sec, 113 degrees. Rain(last 3 hrs): 0 mm
-    Time: Tue Jul 17 09:00:00 MSK 2018. Weather: light rain. Temperature: 18.23 ℃. Minimum temperature: 18.23 ℃. Maximum temperature: 18.51 ℃. Pressure: 997.17 hPa. Sea-level pressure: 1018.18 hPa. Ground-level pressure: 997.17 hPa. Humidity: 100%. Cloudiness: 76%. Wind: 2.11 meter/sec, 107 degrees. Rain(last 3 hrs): 0 mm
-    Time: Tue Jul 17 12:00:00 MSK 2018. Weather: light rain. Temperature: 21.0 ℃. Minimum temperature: 21.0 ℃. Maximum temperature: 21.0 ℃. Pressure: 997.6 hPa. Sea-level pressure: 1018.5 hPa. Ground-level pressure: 997.6 hPa. Humidity: 100%. Cloudiness: 68%. Wind: 2.51 meter/sec, 82 degrees. Rain(last 3 hrs): 0 mm
-    Time: Tue Jul 17 15:00:00 MSK 2018. Weather: light rain. Temperature: 21.78 ℃. Minimum temperature: 21.78 ℃. Maximum temperature: 21.78 ℃. Pressure: 997.73 hPa. Sea-level pressure: 1018.66 hPa. Ground-level pressure: 997.73 hPa. Humidity: 92%. Cloudiness: 88%. Wind: 4.05 meter/sec, 78 degrees. Rain(last 3 hrs): 0 mm
-    Time: Tue Jul 17 18:00:00 MSK 2018. Weather: light rain. Temperature: 22.9 ℃. Minimum temperature: 22.9 ℃. Maximum temperature: 22.9 ℃. Pressure: 997.66 hPa. Sea-level pressure: 1018.55 hPa. Ground-level pressure: 997.66 hPa. Humidity: 93%. Cloudiness: 68%. Wind: 3.06 meter/sec, 67 degrees. Rain(last 3 hrs): 0 mm
-    Time: Tue Jul 17 21:00:00 MSK 2018. Weather: light rain. Temperature: 23.04 ℃. Minimum temperature: 23.04 ℃. Maximum temperature: 23.04 ℃. Pressure: 996.89 hPa. Sea-level pressure: 1017.99 hPa. Ground-level pressure: 996.89 hPa. Humidity: 83%. Cloudiness: 88%. Wind: 3.17 meter/sec, 16 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 00:00:00 MSK 2018. Weather: moderate rain. Temperature: 18.5 ℃. Minimum temperature: 18.5 ℃. Maximum temperature: 18.5 ℃. Pressure: 997.33 hPa. Sea-level pressure: 1018.34 hPa. Ground-level pressure: 997.33 hPa. Humidity: 97%. Cloudiness: 44%. Wind: 3.56 meter/sec, 31 degrees. Rain(last 3 hrs): 7 mm
-    Time: Wed Jul 18 03:00:00 MSK 2018. Weather: few clouds. Temperature: 18.57 ℃. Minimum temperature: 18.57 ℃. Maximum temperature: 18.57 ℃. Pressure: 996.91 hPa. Sea-level pressure: 1017.87 hPa. Ground-level pressure: 996.91 hPa. Humidity: 95%. Cloudiness: 24%. Wind: 5.26 meter/sec, 44 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 06:00:00 MSK 2018. Weather: few clouds. Temperature: 18.94 ℃. Minimum temperature: 18.94 ℃. Maximum temperature: 18.94 ℃. Pressure: 997.07 hPa. Sea-level pressure: 1018.06 hPa. Ground-level pressure: 997.07 hPa. Humidity: 95%. Cloudiness: 20%. Wind: 4.8 meter/sec, 45 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 09:00:00 MSK 2018. Weather: light rain. Temperature: 20.6 ℃. Minimum temperature: 20.6 ℃. Maximum temperature: 20.6 ℃. Pressure: 997.8 hPa. Sea-level pressure: 1018.66 hPa. Ground-level pressure: 997.8 hPa. Humidity: 97%. Cloudiness: 48%. Wind: 5.56 meter/sec, 54 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 12:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.87 ℃. Minimum temperature: 23.87 ℃. Maximum temperature: 23.87 ℃. Pressure: 998.06 hPa. Sea-level pressure: 1019.05 hPa. Ground-level pressure: 998.06 hPa. Humidity: 88%. Cloudiness: 32%. Wind: 5.86 meter/sec, 52 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 24.67 ℃. Minimum temperature: 24.67 ℃. Maximum temperature: 24.67 ℃. Pressure: 998.51 hPa. Sea-level pressure: 1019.33 hPa. Ground-level pressure: 998.51 hPa. Humidity: 84%. Cloudiness: 36%. Wind: 5.63 meter/sec, 51 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 18:00:00 MSK 2018. Weather: scattered clouds. Temperature: 25.15 ℃. Minimum temperature: 25.15 ℃. Maximum temperature: 25.15 ℃. Pressure: 998.79 hPa. Sea-level pressure: 1019.64 hPa. Ground-level pressure: 998.79 hPa. Humidity: 78%. Cloudiness: 44%. Wind: 5.47 meter/sec, 38 degrees. Rain(last 3 hrs): 0 mm
-    Time: Wed Jul 18 21:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.23 ℃. Minimum temperature: 23.23 ℃. Maximum temperature: 23.23 ℃. Pressure: 999.08 hPa. Sea-level pressure: 1020.04 hPa. Ground-level pressure: 999.08 hPa. Humidity: 75%. Cloudiness: 48%. Wind: 4.62 meter/sec, 25 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 00:00:00 MSK 2018. Weather: scattered clouds. Temperature: 20.79 ℃. Minimum temperature: 20.79 ℃. Maximum temperature: 20.79 ℃. Pressure: 999.67 hPa. Sea-level pressure: 1020.68 hPa. Ground-level pressure: 999.67 hPa. Humidity: 76%. Cloudiness: 48%. Wind: 4.29 meter/sec, 13 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 03:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.45 ℃. Minimum temperature: 19.45 ℃. Maximum temperature: 19.45 ℃. Pressure: 999.95 hPa. Sea-level pressure: 1021.02 hPa. Ground-level pressure: 999.95 hPa. Humidity: 80%. Cloudiness: 48%. Wind: 4.22 meter/sec, 17 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 06:00:00 MSK 2018. Weather: light rain. Temperature: 18.9 ℃. Minimum temperature: 18.9 ℃. Maximum temperature: 18.9 ℃. Pressure: 1000.6 hPa. Sea-level pressure: 1021.62 hPa. Ground-level pressure: 1000.6 hPa. Humidity: 83%. Cloudiness: 92%. Wind: 4.43 meter/sec, 10 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 09:00:00 MSK 2018. Weather: light rain. Temperature: 21.37 ℃. Minimum temperature: 21.37 ℃. Maximum temperature: 21.37 ℃. Pressure: 1000.95 hPa. Sea-level pressure: 1022.01 hPa. Ground-level pressure: 1000.95 hPa. Humidity: 87%. Cloudiness: 0%. Wind: 4.36 meter/sec, 6 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 12:00:00 MSK 2018. Weather: clear sky. Temperature: 23.92 ℃. Minimum temperature: 23.92 ℃. Maximum temperature: 23.92 ℃. Pressure: 1001.5 hPa. Sea-level pressure: 1022.43 hPa. Ground-level pressure: 1001.5 hPa. Humidity: 77%. Cloudiness: 0%. Wind: 5.66 meter/sec, 12 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 15:00:00 MSK 2018. Weather: broken clouds. Temperature: 23.7 ℃. Minimum temperature: 23.7 ℃. Maximum temperature: 23.7 ℃. Pressure: 1001.75 hPa. Sea-level pressure: 1022.72 hPa. Ground-level pressure: 1001.75 hPa. Humidity: 72%. Cloudiness: 56%. Wind: 5.87 meter/sec, 349 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 18:00:00 MSK 2018. Weather: broken clouds. Temperature: 23.82 ℃. Minimum temperature: 23.82 ℃. Maximum temperature: 23.82 ℃. Pressure: 1001.55 hPa. Sea-level pressure: 1022.59 hPa. Ground-level pressure: 1001.55 hPa. Humidity: 72%. Cloudiness: 68%. Wind: 5.47 meter/sec, 340 degrees. Rain(last 3 hrs): 0 mm
-    Time: Thu Jul 19 21:00:00 MSK 2018. Weather: broken clouds. Temperature: 22.22 ℃. Minimum temperature: 22.22 ℃. Maximum temperature: 22.22 ℃. Pressure: 1001.82 hPa. Sea-level pressure: 1022.93 hPa. Ground-level pressure: 1001.82 hPa. Humidity: 67%. Cloudiness: 76%. Wind: 4.12 meter/sec, 333 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 00:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.76 ℃. Minimum temperature: 19.76 ℃. Maximum temperature: 19.76 ℃. Pressure: 1001.98 hPa. Sea-level pressure: 1023.13 hPa. Ground-level pressure: 1001.98 hPa. Humidity: 76%. Cloudiness: 32%. Wind: 4.11 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 03:00:00 MSK 2018. Weather: clear sky. Temperature: 17.53 ℃. Minimum temperature: 17.53 ℃. Maximum temperature: 17.53 ℃. Pressure: 1001.93 hPa. Sea-level pressure: 1023.13 hPa. Ground-level pressure: 1001.93 hPa. Humidity: 87%. Cloudiness: 8%. Wind: 4.21 meter/sec, 309 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 06:00:00 MSK 2018. Weather: scattered clouds. Temperature: 16.83 ℃. Minimum temperature: 16.83 ℃. Maximum temperature: 16.83 ℃. Pressure: 1001.79 hPa. Sea-level pressure: 1022.99 hPa. Ground-level pressure: 1001.79 hPa. Humidity: 91%. Cloudiness: 44%. Wind: 3.65 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 09:00:00 MSK 2018. Weather: light rain. Temperature: 19.57 ℃. Minimum temperature: 19.57 ℃. Maximum temperature: 19.57 ℃. Pressure: 1001.34 hPa. Sea-level pressure: 1022.41 hPa. Ground-level pressure: 1001.34 hPa. Humidity: 85%. Cloudiness: 8%. Wind: 4.38 meter/sec, 305 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 12:00:00 MSK 2018. Weather: clear sky. Temperature: 23.5 ℃. Minimum temperature: 23.5 ℃. Maximum temperature: 23.5 ℃. Pressure: 1001.0 hPa. Sea-level pressure: 1021.99 hPa. Ground-level pressure: 1001.0 hPa. Humidity: 85%. Cloudiness: 8%. Wind: 5.36 meter/sec, 299 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 25.14 ℃. Minimum temperature: 25.14 ℃. Maximum temperature: 25.14 ℃. Pressure: 1000.5 hPa. Sea-level pressure: 1021.51 hPa. Ground-level pressure: 1000.5 hPa. Humidity: 73%. Cloudiness: 32%. Wind: 6.72 meter/sec, 305 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 18:00:00 MSK 2018. Weather: overcast clouds. Temperature: 23.56 ℃. Minimum temperature: 23.56 ℃. Maximum temperature: 23.56 ℃. Pressure: 1000.7 hPa. Sea-level pressure: 1021.58 hPa. Ground-level pressure: 1000.7 hPa. Humidity: 66%. Cloudiness: 88%. Wind: 6.57 meter/sec, 317 degrees. Rain(last 3 hrs): 0 mm
-    Time: Fri Jul 20 21:00:00 MSK 2018. Weather: broken clouds. Temperature: 22.41 ℃. Minimum temperature: 22.41 ℃. Maximum temperature: 22.41 ℃. Pressure: 1000.64 hPa. Sea-level pressure: 1021.67 hPa. Ground-level pressure: 1000.64 hPa. Humidity: 68%. Cloudiness: 64%. Wind: 4.31 meter/sec, 326 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 00:00:00 MSK 2018. Weather: broken clouds. Temperature: 20.92 ℃. Minimum temperature: 20.92 ℃. Maximum temperature: 20.92 ℃. Pressure: 1001.06 hPa. Sea-level pressure: 1022.14 hPa. Ground-level pressure: 1001.06 hPa. Humidity: 78%. Cloudiness: 68%. Wind: 3.42 meter/sec, 327 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 03:00:00 MSK 2018. Weather: broken clouds. Temperature: 20.28 ℃. Minimum temperature: 20.28 ℃. Maximum temperature: 20.28 ℃. Pressure: 1001.04 hPa. Sea-level pressure: 1022.13 hPa. Ground-level pressure: 1001.04 hPa. Humidity: 78%. Cloudiness: 76%. Wind: 4.27 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 06:00:00 MSK 2018. Weather: scattered clouds. Temperature: 19.11 ℃. Minimum temperature: 19.11 ℃. Maximum temperature: 19.11 ℃. Pressure: 1001.13 hPa. Sea-level pressure: 1022.28 hPa. Ground-level pressure: 1001.13 hPa. Humidity: 74%. Cloudiness: 32%. Wind: 4.96 meter/sec, 308 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 09:00:00 MSK 2018. Weather: few clouds. Temperature: 20.16 ℃. Minimum temperature: 20.16 ℃. Maximum temperature: 20.16 ℃. Pressure: 1001.43 hPa. Sea-level pressure: 1022.62 hPa. Ground-level pressure: 1001.43 hPa. Humidity: 86%. Cloudiness: 20%. Wind: 5.16 meter/sec, 308 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 12:00:00 MSK 2018. Weather: few clouds. Temperature: 22.37 ℃. Minimum temperature: 22.37 ℃. Maximum temperature: 22.37 ℃. Pressure: 1001.53 hPa. Sea-level pressure: 1022.62 hPa. Ground-level pressure: 1001.53 hPa. Humidity: 88%. Cloudiness: 20%. Wind: 5.56 meter/sec, 307 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 15:00:00 MSK 2018. Weather: scattered clouds. Temperature: 22.85 ℃. Minimum temperature: 22.85 ℃. Maximum temperature: 22.85 ℃. Pressure: 1001.63 hPa. Sea-level pressure: 1022.65 hPa. Ground-level pressure: 1001.63 hPa. Humidity: 81%. Cloudiness: 44%. Wind: 5.46 meter/sec, 314 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 18:00:00 MSK 2018. Weather: scattered clouds. Temperature: 23.79 ℃. Minimum temperature: 23.79 ℃. Maximum temperature: 23.79 ℃. Pressure: 1001.53 hPa. Sea-level pressure: 1022.53 hPa. Ground-level pressure: 1001.53 hPa. Humidity: 72%. Cloudiness: 32%. Wind: 5.56 meter/sec, 313 degrees. Rain(last 3 hrs): 0 mm
-    Time: Sat Jul 21 21:00:00 MSK 2018. Weather: scattered clouds. Temperature: 22.56 ℃. Minimum temperature: 22.56 ℃. Maximum temperature: 22.56 ℃. Pressure: 1001.72 hPa. Sea-level pressure: 1022.7 hPa. Ground-level pressure: 1001.72 hPa. Humidity: 66%. Cloudiness: 48%. Wind: 3.96 meter/sec, 312 degrees. Rain(last 3 hrs): 0 mm
 ```
 
-`HourlyForecast.Forecast`'s useful public methods(setters are not listed):
+`com.github.prominence.openweathermap.api.model.forecast.free.WeatherForecast`'s useful public methods(setters are not listed):
 
-| Method                      | Description                                                                                                      |
+| Method                        | Description                                                                                                                                                               |
-|-----------------------------|------------------------------------------------------------------------------------------------------------------|
+|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `getDataCalculationTime()`  | Returns `long` value that represents data calculation timestamp.                                                 |
+| `getForecastTime()`           | Returns `LocalDateTime` object with weather forecast time.                                                                                                                |
-| `getDataCalculationDate()`  | Returns data calculation time in `Date` representation.                                                          |
+| `getWeatherState()`           | Returns `WeatherState` object with basic weather state information.                                                                                                       |
-| `getWeatherInfo()`          | Returns `HourlyForecast.WeatherInfo` instance that contains information about temperature, pressure and humidity.|
+| `getTemperature()`            | Returns `Temperature` instance that contains information about temperature. Available fields: `value`, `maxTemperature`, `minTemperature`, `feelsLike` and `unit`.        |
-| `getWeatherStates()`        | Returns list of `WeatherState` instances with the only `getDescription` useful method.                           |
+| `getAtmosphericPressure()`    | Returns `AtmosphericPressure` instance that contains information about atmospheric pressure. Available fields: `value`, `seaLevelValue`, `groundLevelValue` and `unit`.   |
-| `getClouds()`               | Returns `Clouds` instance that contains *cloudiness* percentage information.                                     |
+| `getHumidity()`               | Returns `Humidity` instance that contains humidity percentage information.                                                                                                |
-| `getWind()`                 | Returns `Wind` instance that contains information about speed and degree.                                        |
+| `getWind()`                   | Returns `Wind` instance that contains wind information: `speed`, `degrees` and `unit`.                                                                                    |
-| `getSnow()`                 | Returns `Snow` instance that contains information about snow volume for the last 3 hours.                        |
+| `getRain()`                   | Returns `Rain` instance that contains information about rain volume for the last 3 hours. Can be absent in case of no data.                                               |
-| `getRain()`                 | Returns `Rain` instance that contains information about rain volume for the last 3 hours.                        |
+| `getSnow()`                   | Returns `Snow` instance that contains information about snow volume for the last 3 hours. Can be absent in case of no data.                                               |
-| `getSystemInfo()`           | Returns `HourlyForecast.ForecastSystemInfo` instance with internal information.                                  |
+| `getClouds()`                 | Returns `Clouds` instance that contains information about cloudiness percentage.                                                                                          |
-| `getDt_txt()`               | Returns `String` value that represents data calculation time.                                                    |
+| `getForecastTimeISO()`        | Returns String with time of data forecasted, ISO, UTC.                                                                                                                    |
-| `toString()`                | Returns pretty string for the whole available forecast information.                                              |
+| `getDayTime()`                | Returns enumerations representing the part of day(day, night).                                                                                                            |
+| `toString()`                  | Returns informative string for the forecast of particular timestamp.                                                                                                      |
 
-#### 16 day / daily forecast
+#### One Call API
-First step is retrieving `DailyForecastRequester` instance:
+Examples:
 ```java
-OpenWeatherMapManager openWeatherManager = new OpenWeatherMapManager(API_TOKEN);
+final CurrentWeatherData currentWeatherData = openWeatherClient
-DailyForecastRequester forecastRequester = openWeatherManager.getDailyForecastRequester();
+        .oneCall()
+        .current()
+        .byCoordinate(Coordinate.of(53.54, 27.34))
+        .language(Language.ENGLISH)
+        .unitSystem(UnitSystem.METRIC)
+        .retrieve()
+        .asJava();
 ```
-after you are able to set preferable options(via chain methods) and execute appropriate request:
-```
-DailyForecast forecastResponse = forecastRequester
-    .setLanguage(Language.ENGLISH)
-    .setUnitSystem(Unit.METRIC_SYSTEM)
-    .setAccuracy(Accuracy.ACCURATE)
-    .getByCityName("Pruzhany");
-```
-*Language*, *UnitSystem* and *Accuracy* settings will be described below.
 
-Available requests:
-* `getByCityId(String cityId)`
-* `getByCityName(String cityName)`
-* `getByCoordinates(double latitude, double longitude)`
-* `getByCoordinates(Coordinates coordinates)`
-* `getByZIPCode(String zipCode, String countryCode)`
-
-`DailyForecast`'s useful public methods(setters are not listed):
-
-| Method                      | Description                                                                                |
-|-----------------------------|--------------------------------------------------------------------------------------------|
-| `getCityId()`               | Returns city ID. Example: `625144` for Minsk.                                              |
-| `getCityName()`             | Returns city name. Example: `Minsk`.                                                       |
-| `getCoordinates()`          | Returns `Coordinates` instance that contains *latitude* and *longitude* information.       |
-| `getCityInfo()`             | Returns `CityInfo` instance that contains information about city.                          |
-| `getResponseCode()`         | Returns OpenWeatherMap response code. Internal information.                                |
-| `getCountry()`              | An alias for `getCityInfo().getCountry()`.                                                 |
-| `getForecasts()`            | Returns `List<HourlyForecast.Forecast>` collection with all forecast information.          |
-| `toString()`                | Returns pretty string for the whole available forecast information.                        |
-
-`DailyForecast.Forecast`'s useful public methods(setters are not listed):
-
-| Method                      | Description                                                                                                      |
-|-----------------------------|------------------------------------------------------------------------------------------------------------------|
-| `getDataCalculationTime()`  | Returns `long` value that represents data calculation timestamp.                                                 |
-| `getDataCalculationDate()`  | Returns data calculation time in `Date` representation.                                                          |
-| `getTemperature()`          | Returns `DailyForecast.Forecast.Temperature` instance that contains information about temperature(avg, min, max).|
-| `getWeatherStates()`        | Returns list of `WeatherState` instances with the only `getDescription` useful method.                           |
-| `getCloudiness()`           | Returns *cloudiness* percentage information.                                                                     |
-| `getHumidity()`             | Returns *humidity* percentage information.                                                                       |
-| `getWindSpeed()`            | Returns wind's speed.                                                                                            |
-| `getWindDegrees()`          | Returns wind's degree.                                                                                           |
-| `getWindUnit()`             | Returns wind's unit.                                                                                             |
-| `getPressure()`             | Returns pressure value.                                                                                          |
-| `getPressureUnit()`         | Returns pressure's unit.                                                                                         |
-| `toString()`                | Returns pretty string for the whole available forecast information.                                              |
-
-#### UV Index
-
-First step is retrieving `UltravioletIndexRequester` instance:
 ```java
-OpenWeatherMapManager openWeatherMapManager = new OpenWeatherMapManager(API_TOKEN);
+final CurrentWeatherData currentWeatherData = openWeatherClient
-UltravioletIndexRequester requester = openWeatherMapManager.getUltravioletIndexRequester();
+        .oneCall()
-```
+        .current()
-after you need to set coordinates and execute appropriate request:
+        .byCoordinate(Coordinate.of(53.54, 27.34))
-```
+        .language(Language.ENGLISH)
-DailyForecast forecastResponse = forecastRequester
+        .unitSystem(UnitSystem.METRIC)
-    .setCoodrinates(55.33f, 24.27f)
+        .exclude(OneCallResultOptions.CURRENT, OneCallResultOptions.MINUTELY)
-    .getCurrentUVIndex();
+        .retrieve()
+        .asJava();
 ```
 
-Available requests:
-* `getCurrentUVIndex()`
-* `getUVIndexForecast(int amountOfDays)`
-* `getUVIndexByPeriod(Date from, Date to)`
-
-`UltravioletIndex`'s useful public methods(setters are not listed):
-
-| Method                    | Description                                                   |
-|---------------------------|---------------------------------------------------------------|
-| `getLatitude()`           | Returns latitude.                                             |
-| `getLongitude()`          | Returns longitude.                                            |
-| `getDateISO()`            | Returns ISO date in String representation.                    |
-| `getDateTimestamp()`      | Returns date timestamp.                                       |
-| `getValue()`              | Returns UV value.                                             |
-| `getCalculationDate()`    | Returns date in Date representation`.                         |
-| `toString()`              | Returns pretty string for the whole available UV information. |
-
-`toString()` output example:
-```
-Date: Tue Jul 31 15:00:00 MSK 2018, Ultraviolet value: 6.230000
-```
-
-#### Air pollution
-
-First step is retrieving `AirPollutionRequester` instance:
 ```java
-OpenWeatherMapManager openWeatherMapManager = new OpenWeatherMapManager(API_TOKEN);
+final CompletableFuture<CurrentWeatherData> currentWeatherDataFuture = openWeatherClient
-AirPollutionRequester requester = openWeatherMapManager.getAirPollutionRequester();
+        .oneCall()
-```
+        .current()
-after you need to set coordinates, time frame, date and execute appropriate request:
+        .byCoordinate(Coordinate.of(53.54, 27.34))
-```
+        .language(Language.ENGLISH)
-DailyForecast forecastResponse = forecastRequester
+        .unitSystem(UnitSystem.METRIC)
-    .setCoordinates(0.0f, 10.0f)
+        .retrieveAsync()
-    .setTimeFrame(TimeFrame.YEAR)
+        .asJava();
-    .setDate(new Date())
-    .retrieve();
 ```
 
-Available requests:
+```java
-* `retrieve()`
+final String responseJson = openWeatherClient
-
+        .oneCall()
-`AirPollution`'s useful public methods(setters are not listed):
+        .current()
-
+        .byCoordinate(Coordinate.of(53.54, 27.34))
-| Method                    | Description                                                               |
+        .language(Language.ENGLISH)
-|---------------------------|---------------------------------------------------------------------------|
+        .unitSystem(UnitSystem.METRIC)
-| `getCoordinates()`        | Returns `Coordinates` instance.                                           |
+        .retrieve()
-| `getLongitude()`          | Returns longitude.                                                        |
+        .asJSON();
-| `airPollutionInfo()`      | Returns list of `AirPollution.AirPollutionInfo` instances.                |
-| `toString()`              | Returns pretty string for the whole available air pollution information.  |
-
-`toString()` output example:
 ```
-AirPollution[Date: Tue Jul 24 01:04:40 MSK 2018; Coordinates: latitude=0.0, longitude=9.9955]
+
-[Value: 8.0347114E-8, Value: 9.5041536E-8, Value: 7.7667146E-8, Value: 7.251491E-8, Value: 5.899763E-8, Value: 1.9186361E-8, Value: 1.729535E-8, Value: 1.25645805E-8, Value: 3.0852514E-9]
+```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                                                                    |
+|-------------------------------|--------------------------------------------------------------------------------|
+| `getCoordinates()`             | 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                                                                   |
+|-------------------------------|-------------------------------------------------------------------------------|
+| `getCoordinates()`             | 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                                                               |
+|-------------------------------|---------------------------------------------------------------------------|
+| `getCoordinates()`             | 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
 
-#### Accuracy
-| Constant           | Description      |
-|--------------------|------------------|
-| Accuracy.LIKE      | Close result.    |
-| Accuracy.ACCURATE  | Accurate result. |
-
 #### Language
-| Constant                          | Description                   |
+| Constant                     | Description                   |
-|-----------------------------------|-------------------------------|
+|------------------------------|-------------------------------|
-| Language.ARABIC                   | Arabic language.              |
+| Language.AFRIKAANS           | Afrikaans language.           |
-| Language.BULGARIAN                | Bulgarian language.           |
+| Language.ALBANIAN            | ALBANIAN language.            |
-| Language.CATALAN                  | Catalan language.             |
+| Language.ARABIC              | Arabic language.              |
-| Language.CZECH                    | Czech language.               |
+| Language.AZERBAIJANI         | Azerbaijani language.         |
-| Language.GERMAN                   | German language.              |
+| Language.BULGARIAN           | Bulgarian language.           |
-| Language.GREEK                    | Greek language.               |
+| Language.CATALAN             | Catalan language.             |
-| Language.ENGLISH                  | English language.             |
+| Language.CZECH               | Czech language.               |
-| Language.PERSIAN                  | Persian (Farsi) language.     |
+| Language.DANISH              | Danish language.              |
-| Language.FINNISH                  | Finnish language.             |
+| Language.GERMAN              | German language.              |
-| Language.FRENCH                   | French language.              |
+| Language.GREEK               | Greek language.               |
-| Language.GALICIAN                 | Galician language.            |
+| Language.ENGLISH             | English language.             |
-| Language.CROATIAN                 | Croatian language.            |
+| Language.BASQUE              | Basque language.              |
-| Language.HUNGARIAN                | Hungarian language.           |
+| Language.PERSIAN             | Persian (Farsi) language.     |
-| Language.ITALIAN                  | Italian language.             |
+| Language.FINNISH             | Finnish language.             |
-| Language.JAPANESE                 | Japanese language.            |
+| Language.FRENCH              | French language.              |
-| Language.KOREAN                   | Korean language.              |
+| Language.GALICIAN            | Galician language.            |
-| Language.LATVIAN                  | Latvian language.             |
+| Language.HEBREW              | Hebrew language.              |
-| Language.LITHUANIAN               | Lithuanian language.          |
+| Language.HINDI               | Hindi language.               |
-| Language.MACEDONIAN               | Macedonian language.          |
+| Language.CROATIAN            | Croatian language.            |
-| Language.DUTCH                    | Dutch language.               |
+| Language.HUNGARIAN           | Hungarian language.           |
-| Language.POLISH                   | Polish language.              |
+| Language.INDONESIAN          | Indonesian language.          |
-| Language.PORTUGUESE               | Portuguese language.          |
+| Language.ITALIAN             | Italian language.             |
-| Language.ROMANIAN                 | Romanian language.            |
+| Language.JAPANESE            | Japanese language.            |
-| Language.RUSSIAN                  | Russian language.             |
+| Language.KOREAN              | Korean language.              |
-| Language.SWEDISH                  | Swedish language.             |
+| Language.LATVIAN             | Latvian language.             |
-| Language.SLOVAK                   | Slovak language.              |
+| Language.LITHUANIAN          | Lithuanian language.          |
-| Language.SLOVENIAN                | Slovenian language.           |
+| Language.MACEDONIAN          | Macedonian language.          |
-| Language.SPANISH                  | Spanish language.             |
+| Language.NORWEGIAN           | Norwegian language.           |
-| Language.TURKISH                  | Turkish language.             |
+| Language.DUTCH               | Dutch language.               |
-| Language.UKRANIAN                 | Ukrainian language.           |
+| Language.POLISH              | Polish language.              |
-| Language.VIETNAMESE               | Vietnamese language.          |
+| Language.PORTUGUESE          | Portuguese language.          |
-| Language.CHINESE_SIMPLIFIED       | Chinese Simplified language.  |
+| Language.PORTUGUES_BRAZIL    | Português Brasil language.    |
-| Language.CHINESE_TRADITIONAL      | Chinese Traditional 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)         |
+| Unit.STANDARD_SYSTEM | Kelvin, meter/sec, hPa, mm(rain, snow).        |
 
 ### Dependencies
-* com.alibaba:fastjson:1.2.44
+* com.fasterxml.jackson.core:jackson-databind:2.13.2.2
-* org.projectlombok:lombok:1.18.0 (*provided*)
+* 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,148 +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>1.1</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>http://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>
-                <configuration>
-                    <source>8</source>
-                    <target>8</target>
-                </configuration>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-jar-plugin</artifactId>
-                <version>3.1.0</version>
-                <configuration>
-                    <excludes>
-                        <exclude>ApplicationTest.class</exclude>
-                    </excludes>
-                </configuration>
-            </plugin>
-            <plugin>
-                <groupId>org.sonatype.plugins</groupId>
-                <artifactId>nexus-staging-maven-plugin</artifactId>
-                <version>1.6.7</version>
-                <extensions>true</extensions>
-                <configuration>
-                    <serverId>ossrh</serverId>
-                    <nexusUrl>https://oss.sonatype.org/</nexusUrl>
-                    <autoReleaseAfterClose>true</autoReleaseAfterClose>
-                </configuration>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-source-plugin</artifactId>
-                <version>2.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>2.9.1</version>
-                <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>1.5</version>
-                <executions>
-                    <execution>
-                        <id>sign-artifacts</id>
-                        <phase>verify</phase>
-                        <goals>
-                            <goal>sign</goal>
-                        </goals>
-                    </execution>
-                </executions>
-            </plugin>
-        </plugins>
-    </build>
-
-    <dependencies>
-        <dependency>
-            <groupId>com.alibaba</groupId>
-            <artifactId>fastjson</artifactId>
-            <version>1.2.44</version>
-        </dependency>
-
-        <dependency>
-            <groupId>org.projectlombok</groupId>
-            <artifactId>lombok</artifactId>
-            <version>1.18.0</version>
-            <scope>provided</scope>
-        </dependency>
-    </dependencies>
-
-</project>

settings.gradle

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

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

@@ -1,98 +0,0 @@
-/*
- * Copyright (c) 2018 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;
-
-import com.github.prominence.openweathermap.api.constants.TimeFrame;
-import com.github.prominence.openweathermap.api.exception.DataNotFoundException;
-import com.github.prominence.openweathermap.api.exception.InvalidAuthTokenException;
-import com.github.prominence.openweathermap.api.model.Coordinates;
-import com.github.prominence.openweathermap.api.model.response.AirPollution;
-import com.github.prominence.openweathermap.api.utils.JSONUtils;
-import com.github.prominence.openweathermap.api.utils.RequestUtils;
-import com.github.prominence.openweathermap.api.utils.TimeFrameUtils;
-
-import java.io.IOException;
-import java.io.InputStream;
-import java.net.MalformedURLException;
-import java.net.URL;
-import java.util.Date;
-
-public class AirPollutionRequester extends AuthenticationTokenBasedRequester {
-
-    private Coordinates coordinates;
-    private TimeFrame timeFrame;
-    private Date date;
-
-    AirPollutionRequester(String authToken) {
-        super(authToken);
-    }
-
-    public AirPollutionRequester setCoordinates(Coordinates coordinates) {
-        this.coordinates = coordinates;
-        return this;
-    }
-
-    public AirPollutionRequester setCoordinates(float latitude, float longitude) {
-        this.coordinates = new Coordinates(latitude, longitude);
-        return this;
-    }
-
-    public AirPollutionRequester setTimeFrame(TimeFrame timeFrame) {
-        this.timeFrame = timeFrame;
-        return this;
-    }
-
-    public AirPollutionRequester setDate(Date date) {
-        this.date = date;
-        return this;
-    }
-
-    public AirPollution retrieve() throws InvalidAuthTokenException, DataNotFoundException {
-        if (coordinates == null || timeFrame == null || date == null) {
-            throw new IllegalArgumentException("You must execute 'setCoordinates', 'setTimeFrame' and 'setDate' and least once.");
-        }
-
-        String requestParameters = String.format("%s,%s/%s.json", coordinates.getLatitude(), coordinates.getLongitude(), TimeFrameUtils.formatDate(date, timeFrame));
-
-        AirPollution airPollution = null;
-
-        try (InputStream response = executeRequest("pollution/v1/co/", requestParameters)) {
-            airPollution = (AirPollution) JSONUtils.parseJSON(response, AirPollution.class);
-        } catch (IOException ex) {
-            ex.printStackTrace();
-        }
-
-        return airPollution;
-    }
-
-    private InputStream executeRequest(String requestType, String requestSpecificParameters) throws MalformedURLException, InvalidAuthTokenException, DataNotFoundException {
-
-        String url = OPEN_WEATHER_BASE_URL + requestType +
-                requestSpecificParameters +
-                "?appid=" +
-                authToken;
-        return RequestUtils.executeGetRequest(new URL(url));
-    }
-
-}

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

@@ -1,109 +0,0 @@
-/*
- * Copyright (c) 2018 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;
-
-import com.github.prominence.openweathermap.api.constants.Unit;
-import com.github.prominence.openweathermap.api.exception.DataNotFoundException;
-import com.github.prominence.openweathermap.api.exception.InvalidAuthTokenException;
-import com.github.prominence.openweathermap.api.model.Coordinates;
-
-import java.net.MalformedURLException;
-import java.net.URL;
-import java.util.Map;
-
-abstract class BasicRequester<T> extends AuthenticationTokenBasedRequester {
-
-    protected String language;
-    protected String unitSystem = Unit.STANDARD_SYSTEM;
-    protected String accuracy;
-
-    protected BasicRequester(String authToken) {
-        super(authToken);
-    }
-
-    public T getByCityId(String id) throws InvalidAuthTokenException, DataNotFoundException {
-        return executeRequest("?id=" + id);
-    }
-
-    public T getByCityName(String name) throws InvalidAuthTokenException, DataNotFoundException {
-        return executeRequest("?q=" + name);
-    }
-
-    public T getByCoordinates(double latitude, double longitude) throws InvalidAuthTokenException, DataNotFoundException {
-        return executeRequest("?lat=" + latitude + "&lon=" + longitude);
-    }
-
-    public T getByCoordinates(Coordinates coordinates) throws InvalidAuthTokenException, DataNotFoundException {
-        return getByCoordinates(coordinates.getLatitude(), coordinates.getLongitude());
-    }
-
-    public T getByZIPCode(String zipCode, String countryCode) throws InvalidAuthTokenException, DataNotFoundException {
-        return executeRequest("?zip=" + zipCode + "," + countryCode);
-    }
-
-    protected URL buildURL(String requestSpecificParameters) throws MalformedURLException {
-
-        StringBuilder urlBuilder = new StringBuilder(OPEN_WEATHER_API_URL);
-        urlBuilder.append(getRequestType());
-        urlBuilder.append(requestSpecificParameters);
-
-        urlBuilder.append("&appid=");
-        urlBuilder.append(authToken);
-
-
-        if (language != null) {
-            urlBuilder.append("&lang=");
-            urlBuilder.append(language);
-        }
-
-        if (!Unit.STANDARD_SYSTEM.equals(unitSystem)) {
-            urlBuilder.append("&units=");
-            urlBuilder.append(unitSystem);
-        }
-
-        if (accuracy != null) {
-            urlBuilder.append("&type=");
-            urlBuilder.append(accuracy);
-        }
-
-        Map<String, String> additionalParameters = getAdditionalParameters();
-        if (additionalParameters != null) {
-            additionalParameters.forEach((key, value) -> {
-                urlBuilder.append("&");
-                urlBuilder.append(key);
-                urlBuilder.append("=");
-                urlBuilder.append(value);
-            });
-        }
-
-        return new URL(urlBuilder.toString());
-    }
-
-    protected Map<String, String> getAdditionalParameters() {
-        return null;
-    }
-
-    protected abstract String getRequestType();
-    protected abstract T executeRequest(String requestSpecificParameters) throws InvalidAuthTokenException, DataNotFoundException;
-
-}

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

@@ -1,87 +0,0 @@
-/*
- * Copyright (c) 2018 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;
-
-import com.github.prominence.openweathermap.api.constants.Unit;
-import com.github.prominence.openweathermap.api.exception.DataNotFoundException;
-import com.github.prominence.openweathermap.api.exception.InvalidAuthTokenException;
-import com.github.prominence.openweathermap.api.model.response.DailyForecast;
-import com.github.prominence.openweathermap.api.utils.JSONUtils;
-import com.github.prominence.openweathermap.api.utils.RequestUtils;
-
-import java.io.IOException;
-import java.io.InputStream;
-import java.util.HashMap;
-import java.util.Map;
-
-public class DailyForecastRequester extends BasicRequester<DailyForecast> {
-
-    int amountOfDays = -1;
-
-    protected DailyForecastRequester(String authToken) {
-        super(authToken);
-    }
-
-    public DailyForecastRequester setAmountOfDays(int amountOfDays) {
-        this.amountOfDays = amountOfDays;
-        return this;
-    }
-
-    @Override
-    protected String getRequestType() {
-        return "forecast/daily";
-    }
-
-    @Override
-    protected Map<String, String> getAdditionalParameters() {
-        Map<String, String> additionalParameters = null;
-        if (amountOfDays != -1) {
-            additionalParameters = new HashMap<>();
-            additionalParameters.put("cnt", String.valueOf(amountOfDays));
-        }
-
-        return additionalParameters;
-    }
-
-    @Override
-    protected DailyForecast executeRequest(String requestSpecificParameters) throws InvalidAuthTokenException, DataNotFoundException {
-        DailyForecast forecastResponse = null;
-
-        try {
-            InputStream requestResult = RequestUtils.executeGetRequest(buildURL(requestSpecificParameters));
-            forecastResponse = (DailyForecast)JSONUtils.parseJSON(requestResult, DailyForecast.class);
-
-            char temperatureUnit = Unit.getTemperatureUnit(unitSystem);
-            String windUnit = Unit.getWindUnit(unitSystem);
-
-            forecastResponse.getForecasts().forEach(forecastInfo -> {
-                forecastInfo.setWindUnit(windUnit);
-                forecastInfo.getTemperature().setTemperatureUnit(temperatureUnit);
-            });
-        } catch (IOException ex) {
-            ex.printStackTrace();
-        }
-
-        return forecastResponse;
-    }
-}

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

@@ -1,82 +0,0 @@
-/*
- * Copyright (c) 2018 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;
-
-import com.github.prominence.openweathermap.api.constants.Unit;
-import com.github.prominence.openweathermap.api.exception.DataNotFoundException;
-import com.github.prominence.openweathermap.api.exception.InvalidAuthTokenException;
-import com.github.prominence.openweathermap.api.model.response.HourlyForecast;
-import com.github.prominence.openweathermap.api.utils.JSONUtils;
-import com.github.prominence.openweathermap.api.utils.RequestUtils;
-
-import java.io.IOException;
-import java.io.InputStream;
-
-public class HourlyForecastRequester extends BasicRequester<HourlyForecast> {
-
-    HourlyForecastRequester(String authToken) {
-        super(authToken);
-    }
-
-    public HourlyForecastRequester setLanguage(String language) {
-        this.language = language;
-        return this;
-    }
-
-    public HourlyForecastRequester setUnitSystem(String unitSystem) {
-        this.unitSystem = unitSystem;
-        return this;
-    }
-
-    public HourlyForecastRequester setAccuracy(String accuracy) {
-        this.accuracy = accuracy;
-        return this;
-    }
-
-    protected String getRequestType() {
-        return "forecast";
-    }
-
-    protected HourlyForecast executeRequest(String requestSpecificParameters) throws InvalidAuthTokenException, DataNotFoundException {
-
-        HourlyForecast forecastResponse = null;
-
-        try {
-            InputStream requestResult = RequestUtils.executeGetRequest(buildURL(requestSpecificParameters));
-            forecastResponse = (HourlyForecast)JSONUtils.parseJSON(requestResult, HourlyForecast.class);
-
-            char temperatureUnit = Unit.getTemperatureUnit(unitSystem);
-            String windUnit = Unit.getWindUnit(unitSystem);
-
-            forecastResponse.getForecasts().forEach(forecastInfo -> {
-                forecastInfo.getWind().setUnit(windUnit);
-                forecastInfo.getWeatherInfo().setTemperatureUnit(temperatureUnit);
-            });
-        } catch (IOException ex) {
-            ex.printStackTrace();
-        }
-
-        return forecastResponse;
-    }
-
-}

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

@@ -0,0 +1,152 @@
+/*
+ * 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;
+
+import com.github.prominence.openweathermap.api.annotation.SubscriptionAvailability;
+import com.github.prominence.openweathermap.api.conf.TimeoutSettings;
+import com.github.prominence.openweathermap.api.request.RequestSettings;
+import com.github.prominence.openweathermap.api.request.air.pollution.AirPollutionRequester;
+import com.github.prominence.openweathermap.api.request.forecast.climatic.ClimaticForecastRequester;
+import com.github.prominence.openweathermap.api.request.forecast.daily.DailyForecastRequester;
+import com.github.prominence.openweathermap.api.request.forecast.free.FiveDayThreeHourStepForecastRequester;
+import com.github.prominence.openweathermap.api.request.forecast.hourly.FourDaysHourlyForecastRequester;
+import com.github.prominence.openweathermap.api.request.geocoding.GeocodingRequester;
+import com.github.prominence.openweathermap.api.request.onecall.OneCallWeatherRequester;
+import com.github.prominence.openweathermap.api.request.radiation.SolarRadiationRequester;
+import com.github.prominence.openweathermap.api.request.roadrisk.RoadRiskRequester;
+import com.github.prominence.openweathermap.api.request.weather.CurrentWeatherRequester;
+
+import static com.github.prominence.openweathermap.api.enums.SubscriptionPlan.*;
+
+/**
+ * The main public API client to communicate with OpenWeatherMap services.
+ * Requires API key for usage. More info on the website <a href="https://openweathermap.org/api">https://openweathermap.org/api</a>.
+ */
+public class OpenWeatherMapClient {
+    private final String apiKey;
+    private final TimeoutSettings timeoutSettings = new TimeoutSettings();
+
+    /**
+     * Created OpenWeatherMap client object.
+     * @param apiKey API key obtained on <a href="https://home.openweathermap.org/api_keys">OpenWeatherMap site</a>.
+     */
+    public OpenWeatherMapClient(String apiKey) {
+        this.apiKey = apiKey;
+    }
+
+    public void setConnectionTimeout(int connectionTimeout) {
+        timeoutSettings.setConnectionTimeout(connectionTimeout);
+    }
+
+    public void setReadTimeout(int readTimeout) {
+        timeoutSettings.setReadTimeout(readTimeout);
+    }
+
+    /**
+     * Current Weather <a href="https://openweathermap.org/current">API</a>.
+     * @return requester for retrieving current weather information.
+     */
+    @SubscriptionAvailability(plans = ALL)
+    public CurrentWeatherRequester currentWeather() {
+        return new CurrentWeatherRequester(new RequestSettings(apiKey, timeoutSettings));
+    }
+
+    /**
+     * Hourly forecast <a href="https://openweathermap.org/api/hourly-forecast">API</a>.
+     * @return requester for retrieving hourly weather forecast information for 4 days.
+     */
+    @SubscriptionAvailability(plans = { DEVELOPER, PROFESSIONAL, ENTERPRISE })
+    public FourDaysHourlyForecastRequester forecastHourly4Days() {
+        return new FourDaysHourlyForecastRequester(new RequestSettings(apiKey, timeoutSettings));
+    }
+
+    /**
+     * One Call <a href="https://openweathermap.org/api/one-call-api">API</a>.
+     * To get information about current weather, minute forecast for 1 hour, hourly forecast for 48 hours, daily forecast for 7 days and government weather alerts.
+     * @return requester for retrieving one call weather information.
+     */
+    @SubscriptionAvailability(plans = ALL)
+    public OneCallWeatherRequester oneCall() {
+        return new OneCallWeatherRequester(new RequestSettings(apiKey, timeoutSettings));
+    }
+
+    /**
+     * Daily forecast <a href="https://openweathermap.org/api/hourly-forecast">API</a>.
+     * @return requester for retrieving daily weather forecast information for 16 days.
+     */
+    @SubscriptionAvailability(plans = PAID)
+    public DailyForecastRequester forecastDaily16Days() {
+        return new DailyForecastRequester(new RequestSettings(apiKey, timeoutSettings));
+    }
+
+    /**
+     * Climatic forecast <a href="https://openweathermap.org/api/forecast30">API</a>.
+     * @return requester for retrieving climatic weather forecast information for 30 days.
+     */
+    @SubscriptionAvailability(plans = { DEVELOPER, PROFESSIONAL, ENTERPRISE })
+    public ClimaticForecastRequester climaticForecast30Days() {
+        return new ClimaticForecastRequester(new RequestSettings(apiKey, timeoutSettings));
+    }
+
+    /**
+     * Solar Radiation <a href="https://openweathermap.org/api/solar-radiation">API</a>.
+     * @return requester for retrieving solar radiation information.
+     */
+    @SubscriptionAvailability(plans = SPECIAL)
+    public SolarRadiationRequester solarRadiation() {
+        return new SolarRadiationRequester(new RequestSettings(apiKey, timeoutSettings));
+    }
+
+    /**
+     * 5 Day / 3 Hour Forecast <a href="https://openweathermap.org/forecast5">API</a>.
+     * @return requester for retrieving 5 day/3-hour weather forecast information.
+     */
+    @SubscriptionAvailability(plans = ALL)
+    public FiveDayThreeHourStepForecastRequester forecast5Day3HourStep() {
+        return new FiveDayThreeHourStepForecastRequester(new RequestSettings(apiKey, timeoutSettings));
+    }
+
+    /**
+     * Road Risk <a href="https://openweathermap.org/api/road-risk">API</a>.
+     * @return requester for retrieving road risk information.
+     */
+    @SubscriptionAvailability(plans = SPECIAL)
+    public RoadRiskRequester roadRisk() {
+        return new RoadRiskRequester(new RequestSettings(apiKey, timeoutSettings));
+    }
+
+    /**
+     * 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.
+     * @return requester for air pollution information retrieval.
+     */
+    @SubscriptionAvailability(plans = ALL)
+    public AirPollutionRequester airPollution() {
+        return new AirPollutionRequester(new RequestSettings(apiKey, timeoutSettings));
+    }
+
+    @SubscriptionAvailability(plans = ALL)
+    public GeocodingRequester geocoding() {
+        return new GeocodingRequester(new RequestSettings(apiKey, timeoutSettings));
+    }
+}

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

@@ -1,112 +0,0 @@
-/*
- * Copyright (c) 2018 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;
-
-import com.alibaba.fastjson.TypeReference;
-import com.github.prominence.openweathermap.api.exception.DataNotFoundException;
-import com.github.prominence.openweathermap.api.exception.InvalidAuthTokenException;
-import com.github.prominence.openweathermap.api.model.Coordinates;
-import com.github.prominence.openweathermap.api.model.response.UltravioletIndex;
-import com.github.prominence.openweathermap.api.utils.JSONUtils;
-import com.github.prominence.openweathermap.api.utils.RequestUtils;
-
-import java.io.IOException;
-import java.io.InputStream;
-import java.net.MalformedURLException;
-import java.net.URL;
-import java.util.Date;
-import java.util.List;
-
-public class UltravioletIndexRequester extends AuthenticationTokenBasedRequester {
-
-    private Coordinates coordinates;
-
-    UltravioletIndexRequester(String authToken) {
-        super(authToken);
-    }
-
-    public UltravioletIndexRequester setCoordinates(Coordinates coordinates) {
-        this.coordinates = coordinates;
-        return this;
-    }
-
-    public UltravioletIndexRequester setCoordinates(float latitude, float longitude) {
-        this.coordinates = new Coordinates(latitude, longitude);
-        return this;
-    }
-
-    public UltravioletIndex getCurrentUVIndex() throws InvalidAuthTokenException, DataNotFoundException {
-        String requestParameters = String.format("lat=%f&lon=%f", coordinates.getLatitude(), coordinates.getLongitude());
-        return getSingleObject(requestParameters);
-    }
-
-    public List<UltravioletIndex> getUVIndexForecast(int amountOfDays) throws InvalidAuthTokenException, DataNotFoundException {
-        String requestParameters = String.format("lat=%f&lon=%f&cnt=%d", coordinates.getLatitude(), coordinates.getLongitude(), amountOfDays);
-       return getListOfObjects(requestParameters);
-    }
-
-    public List<UltravioletIndex> getUVIndexByPeriod(Date from, Date to) throws InvalidAuthTokenException, DataNotFoundException {
-        String requestParameters = String.format("lat=%f&lon=%f&start=%d&end=%d", coordinates.getLatitude(), coordinates.getLongitude(), from.getTime() / 1000, to.getTime() / 1000);
-        return getListOfObjects(requestParameters);
-    }
-
-    private UltravioletIndex getSingleObject(String requestParameters) throws InvalidAuthTokenException, DataNotFoundException {
-        UltravioletIndex ultravioletIndex = null;
-
-        try (InputStream response = executeRequest("uvi", requestParameters)) {
-            ultravioletIndex = (UltravioletIndex) JSONUtils.parseJSON(response, UltravioletIndex.class);
-        } catch (IOException ex) {
-            ex.printStackTrace();
-        }
-
-        return ultravioletIndex;
-    }
-
-    private List<UltravioletIndex> getListOfObjects(String requestParameters) throws InvalidAuthTokenException, DataNotFoundException {
-        List<UltravioletIndex> ultravioletIndex = null;
-
-        TypeReference<List<UltravioletIndex>> typeRef = new TypeReference<List<UltravioletIndex>>() {};
-
-        try (InputStream response = executeRequest("uvi/forecast", requestParameters)) {
-            ultravioletIndex = (List<UltravioletIndex>) JSONUtils.parseJSON(response, typeRef);
-        } catch (IOException ex) {
-            ex.printStackTrace();
-        }
-
-        return ultravioletIndex;
-    }
-
-    private InputStream executeRequest(String requestType, String requestSpecificParameters) throws MalformedURLException, InvalidAuthTokenException, DataNotFoundException {
-
-        StringBuilder urlBuilder = new StringBuilder(OPEN_WEATHER_API_URL);
-        urlBuilder.append(requestType);
-        urlBuilder.append('?');
-        urlBuilder.append(requestSpecificParameters);
-
-        urlBuilder.append("&appid=");
-        urlBuilder.append(authToken);
-
-        return RequestUtils.executeGetRequest(new URL(urlBuilder.toString()));
-    }
-
-}

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

@@ -1,77 +0,0 @@
-/*
- * Copyright (c) 2018 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;
-
-import com.github.prominence.openweathermap.api.constants.Unit;
-import com.github.prominence.openweathermap.api.exception.DataNotFoundException;
-import com.github.prominence.openweathermap.api.exception.InvalidAuthTokenException;
-import com.github.prominence.openweathermap.api.model.response.Weather;
-import com.github.prominence.openweathermap.api.utils.JSONUtils;
-import com.github.prominence.openweathermap.api.utils.RequestUtils;
-
-import java.io.IOException;
-import java.io.InputStream;
-
-public class WeatherRequester extends BasicRequester<Weather> {
-
-    WeatherRequester(String authToken) {
-        super(authToken);
-    }
-
-    public WeatherRequester setLanguage(String language) {
-        this.language = language;
-        return this;
-    }
-
-    public WeatherRequester setUnitSystem(String unitSystem) {
-        this.unitSystem = unitSystem;
-        return this;
-    }
-
-    public WeatherRequester setAccuracy(String accuracy) {
-        this.accuracy = accuracy;
-        return this;
-    }
-
-    protected String getRequestType() {
-        return "weather";
-    }
-
-    protected Weather executeRequest(String requestSpecificParameters) throws InvalidAuthTokenException, DataNotFoundException {
-
-        Weather weather = null;
-
-        try {
-            InputStream requestResult = RequestUtils.executeGetRequest(buildURL(requestSpecificParameters));
-            weather = (Weather)JSONUtils.parseJSON(requestResult, Weather.class);
-
-            weather.getWind().setUnit(Unit.getWindUnit(unitSystem));
-            weather.getWeatherInfo().setTemperatureUnit(Unit.getTemperatureUnit(unitSystem));
-        } catch (IOException ex) {
-            ex.printStackTrace();
-        }
-
-        return weather;
-    }
-
-}

src/main/java/com/github/prominence/openweathermap/api/annotation/SubscriptionAvailability.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2018 Alexey Zinchenko
+ * 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
@@ -20,18 +20,24 @@
  * SOFTWARE.
  */
 
-package com.github.prominence.openweathermap.api;
+package com.github.prominence.openweathermap.api.annotation;
 
-abstract class AuthenticationTokenBasedRequester {
+import com.github.prominence.openweathermap.api.enums.SubscriptionPlan;
 
-    protected static final String OPEN_WEATHER_API_VERSION = "2.5";
+import java.lang.annotation.ElementType;
-    protected static final String OPEN_WEATHER_BASE_URL = "http://api.openweathermap.org/";
+import java.lang.annotation.Retention;
-    protected static final String OPEN_WEATHER_API_URL = OPEN_WEATHER_BASE_URL + "data/" + OPEN_WEATHER_API_VERSION + "/";
+import java.lang.annotation.RetentionPolicy;
-
+import java.lang.annotation.Target;
-    protected String authToken;
-
-    protected AuthenticationTokenBasedRequester(String authToken) {
-        this.authToken = authToken;
-    }
 
+/**
+ * Marker-type annotation to specify what type of license it needs to have to use API method.
+ */
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.CLASS)
+public @interface SubscriptionAvailability {
+    /**
+     * Marks method with subscription plan it needs to have to use the method.
+     * @return subscription plan.
+     */
+    SubscriptionPlan[] plans();
 }

src/main/java/com/github/prominence/openweathermap/api/conf/TimeoutSettings.java

@@ -0,0 +1,58 @@
+/*
+ * Copyright (c) 2022 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.conf;
+
+public class TimeoutSettings {
+    private Integer connectionTimeout;
+    private Integer readTimeout;
+
+    public TimeoutSettings() {
+        this(2000, 2000);
+    }
+
+    public TimeoutSettings(Integer connectionTimeout, Integer readTimeout) {
+        this.connectionTimeout = connectionTimeout;
+        this.readTimeout = readTimeout;
+    }
+
+    public TimeoutSettings(TimeoutSettings from) {
+        this.connectionTimeout = from.connectionTimeout;
+        this.readTimeout = from.readTimeout;
+    }
+
+    public Integer getConnectionTimeout() {
+        return connectionTimeout;
+    }
+
+    public void setConnectionTimeout(Integer connectionTimeout) {
+        this.connectionTimeout = connectionTimeout;
+    }
+
+    public Integer getReadTimeout() {
+        return readTimeout;
+    }
+
+    public void setReadTimeout(Integer readTimeout) {
+        this.readTimeout = readTimeout;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/constants/Language.java

@@ -1,63 +0,0 @@
-/*
- * Copyright (c) 2018 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.constants;
-
-public final class Language {
-
-    private Language() {}
-
-    public static final String ARABIC = "ar";
-    public static final String BULGARIAN = "bg";
-    public static final String CATALAN = "ca";
-    public static final String CZECH = "cz";
-    public static final String GERMAN = "de";
-    public static final String GREEK = "el";
-    public static final String ENGLISH = "en";
-    public static final String PERSIAN = "fa";
-    public static final String FINNISH = "fi";
-    public static final String FRENCH = "fr";
-    public static final String GALICIAN = "gl";
-    public static final String CROATIAN = "hr";
-    public static final String HUNGARIAN = "hu";
-    public static final String ITALIAN = "it";
-    public static final String JAPANESE = "ja";
-    public static final String KOREAN = "kr";
-    public static final String LATVIAN = "la";
-    public static final String LITHUANIAN = "lt";
-    public static final String MACEDONIAN = "mk";
-    public static final String DUTCH = "nl";
-    public static final String POLISH = "pl";
-    public static final String PORTUGUESE = "pt";
-    public static final String ROMANIAN ="ro";
-    public static final String RUSSIAN = "ru";
-    public static final String SWEDISH = "se";
-    public static final String SLOVAK = "sk";
-    public static final String SLOVENIAN = "sl";
-    public static final String SPANISH = "en";
-    public static final String TURKISH = "tr";
-    public static final String UKRANIAN = "uk";
-    public static final String VIETNAMESE = "vi";
-    public static final String CHINESE_SIMPLIFIED = "zh_cn";
-    public static final String CHINESE_TRADITIONAL = "zh_tw";
-
-}

src/main/java/com/github/prominence/openweathermap/api/deserializer/AtmosphericPressureDeserializer.java

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2022 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.deserializer;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.AtmosphericPressure;
+
+import java.io.IOException;
+
+public class AtmosphericPressureDeserializer extends JsonDeserializer<AtmosphericPressure> {
+    @Override
+    public AtmosphericPressure deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode mainNode = p.getCodec().readTree(p);
+
+        final AtmosphericPressure atmosphericPressure = AtmosphericPressure.withValue(mainNode.get("pressure").asDouble());
+
+        final JsonNode seaLevelNode = mainNode.get("sea_level");
+        final JsonNode groundLevelNode = mainNode.get("grnd_level");
+        if (seaLevelNode != null) {
+            atmosphericPressure.setSeaLevelValue(seaLevelNode.asDouble());
+        }
+        if (groundLevelNode != null) {
+            atmosphericPressure.setGroundLevelValue(groundLevelNode.asDouble());
+        }
+
+        return atmosphericPressure;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/CloudsDeserializer.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2018 Alexey Zinchenko
+ * Copyright (c) 2022 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
@@ -20,37 +20,26 @@
  * SOFTWARE.
  */
 
-package com.github.prominence.openweathermap.api.constants;
+package com.github.prominence.openweathermap.api.deserializer;
 
-public final class Unit {
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.Clouds;
 
-    private Unit() {}
+import java.io.IOException;
 
-    public static final String METRIC_SYSTEM = "metric";
+public class CloudsDeserializer extends JsonDeserializer<Clouds> {
-    public static final String IMPERIAL_SYSTEM = "imperial";
+    @Override
-    public static final String STANDARD_SYSTEM = "standard";
+    public Clouds deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode cloudsNode = p.getCodec().readTree(p);
 
-    public static String getWindUnit(String type) {
+        final JsonNode allValueNode = cloudsNode.get("all");
-        switch (type) {
+        if (allValueNode != null) {
-            case IMPERIAL_SYSTEM:
+            return Clouds.withValue((byte) allValueNode.asInt());
-                return "miles/hour";
-            case STANDARD_SYSTEM:
-            case METRIC_SYSTEM:
-            default:
-                return "meter/sec";
         }
+        return null;
     }
-
-    public static char getTemperatureUnit(String type) {
-        switch (type) {
-            case METRIC_SYSTEM:
-                return '℃';
-            case IMPERIAL_SYSTEM:
-                return '℉';
-            case STANDARD_SYSTEM:
-            default:
-                return 'K';
-        }
-    }
-
 }

src/main/java/com/github/prominence/openweathermap/api/deserializer/CoordinatesDeserializer.java

@@ -0,0 +1,43 @@
+/*
+ * Copyright (c) 2022 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.deserializer;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.Coordinates;
+
+import java.io.IOException;
+
+public class CoordinatesDeserializer extends JsonDeserializer<Coordinates> {
+    @Override
+    public Coordinates deserialize(JsonParser jp, DeserializationContext ctxt) throws IOException, JacksonException {
+        JsonNode rootNode = jp.getCodec().readTree(jp);
+        if (rootNode.has("lat") && rootNode.has("lon")) {
+            return Coordinates.of(rootNode.get("lat").asDouble(), rootNode.get("lon").asDouble());
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/GeocodingRecordDeserializer.java

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2022 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.deserializer;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.type.TypeReference;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.model.Coordinates;
+import com.github.prominence.openweathermap.api.model.geocoding.GeocodingRecord;
+
+import java.io.IOException;
+import java.util.Map;
+
+public class GeocodingRecordDeserializer extends JsonDeserializer<GeocodingRecord> {
+    private static final ObjectMapper objectMapper = new ObjectMapper();
+
+    public GeocodingRecordDeserializer() {
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(Coordinates.class, new CoordinatesDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    @Override
+    public GeocodingRecord deserialize(JsonParser jp, DeserializationContext ctxt) throws IOException, JacksonException {
+        JsonNode rootNode = jp.getCodec().readTree(jp);
+        String name = rootNode.get("name").asText();
+        String country = rootNode.get("country").asText();
+        Map<String, String> localNames = objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("local_names")), new TypeReference<Map<String, String>>() {});
+        Coordinates coordinates = objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Coordinates.class);
+        return new GeocodingRecord(name, localNames, coordinates, country);
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/HumidityDeserializer.java

@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2022 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.deserializer;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.Humidity;
+
+import java.io.IOException;
+
+public class HumidityDeserializer extends JsonDeserializer<Humidity> {
+    @Override
+    public Humidity deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rootNode = p.getCodec().readTree(p);
+
+        return Humidity.withValue((byte) (rootNode.get("humidity").asInt()));
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/TemperatureDeserializer.java

@@ -0,0 +1,59 @@
+/*
+ * Copyright (c) 2022 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.deserializer;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.enums.UnitSystem;
+import com.github.prominence.openweathermap.api.model.Temperature;
+
+import java.io.IOException;
+
+public class TemperatureDeserializer extends JsonDeserializer<Temperature> {
+    @Override
+    public Temperature deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode mainNode = p.getCodec().readTree(p);
+        final UnitSystem unitSystem = (UnitSystem) ctxt.findInjectableValue("unitSystem", null, null);
+
+        final double tempValue = mainNode.get("temp").asDouble();
+        final Temperature temperature = Temperature.withValue(tempValue, unitSystem.getTemperatureUnit());
+
+        final JsonNode feelsLikeNode = mainNode.get("feels_like");
+        if (feelsLikeNode != null) {
+            temperature.setFeelsLike(feelsLikeNode.asDouble());
+        }
+        final JsonNode tempMaxNode = mainNode.get("temp_max");
+        if (tempMaxNode != null) {
+            temperature.setMaxTemperature(tempMaxNode.asDouble());
+        }
+        final JsonNode tempMinNode = mainNode.get("temp_min");
+        if (tempMinNode != null) {
+            temperature.setMinTemperature(tempMinNode.asDouble());
+        }
+
+        return temperature;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/WeatherStateDeserializer.java

@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2022 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.deserializer;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.WeatherState;
+
+import java.io.IOException;
+
+public class WeatherStateDeserializer extends JsonDeserializer<WeatherState> {
+    @Override
+    public WeatherState deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        JsonNode weatherNode = p.getCodec().readTree(p);
+        final WeatherState weatherState = new WeatherState(
+                weatherNode.get("id").asInt(),
+                weatherNode.get("main").asText(),
+                weatherNode.get("description").asText()
+        );
+        weatherState.setIconId(weatherNode.get("icon").asText());
+        return weatherState;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/WindDeserializer.java

@@ -0,0 +1,66 @@
+/*
+ * Copyright (c) 2022 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.deserializer;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.enums.UnitSystem;
+import com.github.prominence.openweathermap.api.model.Wind;
+
+import java.io.IOException;
+
+public class WindDeserializer extends JsonDeserializer<Wind> {
+    @Override
+    public Wind deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode windNode = p.getCodec().readTree(p);
+        final UnitSystem unitSystem = (UnitSystem) ctxt.findInjectableValue("unitSystem", null, null);
+
+        JsonNode speedNode = windNode.get("speed");
+        if (speedNode == null) {
+            speedNode = windNode.get("wind_speed");
+        }
+        double speed = speedNode.asDouble();
+
+        final Wind wind = Wind.withValue(speed, unitSystem.getWindUnit());
+        JsonNode degNode = windNode.get("deg");
+        if (degNode == null) {
+            degNode = windNode.get("wind_deg");
+        }
+        if (degNode != null) {
+            wind.setDegrees(degNode.asDouble());
+        }
+
+        JsonNode gustNode = windNode.get("gust");
+        if (gustNode == null) {
+            gustNode = windNode.get("wind_gust");
+        }
+        if (gustNode != null) {
+            wind.setGust(gustNode.asDouble());
+        }
+
+        return wind;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/ZipCodeGeocodingDeserializer.java

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2022 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.deserializer;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.model.Coordinates;
+import com.github.prominence.openweathermap.api.model.geocoding.ZipCodeGeocodingRecord;
+
+import java.io.IOException;
+
+public class ZipCodeGeocodingDeserializer extends JsonDeserializer<ZipCodeGeocodingRecord> {
+    private static final ObjectMapper objectMapper = new ObjectMapper();
+
+    public ZipCodeGeocodingDeserializer() {
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(Coordinates.class, new CoordinatesDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    @Override
+    public ZipCodeGeocodingRecord deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        JsonNode rootNode = p.getCodec().readTree(p);
+        String zip = rootNode.get("zip").asText();
+        String name = rootNode.get("name").asText();
+        String country = rootNode.get("country").asText();
+
+        Coordinates coordinates = objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Coordinates.class);
+
+        return new ZipCodeGeocodingRecord(zip, name, coordinates, country);
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/climatic/ClimaticForecastAtmosphericPressureDeserializer.java

@@ -0,0 +1,18 @@
+package com.github.prominence.openweathermap.api.deserializer.forecast.climatic;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.forecast.climatic.AtmosphericPressure;
+
+import java.io.IOException;
+
+public class ClimaticForecastAtmosphericPressureDeserializer extends JsonDeserializer<AtmosphericPressure> {
+    @Override
+    public AtmosphericPressure deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode jsonNode = jsonParser.getCodec().readTree(jsonParser);
+        return (AtmosphericPressure) AtmosphericPressure.withValue(jsonNode.get("pressure").asDouble());
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/climatic/ClimaticForecastCloudsDeserializer.java

@@ -0,0 +1,23 @@
+package com.github.prominence.openweathermap.api.deserializer.forecast.climatic;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.Clouds;
+
+import java.io.IOException;
+
+public class ClimaticForecastCloudsDeserializer extends JsonDeserializer<Clouds> {
+    @Override
+    public Clouds deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+        final JsonNode cloudsNode = rootNode.get("clouds");
+        if (cloudsNode != null) {
+            return Clouds.withValue((byte) cloudsNode.asInt());
+        }
+
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/climatic/ClimaticForecastLocationDeserializer.java

@@ -0,0 +1,54 @@
+package com.github.prominence.openweathermap.api.deserializer.forecast.climatic;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.CoordinatesDeserializer;
+import com.github.prominence.openweathermap.api.model.Coordinates;
+import com.github.prominence.openweathermap.api.model.forecast.climatic.Location;
+
+import java.io.IOException;
+
+import static com.github.prominence.openweathermap.api.utils.JsonDeserializationUtils.parseZoneOffset;
+
+public class ClimaticForecastLocationDeserializer extends JsonDeserializer<Location> {
+    private final ObjectMapper objectMapper = new ObjectMapper();
+
+    public ClimaticForecastLocationDeserializer() {
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(Coordinates.class, new CoordinatesDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    @Override
+    public Location deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+        final Location location = (Location) Location.withValues(rootNode.get("id").asInt(), rootNode.get("name").asText());
+
+        final JsonNode timezoneNode = rootNode.get("timezone");
+        if (timezoneNode != null) {
+            location.setZoneOffset(parseZoneOffset(timezoneNode));
+        }
+
+        final JsonNode countryNode = rootNode.get("country");
+        if (countryNode != null) {
+            location.setCountryCode(countryNode.asText());
+        }
+
+        final JsonNode coordNode = rootNode.get("coord");
+        if (coordNode != null) {
+            location.setCoordinates(objectMapper.readValue(objectMapper.treeAsTokens(coordNode), Coordinates.class));
+        }
+
+        final JsonNode populationNode = rootNode.get("population");
+        if (populationNode != null) {
+            location.setPopulation(populationNode.asLong());
+        }
+
+        return location;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/climatic/ClimaticForecastRainDeserializer.java

@@ -0,0 +1,22 @@
+package com.github.prominence.openweathermap.api.deserializer.forecast.climatic;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.forecast.climatic.Rain;
+
+import java.io.IOException;
+
+public class ClimaticForecastRainDeserializer extends JsonDeserializer<Rain> {
+    @Override
+    public Rain deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+        final JsonNode rainNode = rootNode.get("rain");
+        if (rainNode != null) {
+            return (Rain) Rain.withValue(rainNode.asDouble());
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/climatic/ClimaticForecastSnowDeserializer.java

@@ -0,0 +1,22 @@
+package com.github.prominence.openweathermap.api.deserializer.forecast.climatic;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.forecast.climatic.Snow;
+
+import java.io.IOException;
+
+public class ClimaticForecastSnowDeserializer extends JsonDeserializer<Snow> {
+    @Override
+    public Snow deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+        final JsonNode snowNode = rootNode.get("snow");
+        if (snowNode != null) {
+            return (Snow) Snow.withValue(snowNode.asDouble());
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/climatic/ClimaticForecastTemperatureDeserializer.java

@@ -0,0 +1,34 @@
+package com.github.prominence.openweathermap.api.deserializer.forecast.climatic;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.forecast.climatic.Temperature;
+
+import java.io.IOException;
+
+public class ClimaticForecastTemperatureDeserializer extends JsonDeserializer<Temperature> {
+    @Override
+    public Temperature deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+
+        final Temperature temperature = new Temperature();
+        final JsonNode tempNode = rootNode.get("temp");
+        temperature.setMorning(tempNode.get("morn").asDouble());
+        temperature.setDay(tempNode.get("day").asDouble());
+        temperature.setEve(tempNode.get("eve").asDouble());
+        temperature.setNight(tempNode.get("night").asDouble());
+        temperature.setMin(tempNode.get("min").asDouble());
+        temperature.setMax(tempNode.get("max").asDouble());
+
+        final JsonNode feelsLikeNode = rootNode.get("feels_like");
+        temperature.setMorningFeelsLike(feelsLikeNode.get("morn").asDouble());
+        temperature.setDayFeelsLike(feelsLikeNode.get("day").asDouble());
+        temperature.setEveFeelsLike(feelsLikeNode.get("eve").asDouble());
+        temperature.setNightFeelsLike(feelsLikeNode.get("night").asDouble());
+
+        return temperature;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/climatic/ClimaticForecastWindDeserializer.java

@@ -0,0 +1,58 @@
+/*
+ * Copyright (c) 2022 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.deserializer.forecast.climatic;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.enums.UnitSystem;
+import com.github.prominence.openweathermap.api.model.Wind;
+
+import java.io.IOException;
+
+public class ClimaticForecastWindDeserializer extends JsonDeserializer<Wind> {
+    @Override
+    public Wind deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode windNode = p.getCodec().readTree(p);
+        final UnitSystem unitSystem = (UnitSystem) ctxt.findInjectableValue("unitSystem", null, null);
+
+        JsonNode speedNode = windNode.get("speed");
+        if (speedNode == null) {
+            speedNode = windNode.get("wind_speed");
+        }
+        double speed = speedNode.asDouble();
+
+        final Wind wind = Wind.withValue(speed, unitSystem.getWindUnit());
+        JsonNode degNode = windNode.get("deg");
+        if (degNode == null) {
+            degNode = windNode.get("wind_deg");
+        }
+        if (degNode != null) {
+            wind.setDegrees(degNode.asDouble());
+        }
+
+        return wind;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/daily/DailyForecastAtmosphericPressureDeserializer.java

@@ -0,0 +1,18 @@
+package com.github.prominence.openweathermap.api.deserializer.forecast.daily;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.forecast.daily.AtmosphericPressure;
+
+import java.io.IOException;
+
+public class DailyForecastAtmosphericPressureDeserializer extends JsonDeserializer<AtmosphericPressure> {
+    @Override
+    public AtmosphericPressure deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode jsonNode = jsonParser.getCodec().readTree(jsonParser);
+        return (AtmosphericPressure) AtmosphericPressure.withValue(jsonNode.get("pressure").asDouble());
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/daily/DailyForecastCloudsDeserializer.java

@@ -0,0 +1,23 @@
+package com.github.prominence.openweathermap.api.deserializer.forecast.daily;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.Clouds;
+
+import java.io.IOException;
+
+public class DailyForecastCloudsDeserializer extends JsonDeserializer<Clouds> {
+    @Override
+    public Clouds deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+        final JsonNode cloudsNode = rootNode.get("clouds");
+        if (cloudsNode != null) {
+            return Clouds.withValue((byte) cloudsNode.asInt());
+        }
+
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/daily/DailyForecastLocationDeserializer.java

@@ -0,0 +1,54 @@
+package com.github.prominence.openweathermap.api.deserializer.forecast.daily;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.CoordinatesDeserializer;
+import com.github.prominence.openweathermap.api.model.Coordinates;
+import com.github.prominence.openweathermap.api.model.forecast.daily.Location;
+
+import java.io.IOException;
+
+import static com.github.prominence.openweathermap.api.utils.JsonDeserializationUtils.parseZoneOffset;
+
+public class DailyForecastLocationDeserializer extends JsonDeserializer<Location> {
+    private final ObjectMapper objectMapper = new ObjectMapper();
+
+    public DailyForecastLocationDeserializer() {
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(Coordinates.class, new CoordinatesDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    @Override
+    public Location deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+        final Location location = (Location) Location.withValues(rootNode.get("id").asInt(), rootNode.get("name").asText());
+
+        final JsonNode timezoneNode = rootNode.get("timezone");
+        if (timezoneNode != null) {
+            location.setZoneOffset(parseZoneOffset(timezoneNode));
+        }
+
+        final JsonNode countryNode = rootNode.get("country");
+        if (countryNode != null) {
+            location.setCountryCode(countryNode.asText());
+        }
+
+        final JsonNode coordNode = rootNode.get("coord");
+        if (coordNode != null) {
+            location.setCoordinates(objectMapper.readValue(objectMapper.treeAsTokens(coordNode), Coordinates.class));
+        }
+
+        final JsonNode populationNode = rootNode.get("population");
+        if (populationNode != null) {
+            location.setPopulation(populationNode.asLong());
+        }
+
+        return location;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/daily/DailyForecastRainDeserializer.java

@@ -0,0 +1,22 @@
+package com.github.prominence.openweathermap.api.deserializer.forecast.daily;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.forecast.daily.Rain;
+
+import java.io.IOException;
+
+public class DailyForecastRainDeserializer extends JsonDeserializer<Rain> {
+    @Override
+    public Rain deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+        final JsonNode rainNode = rootNode.get("rain");
+        if (rainNode != null) {
+            return (Rain) Rain.withValue(rainNode.asDouble());
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/daily/DailyForecastSnowDeserializer.java

@@ -0,0 +1,22 @@
+package com.github.prominence.openweathermap.api.deserializer.forecast.daily;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.forecast.daily.Snow;
+
+import java.io.IOException;
+
+public class DailyForecastSnowDeserializer extends JsonDeserializer<Snow> {
+    @Override
+    public Snow deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+        final JsonNode snowNode = rootNode.get("snow");
+        if (snowNode != null) {
+            return (Snow) Snow.withValue(snowNode.asDouble());
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/daily/DailyForecastTemperatureDeserializer.java

@@ -0,0 +1,34 @@
+package com.github.prominence.openweathermap.api.deserializer.forecast.daily;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.forecast.daily.Temperature;
+
+import java.io.IOException;
+
+public class DailyForecastTemperatureDeserializer extends JsonDeserializer<Temperature> {
+    @Override
+    public Temperature deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+
+        final Temperature temperature = new Temperature();
+        final JsonNode tempNode = rootNode.get("temp");
+        temperature.setMorning(tempNode.get("morn").asDouble());
+        temperature.setDay(tempNode.get("day").asDouble());
+        temperature.setEve(tempNode.get("eve").asDouble());
+        temperature.setNight(tempNode.get("night").asDouble());
+        temperature.setMin(tempNode.get("min").asDouble());
+        temperature.setMax(tempNode.get("max").asDouble());
+
+        final JsonNode feelsLikeNode = rootNode.get("feels_like");
+        temperature.setMorningFeelsLike(feelsLikeNode.get("morn").asDouble());
+        temperature.setDayFeelsLike(feelsLikeNode.get("day").asDouble());
+        temperature.setEveFeelsLike(feelsLikeNode.get("eve").asDouble());
+        temperature.setNightFeelsLike(feelsLikeNode.get("night").asDouble());
+
+        return temperature;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/free/FreeForecastLocationDeserializer.java

@@ -0,0 +1,87 @@
+/*
+ * Copyright (c) 2022 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.deserializer.forecast.free;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.CoordinatesDeserializer;
+import com.github.prominence.openweathermap.api.model.Coordinates;
+import com.github.prominence.openweathermap.api.model.forecast.free.Location;
+
+import java.io.IOException;
+import java.time.Instant;
+import java.time.LocalDateTime;
+import java.time.ZoneOffset;
+import java.util.TimeZone;
+
+public class FreeForecastLocationDeserializer extends JsonDeserializer<Location> {
+    private final ObjectMapper objectMapper = new ObjectMapper();
+
+    public FreeForecastLocationDeserializer() {
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(Coordinates.class, new CoordinatesDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    @Override
+    public Location deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rootNode = p.getCodec().readTree(p);
+        final Location location = Location.withValues(rootNode.get("id").asInt(), rootNode.get("name").asText());
+
+        final JsonNode timezoneNode = rootNode.get("timezone");
+        if (timezoneNode != null) {
+            location.setZoneOffset(ZoneOffset.ofTotalSeconds(timezoneNode.asInt()));
+        }
+
+        final JsonNode countryNode = rootNode.get("country");
+        if (countryNode != null) {
+            location.setCountryCode(countryNode.asText());
+        }
+
+        final JsonNode sunriseNode = rootNode.get("sunrise");
+        final JsonNode sunsetNode = rootNode.get("sunset");
+        if (sunriseNode != null) {
+            location.setSunriseTime(LocalDateTime.ofInstant(Instant.ofEpochSecond(sunriseNode.asLong()), TimeZone.getDefault().toZoneId()));
+        }
+        if (sunsetNode != null) {
+            location.setSunsetTime(LocalDateTime.ofInstant(Instant.ofEpochSecond(sunsetNode.asLong()), TimeZone.getDefault().toZoneId()));
+        }
+
+        final JsonNode coordNode = rootNode.get("coord");
+        if (coordNode != null) {
+            location.setCoordinates(objectMapper.readValue(objectMapper.treeAsTokens(coordNode), Coordinates.class));
+        }
+
+        final JsonNode populationNode = rootNode.get("population");
+        if (populationNode != null) {
+            location.setPopulation(populationNode.asLong());
+        }
+
+        return location;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/free/FreeForecastRainDeserializer.java

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2022 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.deserializer.forecast.free;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.forecast.free.Rain;
+
+import java.io.IOException;
+
+public class FreeForecastRainDeserializer extends JsonDeserializer<Rain> {
+    @Override
+    public Rain deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rainNode = p.getCodec().readTree(p);
+        final JsonNode oneHourNode = rainNode.get("3h");
+        if (oneHourNode != null) {
+            return Rain.withThreeHourLevelValue(oneHourNode.asDouble());
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/free/FreeForecastSnowDeserializer.java

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2022 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.deserializer.forecast.free;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.forecast.free.Snow;
+
+import java.io.IOException;
+
+public class FreeForecastSnowDeserializer extends JsonDeserializer<Snow> {
+    @Override
+    public Snow deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode snowNode = p.getCodec().readTree(p);
+        final JsonNode oneHourNode = snowNode.get("3h");
+        if (oneHourNode != null) {
+            return Snow.withThreeHourLevelValue(oneHourNode.asDouble());
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/hourly/HourlyForecastLocationDeserializer.java

@@ -0,0 +1,82 @@
+/*
+ * Copyright (c) 2022 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.deserializer.forecast.hourly;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.CoordinatesDeserializer;
+import com.github.prominence.openweathermap.api.model.Coordinates;
+import com.github.prominence.openweathermap.api.model.forecast.hourly.Location;
+
+import java.io.IOException;
+import java.time.Instant;
+import java.time.LocalDateTime;
+import java.time.ZoneOffset;
+import java.util.TimeZone;
+
+public class HourlyForecastLocationDeserializer extends JsonDeserializer<Location> {
+    private final ObjectMapper objectMapper = new ObjectMapper();
+
+    public HourlyForecastLocationDeserializer() {
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(Coordinates.class, new CoordinatesDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    @Override
+    public Location deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rootNode = p.getCodec().readTree(p);
+        final Location location = Location.withValues(rootNode.get("id").asInt(), rootNode.get("name").asText());
+
+        final JsonNode timezoneNode = rootNode.get("timezone");
+        if (timezoneNode != null) {
+            location.setZoneOffset(ZoneOffset.ofTotalSeconds(timezoneNode.asInt()));
+        }
+
+        final JsonNode countryNode = rootNode.get("country");
+        if (countryNode != null) {
+            location.setCountryCode(countryNode.asText());
+        }
+
+        final JsonNode sunriseNode = rootNode.get("sunrise");
+        final JsonNode sunsetNode = rootNode.get("sunset");
+        if (sunriseNode != null) {
+            location.setSunriseTime(LocalDateTime.ofInstant(Instant.ofEpochSecond(sunriseNode.asLong()), TimeZone.getDefault().toZoneId()));
+        }
+        if (sunsetNode != null) {
+            location.setSunsetTime(LocalDateTime.ofInstant(Instant.ofEpochSecond(sunsetNode.asLong()), TimeZone.getDefault().toZoneId()));
+        }
+
+        final JsonNode coordNode = rootNode.get("coord");
+        if (coordNode != null) {
+            location.setCoordinates(objectMapper.readValue(objectMapper.treeAsTokens(coordNode), Coordinates.class));
+        }
+
+        return location;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/hourly/HourlyForecastRainDeserializer.java

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2022 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.deserializer.forecast.hourly;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.forecast.hourly.Rain;
+
+import java.io.IOException;
+
+public class HourlyForecastRainDeserializer extends JsonDeserializer<Rain> {
+    @Override
+    public Rain deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rainNode = p.getCodec().readTree(p);
+        final JsonNode oneHourNode = rainNode.get("1h");
+        if (oneHourNode != null) {
+            return Rain.withOneHourLevelValue(oneHourNode.asDouble());
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/forecast/hourly/HourlyForecastSnowDeserializer.java

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2022 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.deserializer.forecast.hourly;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.forecast.hourly.Snow;
+
+import java.io.IOException;
+
+public class HourlyForecastSnowDeserializer extends JsonDeserializer<Snow> {
+    @Override
+    public Snow deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode snowNode = p.getCodec().readTree(p);
+        final JsonNode oneHourNode = snowNode.get("1h");
+        if (oneHourNode != null) {
+            return Snow.withOneHourLevelValue(oneHourNode.asDouble());
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/onecall/AlertDeserializer.java

@@ -0,0 +1,60 @@
+/*
+ * Copyright (c) 2022 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.deserializer.onecall;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.onecall.current.Alert;
+import com.github.prominence.openweathermap.api.utils.JsonDeserializationUtils;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+public class AlertDeserializer extends JsonDeserializer<Alert> {
+    @Override
+    public Alert deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode alertNode = p.getCodec().readTree(p);
+
+        Alert alert = new Alert();
+        alert.setSenderName(alertNode.get("sender_name").asText());
+        alert.setEventName(alertNode.get("event").asText());
+        alert.setStartTime(JsonDeserializationUtils.parseDateTime(alertNode.get("start")));
+        alert.setEndTime(JsonDeserializationUtils.parseDateTime(alertNode.get("end")));
+        alert.setDescription(alertNode.get("description").asText());
+
+        final JsonNode tagsNode = alertNode.get("tags");
+        if (tagsNode != null) {
+            List<String> tags = new ArrayList<>();
+            for (JsonNode tagNode : tagsNode) {
+                tags.add(tagNode.asText());
+            }
+            alert.setTags(tags);
+        }
+
+        return alert;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/onecall/OneCallAtmosphericPressureDeserializer.java

@@ -0,0 +1,40 @@
+/*
+ * Copyright (c) 2022 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.deserializer.onecall;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.onecall.AtmosphericPressure;
+
+import java.io.IOException;
+
+public class OneCallAtmosphericPressureDeserializer extends JsonDeserializer<AtmosphericPressure> {
+    @Override
+    public AtmosphericPressure deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rootNode = p.getCodec().readTree(p);
+        return AtmosphericPressure.withValue(rootNode.get("pressure").asDouble());
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/onecall/OneCallDailyRainDeserializer.java

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2022 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.deserializer.onecall;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.onecall.current.DailyRain;
+
+import java.io.IOException;
+
+public class OneCallDailyRainDeserializer extends JsonDeserializer<DailyRain> {
+    @Override
+    public DailyRain deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rootNode = p.getCodec().readTree(p);
+        final JsonNode valueNode = rootNode.get("rain");
+        if (valueNode != null) {
+            return DailyRain.withValue(valueNode.asDouble());
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/onecall/OneCallDailySnowDeserializer.java

@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2022 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.deserializer.onecall;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.onecall.current.DailySnow;
+
+import java.io.IOException;
+
+public class OneCallDailySnowDeserializer extends JsonDeserializer<DailySnow> {
+    @Override
+    public DailySnow deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rootNode = p.getCodec().readTree(p);
+
+        final JsonNode valueNode = rootNode.get("snow");
+        if (valueNode != null) {
+            return DailySnow.withValue(valueNode.asDouble());
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/onecall/OneCallDailyTemperatureDeserializer.java

@@ -0,0 +1,56 @@
+/*
+ * Copyright (c) 2022 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.deserializer.onecall;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.onecall.current.DailyTemperature;
+
+import java.io.IOException;
+
+public class OneCallDailyTemperatureDeserializer extends JsonDeserializer<DailyTemperature> {
+    @Override
+    public DailyTemperature deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rootNode = p.getCodec().readTree(p);
+
+        final DailyTemperature temperature = new DailyTemperature();
+        final JsonNode tempNode = rootNode.get("temp");
+        temperature.setMorning(tempNode.get("morn").asDouble());
+        temperature.setDay(tempNode.get("day").asDouble());
+        temperature.setEve(tempNode.get("eve").asDouble());
+        temperature.setNight(tempNode.get("night").asDouble());
+        temperature.setMin(tempNode.get("min").asDouble());
+        temperature.setMax(tempNode.get("max").asDouble());
+
+        final JsonNode feelsLikeNode = rootNode.get("feels_like");
+        temperature.setMorningFeelsLike(feelsLikeNode.get("morn").asDouble());
+        temperature.setDayFeelsLike(feelsLikeNode.get("day").asDouble());
+        temperature.setEveFeelsLike(feelsLikeNode.get("eve").asDouble());
+        temperature.setNightFeelsLike(feelsLikeNode.get("night").asDouble());
+
+        return temperature;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/onecall/OneCallRainDeserializer.java

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2022 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.deserializer.onecall;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.onecall.Rain;
+
+import java.io.IOException;
+
+public class OneCallRainDeserializer extends JsonDeserializer<Rain> {
+    @Override
+    public Rain deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rootNode = p.getCodec().readTree(p);
+        final JsonNode rainNode = rootNode.get("rain");
+        if (rainNode != null) {
+            final JsonNode oneHourNode = rainNode.get("1h");
+            if (oneHourNode != null) {
+                return Rain.withOneHourLevelValue(oneHourNode.asDouble());
+            }
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/onecall/OneCallSnowDeserializer.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2018 Alexey Zinchenko
+ * Copyright (c) 2022 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
@@ -20,39 +20,29 @@
  * SOFTWARE.
  */
 
-package com.github.prominence.openweathermap.api.utils;
+package com.github.prominence.openweathermap.api.deserializer.onecall;
 
-import com.alibaba.fastjson.JSON;
+import com.fasterxml.jackson.core.JacksonException;
-import com.alibaba.fastjson.TypeReference;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.onecall.Rain;
+import com.github.prominence.openweathermap.api.model.onecall.Snow;
 
-import java.io.BufferedReader;
 import java.io.IOException;
-import java.io.InputStream;
-import java.io.InputStreamReader;
 
-public final class JSONUtils {
+public class OneCallSnowDeserializer extends JsonDeserializer<Snow> {
-
+    @Override
-    private JSONUtils() {}
+    public Snow deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
-
+        final JsonNode rootNode = p.getCodec().readTree(p);
-    public static Object parseJSON(InputStream inputStream, Class clazz) throws IOException {
+        final JsonNode snowNode = rootNode.get("snow");
-        return JSON.parseObject(getStringFromStream(inputStream), clazz);
+        if (snowNode != null) {
-    }
+            final JsonNode OneHourNode = snowNode.get("1h");
-
+            if (OneHourNode != null) {
-    public static Object parseJSON(InputStream inputStream, TypeReference typeReference) throws IOException {
+                Rain.withOneHourLevelValue(OneHourNode.asDouble());
-        return JSON.parseObject(getStringFromStream(inputStream), typeReference);
+            }
-    }
-
-    private static String getStringFromStream(InputStream inputStream) throws IOException {
-        BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
-
-        StringBuilder result = new StringBuilder();
-        String line;
-        while ((line = reader.readLine()) != null) {
-            result.append(line);
         }
-
+        return null;
-        reader.close();
-
-        return result.toString();
     }
 }

src/main/java/com/github/prominence/openweathermap/api/deserializer/onecall/OneCallTemperatureDeserializer.java

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2022 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.deserializer.onecall;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.enums.UnitSystem;
+import com.github.prominence.openweathermap.api.model.onecall.Temperature;
+
+import java.io.IOException;
+
+public class OneCallTemperatureDeserializer extends JsonDeserializer<Temperature> {
+    @Override
+    public Temperature deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rootNode = p.getCodec().readTree(p);
+        final UnitSystem unitSystem = (UnitSystem) ctxt.findInjectableValue("unitSystem", null, null);
+
+        final double tempValue = rootNode.get("temp").asDouble();
+        final Temperature temperature = Temperature.withValue(tempValue, unitSystem.getTemperatureUnit());
+
+        final JsonNode tempFeelsLike = rootNode.get("feels_like");
+        if (tempFeelsLike != null) {
+            temperature.setFeelsLike(tempFeelsLike.asDouble());
+        }
+        final JsonNode dewPoint = rootNode.get("dew_point");
+        if (dewPoint != null) {
+            temperature.setDewPoint(dewPoint.asDouble());
+        }
+
+        return temperature;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/radiation/SolarRadiationRecordDeserializer.java

@@ -0,0 +1,29 @@
+package com.github.prominence.openweathermap.api.deserializer.radiation;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.radiation.SolarRadiationRecord;
+import com.github.prominence.openweathermap.api.utils.JsonDeserializationUtils;
+
+import java.io.IOException;
+
+public class SolarRadiationRecordDeserializer extends JsonDeserializer<SolarRadiationRecord> {
+    @Override
+    public SolarRadiationRecord deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+
+        SolarRadiationRecord record = new SolarRadiationRecord();
+        final JsonNode radiationNode = rootNode.get("radiation");
+        record.setMeasurementTime(JsonDeserializationUtils.parseDateTime(rootNode.get("dt")));
+        record.setCloudSkyGlobalHorizontalIrradiance(radiationNode.get("ghi").asDouble());
+        record.setCloudSkyDirectNormalIrradiance(radiationNode.get("dni").asDouble());
+        record.setCloudSkyDiffuseHorizontalIrradiance(radiationNode.get("dhi").asDouble());
+        record.setClearSkyGlobalHorizontalIrradiance(radiationNode.get("ghi_cs").asDouble());
+        record.setClearSkyDirectNormalIrradiance(radiationNode.get("dni_cs").asDouble());
+        record.setClearSkyDiffuseHorizontalIrradiance(radiationNode.get("dhi_cs").asDouble());
+        return record;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/roadrisk/RoadRiskAlertDeserializer.java

@@ -0,0 +1,23 @@
+package com.github.prominence.openweathermap.api.deserializer.roadrisk;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.enums.EventLevel;
+import com.github.prominence.openweathermap.api.model.roadrisk.Alert;
+
+import java.io.IOException;
+
+public class RoadRiskAlertDeserializer extends JsonDeserializer<Alert> {
+    @Override
+    public Alert deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+        final Alert alert = new Alert();
+        alert.setEvent(rootNode.get("event").asText());
+        alert.setSenderName(rootNode.get("sender_name").asText());
+        alert.setEventLevel(EventLevel.findByValue(rootNode.get("event_level").asInt()));
+        return alert;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/roadrisk/RoadRiskRoadDetailsDeserializer.java

@@ -0,0 +1,23 @@
+package com.github.prominence.openweathermap.api.deserializer.roadrisk;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.enums.RoadState;
+import com.github.prominence.openweathermap.api.model.roadrisk.RoadDetails;
+
+import java.io.IOException;
+
+public class RoadRiskRoadDetailsDeserializer extends JsonDeserializer<RoadDetails> {
+    @Override
+    public RoadDetails deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+        final RoadDetails roadDetails = new RoadDetails();
+        roadDetails.setSurfaceTemperature(rootNode.get("temp").asDouble());
+        roadDetails.setRoadState(RoadState.findByValue(rootNode.get("state").asInt()));
+
+        return roadDetails;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/roadrisk/RoadRiskWeatherDeserializer.java

@@ -0,0 +1,31 @@
+package com.github.prominence.openweathermap.api.deserializer.roadrisk;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.roadrisk.Weather;
+
+import java.io.IOException;
+
+public class RoadRiskWeatherDeserializer extends JsonDeserializer<Weather> {
+    @Override
+    public Weather deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JacksonException {
+        final JsonNode rootNode = jsonParser.getCodec().readTree(jsonParser);
+
+        final Weather weather = new Weather();
+        weather.setTemperature(rootNode.get("temp").asDouble());
+        weather.setDewPoint(rootNode.get("dew_point").asDouble());
+        weather.setWindSpeed(rootNode.get("wind_speed").asDouble());
+        weather.setWindDegrees(rootNode.get("wind_deg").asDouble());
+        if (rootNode.has("precipitation_intensity")) {
+            weather.setPrecipitationIntensity(rootNode.get("precipitation_intensity").asDouble());
+        }
+        if (rootNode.has("visibility")) {
+            weather.setVisibilityInMetres(rootNode.get("visibility").asDouble());
+        }
+
+        return weather;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/weather/WeatherLocationDeserializer.java

@@ -0,0 +1,85 @@
+/*
+ * Copyright (c) 2022 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.deserializer.weather;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.CoordinatesDeserializer;
+import com.github.prominence.openweathermap.api.model.Coordinates;
+import com.github.prominence.openweathermap.api.model.weather.Location;
+
+import java.io.IOException;
+import java.time.Instant;
+import java.time.LocalDateTime;
+import java.time.ZoneOffset;
+import java.util.TimeZone;
+
+public class WeatherLocationDeserializer extends JsonDeserializer<Location> {
+    private final ObjectMapper objectMapper = new ObjectMapper();
+
+    public WeatherLocationDeserializer() {
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(Coordinates.class, new CoordinatesDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    @Override
+    public Location deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rootNode = p.getCodec().readTree(p);
+        final Location location = Location.withValues(rootNode.get("id").asInt(), rootNode.get("name").asText());
+
+        final JsonNode timezoneNode = rootNode.get("timezone");
+        if (timezoneNode != null) {
+            location.setZoneOffset(ZoneOffset.ofTotalSeconds(timezoneNode.asInt()));
+        }
+
+        final JsonNode sysNode = rootNode.get("sys");
+        if (sysNode != null) {
+            final JsonNode countryNode = sysNode.get("country");
+            if (countryNode != null) {
+                location.setCountryCode(countryNode.asText());
+            }
+
+            final JsonNode sunriseNode = sysNode.get("sunrise");
+            final JsonNode sunsetNode = sysNode.get("sunset");
+            if (sunriseNode != null) {
+                location.setSunriseTime(LocalDateTime.ofInstant(Instant.ofEpochSecond(sunriseNode.asInt()), TimeZone.getDefault().toZoneId()));
+            }
+            if (sunsetNode != null) {
+                location.setSunsetTime(LocalDateTime.ofInstant(Instant.ofEpochSecond(sunsetNode.asInt()), TimeZone.getDefault().toZoneId()));
+            }
+        }
+
+        final JsonNode coordNode = rootNode.get("coord");
+        if (coordNode != null) {
+            location.setCoordinates(objectMapper.readValue(objectMapper.treeAsTokens(coordNode), Coordinates.class));
+        }
+
+        return location;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/weather/WeatherRainDeserializer.java

@@ -0,0 +1,51 @@
+/*
+ * Copyright (c) 2022 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.deserializer.weather;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.weather.Rain;
+
+import java.io.IOException;
+
+public class WeatherRainDeserializer extends JsonDeserializer<Rain> {
+    @Override
+    public Rain deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode rainNode = p.getCodec().readTree(p);
+        if (rainNode != null) {
+            final JsonNode oneHourNode = rainNode.get("1h");
+            final JsonNode threeHourNode = rainNode.get("3h");
+            if (oneHourNode != null && threeHourNode != null) {
+                return Rain.withValues(oneHourNode.asDouble(), threeHourNode.asDouble());
+            } else if (oneHourNode != null) {
+                return Rain.withOneHourLevelValue(oneHourNode.asDouble());
+            } else if (threeHourNode != null) {
+                return Rain.withThreeHourLevelValue(threeHourNode.asDouble());
+            }
+        }
+        return null;
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/deserializer/weather/WeatherSnowDeserializer.java

@@ -0,0 +1,51 @@
+/*
+ * Copyright (c) 2022 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.deserializer.weather;
+
+import com.fasterxml.jackson.core.JacksonException;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.github.prominence.openweathermap.api.model.weather.Snow;
+
+import java.io.IOException;
+
+public class WeatherSnowDeserializer extends JsonDeserializer<Snow> {
+    @Override
+    public Snow deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JacksonException {
+        final JsonNode snowNode = p.getCodec().readTree(p);
+        if (snowNode != null) {
+            final JsonNode oneHourNode = snowNode.get("1h");
+            final JsonNode threeHourNode = snowNode.get("3h");
+            if (oneHourNode != null && threeHourNode != null) {
+                return Snow.withValues(oneHourNode.asDouble(), threeHourNode.asDouble());
+            } else if (oneHourNode != null) {
+                return Snow.withOneHourLevelValue(oneHourNode.asDouble());
+            } else if (threeHourNode != null) {
+                return Snow.withThreeHourLevelValue(threeHourNode.asDouble());
+            }
+        }
+        return null;
+    }
+}

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

@@ -0,0 +1,80 @@
+/*
+ *
+ *  * 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.enums;
+
+import java.util.Arrays;
+import java.util.Optional;
+
+/**
+ * The enum Air quality index.
+ */
+public enum AirQualityIndex {
+    /**
+     * Good air quality index.
+     */
+    GOOD(1),
+    /**
+     * Fair air quality index.
+     */
+    FAIR(2),
+    /**
+     * Moderate air quality index.
+     */
+    MODERATE(3),
+    /**
+     * Poor air quality index.
+     */
+    POOR(4),
+    /**
+     * Very poor air quality index.
+     */
+    VERY_POOR(5);
+
+    private final int value;
+
+    AirQualityIndex(int index) {
+        this.value = index;
+    }
+
+    /**
+     * Gets value.
+     *
+     * @return the value
+     */
+    public int getValue() {
+        return value;
+    }
+
+    /**
+     * Gets by index.
+     *
+     * @param index the index
+     * @return the by index
+     */
+    public static AirQualityIndex getByIndex(int index) {
+        final Optional<AirQualityIndex> optionalAirQualityIndex = Arrays.stream(values()).filter(airQualityIndex -> airQualityIndex.getValue() == index).findFirst();
+        return optionalAirQualityIndex.orElse(null);
+    }
+}

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

@@ -0,0 +1,25 @@
+package com.github.prominence.openweathermap.api.enums;
+
+import java.util.Arrays;
+
+public enum EventLevel {
+    UNKNOWN(0),
+    GREEN(1),
+    YELLOW(2),
+    ORANGE(3),
+    RED(4);
+
+    private final int value;
+
+    EventLevel(int value) {
+        this.value = value;
+    }
+
+    public int getValue() {
+        return value;
+    }
+
+    public static EventLevel findByValue(int value) {
+        return Arrays.stream(values()).filter(eventLevel -> eventLevel.getValue() == value).findFirst().orElse(null);
+    }
+}

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

@@ -0,0 +1,273 @@
+/*
+ * 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.enums;
+
+/**
+ * An enumeration which lists all available languages for API usage.
+ * Usually it could be specified to get response with some fields translated into desired language.
+ */
+public enum Language {
+    /**
+     * Afrikaans language.
+     */
+    AFRIKAANS("af"),
+
+    /**
+     * Albanian language.
+     */
+    ALBANIAN("al"),
+
+    /**
+     * Arabic language.
+     */
+    ARABIC("ar"),
+
+    /**
+     * Azerbaijani language.
+     */
+    AZERBAIJANI("az"),
+
+    /**
+     * Bulgarian language.
+     */
+    BULGARIAN("bg"),
+
+    /**
+     * Catalan language.
+     */
+    CATALAN("ca"),
+
+    /**
+     * Czech language.
+     */
+    CZECH("cz"),
+
+    /**
+     * Danish language
+     */
+    DANISH("da"),
+
+    /**
+     * German language.
+     */
+    GERMAN("de"),
+
+    /**
+     * Greek language.
+     */
+    GREEK("el"),
+
+    /**
+     * English language.
+     */
+    ENGLISH("en"),
+
+    /**
+     * Basque language.
+     */
+    BASQUE("eu"),
+
+    /**
+     * Persian language.
+     */
+    PERSIAN("fa"),
+
+    /**
+     * Finnish language.
+     */
+    FINNISH("fi"),
+
+    /**
+     * French language.
+     */
+    FRENCH("fr"),
+
+    /**
+     * Galician language.
+     */
+    GALICIAN("gl"),
+
+    /**
+     * Hebrew language.
+     */
+    HEBREW("he"),
+
+    /**
+     * Hindi language.
+     */
+    HINDI("hi"),
+
+    /**
+     * Croatian language.
+     */
+    CROATIAN("hr"),
+
+    /**
+     * Hungarian language.
+     */
+    HUNGARIAN("hu"),
+
+    /**
+     * Indonesian language.
+     */
+    INDONESIAN("id"),
+
+    /**
+     * Italian language.
+     */
+    ITALIAN("it"),
+
+    /**
+     * Japanese language.
+     */
+    JAPANESE("ja"),
+
+    /**
+     * Korean language.
+     */
+    KOREAN("kr"),
+
+    /**
+     * Latvian language.
+     */
+    LATVIAN("la"),
+
+    /**
+     * Lithuanian language.
+     */
+    LITHUANIAN("lt"),
+
+    /**
+     * Macedonian language.
+     */
+    MACEDONIAN("mk"),
+
+    /**
+     * Norwegian language.
+     */
+    NORWEGIAN("no"),
+
+    /**
+     * Dutch language.
+     */
+    DUTCH("nl"),
+
+    /**
+     * Polish language.
+     */
+    POLISH("pl"),
+
+    /**
+     * Portuguese language.
+     */
+    PORTUGUESE("pt"),
+
+    /**
+     * Português Brasil language.
+     */
+    PORTUGUES_BRAZIL("pt_br"),
+
+    /**
+     * Romanian language.
+     */
+    ROMANIAN ("ro"),
+
+    /**
+     * Russian language.
+     */
+    RUSSIAN("ru"),
+
+    /**
+     * Swedish language.
+     */
+    SWEDISH("se"),
+
+    /**
+     * Slovak language.
+     */
+    SLOVAK("sk"),
+
+    /**
+     * Slovenian language.
+     */
+    SLOVENIAN("sl"),
+
+    /**
+     * Spanish language.
+     */
+    SPANISH("es"),
+
+    /**
+     * Serbian language.
+     */
+    SERBIAN("sr"),
+
+    /**
+     * Thai language.
+     */
+    THAI("th"),
+
+    /**
+     * Turkish language.
+     */
+    TURKISH("tr"),
+
+    /**
+     * Ukrainian language.
+     */
+    UKRAINIAN("uk"),
+
+    /**
+     * Vietnamese language.
+     */
+    VIETNAMESE("vi"),
+
+    /**
+     * Chinese simplified language.
+     */
+    CHINESE_SIMPLIFIED("zh_cn"),
+
+    /**
+     * Chinese traditional language.
+     */
+    CHINESE_TRADITIONAL("zh_tw"),
+
+    /**
+     * Zulu language.
+     */
+    ZULU("zu");
+
+    private final String value;
+
+    Language(String value) {
+        this.value = value;
+    }
+
+    /**
+     * Returns language's value.
+     * @return value.
+     */
+    public String getValue() {
+        return value;
+    }
+}

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

@@ -0,0 +1,62 @@
+/*
+ * Copyright (c) 2022 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.enums;
+
+public enum MoonType {
+    NEW_MOON,
+    WAXING_CRESCENT,
+    FIRST_QUARTER_MOON,
+    WAXING_GIBBOUS,
+    FULL_MOON,
+    WANING_GIBBOUS,
+    LAST_QUARTER_MOON,
+    WANING_CRESCENT,
+    INVALID;
+
+    private static final double precision = 0.000001d;
+
+    public static MoonType valueOf(double numericValue) {
+        if (equals(numericValue, 0) || equals(numericValue, 1)) {
+            return NEW_MOON;
+        } else if (equals(numericValue, 0.25)) {
+            return FIRST_QUARTER_MOON;
+        } else if (equals(numericValue, 0.5)) {
+            return FULL_MOON;
+        } else if (equals(numericValue, 0.75)) {
+            return LAST_QUARTER_MOON;
+        } else if (numericValue > 0 && numericValue < 0.25) {
+            return WAXING_CRESCENT;
+        } else if (numericValue > 0.25 && numericValue < 0.5) {
+            return WAXING_GIBBOUS;
+        } else if (numericValue > 0.5 && numericValue < 0.75) {
+            return WANING_GIBBOUS;
+        } else if (numericValue > 0.75 && numericValue < 1) {
+            return WANING_CRESCENT;
+        }
+        return INVALID;
+    }
+
+    private static boolean equals(double d1, double d2) {
+        return Math.abs(d1 - d2) < precision;
+    }
+}

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

@@ -0,0 +1,64 @@
+/*
+ * 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.enums;
+
+/**
+ * The enum One call result options.
+ */
+public enum OneCallResultOptions {
+    /**
+     * Current one call result options.
+     */
+    CURRENT("current"),
+    /**
+     * Minutely one call result options.
+     */
+    MINUTELY("minutely"),
+    /**
+     * Hourly one call result options.
+     */
+    HOURLY("hourly"),
+    /**
+     * Daily one call result options.
+     */
+    DAILY("daily"),
+    /**
+     * Alerts one call result options.
+     */
+    ALERTS("alerts");
+
+    private final String value;
+
+    OneCallResultOptions(String value) {
+        this.value = value;
+    }
+
+    /**
+     * Gets value.
+     *
+     * @return the value
+     */
+    public String getValue() {
+        return value;
+    }
+}

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2018 Alexey Zinchenko
+ * Copyright (c) 2022 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
@@ -20,12 +20,23 @@
  * SOFTWARE.
  */
 
-package com.github.prominence.openweathermap.api.exception;
+package com.github.prominence.openweathermap.api.enums;
 
-public class DataNotFoundException extends Exception {
+public enum ResponseType {
+    HTML("html"),
+    XML("xml");
 
-    public DataNotFoundException() {
+    private final String value;
-        super("Data for provided parameters wasn't found. Please, check your request.");
+
+    ResponseType(String value) {
+        this.value = value;
     }
 
+    /**
+     * Returns language's value.
+     * @return value.
+     */
+    public String getValue() {
+        return value;
+    }
 }

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

@@ -0,0 +1,39 @@
+package com.github.prominence.openweathermap.api.enums;
+
+import java.util.Arrays;
+
+public enum RoadState {
+    NO_REPORT(0),
+    DRY(1),
+    MOIST(2),
+    MOIST_AND_CHEMICALLY_TREATED(3),
+    WET(4),
+    WET_AND_CHEMICALLY_TREATED(5),
+    ICE(6),
+    FROST(7),
+    SNOW(8),
+    SNOW_OR_ICE_WATCH(9),
+    SNOW_OR_ICE_WARNING(10),
+    WET_ABOVE_FREEZING(11),
+    WET_BELOW_FREEZING(12),
+    ABSORPTION(13),
+    ABSORPTION_AT_DEWPOINT(14),
+    DEW(15),
+    BLACK_ICE_WARNING(16),
+    OTHER(17),
+    SLUSH(18);
+
+    private final int value;
+
+    RoadState(int value) {
+        this.value = value;
+    }
+
+    public int getValue() {
+        return value;
+    }
+
+    public static RoadState findByValue(int value) {
+        return Arrays.stream(values()).filter(roadState -> roadState.getValue() == value).findFirst().orElse(null);
+    }
+}

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

@@ -0,0 +1,65 @@
+/*
+ * 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.enums;
+
+/**
+ * An enumeration with all available subscription plans.
+ * More information <a href="https://openweathermap.org/price">at official website</a>.
+ */
+public enum SubscriptionPlan {
+    /**
+     * An alias that represents any of paid plans: startup, developer, professional or enterprise.
+     */
+    PAID,
+
+    /**
+     * Startup subscription plan.
+     */
+    STARTUP,
+
+    /**
+     * Developer subscription plan.
+     */
+    DEVELOPER,
+
+    /**
+     * Professional subscription plan.
+     */
+    PROFESSIONAL,
+
+    /**
+     * Enterprise subscription plan.
+     */
+    ENTERPRISE,
+
+    /**
+     * Special subscription plan. You should contact a manager to get an access.
+     */
+    SPECIAL,
+
+
+    /**
+     * All existing subscription plans.
+     */
+    ALL,
+}

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

@@ -0,0 +1,80 @@
+/*
+ * 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.enums;
+
+/**
+ * An enumeration for supported unit systems with helper methods.
+ */
+public enum UnitSystem {
+    /**
+     * Metric units: Celsius, meter/sec, hPa, mm(rain, snow).
+     */
+    METRIC("metric"),
+
+    /**
+     * Imperial units: Fahrenheit, miles/hour, hPa, mm(rain, snow).
+     */
+    IMPERIAL("imperial"),
+
+    /**
+     * OpenWeatherMap standard units: Kelvin, meter/sec, hPa, mm(rain, snow).
+     */
+    STANDARD("standard");
+
+    private final String value;
+
+    UnitSystem(String value) {
+        this.value = value;
+    }
+
+    /**
+     * Returns wind unit for current unit system.
+     * @return wind unit.
+     */
+    public String getWindUnit() {
+        return switch (this) {
+            case IMPERIAL -> "miles/hour";
+            case STANDARD, METRIC -> "meter/sec";
+        };
+    }
+
+    /**
+     * Returns temperature unit for current unit system.
+     * @return temperature unit.
+     */
+    public String getTemperatureUnit() {
+        return switch (this) {
+            case METRIC -> "°C";
+            case IMPERIAL -> "°F";
+            case STANDARD -> "K";
+        };
+    }
+
+    /**
+     * Returns unit system value.
+     * @return value unit system.
+     */
+    public String getValue() {
+        return value;
+    }
+}

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

@@ -0,0 +1,375 @@
+/*
+ * 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.enums;
+
+import java.util.Arrays;
+import java.util.Optional;
+
+/**
+ * Represents weather condition and related information.
+ * More details <a href="https://openweathermap.org/weather-conditions#Weather-Condition-Codes-2">here</a>.
+ */
+public enum WeatherCondition {
+    // Group 2xx: Thunderstorm
+
+    /**
+     * The thunderstorm with light rain.
+     */
+    THUNDERSTORM_LIGHT_RAIN(200, "Thunderstorm", "thunderstorm with light rain", "11"),
+    /**
+     * The thunderstorm with rain.
+     */
+    THUNDERSTORM_RAIN(201, "Thunderstorm", "thunderstorm with rain", "11"),
+    /**
+     * The thunderstorm with heavy rain.
+     */
+    THUNDERSTORM_HEAVY_RAIN(202, "Thunderstorm", "thunderstorm with heavy rain", "11"),
+    /**
+     * The light thunderstorm.
+     */
+    THUNDERSTORM_LIGHT(210, "Thunderstorm", "light thunderstorm", "11"),
+    /**
+     * The thunderstorm.
+     */
+    THUNDERSTORM(211, "Thunderstorm", "thunderstorm", "11"),
+    /**
+     * The heavy thunderstorm.
+     */
+    THUNDERSTORM_HEAVY(212, "Thunderstorm", "heavy thunderstorm", "11"),
+    /**
+     * The ragged thunderstorm.
+     */
+    THUNDERSTORM_RAGGED(221, "Thunderstorm", "ragged thunderstorm", "11"),
+    /**
+     * The thunderstorm with light drizzle.
+     */
+    THUNDERSTORM_LIGHT_DRIZZLE(230, "Thunderstorm", "thunderstorm with light drizzle", "11"),
+    /**
+     * The thunderstorm with drizzle.
+     */
+    THUNDERSTORM_DRIZZLE(231, "Thunderstorm", "thunderstorm with drizzle", "11"),
+    /**
+     * The thunderstorm with heavy drizzle.
+     */
+    THUNDERSTORM_HEAVY_DRIZZLE(232, "Thunderstorm", "thunderstorm with heavy drizzle", "11"),
+
+    // Group 3xx: Drizzle
+
+    /**
+     * The light intensity drizzle.
+     */
+    DRIZZLE_LIGHT(300, "Drizzle", "light intensity drizzle", "09"),
+    /**
+     * The drizzle.
+     */
+    DRIZZLE(301, "Drizzle", "drizzle", "09"),
+    /**
+     * The heavy intensity drizzle.
+     */
+    DRIZZLE_HEAVY(302, "Drizzle", "heavy intensity drizzle", "09"),
+    /**
+     * The light intensity drizzle rain.
+     */
+    DRIZZLE_LIGHT_RAIN(310, "Drizzle", "light intensity drizzle rain", "09"),
+    /**
+     * The drizzle rain.
+     */
+    DRIZZLE_RAIN(311, "Drizzle", "drizzle rain", "09"),
+    /**
+     * The heavy intensity drizzle rain.
+     */
+    DRIZZLE_HEAVY_RAIN(312, "Drizzle", "heavy intensity drizzle rain", "09"),
+    /**
+     * The shower rain and drizzle.
+     */
+    DRIZZLE_SHOWER_RAIN(313, "Drizzle", "shower rain and drizzle", "09"),
+    /**
+     * The heavy shower rain and drizzle.
+     */
+    DRIZZLE_HEAVY_SHOWER_RAIN(314, "Drizzle", "heavy shower rain and drizzle", "09"),
+    /**
+     * The shower drizzle.
+     */
+    DRIZZLE_SHOWER(321, "Drizzle", "shower drizzle", "09"),
+
+    // Group 5xx: Rain
+
+    /**
+     * The light rain.
+     */
+    RAIN_LIGHT(500, "Rain", "light rain", "10"),
+    /**
+     * The moderate rain.
+     */
+    RAIN_MODERATE(501, "Rain", "moderate rain", "10"),
+    /**
+     * The heavy intensity rain.
+     */
+    RAIN_HEAVY(502, "Rain", "heavy intensity rain", "10"),
+    /**
+     * The very heavy rain.
+     */
+    RAIN_VERY_HEAVY(503, "Rain", "very heavy rain", "10"),
+    /**
+     * The very heavy rain.
+     */
+    RAIN_EXTREME(504, "Rain", "very heavy rain", "10"),
+    /**
+     * The freezing rain.
+     */
+    RAIN_FREEZING(511, "Rain", "freezing rain", "10"),
+    /**
+     * The light intensity shower rain.
+     */
+    RAIN_LIGHT_SHOWER(520, "Rain", "light intensity shower rain", "10"),
+    /**
+     * The shower rain.
+     */
+    RAIN_SHOWER(521, "Rain", "shower rain", "10"),
+    /**
+     * The heavy intensity shower rain.
+     */
+    RAIN_HEAVY_SHOWER(522, "Rain", "heavy intensity shower rain", "10"),
+    /**
+     * The ragged shower rain.
+     */
+    RAIN_RAGGED_SHOWER(531, "Rain", "ragged shower rain", "10"),
+
+    // Group 6xx: Snow
+
+    /**
+     * The light snow.
+     */
+    SNOW_LIGHT(600, "Snow", "light snow", "13"),
+    /**
+     * The snow.
+     */
+    SNOW(601, "Snow", "snow", "13"),
+    /**
+     * The heavy snow.
+     */
+    SNOW_HEAVY(602, "Snow", "heavy snow", "13"),
+    /**
+     * The sleet.
+     */
+    SNOW_SLEET(611, "Snow", "sleet", "13"),
+    /**
+     * The light shower sleet.
+     */
+    SNOW_LIGHT_SHOWER_SLEET(612, "Snow", "light shower sleet", "13"),
+    /**
+     * The shower sleet.
+     */
+    SNOW_SHOWER_SLEET(613, "Snow", "shower sleet", "13"),
+    /**
+     * The light rain and snow.
+     */
+    SNOW_LIGHT_RAIN_AND_SNOW(615, "Snow", "light rain and snow", "13"),
+    /**
+     * The rain and snow.
+     */
+    SNOW_RAIN_AND_SNOW(616, "Snow", "rain and snow", "13"),
+    /**
+     * The light shower snow.
+     */
+    SNOW_LIGHT_SHOWER_SNOW(620, "Snow", "light shower snow", "13"),
+    /**
+     * The shower snow.
+     */
+    SNOW_SHOWER_SNOW(621, "Snow", "shower snow", "13"),
+    /**
+     * The heavy shower snow.
+     */
+    SNOW_HEAVY_SHOWER_SNOW(622, "Snow", "heavy shower snow", "13"),
+
+    // Group 7xx: Atmosphere
+
+    /**
+     * The mist.
+     */
+    MIST(701, "Mist", "mist", "50"),
+    /**
+     * The smoke.
+     */
+    SMOKE(711, "Smoke", "smoke", "50"),
+    /**
+     * The haze.
+     */
+    HAZE(721, "Haze", "haze", "50"),
+    /**
+     * The sand/dust whirls.
+     */
+    DUST_WHIRLS(731, "Dust", "sand/dust whirls", "50"),
+    /**
+     * The fog.
+     */
+    FOG(741, "Fog", "fog", "50"),
+    /**
+     * The sand.
+     */
+    SAND(751, "Sand", "sand", "50"),
+    /**
+     * The dust.
+     */
+    DUST(761, "Dust", "dust", "50"),
+    /**
+     * The volcanic ash.
+     */
+    ASH(762, "Ash", "volcanic ash", "50"),
+    /**
+     * The squall.
+     */
+    SQUALL(771, "Squall", "squalls", "50"),
+    /**
+     * The tornado.
+     */
+    TORNADO(781, "Tornado", "tornado", "50"),
+
+    // Group 800: Clear
+
+    /**
+     * The clear sky.
+     */
+    CLEAR(800, "Clear", "clear sky", "01"),
+
+    // Group 80x: Clouds
+
+    /**
+     * A few clouds: 11-25%.
+     */
+    CLOUDS_FEW(801, "Clouds", "few clouds: 11-25%", "02"),
+    /**
+     * A scattered clouds: 25-50%.
+     */
+    CLOUDS_SCATTERED(802, "Clouds", "scattered clouds: 25-50%", "03"),
+    /**
+     * A broken clouds: 51-84%.
+     */
+    CLOUDS_BROKEN(803, "Clouds", "broken clouds: 51-84%", "04"),
+    /**
+     * An overcast clouds: 85-100%.
+     */
+    CLOUDS_OVERCAST(804, "Clouds", "overcast clouds: 85-100%", "04");
+
+
+    private final int id;
+    private final String name;
+    private final String description;
+    private final String iconId;
+
+    private WeatherCondition(int id, String name, String description, String iconId) {
+        this.id = id;
+        this.name = name;
+        this.description = description;
+        this.iconId = iconId;
+    }
+
+    /**
+     * Gets id.
+     *
+     * @return the id
+     */
+    public int getId() {
+        return id;
+    }
+
+    /**
+     * Gets name.
+     *
+     * @return the name
+     */
+    public String getName() {
+        return name;
+    }
+
+    /**
+     * Gets description.
+     *
+     * @return the description
+     */
+    public String getDescription() {
+        return description;
+    }
+
+    /**
+     * Gets day icon id.
+     *
+     * @return the day icon id
+     */
+    public String getDayIconId() {
+        return iconId + 'd';
+    }
+
+    /**
+     * Gets night icon id.
+     *
+     * @return the night icon id
+     */
+    public String getNightIconId() {
+        return iconId + 'n';
+    }
+
+    /**
+     * Gets day icon url.
+     *
+     * @return the day icon url
+     */
+    public String getDayIconUrl() {
+        return getIconUrl(getDayIconId());
+    }
+
+    /**
+     * Gets night icon url.
+     *
+     * @return the night icon url
+     */
+    public String getNightIconUrl() {
+        return getIconUrl(getNightIconId());
+    }
+
+    /**
+     * Gets icon url.
+     *
+     * @param iconId the icon id
+     * @return the icon url
+     */
+    public static String getIconUrl(String iconId) {
+        return "http://openweathermap.org/img/w/" + iconId + ".png";
+    }
+
+    /**
+     * Gets {@link WeatherCondition} by id.
+     *
+     * @param id the id
+     * @return the by id
+     */
+    public static WeatherCondition getById(int id) {
+        final Optional<WeatherCondition> optionalWeatherCondition = Arrays.stream(values()).filter(weatherCondition -> weatherCondition.getId() == id).findFirst();
+        return optionalWeatherCondition.orElse(null);
+    }
+
+    @Override
+    public String toString() {
+        return "Weather condition(" + id + "): " + name + '(' + description + ')';
+    }
+}

src/main/java/com/github/prominence/openweathermap/api/exception/InvalidAuthTokenException.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2018 Alexey Zinchenko
+ * 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
@@ -22,10 +22,16 @@
 
 package com.github.prominence.openweathermap.api.exception;
 
-public class InvalidAuthTokenException extends Exception {
+/**
-
+ * An exception that could be thrown in case of your API key is invalid or your subscription plan does not cover requested functionality.
+ * Subscription plans information you can find <a href="https://openweathermap.org/price">here</a>.
+ * API Keys could be checked in <a href="https://home.openweathermap.org/api_keys/">your profile</a>.
+ */
+public class InvalidAuthTokenException extends RuntimeException {
+    /**
+     * Creates {@link InvalidAuthTokenException} exception with default message.
+     */
     public InvalidAuthTokenException() {
-        super("Check your authentication token! You can get it here: https://home.openweathermap.org/api_keys/.");
+        super("Authentication token wasn't set or requested functionality is not permitted for your subscription plan. Please, check https://home.openweathermap.org/api_keys/ and https://openweathermap.org/price.");
     }
-
 }

src/main/java/com/github/prominence/openweathermap/api/exception/NoDataFoundException.java

@@ -0,0 +1,48 @@
+/*
+ * 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.exception;
+
+/**
+ * An exception that could be thrown in several cases:
+ * <ul>
+ *     <li>There is no data found for your query(wrong coordinates somewhere in the sea, some distant place, etc.);</li>
+ *     <li>Request is malformed. An occasion to report an <a href="https://github.com/Prominence/openweathermap-java-api/issues">issue</a>;</li>
+ *     <li>Any other unpredictable problems.</li>
+ * </ul>
+ */
+public class NoDataFoundException extends RuntimeException {
+    /**
+     * Creates {@link NoDataFoundException} with default message.
+     */
+    public NoDataFoundException() {
+        super("Data for provided parameters wasn't found. Please, check requested location.");
+    }
+
+    /**
+     * Creates {@link NoDataFoundException} with message from another throwable.
+     * @param throwable source throwable.
+     */
+    public NoDataFoundException(Throwable throwable) {
+        super(throwable.getMessage(), throwable.getCause());
+    }
+}

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

@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2022 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.mapper;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.github.prominence.openweathermap.api.model.WeatherState;
+import com.github.prominence.openweathermap.api.utils.JsonDeserializationUtils;
+
+import java.io.IOException;
+import java.time.LocalDateTime;
+import java.time.ZoneId;
+import java.time.ZoneOffset;
+import java.util.ArrayList;
+import java.util.List;
+
+public abstract class AbstractMapper {
+    protected final ObjectMapper objectMapper = new ObjectMapper();
+
+    protected LocalDateTime parseDateTime(JsonNode dateTimeNode) {
+        return JsonDeserializationUtils.parseDateTime(dateTimeNode);
+    }
+
+    protected ZoneId parseZoneId(JsonNode zoneIdNode) {
+        return JsonDeserializationUtils.parseZoneId(zoneIdNode);
+    }
+
+    protected ZoneOffset parseZoneOffset(JsonNode zoneOffsetNode) {
+        return JsonDeserializationUtils.parseZoneOffset(zoneOffsetNode);
+    }
+
+    protected List<WeatherState> parseWeatherStates(JsonNode weatherArrayNode) throws IOException {
+        List<WeatherState> weatherStateList = new ArrayList<>();
+        if (weatherArrayNode != null && weatherArrayNode.isArray()) {
+            for (JsonNode weatherNode : weatherArrayNode) {
+                weatherStateList.add(objectMapper.readValue(objectMapper.treeAsTokens(weatherNode), WeatherState.class));
+            }
+        }
+        return weatherStateList;
+    }
+}

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

@@ -0,0 +1,102 @@
+/*
+ * Copyright (c) 2022 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.mapper;
+
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.github.prominence.openweathermap.api.enums.AirQualityIndex;
+import com.github.prominence.openweathermap.api.model.Coordinates;
+import com.github.prominence.openweathermap.api.model.air.pollution.AirPollutionDetails;
+import com.github.prominence.openweathermap.api.model.air.pollution.AirPollutionRecord;
+
+import java.time.Instant;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.TimeZone;
+
+/**
+ * Official API response documentation: <a href="https://openweathermap.org/api/air-pollution#fields">https://openweathermap.org/api/air-pollution#fields</a>.
+ */
+public class AirPollutionResponseMapper {
+    /**
+     * Map to air pollution air pollution.
+     *
+     * @param json the json
+     * @return the air pollution
+     */
+    public AirPollutionDetails mapToAirPollution(String json) {
+        final ObjectMapper objectMapper = new ObjectMapper();
+        AirPollutionDetails airPollutionDetails;
+        try {
+            final JsonNode root = objectMapper.readTree(json);
+            airPollutionDetails = mapToAirPollution(root);
+        } catch (JsonProcessingException e) {
+            throw new RuntimeException("Cannot parse Air Pollution response");
+        }
+
+        return airPollutionDetails;
+    }
+
+    private AirPollutionDetails mapToAirPollution(JsonNode rootNode) {
+        final AirPollutionDetails airPollutionDetails = new AirPollutionDetails();
+        airPollutionDetails.setCoordinates(parseCoordinate(rootNode.get("coord")));
+
+        final List<AirPollutionRecord> sampleList = new ArrayList<>();
+        final JsonNode sampleListNode = rootNode.get("list");
+        sampleListNode.forEach(sampleNode -> {
+            sampleList.add(parseAirPollutionSample(sampleNode));
+        });
+        airPollutionDetails.setAirPollutionRecords(sampleList);
+
+        return airPollutionDetails;
+    }
+
+    private AirPollutionRecord parseAirPollutionSample(JsonNode sampleNode) {
+        AirPollutionRecord airPollutionRecord = new AirPollutionRecord();
+        airPollutionRecord.setForecastTime(LocalDateTime.ofInstant(Instant.ofEpochSecond(sampleNode.get("dt").asInt()), TimeZone.getDefault().toZoneId()));
+        airPollutionRecord.setAirQualityIndex(AirQualityIndex.getByIndex(sampleNode.get("main").get("aqi").asInt()));
+
+        final JsonNode componentsNode = sampleNode.get("components");
+        airPollutionRecord.setCO(componentsNode.get("co").asDouble());
+        airPollutionRecord.setNO(componentsNode.get("no").asDouble());
+        airPollutionRecord.setNO2(componentsNode.get("no2").asDouble());
+        airPollutionRecord.setO3(componentsNode.get("o3").asDouble());
+        airPollutionRecord.setSO2(componentsNode.get("so2").asDouble());
+        airPollutionRecord.setPM2_5(componentsNode.get("pm2_5").asDouble());
+        airPollutionRecord.setPM10(componentsNode.get("pm10").asDouble());
+        airPollutionRecord.setNH3(componentsNode.get("nh3").asDouble());
+
+        return airPollutionRecord;
+    }
+
+    private Coordinates parseCoordinate(JsonNode rootNode) {
+        final JsonNode latitudeNode = rootNode.get("lat");
+        final JsonNode longitudeNode = rootNode.get("lon");
+        if (latitudeNode != null && longitudeNode != null) {
+            return Coordinates.of(latitudeNode.asDouble(), longitudeNode.asDouble());
+        }
+        return null;
+    }
+}

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

@@ -0,0 +1,84 @@
+package com.github.prominence.openweathermap.api.mapper;
+
+import com.fasterxml.jackson.databind.InjectableValues;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.HumidityDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.WeatherStateDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.forecast.climatic.*;
+import com.github.prominence.openweathermap.api.enums.UnitSystem;
+import com.github.prominence.openweathermap.api.model.Clouds;
+import com.github.prominence.openweathermap.api.model.Humidity;
+import com.github.prominence.openweathermap.api.model.WeatherState;
+import com.github.prominence.openweathermap.api.model.Wind;
+import com.github.prominence.openweathermap.api.model.forecast.climatic.*;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+public class ClimaticForecastResponseMapper extends AbstractMapper {
+
+    public ClimaticForecastResponseMapper(UnitSystem unitSystem) {
+        objectMapper.setInjectableValues(new InjectableValues.Std().addValue("unitSystem", unitSystem != null ? unitSystem : UnitSystem.STANDARD));
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(WeatherState.class, new WeatherStateDeserializer());
+        module.addDeserializer(Temperature.class, new ClimaticForecastTemperatureDeserializer());
+        module.addDeserializer(AtmosphericPressure.class, new ClimaticForecastAtmosphericPressureDeserializer());
+        module.addDeserializer(Humidity.class, new HumidityDeserializer());
+        module.addDeserializer(Clouds.class, new ClimaticForecastCloudsDeserializer());
+        module.addDeserializer(Rain.class, new ClimaticForecastRainDeserializer());
+        module.addDeserializer(Snow.class, new ClimaticForecastSnowDeserializer());
+        module.addDeserializer(Wind.class, new ClimaticForecastWindDeserializer());
+        module.addDeserializer(Location.class, new ClimaticForecastLocationDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    public Forecast mapToForecast(String json) {
+        Forecast forecast;
+        try {
+            final JsonNode root = objectMapper.readTree(json);
+            forecast = mapToForecast(root);
+        } catch (IOException e) {
+            throw new RuntimeException("Cannot parse Forecast response", e);
+        }
+
+        return forecast;
+    }
+
+    private Forecast mapToForecast(JsonNode root) throws IOException {
+        final Forecast forecast = new Forecast();
+        forecast.setLocation(objectMapper.readValue(objectMapper.treeAsTokens(root.get("city")), Location.class));
+
+        final List<WeatherForecast> forecasts = new ArrayList<>();
+
+        final JsonNode forecastListNode = root.get("list");
+        for (JsonNode forecastNode : forecastListNode) {
+            forecasts.add(parseWeatherForecast(forecastNode));
+        }
+
+        forecast.setWeatherForecasts(forecasts);
+
+        return forecast;
+    }
+
+    private WeatherForecast parseWeatherForecast(JsonNode rootNode) throws IOException {
+        final WeatherForecast weatherForecast = new WeatherForecast();
+
+        weatherForecast.setForecastTime(parseDateTime(rootNode.get("dt")));
+        weatherForecast.setSunriseTime(parseDateTime(rootNode.get("sunrise")));
+        weatherForecast.setSunsetTime(parseDateTime(rootNode.get("sunset")));
+
+        weatherForecast.setWeatherStates(parseWeatherStates(rootNode.get("weather")));
+
+        weatherForecast.setTemperature(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Temperature.class));
+        weatherForecast.setAtmosphericPressure(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), AtmosphericPressure.class));
+        weatherForecast.setHumidity(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Humidity.class));
+        weatherForecast.setClouds(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Clouds.class));
+        weatherForecast.setWind(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Wind.class));
+        weatherForecast.setRain(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Rain.class));
+        weatherForecast.setSnow(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Snow.class));
+
+        return weatherForecast;
+    }
+}

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

@@ -0,0 +1,112 @@
+/*
+ * Copyright (c) 2022 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.mapper;
+
+import com.fasterxml.jackson.databind.InjectableValues;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.*;
+import com.github.prominence.openweathermap.api.deserializer.weather.WeatherLocationDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.weather.WeatherRainDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.weather.WeatherSnowDeserializer;
+import com.github.prominence.openweathermap.api.enums.UnitSystem;
+import com.github.prominence.openweathermap.api.model.*;
+import com.github.prominence.openweathermap.api.model.weather.Location;
+import com.github.prominence.openweathermap.api.model.weather.Rain;
+import com.github.prominence.openweathermap.api.model.weather.Snow;
+import com.github.prominence.openweathermap.api.model.weather.Weather;
+
+import java.io.IOException;
+
+/**
+ * Official API response documentation: <a href="https://openweathermap.org/current#current_JSON">https://openweathermap.org/current#current_JSON</a>.
+ * Ignored internal parameters: "root.cod", "sys.type", "sys.id", "sys.message".
+ */
+public class CurrentWeatherResponseMapper extends AbstractMapper {
+    /**
+     * Instantiates a new Current weather response mapper.
+     *
+     * @param unitSystem the unit system
+     */
+    public CurrentWeatherResponseMapper(UnitSystem unitSystem) {
+        objectMapper.setInjectableValues(new InjectableValues.Std().addValue("unitSystem", unitSystem != null ? unitSystem : UnitSystem.STANDARD));
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(WeatherState.class, new WeatherStateDeserializer());
+        module.addDeserializer(Temperature.class, new TemperatureDeserializer());
+        module.addDeserializer(AtmosphericPressure.class, new AtmosphericPressureDeserializer());
+        module.addDeserializer(Humidity.class, new HumidityDeserializer());
+        module.addDeserializer(Wind.class, new WindDeserializer());
+        module.addDeserializer(Rain.class, new WeatherRainDeserializer());
+        module.addDeserializer(Snow.class, new WeatherSnowDeserializer());
+        module.addDeserializer(Clouds.class, new CloudsDeserializer());
+        module.addDeserializer(Location.class, new WeatherLocationDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    /**
+     * Gets single result.
+     *
+     * @param json the json string
+     * @return the weather object
+     */
+    public Weather mapToWeather(String json) {
+        Weather weather;
+        try {
+            final JsonNode root = objectMapper.readTree(json);
+            weather = mapToWeather(root);
+        } catch (IOException e) {
+            throw new RuntimeException("Cannot parse Weather response", e);
+        }
+
+        return weather;
+    }
+
+    private Weather mapToWeather(JsonNode rootNode) throws IOException {
+        final JsonNode weatherArrayNode = rootNode.get("weather");
+        final Weather weather = new Weather();
+
+        weather.setWeatherStates(parseWeatherStates(weatherArrayNode));
+
+        weather.setTemperature(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("main")), Temperature.class));
+        weather.setAtmosphericPressure(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("main")), AtmosphericPressure.class));
+        weather.setHumidity(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("main")), Humidity.class));
+        weather.setWind(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("wind")), Wind.class));
+        if (rootNode.has("rain")) {
+            weather.setRain(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("rain")), Rain.class));
+        }
+        if (rootNode.has("snow")) {
+            weather.setSnow(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("snow")), Snow.class));
+        }
+        weather.setClouds(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("clouds")), Clouds.class));
+        weather.setLocation(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Location.class));
+
+        final JsonNode dtNode = rootNode.get("dt");
+        if (dtNode != null) {
+            weather.setCalculationTime(parseDateTime(dtNode));
+        }
+
+        weather.setBase(rootNode.get("base").asText());
+
+        return weather;
+    }
+}

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

@@ -0,0 +1,119 @@
+/*
+ * Copyright (c) 2022 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.mapper;
+
+import com.fasterxml.jackson.databind.InjectableValues;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.HumidityDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.WeatherStateDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.WindDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.forecast.daily.*;
+import com.github.prominence.openweathermap.api.enums.UnitSystem;
+import com.github.prominence.openweathermap.api.model.Clouds;
+import com.github.prominence.openweathermap.api.model.Humidity;
+import com.github.prominence.openweathermap.api.model.WeatherState;
+import com.github.prominence.openweathermap.api.model.Wind;
+import com.github.prominence.openweathermap.api.model.forecast.daily.*;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * Official API response documentation: <a href="https://openweathermap.org/forecast16#JSON">https://openweathermap.org/forecast16#JSON</a>.
+ */
+public class DailyForecastResponseMapper extends AbstractMapper {
+    public DailyForecastResponseMapper(UnitSystem unitSystem) {
+        objectMapper.setInjectableValues(new InjectableValues.Std().addValue("unitSystem", unitSystem != null ? unitSystem : UnitSystem.STANDARD));
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(WeatherState.class, new WeatherStateDeserializer());
+        module.addDeserializer(Temperature.class, new DailyForecastTemperatureDeserializer());
+        module.addDeserializer(AtmosphericPressure.class, new DailyForecastAtmosphericPressureDeserializer());
+        module.addDeserializer(Humidity.class, new HumidityDeserializer());
+        module.addDeserializer(Clouds.class, new DailyForecastCloudsDeserializer());
+        module.addDeserializer(Rain.class, new DailyForecastRainDeserializer());
+        module.addDeserializer(Snow.class, new DailyForecastSnowDeserializer());
+        module.addDeserializer(Wind.class, new WindDeserializer());
+        module.addDeserializer(Location.class, new DailyForecastLocationDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    /**
+     * Maps forecast response into java object.
+     *
+     * @param json the json string
+     * @return the forecast
+     */
+    public Forecast mapToForecast(String json) {
+        Forecast forecast;
+        try {
+            final JsonNode root = objectMapper.readTree(json);
+            forecast = mapToForecast(root);
+        } catch (IOException e) {
+            throw new RuntimeException("Cannot parse Forecast response", e);
+        }
+
+        return forecast;
+    }
+
+    private Forecast mapToForecast(JsonNode root) throws IOException {
+        final Forecast forecast = new Forecast();
+        forecast.setLocation(objectMapper.readValue(objectMapper.treeAsTokens(root.get("city")), Location.class));
+
+        final List<WeatherForecast> forecasts = new ArrayList<>(root.get("cnt").asInt());
+
+        final JsonNode forecastListNode = root.get("list");
+        for (JsonNode forecastNode : forecastListNode) {
+            forecasts.add(parseWeatherForecast(forecastNode));
+        }
+
+        forecast.setWeatherForecasts(forecasts);
+
+        return forecast;
+    }
+
+    private WeatherForecast parseWeatherForecast(JsonNode rootNode) throws IOException {
+        final WeatherForecast weatherForecast = new WeatherForecast();
+
+        weatherForecast.setForecastTime(parseDateTime(rootNode.get("dt")));
+        weatherForecast.setSunriseTime(parseDateTime(rootNode.get("sunrise")));
+        weatherForecast.setSunsetTime(parseDateTime(rootNode.get("sunset")));
+
+        weatherForecast.setWeatherStates(parseWeatherStates(rootNode.get("weather")));
+
+        weatherForecast.setTemperature(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Temperature.class));
+        weatherForecast.setAtmosphericPressure(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), AtmosphericPressure.class));
+        weatherForecast.setHumidity(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Humidity.class));
+        weatherForecast.setClouds(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Clouds.class));
+        weatherForecast.setWind(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Wind.class));
+        weatherForecast.setRain(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Rain.class));
+        weatherForecast.setSnow(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Snow.class));
+
+        if (rootNode.has("pop")) {
+            weatherForecast.setProbabilityOfPrecipitation(rootNode.get("pop").asDouble());
+        }
+
+        return weatherForecast;
+    }
+}

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

@@ -0,0 +1,137 @@
+/*
+ * Copyright (c) 2022 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.mapper;
+
+import com.fasterxml.jackson.databind.InjectableValues;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.*;
+import com.github.prominence.openweathermap.api.deserializer.forecast.free.FreeForecastLocationDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.forecast.free.FreeForecastRainDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.forecast.free.FreeForecastSnowDeserializer;
+import com.github.prominence.openweathermap.api.enums.UnitSystem;
+import com.github.prominence.openweathermap.api.model.*;
+import com.github.prominence.openweathermap.api.model.forecast.free.*;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * Official API response documentation: <a href="https://openweathermap.org/forecast5#JSON">https://openweathermap.org/forecast5#JSON</a>.
+ */
+public class FiveDayThreeHourStepForecastResponseMapper extends AbstractMapper {
+    /**
+     * Instantiates a new forecast response mapper.
+     *
+     * @param unitSystem the unit system
+     */
+    public FiveDayThreeHourStepForecastResponseMapper(UnitSystem unitSystem) {
+        objectMapper.setInjectableValues(new InjectableValues.Std().addValue("unitSystem", unitSystem != null ? unitSystem : UnitSystem.STANDARD));
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(WeatherState.class, new WeatherStateDeserializer());
+        module.addDeserializer(Temperature.class, new TemperatureDeserializer());
+        module.addDeserializer(AtmosphericPressure.class, new AtmosphericPressureDeserializer());
+        module.addDeserializer(Humidity.class, new HumidityDeserializer());
+        module.addDeserializer(Clouds.class, new CloudsDeserializer());
+        module.addDeserializer(Wind.class, new WindDeserializer());
+        module.addDeserializer(Rain.class, new FreeForecastRainDeserializer());
+        module.addDeserializer(Snow.class, new FreeForecastSnowDeserializer());
+        module.addDeserializer(Location.class, new FreeForecastLocationDeserializer());
+        objectMapper.registerModule(module);
+
+    }
+
+    /**
+     * Maps forecast response into java object.
+     *
+     * @param json the json string
+     * @return the forecast
+     */
+    public Forecast mapToForecast(String json) {
+
+        Forecast forecast;
+        try {
+            final JsonNode root = objectMapper.readTree(json);
+            forecast = mapToForecast(root);
+        } catch (IOException e) {
+            throw new RuntimeException("Cannot parse Forecast response", e);
+        }
+
+        return forecast;
+    }
+
+    private Forecast mapToForecast(JsonNode rootNode) throws IOException {
+        final Forecast forecast = new Forecast();
+        forecast.setLocation(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("city")), Location.class));
+
+        final List<WeatherForecast> forecasts = new ArrayList<>(rootNode.get("cnt").asInt());
+
+        final JsonNode forecastListNode = rootNode.get("list");
+        for (JsonNode forecastNode : forecastListNode) {
+            forecasts.add(parseWeatherForecast(forecastNode));
+        }
+
+        forecast.setWeatherForecasts(forecasts);
+
+        return forecast;
+    }
+
+    private WeatherForecast parseWeatherForecast(JsonNode rootNode) throws IOException {
+        final WeatherForecast weatherForecast = new WeatherForecast();
+        final JsonNode weatherArrayNode = rootNode.get("weather");
+        weatherForecast.setWeatherStates(parseWeatherStates(weatherArrayNode));
+
+        final JsonNode mainNode = rootNode.get("main");
+        weatherForecast.setTemperature(objectMapper.readValue(objectMapper.treeAsTokens(mainNode), Temperature.class));
+        weatherForecast.setAtmosphericPressure(objectMapper.readValue(objectMapper.treeAsTokens(mainNode), AtmosphericPressure.class));
+        weatherForecast.setHumidity(objectMapper.readValue(objectMapper.treeAsTokens(mainNode), Humidity.class));
+        weatherForecast.setClouds(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("clouds")), Clouds.class));
+        weatherForecast.setWind(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("wind")), Wind.class));
+        if (rootNode.has("rain")) {
+            weatherForecast.setRain(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("rain")), Rain.class));
+        }
+        if (rootNode.has("snow")) {
+            weatherForecast.setSnow(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("snow")), Snow.class));
+        }
+
+        final JsonNode sysNode = rootNode.get("sys");
+        if (sysNode != null) {
+            weatherForecast.setDayTime("d".equals(sysNode.get("pod").asText()) ? DayTime.DAY : DayTime.NIGHT);
+        }
+
+        final JsonNode visibilityNode = rootNode.get("visibility");
+        if (visibilityNode != null) {
+            weatherForecast.setVisibilityInMetres(visibilityNode.asDouble());
+        }
+        final JsonNode popNode = rootNode.get("pop");
+        if (popNode != null) {
+            weatherForecast.setProbabilityOfPrecipitation(popNode.asDouble());
+        }
+
+        weatherForecast.setForecastTime(parseDateTime(rootNode.get("dt")));
+        weatherForecast.setForecastTimeISO(rootNode.get("dt_txt").asText());
+
+        return weatherForecast;
+    }
+}

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

@@ -0,0 +1,64 @@
+/*
+ * Copyright (c) 2022 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.mapper;
+
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.core.type.TypeReference;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.GeocodingRecordDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.ZipCodeGeocodingDeserializer;
+import com.github.prominence.openweathermap.api.model.geocoding.GeocodingRecord;
+import com.github.prominence.openweathermap.api.model.geocoding.ZipCodeGeocodingRecord;
+
+import java.util.List;
+
+/**
+ * Official API response documentation: <a href="https://openweathermap.org/api/geocoding-api">https://openweathermap.org/api/geocoding-api</a>.
+ */
+public class GeocodingResponseMapper {
+    private static final ObjectMapper objectMapper = new ObjectMapper();
+
+    public GeocodingResponseMapper() {
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(GeocodingRecord.class, new GeocodingRecordDeserializer());
+        module.addDeserializer(ZipCodeGeocodingRecord.class, new ZipCodeGeocodingDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    public List<GeocodingRecord> mapGeocodingResponse(String json) {
+        try {
+            return objectMapper.readValue(json, new TypeReference<List<GeocodingRecord>>() {});
+        }  catch (JsonProcessingException e) {
+            throw new RuntimeException("Cannot parse ReverseGeocoding response.", e);
+        }
+    }
+
+    public ZipCodeGeocodingRecord mapZipCodeGeocodingResponse(String json) {
+        try {
+            return objectMapper.readValue(json, ZipCodeGeocodingRecord.class);
+        } catch (JsonProcessingException e) {
+            throw new RuntimeException("Cannot parse GeocodingInfo response.", e);
+        }
+    }
+}

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

@@ -0,0 +1,143 @@
+/*
+ * Copyright (c) 2022 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.mapper;
+
+import com.fasterxml.jackson.databind.InjectableValues;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.*;
+import com.github.prominence.openweathermap.api.deserializer.forecast.hourly.HourlyForecastLocationDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.forecast.hourly.HourlyForecastRainDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.forecast.hourly.HourlyForecastSnowDeserializer;
+import com.github.prominence.openweathermap.api.enums.UnitSystem;
+import com.github.prominence.openweathermap.api.model.*;
+import com.github.prominence.openweathermap.api.model.forecast.hourly.*;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+
+/**
+ * Official API response documentation: <a href="https://openweathermap.org/api/hourly-forecast#JSON">https://openweathermap.org/api/hourly-forecast#JSON</a>.
+ */
+public class HourlyForecastResponseMapper extends AbstractMapper {
+    /**
+     * Instantiates a new forecast response mapper.
+     *
+     * @param unitSystem the unit system
+     */
+    public HourlyForecastResponseMapper(UnitSystem unitSystem) {
+        objectMapper.setInjectableValues(new InjectableValues.Std().addValue("unitSystem", unitSystem != null ? unitSystem : UnitSystem.STANDARD));
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(WeatherState.class, new WeatherStateDeserializer());
+        module.addDeserializer(Temperature.class, new TemperatureDeserializer());
+        module.addDeserializer(AtmosphericPressure.class, new AtmosphericPressureDeserializer());
+        module.addDeserializer(Wind.class, new WindDeserializer());
+        module.addDeserializer(Humidity.class, new HumidityDeserializer());
+        module.addDeserializer(Clouds.class, new CloudsDeserializer());
+        module.addDeserializer(Rain.class, new HourlyForecastRainDeserializer());
+        module.addDeserializer(Snow.class, new HourlyForecastSnowDeserializer());
+        module.addDeserializer(Location.class, new HourlyForecastLocationDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    /**
+     * Maps forecast response into java object.
+     *
+     * @param json the json string
+     * @return the forecast
+     */
+    public HourlyForecast mapToForecast(String json) {
+        HourlyForecast hourlyForecast;
+        try {
+            final JsonNode root = objectMapper.readTree(json);
+            hourlyForecast = mapToForecast(root);
+        } catch (IOException e) {
+            throw new RuntimeException("Cannot parse Forecast response");
+        }
+
+        return hourlyForecast;
+    }
+
+    private HourlyForecast mapToForecast(JsonNode root) throws IOException {
+        final HourlyForecast hourlyForecast = new HourlyForecast();
+        hourlyForecast.setLocation(objectMapper.readValue(objectMapper.treeAsTokens(root.get("city")), Location.class));
+
+        final List<WeatherForecast> forecasts = new ArrayList<>(root.get("cnt").asInt());
+
+        final JsonNode forecastListNode = root.get("list");
+        for (JsonNode forecastNode : forecastListNode) {
+            forecasts.add(parseWeatherForecast(forecastNode));
+        }
+
+        hourlyForecast.setWeatherForecasts(forecasts);
+
+        return hourlyForecast;
+    }
+
+    private WeatherForecast parseWeatherForecast(JsonNode rootNode) throws IOException {
+        final WeatherForecast weatherForecast = new WeatherForecast();
+
+        final JsonNode weatherArrayNode = rootNode.get("weather");
+        if (weatherArrayNode != null && weatherArrayNode.isArray()) {
+            List<WeatherState> weatherStateList = new ArrayList<>();
+            for (JsonNode weatherNode : weatherArrayNode) {
+                weatherStateList.add(objectMapper.readValue(objectMapper.treeAsTokens(weatherNode), WeatherState.class));
+            }
+
+            weatherForecast.setWeatherStates(weatherStateList);
+        }
+
+        final JsonNode mainNode = rootNode.get("main");
+        weatherForecast.setTemperature(objectMapper.readValue(objectMapper.treeAsTokens(mainNode), Temperature.class));
+        weatherForecast.setAtmosphericPressure(objectMapper.readValue(objectMapper.treeAsTokens(mainNode), AtmosphericPressure.class));
+        weatherForecast.setHumidity(objectMapper.readValue(objectMapper.treeAsTokens(mainNode), Humidity.class));
+        weatherForecast.setClouds(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("clouds")), Clouds.class));
+        weatherForecast.setWind(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("wind")), Wind.class));
+        if (rootNode.has("rain")) {
+            weatherForecast.setRain(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("rain")), Rain.class));
+        }
+        if (rootNode.has("snow")) {
+            weatherForecast.setSnow(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("snow")), Snow.class));
+        }
+
+        final JsonNode sysNode = rootNode.get("sys");
+        if (sysNode != null) {
+            weatherForecast.setDayTime("d".equals(sysNode.get("pod").asText()) ? DayTime.DAY : DayTime.NIGHT);
+        }
+
+        if (rootNode.has("visibility")) {
+            weatherForecast.setAverageVisibilityInMetres(rootNode.get("visibility").asInt());
+        }
+
+        if (rootNode.has("pop")) {
+            weatherForecast.setProbabilityOfPrecipitation(rootNode.get("pop").asDouble());
+        }
+
+        weatherForecast.setForecastTime(parseDateTime(rootNode.get("dt")));
+        weatherForecast.setForecastTimeISO(rootNode.get("dt_txt").asText());
+
+        return weatherForecast;
+    }
+}

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

@@ -0,0 +1,334 @@
+/*
+ * Copyright (c) 2022 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.mapper;
+
+import com.fasterxml.jackson.databind.InjectableValues;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.*;
+import com.github.prominence.openweathermap.api.deserializer.onecall.*;
+import com.github.prominence.openweathermap.api.enums.UnitSystem;
+import com.github.prominence.openweathermap.api.model.*;
+import com.github.prominence.openweathermap.api.model.onecall.AtmosphericPressure;
+import com.github.prominence.openweathermap.api.model.onecall.Temperature;
+import com.github.prominence.openweathermap.api.model.onecall.*;
+import com.github.prominence.openweathermap.api.model.onecall.current.*;
+import com.github.prominence.openweathermap.api.model.onecall.historical.HistoricalWeather;
+import com.github.prominence.openweathermap.api.model.onecall.historical.HistoricalWeatherData;
+import com.github.prominence.openweathermap.api.model.onecall.historical.HourlyHistorical;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * Official API response documentation:
+ * <ul>
+ *  <li></li><a href="https://openweathermap.org/api/one-call-api#parameter">https://openweathermap.org/api/one-call-api#parameter</a></li>
+ *  <li></li><a href="https://openweathermap.org/api/one-call-api#hist_parameter">https://openweathermap.org/api/one-call-api#hist_parameter</a></li>
+ * </ul>
+ */
+public class OneCallWeatherResponseMapper extends AbstractMapper {
+    /**
+     * Instantiates a new forecast response mapper.
+     *
+     * @param unitSystem the unit system
+     */
+    public OneCallWeatherResponseMapper(UnitSystem unitSystem) {
+        objectMapper.setInjectableValues(new InjectableValues.Std().addValue("unitSystem", unitSystem != null ? unitSystem : UnitSystem.STANDARD));
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(Coordinates.class, new CoordinatesDeserializer());
+        module.addDeserializer(AtmosphericPressure.class, new OneCallAtmosphericPressureDeserializer());
+        module.addDeserializer(Temperature.class, new OneCallTemperatureDeserializer());
+        module.addDeserializer(WeatherState.class, new WeatherStateDeserializer());
+        module.addDeserializer(Humidity.class, new HumidityDeserializer());
+        module.addDeserializer(Wind.class, new WindDeserializer());
+        module.addDeserializer(Clouds.class, new CloudsDeserializer());
+        module.addDeserializer(Rain.class, new OneCallRainDeserializer());
+        module.addDeserializer(Snow.class, new OneCallSnowDeserializer());
+        module.addDeserializer(DailyTemperature.class, new OneCallDailyTemperatureDeserializer());
+        module.addDeserializer(DailyRain.class, new OneCallDailyRainDeserializer());
+        module.addDeserializer(DailySnow.class, new OneCallDailySnowDeserializer());
+        module.addDeserializer(Alert.class, new AlertDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    /**
+     * Maps current weather data response into java object.
+     *
+     * @param json the json string
+     * @return the current data object
+     */
+    public CurrentWeatherData mapToCurrent(String json) {
+        CurrentWeatherData currentData;
+        try {
+            final JsonNode root = objectMapper.readTree(json);
+            currentData = mapToCurrent(root);
+        } catch (IOException e) {
+            throw new RuntimeException("Cannot parse OneCall response", e);
+        }
+
+        return currentData;
+    }
+
+    /**
+     * Maps current weather data response into java object.
+     *
+     * @param json the json string
+     * @return the current data object
+     */
+    public HistoricalWeatherData mapToHistorical(String json) {
+        HistoricalWeatherData historicalData;
+        try {
+            final JsonNode root = objectMapper.readTree(json);
+            historicalData = mapToHistorical(root);
+        } catch (IOException e) {
+            throw new RuntimeException("Cannot parse OneCall response");
+        }
+
+        return historicalData;
+    }
+
+    private CurrentWeatherData mapToCurrent(JsonNode rootNode) throws IOException {
+        final CurrentWeatherData currentData = new CurrentWeatherData();
+        currentData.setCoordinates(objectMapper.readValue(objectMapper.treeAsTokens(rootNode), Coordinates.class));
+        currentData.setTimezone(parseZoneId(rootNode.get("timezone")));
+        currentData.setTimezoneOffset(parseZoneOffset(rootNode.get("timezone_offset")));
+
+        currentData.setCurrent(parseCurrent(rootNode.get("current")));
+        currentData.setMinutelyList(parseMinutelyList(rootNode.get("minutely")));
+        currentData.setHourlyList(parseHourlyList(rootNode.get("hourly")));
+        currentData.setDailyList(parseDailyList(rootNode.get("daily")));
+        currentData.setAlerts(parseAlerts(rootNode.get("alerts")));
+
+        return currentData;
+    }
+
+    private Current parseCurrent(JsonNode currentNode) throws IOException {
+        if (currentNode == null) {
+            return null;
+        }
+        final Current current = new Current();
+        current.setForecastTime(parseDateTime(currentNode.get("dt")));
+        current.setSunriseTime(parseDateTime(currentNode.get("sunrise")));
+        current.setSunsetTime(parseDateTime(currentNode.get("sunset")));
+
+        current.setWeatherStates(parseWeatherStates(currentNode.get("weather")));
+
+        current.setTemperature(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), Temperature.class));
+        current.setAtmosphericPressure(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), AtmosphericPressure.class));
+        current.setHumidity(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), Humidity.class));
+        current.setClouds(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), Clouds.class));
+
+        current.setUvIndex(currentNode.get("uvi").asDouble());
+        final JsonNode visibilityNode = currentNode.get("visibility");
+        if (visibilityNode != null) {
+            current.setVisibilityInMetres(visibilityNode.asDouble());
+        }
+
+        current.setWind(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), Wind.class));
+        current.setRain(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), Rain.class));
+        current.setSnow(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), Snow.class));
+
+        return current;
+    }
+
+    private List<Minutely> parseMinutelyList(JsonNode minutelyListNode) {
+        if (minutelyListNode == null) {
+            return null;
+        }
+        final List<Minutely> minutelyList = new ArrayList<>();
+        for (final JsonNode minutelyNode : minutelyListNode) {
+            minutelyList.add(Minutely.withValue(
+                    parseDateTime(minutelyNode.get("dt")),
+                    minutelyNode.get("precipitation").asDouble()
+            ));
+        }
+
+        return minutelyList;
+    }
+
+    private List<Hourly> parseHourlyList(JsonNode hourlyListNode) throws IOException {
+        if (hourlyListNode == null) {
+            return null;
+        }
+        final List<Hourly> hourlyList = new ArrayList<>();
+        for (final JsonNode hourlyNode : hourlyListNode) {
+            final Hourly hourly = new Hourly();
+            hourly.setForecastTime(parseDateTime(hourlyNode.get("dt")));
+
+            hourly.setWeatherStates(parseWeatherStates(hourlyNode.get("weather")));
+
+            hourly.setTemperature(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), Temperature.class));
+            hourly.setAtmosphericPressure(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), AtmosphericPressure.class));
+            hourly.setHumidity(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), Humidity.class));
+            hourly.setClouds(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), Clouds.class));
+
+            final JsonNode uviNode = hourlyNode.get("uvi");
+            if (uviNode != null) {
+                hourly.setUvIndex(uviNode.asDouble());
+            }
+
+            final JsonNode visibilityNode = hourlyNode.get("visibility");
+            if (visibilityNode != null) {
+                hourly.setVisibilityInMetres(visibilityNode.asDouble());
+            }
+            hourly.setWind(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), Wind.class));
+            final JsonNode popNode = hourlyNode.get("pop");
+            if (popNode != null) {
+                hourly.setProbabilityOfPrecipitation(popNode.asDouble());
+            }
+            hourly.setRain(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), Rain.class));
+            hourly.setSnow(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), Snow.class));
+
+            hourlyList.add(hourly);
+        }
+
+        return hourlyList;
+    }
+
+    private List<Daily> parseDailyList(JsonNode dailyListNode) throws IOException {
+        if (dailyListNode == null) {
+            return null;
+        }
+        final List<Daily> dailyList = new ArrayList<>();
+        for (final JsonNode dailyNode : dailyListNode) {
+            final Daily daily = new Daily();
+            daily.setForecastTime(parseDateTime(dailyNode.get("dt")));
+            daily.setSunriseTime(parseDateTime(dailyNode.get("sunrise")));
+            daily.setSunsetTime(parseDateTime(dailyNode.get("sunset")));
+            final JsonNode moonriseTimeNode = dailyNode.get("moonrise");
+            if (moonriseTimeNode != null) {
+                daily.setMoonriseTime(parseDateTime(moonriseTimeNode));
+            }
+            final JsonNode moonsetTimeNode = dailyNode.get("moonset");
+            if (moonsetTimeNode != null) {
+                daily.setMoonsetTime(parseDateTime(moonsetTimeNode));
+            }
+            final JsonNode moonPhaseNode = dailyNode.get("moon_phase");
+            if (moonPhaseNode != null) {
+                daily.setMoonPhase(new MoonPhase(moonPhaseNode.asDouble()));
+            }
+
+            daily.setWeatherStates(parseWeatherStates(dailyNode.get("weather")));
+
+            daily.setTemperature(objectMapper.readValue(objectMapper.treeAsTokens(dailyNode), DailyTemperature.class));
+            daily.setAtmosphericPressure(objectMapper.readValue(objectMapper.treeAsTokens(dailyNode), AtmosphericPressure.class));
+            daily.setHumidity(objectMapper.readValue(objectMapper.treeAsTokens(dailyNode), Humidity.class));
+            daily.setWind(objectMapper.readValue(objectMapper.treeAsTokens(dailyNode), Wind.class));
+            daily.setClouds(objectMapper.readValue(objectMapper.treeAsTokens(dailyNode), Clouds.class));
+            daily.setUvIndex(dailyNode.get("uvi").asDouble());
+            daily.setProbabilityOfPrecipitation(dailyNode.get("pop").asDouble());
+            daily.setRain(objectMapper.readValue(objectMapper.treeAsTokens(dailyNode), DailyRain.class));
+            daily.setSnow(objectMapper.readValue(objectMapper.treeAsTokens(dailyNode), DailySnow.class));
+
+            dailyList.add(daily);
+        }
+
+        return dailyList;
+    }
+
+    private List<Alert> parseAlerts(JsonNode alertsNode) throws IOException {
+        if (alertsNode == null || !alertsNode.isArray()) {
+            return null;
+        }
+        final List<Alert> alerts = new ArrayList<>();
+        for (final JsonNode alertNode : alertsNode) {
+            alerts.add(objectMapper.readValue(objectMapper.treeAsTokens(alertNode), Alert.class));
+        }
+        return alerts;
+    }
+
+    private HistoricalWeatherData mapToHistorical(JsonNode rootNode) throws IOException {
+        final HistoricalWeatherData historicalData = new HistoricalWeatherData();
+        historicalData.setCoordinates(Coordinates.of(rootNode.get("lat").asDouble(), rootNode.get("lon").asDouble()));
+        historicalData.setTimezone(parseZoneId(rootNode.get("timezone")));
+        historicalData.setTimezoneOffset(parseZoneOffset(rootNode.get("timezone_offset")));
+        historicalData.setHistoricalWeather(parseHistoricalWeather(rootNode.get("current")));
+        historicalData.setHourlyList(parseHourlyHistoricalList(rootNode.get("hourly")));
+
+        return historicalData;
+    }
+
+    private HistoricalWeather parseHistoricalWeather(JsonNode currentNode) throws IOException {
+        if (currentNode == null) {
+            return null;
+        }
+        final HistoricalWeather historicalWeather = new HistoricalWeather();
+        historicalWeather.setForecastTime(parseDateTime(currentNode.get("dt")));
+        historicalWeather.setSunriseTime(parseDateTime(currentNode.get("sunrise")));
+        historicalWeather.setSunsetTime(parseDateTime(currentNode.get("sunset")));
+
+        historicalWeather.setWeatherStates(parseWeatherStates(currentNode.get("weather")));
+
+        historicalWeather.setTemperature(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), Temperature.class));
+        historicalWeather.setAtmosphericPressure(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), AtmosphericPressure.class));
+        historicalWeather.setHumidity(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), Humidity.class));
+        historicalWeather.setClouds(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), Clouds.class));
+
+        final JsonNode uviNode = currentNode.get("uvi");
+        if (uviNode != null) {
+            historicalWeather.setUvIndex(uviNode.asDouble());
+        }
+
+        final JsonNode visibilityNode = currentNode.get("visibility");
+        if (visibilityNode != null) {
+            historicalWeather.setVisibilityInMetres(visibilityNode.asDouble());
+        }
+        historicalWeather.setWind(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), Wind.class));
+        historicalWeather.setRain(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), Rain.class));
+        historicalWeather.setSnow(objectMapper.readValue(objectMapper.treeAsTokens(currentNode), Snow.class));
+
+        return historicalWeather;
+    }
+
+    private List<HourlyHistorical> parseHourlyHistoricalList(JsonNode hourlyListNode) throws IOException {
+        if (hourlyListNode == null) {
+            return null;
+        }
+        final List<HourlyHistorical> hourlyList = new ArrayList<>();
+        for (final JsonNode hourlyNode : hourlyListNode) {
+            final HourlyHistorical hourly = new HourlyHistorical();
+            hourly.setForecastTime(parseDateTime(hourlyNode.get("dt")));
+
+            hourly.setWeatherStates(parseWeatherStates(hourlyNode.get("weather")));
+
+            hourly.setTemperature(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), Temperature.class));
+            hourly.setAtmosphericPressure(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), AtmosphericPressure.class));
+            hourly.setHumidity(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), Humidity.class));
+            hourly.setClouds(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), Clouds.class));
+
+            final JsonNode visibilityNode = hourlyNode.get("visibility");
+            if (visibilityNode != null) {
+                hourly.setVisibilityInMetres(visibilityNode.asDouble());
+            }
+            hourly.setWind(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), Wind.class));
+            hourly.setRain(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), Rain.class));
+            hourly.setSnow(objectMapper.readValue(objectMapper.treeAsTokens(hourlyNode), Snow.class));
+
+            hourlyList.add(hourly);
+        }
+
+        return hourlyList;
+    }
+}

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

@@ -0,0 +1,72 @@
+package com.github.prominence.openweathermap.api.mapper;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.roadrisk.RoadRiskAlertDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.roadrisk.RoadRiskRoadDetailsDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.roadrisk.RoadRiskWeatherDeserializer;
+import com.github.prominence.openweathermap.api.model.Coordinates;
+import com.github.prominence.openweathermap.api.model.roadrisk.Alert;
+import com.github.prominence.openweathermap.api.model.roadrisk.RoadDetails;
+import com.github.prominence.openweathermap.api.model.roadrisk.RoadRiskRecord;
+import com.github.prominence.openweathermap.api.model.roadrisk.Weather;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+public class RoadRiskResponseMapper extends AbstractMapper {
+
+    public RoadRiskResponseMapper() {
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(Weather.class, new RoadRiskWeatherDeserializer());
+        module.addDeserializer(RoadDetails.class, new RoadRiskRoadDetailsDeserializer());
+        module.addDeserializer(Alert.class, new RoadRiskAlertDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    public List<RoadRiskRecord> mapToObjects(String jsonResponse) {
+        List<RoadRiskRecord> roadRiskRecords;
+        try {
+            final JsonNode root = objectMapper.readTree(jsonResponse);
+            roadRiskRecords = mapToObjects(root);
+        } catch (IOException e) {
+            throw new RuntimeException("Cannot parse SolarRadiation response", e);
+        }
+
+        return roadRiskRecords;
+    }
+
+    private List<RoadRiskRecord> mapToObjects(JsonNode rootNode) throws IOException {
+        List<RoadRiskRecord> roadRiskRecords = new ArrayList<>();
+
+        if (rootNode.isArray()) {
+            for (JsonNode recordNode : rootNode) {
+                RoadRiskRecord roadRiskRecord = new RoadRiskRecord();
+                roadRiskRecord.setForecastTime(parseDateTime(recordNode.get("dt")));
+
+                final JsonNode coordNode = recordNode.get("coord");
+                roadRiskRecord.setCoordinates(Coordinates.of(coordNode.get(0).asDouble(), coordNode.get(1).asDouble()));
+
+                roadRiskRecord.setWeather(objectMapper.readValue(objectMapper.treeAsTokens(recordNode.get("weather")), Weather.class));
+                if (recordNode.has("road")) {
+                    roadRiskRecord.setRoadDetails(objectMapper.readValue(objectMapper.treeAsTokens(recordNode.get("road")), RoadDetails.class));
+                }
+
+                final JsonNode alertsNode = recordNode.get("alerts");
+                if (alertsNode != null && alertsNode.isArray()) {
+                    List<Alert> alerts = new ArrayList<>();
+                    for (JsonNode alertNode : alertsNode) {
+                        alerts.add(objectMapper.readValue(objectMapper.treeAsTokens(alertNode), Alert.class));
+                    }
+
+                    roadRiskRecord.setAlerts(alerts);
+                }
+
+                roadRiskRecords.add(roadRiskRecord);
+            }
+        }
+
+        return roadRiskRecords;
+    }
+}

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

@@ -0,0 +1,49 @@
+package com.github.prominence.openweathermap.api.mapper;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.github.prominence.openweathermap.api.deserializer.CoordinatesDeserializer;
+import com.github.prominence.openweathermap.api.deserializer.radiation.SolarRadiationRecordDeserializer;
+import com.github.prominence.openweathermap.api.model.Coordinates;
+import com.github.prominence.openweathermap.api.model.radiation.SolarRadiation;
+import com.github.prominence.openweathermap.api.model.radiation.SolarRadiationRecord;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+public class SolarRadiationResponseMapper extends AbstractMapper {
+
+    public SolarRadiationResponseMapper() {
+        final SimpleModule module = new SimpleModule();
+        module.addDeserializer(SolarRadiationRecord.class, new SolarRadiationRecordDeserializer());
+        module.addDeserializer(Coordinates.class, new CoordinatesDeserializer());
+        objectMapper.registerModule(module);
+    }
+
+    public SolarRadiation mapToObject(String jsonResponse) {
+        SolarRadiation solarRadiation;
+        try {
+            final JsonNode root = objectMapper.readTree(jsonResponse);
+            solarRadiation = mapToObject(root);
+        } catch (IOException e) {
+            throw new RuntimeException("Cannot parse SolarRadiation response", e);
+        }
+
+        return solarRadiation;
+    }
+
+    private SolarRadiation mapToObject(JsonNode rootNode) throws IOException {
+        final SolarRadiation solarRadiation = new SolarRadiation();
+        solarRadiation.setCoordinates(objectMapper.readValue(objectMapper.treeAsTokens(rootNode.get("coord")), Coordinates.class));
+
+        final JsonNode listRecordsNode = rootNode.get("list");
+        List<SolarRadiationRecord> radiationRecords = new ArrayList<>();
+        for (JsonNode recordNode : listRecordsNode) {
+            radiationRecords.add(objectMapper.readValue(objectMapper.treeAsTokens(recordNode), SolarRadiationRecord.class));
+        }
+        solarRadiation.setSolarRadiationRecords(radiationRecords);
+
+        return solarRadiation;
+    }
+}

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

@@ -0,0 +1,156 @@
+/*
+ * 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.model;
+
+import java.util.Objects;
+
+/**
+ * The AtmosphericPressure type represents atmospheric pressure value.
+ * Its value can only be a double in [0, +∞) range.
+ */
+public class AtmosphericPressure {
+    private static final String DEFAULT_UNIT = "hPa";
+
+    private double value;
+
+    private Double seaLevelValue;
+    private Double groundLevelValue;
+
+    /**
+     * Instantiates a new Pressure.
+     *
+     * @param value the value representing pressure value.
+     * @throws IllegalArgumentException in case if provided value isn't in allowed range.
+     */
+    private AtmosphericPressure(double value) {
+        this.value = value;
+    }
+
+    /**
+     * Static method for {@link AtmosphericPressure} creation with value checking.
+     *
+     * @param value atmospheric pressure value.
+     * @return instantiated {@link AtmosphericPressure} object.
+     */
+    public static AtmosphericPressure withValue(double value) {
+        if (value < 0) {
+            throw new IllegalArgumentException("Atmospheric pressure value must be in [0, +∞) range.");
+        }
+        return new AtmosphericPressure(value);
+    }
+
+    /**
+     * Returns pressure value.
+     *
+     * @return pressure value.
+     */
+    public double getValue() {
+        return value;
+    }
+
+    /**
+     * Sets pressure value.
+     *
+     * @param value new pressure value.
+     * @throws IllegalArgumentException in case if provided value isn't in allowed range.
+     */
+    public void setValue(double value) {
+        if (value < 0) {
+            throw new IllegalArgumentException("Atmospheric pressure value must be in [0, +∞) range.");
+        }
+        this.value = value;
+    }
+
+    /**
+     * Gets sea level value.
+     *
+     * @return the sea level value.
+     */
+    public Double getSeaLevelValue() {
+        return seaLevelValue;
+    }
+
+    /**
+     * Sets sea level value.
+     *
+     * @param seaLevelValue the sea level value.
+     * @throws IllegalArgumentException in case if provided value isn't in allowed range.
+     */
+    public void setSeaLevelValue(double seaLevelValue) {
+        if (seaLevelValue < 0) {
+            throw new IllegalArgumentException("Atmospheric pressure value must be in [0, +∞) range.");
+        }
+        this.seaLevelValue = seaLevelValue;
+    }
+
+    /**
+     * Gets ground level value.
+     *
+     * @return the ground level value.
+     */
+    public Double getGroundLevelValue() {
+        return groundLevelValue;
+    }
+
+    /**
+     * Sets ground level value.
+     *
+     * @param groundLevelValue the ground level value.
+     * @throws IllegalArgumentException in case if provided value isn't in allowed range.
+     */
+    public void setGroundLevelValue(double groundLevelValue) {
+        if (groundLevelValue < 0) {
+            throw new IllegalArgumentException("Atmospheric pressure value must be in [0, +∞) range.");
+        }
+        this.groundLevelValue = groundLevelValue;
+    }
+
+    /**
+     * Returns pressure unitSystem. Constantly equals to 'hPa'.
+     *
+     * @return the pressure unitSystem.
+     */
+    public String getUnit() {
+        return DEFAULT_UNIT;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (!(o instanceof AtmosphericPressure)) return false;
+        AtmosphericPressure atmosphericPressure = (AtmosphericPressure) o;
+        return Double.compare(atmosphericPressure.value, value) == 0 &&
+                Objects.equals(seaLevelValue, atmosphericPressure.seaLevelValue) &&
+                Objects.equals(groundLevelValue, atmosphericPressure.groundLevelValue);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(value, seaLevelValue, groundLevelValue);
+    }
+
+    @Override
+    public String toString() {
+        return "Pressure: " + value + ' ' + getUnit();
+    }
+}