feat(apix): historical endpoint

Author: DadiBit

lib/src/main/kotlin/com/openmeteo/apix/OpenMeteo.kt

@@ -16,7 +16,7 @@ import com.openmeteo.apix.forecast.Forecast
 import com.openmeteo.apix.geocoding.GeocodingGet
 import com.openmeteo.apix.geocoding.GeocodingSearch
 import com.openmeteo.apix.gfs.Gfs
-import kotlinx.serialization.SerialName
+import com.openmeteo.apix.historical.Historical
 
 class OpenMeteo(
     override val latitude: Float = 0f,
@@ -28,6 +28,7 @@ class OpenMeteo(
     val geocodingGet: Endpoint = Endpoint(GeocodingGet.context),
     val geocodingSearch: Endpoint = Endpoint(GeocodingSearch.context),
     val gfs: Endpoint = Endpoint(Gfs.context),
+    val historical: Endpoint = Endpoint(Historical.context),
 ) : QueryCoordinates {
 
     constructor(coordinates: Pair<Float, Float>) : this(
@@ -66,6 +67,9 @@ class OpenMeteo(
     operator fun invoke(query: Gfs.Query) =
         gfs.query<Gfs.Response>(query)
 
+    operator fun invoke(query: Historical.Query) =
+        historical.query<Historical.Response>(query)
+
     fun airQuality(
         latitude: Float = this.latitude,
         longitude: Float = this.longitude,
@@ -141,4 +145,18 @@ class OpenMeteo(
         temperatureUnit, windSpeedUnit, precipitationUnit, timeZone, startDate,
         endDate, pastDays, forecastDays))
 
+    fun historical(
+        latitude: Float = this.latitude,
+        longitude: Float = this.longitude,
+        hourly: Iterable<com.openmeteo.apix.historical.Hourly>? = null,
+        daily: Iterable<com.openmeteo.apix.historical.Daily>? = null,
+        temperatureUnit: TemperatureUnit? = null,
+        windSpeedUnit: WindSpeedUnit? = null,
+        precipitationUnit: PrecipitationUnit? = null,
+        timeZone: TimeZone? = null,
+        startDate: Date? = null,
+        endDate: Date? = null,
+    ) = invoke(Historical.Query(latitude, longitude, hourly, daily, temperatureUnit,
+        windSpeedUnit, precipitationUnit, timeZone, startDate, endDate))
+
 }

lib/src/main/kotlin/com/openmeteo/apix/historical/Historical.kt

@@ -0,0 +1,63 @@
+package com.openmeteo.apix.historical
+
+import com.openmeteo.apix.common.query.*
+import com.openmeteo.apix.common.response.ResponseCoordinates
+import com.openmeteo.apix.common.response.ResponseDaily
+import com.openmeteo.apix.common.response.ResponseGenerationTimed
+import com.openmeteo.apix.common.response.ResponseHourly
+import com.openmeteo.apix.common.time.Date
+import com.openmeteo.apix.common.time.TimeZone
+import com.openmeteo.apix.common.units.PrecipitationUnit
+import com.openmeteo.apix.common.units.TemperatureUnit
+import com.openmeteo.apix.common.units.Unit
+import com.openmeteo.apix.common.units.WindSpeedUnit
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+import java.net.URL
+
+object Historical {
+
+    val context = URL("https://archive-api.open-meteo.com/v1/era5")
+
+    class Query(
+        override val latitude: Float,
+        override val longitude: Float,
+        override val hourly: Iterable<Hourly>? = null,
+        override val daily: Iterable<Daily>? = null,
+        val temperatureUnit: TemperatureUnit? = null,
+        val windSpeedUnit: WindSpeedUnit? = null,
+        val precipitationUnit: PrecipitationUnit? = null,
+        override val timeZone: TimeZone? = null,
+        override val startDate: Date? = null,
+        override val endDate: Date? = null,
+    ) : QueryCoordinates,
+        QueryHourly,
+        QueryDaily,
+        QueryDateRange
+
+    @Serializable
+    class Response(
+        override val latitude: Float,
+        override val longitude: Float,
+        @SerialName("utc_offset_seconds")
+        override val utcOffsetSeconds: Int,
+        @SerialName("timezone")
+        override val timeZone: TimeZone,
+        @SerialName("timezone_abbreviation")
+        override val timeZoneAbbreviation: String,
+        @SerialName("hourly_units")
+        override val hourlyUnits: Map<Hourly, Unit>? = null,
+        @SerialName("hourly")
+        override val hourlyValues: Map<Hourly, Array<Double?>>? = null,
+        @SerialName("daily_units")
+        override val dailyUnits: Map<Daily, Unit>? = null,
+        @SerialName("daily")
+        override val dailyValues: Map<Daily, Array<Double?>>? = null,
+        @SerialName("generationtime_ms")
+        override val generationTimeMs: Float,
+    ) : ResponseCoordinates,
+        ResponseHourly<Hourly>,
+        ResponseDaily<Daily>,
+        ResponseGenerationTimed
+
+}