Prominence/openweathermap-java-api
1
0
Fork 0
mirror of https://github.com/Prominence/openweathermap-java-api.git synced 2026-01-09 19:46:41 +03:00
Code Issues Projects Releases Wiki Activity

Changed subscription plan for oneCall3 requester, deprecated oneCall.

Browse Source
This commit is contained in:
Prominence 2024-11-14 11:28:34 +03:00
parent ac1f043f51
commit 1002bc79de
No known key found for this signature in database
GPG Key ID: B5C2DFCB54798A7B
2 changed files with 14 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
src/main/java/com/github/prominence/openweathermap/api/OpenWeatherMapClient.java
View File

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

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

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