2.1.0 version implementation.

Author: Prominence

README.md

@@ -5,11 +5,11 @@ Java API for OpenWeatherMap services.
 Free: 
 * Current weather data
 * 5 day / 3-hour forecast
+* One Call API
 
 ### Will be implemented later:
 
 Free:
-* One Call API
 * Air pollution
 * Geocoding API
 * Weather Stations
@@ -26,14 +26,14 @@ Paid:
 <dependency>
   <groupId>com.github.prominence</groupId>
   <artifactId>openweathermap-api</artifactId>
-  <version>2.0.1</version>
+  <version>2.1.0</version>
 </dependency>
 ```
 
 ### Gradle coordinates:
 
 ```groovy
-compile('com.github.prominence:openweathermap-api:2.0.1')
+compile('com.github.prominence:openweathermap-api:2.1.0')
 ```
 
 ### Documentation
@@ -42,6 +42,7 @@ compile('com.github.prominence:openweathermap-api:2.0.1')
 * [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 - SNAPSHOT](docs/SNAPSHOT.md)
 
 ### License

docs/Release_2.0.0.md

@@ -79,7 +79,7 @@ final Weather weather = openWeatherClient
 final List<Weather> weatherList = openWeatherClient
         .currentWeather()
         .multiple()
-        .byCitiesInCycle(Coordinate.withValues(55.5, 37.5))
+        .byCitiesInCycle(Coordinate.of(55.5, 37.5))
         .language(Language.GERMAN)
         .unitSystem(UnitSystem.IMPERIAL)
         .retrieve()

docs/Release_2.0.1.md

@@ -79,7 +79,7 @@ final Weather weather = openWeatherClient
 final List<Weather> weatherList = openWeatherClient
         .currentWeather()
         .multiple()
-        .byCitiesInCycle(Coordinate.withValues(55.5, 37.5))
+        .byCitiesInCycle(Coordinate.of(55.5, 37.5))
         .language(Language.GERMAN)
         .unitSystem(UnitSystem.IMPERIAL)
         .retrieve()

docs/Release_2.1.0.md

@@ -6,7 +6,7 @@
 
     <groupId>com.github.prominence</groupId>
     <artifactId>openweathermap-api</artifactId>
-    <version>2.0.1</version>
+    <version>2.1.0</version>
     <packaging>jar</packaging>
 
     <name>Java OpenWeatherMap API</name>
@@ -27,7 +27,7 @@
     <licenses>
         <license>
             <name>MIT License</name>
-            <url>http://www.opensource.org/licenses/mit-license.php</url>
+            <url>https://www.opensource.org/licenses/mit-license.php</url>
             <distribution>repo</distribution>
         </license>
     </licenses>
@@ -150,6 +150,12 @@
                     </execution>
                 </executions>
             </plugin>
+
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-surefire-plugin</artifactId>
+                <version>2.22.2</version>
+            </plugin>
         </plugins>
     </build>
 
@@ -167,10 +173,15 @@
         </dependency>
 
         <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-            <version>4.13.1</version>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <version>5.7.1</version>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>org.junit.platform</groupId>
+            <artifactId>junit-platform-runner</artifactId>
+            <version>1.7.1</version>
+        </dependency>
     </dependencies>
 </project>

docs/SNAPSHOT.md

@@ -25,6 +25,8 @@
 import com.github.prominence.openweathermap.api.annotation.SubscriptionAvailability;
 import com.github.prominence.openweathermap.api.request.forecast.free.FiveDayThreeHourStepForecastRequester;
 import com.github.prominence.openweathermap.api.request.forecast.free.FiveDayThreeHourStepForecastRequesterImpl;
+import com.github.prominence.openweathermap.api.request.onecall.OneCallWeatherRequester;
+import com.github.prominence.openweathermap.api.request.onecall.OneCallWeatherRequesterImpl;
 import com.github.prominence.openweathermap.api.request.weather.CurrentWeatherRequester;
 import com.github.prominence.openweathermap.api.request.weather.CurrentWeatherRequesterImpl;
 
@@ -39,7 +41,7 @@ public class OpenWeatherMapClient {
 
     /**
      * Created OpenWeatherMap client object.
-     * @param apiKey API key obtained on <a href="https://home.openweathermap.org/api_keys">OpwnWeatherMap site</a>.
+     * @param apiKey API key obtained on <a href="https://home.openweathermap.org/api_keys">OpenWeatherMap site</a>.
      */
     public OpenWeatherMapClient(String apiKey) {
         this.apiKey = apiKey;
@@ -62,4 +64,14 @@ public CurrentWeatherRequester currentWeather() {
     public FiveDayThreeHourStepForecastRequester forecast5Day3HourStep() {
         return new FiveDayThreeHourStepForecastRequesterImpl(apiKey);
     }
+
+    /**
+     * 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 OneCallWeatherRequesterImpl(apiKey);
+    }
 }

pom.xml

@@ -27,11 +27,26 @@
  * 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.
      */
@@ -47,6 +62,11 @@ public enum Language {
      */
     CZECH("cz"),
 
+    /**
+     * Danish language
+     */
+    DANISH("da"),
+
     /**
      * German language.
      */
@@ -62,6 +82,11 @@ public enum Language {
      */
     ENGLISH("en"),
 
+    /**
+     * Basque language.
+     */
+    BASQUE("eu"),
+
     /**
      * Persian language.
      */
@@ -82,6 +107,16 @@ public enum Language {
      */
     GALICIAN("gl"),
 
+    /**
+     * Hebrew language.
+     */
+    HEBREW("he"),
+
+    /**
+     * Hindi language.
+     */
+    HINDI("hi"),
+
     /**
      * Croatian language.
      */
@@ -92,6 +127,11 @@ public enum Language {
      */
     HUNGARIAN("hu"),
 
+    /**
+     * Indonesian language.
+     */
+    INDONESIAN("id"),
+
     /**
      * Italian language.
      */
@@ -122,6 +162,11 @@ public enum Language {
      */
     MACEDONIAN("mk"),
 
+    /**
+     * Norwegian language.
+     */
+    NORWEGIAN("no"),
+
     /**
      * Dutch language.
      */
@@ -137,6 +182,11 @@ public enum Language {
      */
     PORTUGUESE("pt"),
 
+    /**
+     * Português Brasil language.
+     */
+    PORTUGUES_BRAZIL("pt_br"),
+
     /**
      * Romanian language.
      */
@@ -165,7 +215,17 @@ public enum Language {
     /**
      * Spanish language.
      */
-    SPANISH("en"),
+    SPANISH("es"),
+
+    /**
+     * Serbian language.
+     */
+    SERBIAN("sr"),
+
+    /**
+     * Thai language.
+     */
+    THAI("th"),
 
     /**
      * Turkish language.
@@ -190,7 +250,12 @@ public enum Language {
     /**
      * Chinese traditional language.
      */
-    CHINESE_TRADITIONAL("zh_tw");
+    CHINESE_TRADITIONAL("zh_tw"),
+
+    /**
+     * Zulu language.
+     */
+    ZULU("zu");
 
     private final String value;
 

src/main/java/com/github/prominence/openweathermap/api/OpenWeatherMapClient.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;
+    }
+}