Add support for selecting radiation database

README.md

@@ -14,6 +14,7 @@ composer require holicz/pvgis
 
 use holicz\PVGIS\PVGIS;
 use holicz\PVGIS\Adapter\PvgisAdapter;
+use holicz\PVGIS\Enum\Database;
 
 $latitude = '50.0898689';
 $longitude = '14.4000936';
@@ -23,7 +24,8 @@ $electricityProduction = $pvgis->getElectricityProduction(
     $latitude,
     $longitude,
     35, // Solar panels angle (not required)
-    CardinalDirection::SOUTH // Solar panels azimuth (not required)
+    CardinalDirection::SOUTH, // Solar panels azimuth (not required)
+    Database::SARAH // Name of the radiation database (not required)
 );
 
 // Yearly sum of production

src/Adapter/UrlBuilder.php

@@ -25,6 +25,7 @@ public function build(): string
         $this->buildGPSCoordinates();
         $this->buildAngle();
         $this->buildAzimuth();
+        $this->buildDatabase();
 
         return $this->url;
     }
@@ -51,4 +52,13 @@ private function buildAzimuth(): void
 
         $this->url .= sprintf('&aspect=%d', $this->request->getAzimuth());
     }
+
+    private function buildDatabase(): void
+    {
+        if ($this->request->getDatabase() === null) {
+            return;
+        }
+
+        $this->url .= sprintf('&raddatabase=%s', $this->request->getDatabase());
+    }
 }

src/Enum/Database.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace holicz\PVGIS\Enum;
+
+final class Database
+{
+    public const SARAH = 'PVGIS-SARAH';
+    public const NSRDB = 'PVGIS-NSRDB';
+    public const ERA5 = 'PVGIS-ERA5';
+    public const COSMO = 'PVGIS-COSMO';
+    /** @deprecated */
+    public const CMSAF = 'PVGIS-CMSAF';
+}

src/Model/Request.php

@@ -13,17 +13,20 @@ final class Request
     private string $longitude;
     private ?int $angle;
     private ?int $azimuth;
+    private ?string $database;
 
     public function __construct(
         string $latitude,
         string $longitude,
         ?int $angle = null,
-        ?int $azimuth = null
+        ?int $azimuth = null,
+        ?string $database = null
     ) {
         $this->latitude = $latitude;
         $this->longitude = $longitude;
         $this->angle = $angle;
         $this->azimuth = $azimuth;
+        $this->database = $database;
     }
 
     public function getLatitude(): string
@@ -55,4 +58,14 @@ public function getAzimuth(): ?int
     {
         return $this->azimuth;
     }
+
+    public function setDatabase(?string $database): void
+    {
+        $this->database = $database;
+    }
+
+    public function getDatabase(): ?string
+    {
+        return $this->database;
+    }
 }

src/PVGIS.php

@@ -25,9 +25,10 @@ public function getElectricityProduction(
         string $latitude,
         string $longitude,
         ?int $angle = null,
-        ?int $azimuth = null
+        ?int $azimuth = null,
+        ?string $database = null
     ): ElectricityProduction {
-        $request = new Request($latitude, $longitude, $angle, $azimuth);
+        $request = new Request($latitude, $longitude, $angle, $azimuth, $database);
 
         return $this->pvgisAdapter->getPvgisData($request);
     }