feat(docs): added common methods to supported apis page

Author: andrepimpao

docs/03-supported-apis.md

@@ -1,24 +1,31 @@
 # Supported APIs
 
-- [One Call](#one-call)
-  - [getWeather](#getweatherfloat-latitude-float-longitude)
-  - [getHistoryMoment](#gethistorymomentfloat-latitude-float-longitude-datetimeinterface-datetime)
-  - [getHistoryAggregate](#gethistoryaggregatefloat-latitude-float-longitude-datetimeinterface-date)
-- [Weather](#weather)
-  - [getCurrent](#getcurrentfloat-latitude-float-longitude)
-  - [getForecast](#getforecastfloat-latitude-float-longitude-int-numresults--40)
-- [Air Pollution](#air-pollution)
-  - [getCurrent](#getcurrentfloat-latitude-float-longitude-1)
-  - [getForecast](#getforecastfloat-latitude-float-longitude)
-  - [getHistory](#gethistoryfloat-latitude-float-longitude-datetimeinterface-startdate-datetimeinterface-enddate)
-- [Geocoding](#geocoding)
-  - [getByLocationName](#getbylocationnamestring-locationname-int-numresults--5)
-  - [getByZipCode](#getbyzipcodestring-zipcode-string-countrycode)
-  - [getByCoordinate](#getbycoordinatefloat-latitude-float-longitude-int-numresults--5)
-
-## One Call
-
-### `getWeather(float $latitude, float $longitude)`
+- [APIs](#apis)
+  - [One Call](#one-call)
+    - [getWeather](#getweatherfloat-latitude-float-longitude)
+    - [getHistoryMoment](#gethistorymomentfloat-latitude-float-longitude-datetimeinterface-datetime)
+    - [getHistoryAggregate](#gethistoryaggregatefloat-latitude-float-longitude-datetimeinterface-date)
+  - [Weather](#weather)
+    - [getCurrent](#getcurrentfloat-latitude-float-longitude)
+    - [getForecast](#getforecastfloat-latitude-float-longitude-int-numresults--40)
+  - [Air Pollution](#air-pollution)
+    - [getCurrent](#getcurrentfloat-latitude-float-longitude-1)
+    - [getForecast](#getforecastfloat-latitude-float-longitude)
+    - [getHistory](#gethistoryfloat-latitude-float-longitude-datetimeinterface-startdate-datetimeinterface-enddate)
+  - [Geocoding](#geocoding)
+    - [getByLocationName](#getbylocationnamestring-locationname-int-numresults--5)
+    - [getByZipCode](#getbyzipcodestring-zipcode-string-countrycode)
+    - [getByCoordinate](#getbycoordinatefloat-latitude-float-longitude-int-numresults--5)
+- [Common Methods](#common-methods)
+  - [withUnitSystem](#withunitsystemstring-unitsystem)
+  - [withLanguage](#withlanguagestring-language)
+  - [withCacheTtl](#withcachettlint-time)
+
+## APIs
+
+### One Call
+
+#### `getWeather(float $latitude, float $longitude)`
 
 Get current and forecast (minutely, hourly and daily) weather data.
 
@@ -30,7 +37,7 @@ $weather = $openWeatherMap->getOneCall()->getWeather(50, 50);
 echo $weather->getCurrent()->getTemperature();
 ```
 
-### `getHistoryMoment(float $latitude, float $longitude, \DateTimeInterface $dateTime)`
+#### `getHistoryMoment(float $latitude, float $longitude, \DateTimeInterface $dateTime)`
 
 Get weather data from a single moment in the past.
 
@@ -42,7 +49,7 @@ $weather = $openWeatherMap->getOneCall()->getHistoryMoment(50, 50, new \DateTime
 echo $weather->getTemperature();
 ```
 
-### `getHistoryAggregate(float $latitude, float $longitude, \DateTimeInterface $date)`
+#### `getHistoryAggregate(float $latitude, float $longitude, \DateTimeInterface $date)`
 
 Get aggregated weather data from a single day in the past.
 
@@ -54,9 +61,9 @@ $weather = $openWeatherMap->getOneCall()->getHistoryAggregate(50, 50, new \DateT
 echo $weather->getTemperature();
 ```
 
-## Weather
+### Weather
 
-### `getCurrent(float $latitude, float $longitude)`
+#### `getCurrent(float $latitude, float $longitude)`
 
 Get current weather data.
 
@@ -68,7 +75,7 @@ $weather = $openWeatherMap->getWeather()->getCurrent(50, 50);
 echo $weather->getTemperature();
 ```
 
-### `getForecast(float $latitude, float $longitude, int $numResults = 40)`
+#### `getForecast(float $latitude, float $longitude, int $numResults = 40)`
 
 Get weather forecast data per 3-hour steps for the next 5 days.
 
@@ -85,9 +92,9 @@ foreach ($weatherForecast->getList() as $weather) {
 }
 ```
 
-## Air Pollution
+### Air Pollution
 
-### `getCurrent(float $latitude, float $longitude)`
+#### `getCurrent(float $latitude, float $longitude)`
 
 Get current air pollution data.
 
@@ -100,7 +107,7 @@ echo $airPollution->getAirQuality()->getQualitativeName();
 echo $airPollution->getCarbonMonoxide();
 ```
 
-### `getForecast(float $latitude, float $longitude)`
+#### `getForecast(float $latitude, float $longitude)`
 
 Get air pollution forecast data per 1-hour for the next 24 hours.
 
@@ -116,7 +123,7 @@ foreach ($airPollutionForecast->getList() as $airPollution) {
 }
 ```
 
-### `getHistory(float $latitude, float $longitude, \DateTimeInterface $startDate, \DateTimeInterface $endDate)`
+#### `getHistory(float $latitude, float $longitude, \DateTimeInterface $startDate, \DateTimeInterface $endDate)`
 
 Get air pollution history data between two dates.
 
@@ -134,9 +141,9 @@ foreach ($airPollutionHistory->getList() as $airPollution) {
 }
 ```
 
-## Geocoding
+### Geocoding
 
-### `getByLocationName(string $locationName, int $numResults = 5)`
+#### `getByLocationName(string $locationName, int $numResults = 5)`
 
 Get locations data by location name.
 
@@ -151,7 +158,7 @@ foreach ($locations as $location) {
 }
 ```
 
-### `getByZipCode(string $zipCode, string $countryCode)`
+#### `getByZipCode(string $zipCode, string $countryCode)`
 
 Get location data by zip/post code.
 
@@ -163,7 +170,7 @@ $location = $openWeatherMap->getGeocoding()->getByZipCode('1000-001', 'pt');
 echo $location->getName();
 ```
 
-### `getByCoordinate(float $latitude, float $longitude, int $numResults = 5)`
+#### `getByCoordinate(float $latitude, float $longitude, int $numResults = 5)`
 
 Get locations data by coordinate.
 
@@ -177,3 +184,51 @@ foreach ($locations as $location) {
     echo $location->getCountryCode();
 }
 ```
+
+## Common Methods
+
+#### `withUnitSystem(string $unitSystem)`
+
+Makes a request with a different unit system from the one globally defined in the [configuration](02-configuration.md#unitsystem).
+
+Only available for [`OneCall`](#one-call) and [`Weather`](#weather) APIs.
+
+```php
+use ProgrammatorDev\OpenWeatherMap\UnitSystem\UnitSystem;
+
+// Uses 'imperial' unit system for this request alone
+$openWeatherMap->getWeather()
+    ->withUnitSystem(UnitSystem::IMPERIAL)
+    ->getCurrent(50, 50);
+```
+
+#### `withLanguage(string $language)`
+
+Makes a request with a different language from the one globally defined in the [configuration](02-configuration.md#language).
+
+Only available for [`OneCall`](#one-call) and [`Weather`](#weather) APIs.
+
+```php
+use ProgrammatorDev\OpenWeatherMap\Language\Language
+
+// Uses 'pt' language for this request alone
+$openWeatherMap->getWeather()
+    ->withLanguage(Language::PORTUGUESE)
+    ->getCurrent(50, 50);
+```
+
+#### `withCacheTtl(?int $time)`
+
+Makes a request and saves into cache with the provided time duration value (in seconds). 
+Check the [Cache TTL](02-configuration.md#cache-ttl) section for more information regarding default values.
+
+Available for all APIs if `cache` is enabled in the [configuration](02-configuration.md#cache).
+
+```php
+use ProgrammatorDev\OpenWeatherMap\Language\Language
+
+// Cache will be saved for 1 hour for this request alone
+$openWeatherMap->getWeather()
+    ->withCacheTtl(3600)
+    ->getCurrent(50, 50);
+```

docs/05-objects.md

@@ -55,19 +55,19 @@
 
 ### OneCall
 
-`getCoordinate()`: [`Coordinate`](05-objects.md#coordinate)
+`getCoordinate()`: [`Coordinate`](#coordinate)
 
-`getTimezone()`: [`Timezone`](05-objects.md#timezone)
+`getTimezone()`: [`Timezone`](#timezone)
 
-`getCurrent()`: [`Weather`](05-objects.md#weather)
+`getCurrent()`: [`Weather`](#weather)
 
-`getMinutelyForecast()`: [`?MinuteForecast[]`](05-objects.md#minuteforecast)
+`getMinutelyForecast()`: [`?MinuteForecast[]`](#minuteforecast)
 
-`getHourlyForecast()`: [`Weather[]`](05-objects.md#weather)
+`getHourlyForecast()`: [`Weather[]`](#weather)
 
-`getDailyForecast()`: [`Weather[]`](05-objects.md#weather)
+`getDailyForecast()`: [`Weather[]`](#weather)
 
-`getAlerts()`: [`?Alert[]`](05-objects.md#alert)
+`getAlerts()`: [`?Alert[]`](#alert)
 
 ### Weather