events: support region

README.md

@@ -70,7 +70,7 @@ foreach ($events as $event) {
 
 #### Filters
 
-Events can be filtered by group, category, program or intended for:
+Events can be filtered by group, category, program, intended for and other options:
 
 ```php
 $parameters = new \HnutiBrontosaurus\BisClient\Event\Request\EventParameters();
@@ -93,6 +93,9 @@ $parameters->setIntendedFor(\HnutiBrontosaurus\BisClient\Event\IntendedFor::FIRS
 // only for some administration units
 $parameters->setAdministrationUnit(5);
 
+// only in "Vysočina" region
+$parameters->setRegion(\HnutiBrontosaurus\BisClient\Event\Request\Region::VYSOCINA());
+
 $events = $client->getEvents($parameters);
 ```
 

src/Event/Request/EventParameters.php

@@ -54,6 +54,27 @@ public function setAdministrationUnits(array $ids): self
 	}
 
 
+	// region
+
+	/** @var Region[] */
+	private array $regions = [];
+
+	public function setRegion(Region $region): self
+	{
+		$this->regions = [$region];
+		return $this;
+	}
+
+	/**
+	 * @param Region[] $regions
+	 */
+	public function setRegions(array $regions): self
+	{
+		$this->regions = $regions;
+		return $this;
+	}
+
+
 	// groups
 
 	/** @var Group[] */
@@ -258,6 +279,9 @@ public function toArray(): array
 		if (count($this->administrationUnits) > 0) {
 			$array['administration_unit'] = implode(',', $this->administrationUnits);
 		}
+		if (count($this->regions) > 0) {
+			$array['region'] = implode(',', $this->regions);
+		}
 		if (count($this->groups) > 0) {
 			$array['group'] = implode(',', $this->groups);
 		}

src/Event/Request/Region.php

@@ -0,0 +1,44 @@
+<?php declare(strict_types = 1);
+
+namespace HnutiBrontosaurus\BisClient\Event\Request;
+
+use Grifart\Enum\AutoInstances;
+use Grifart\Enum\Enum;
+
+
+/**
+ * @method static Region PRAHA()
+ * @method static Region STREDOCESKY()
+ * @method static Region JIHOCESKY()
+ * @method static Region PLZENSKY()
+ * @method static Region KARLOVARSKY()
+ * @method static Region USTECKY()
+ * @method static Region LIBERECKY()
+ * @method static Region KRALOVEHRADECKY()
+ * @method static Region PARDUBICKY()
+ * @method static Region VYSOCINA()
+ * @method static Region JIHOMORAVSKY()
+ * @method static Region OLOMOUCKY()
+ * @method static Region MORAVSKOSLEZSKY()
+ * @method static Region ZLINSKY()
+ */
+final class Region extends Enum
+{
+	use AutoInstances;
+
+	protected const PRAHA = 1;
+	protected const STREDOCESKY = 2;
+	protected const JIHOCESKY = 3;
+	protected const PLZENSKY = 4;
+	protected const KARLOVARSKY = 5;
+	protected const USTECKY = 6;
+	protected const LIBERECKY = 7;
+	protected const KRALOVEHRADECKY = 8;
+	protected const PARDUBICKY = 9;
+	protected const VYSOCINA = 10;
+	protected const JIHOMORAVSKY = 11;
+	protected const OLOMOUCKY = 12;
+	protected const MORAVSKOSLEZSKY = 13;
+	protected const ZLINSKY = 14;
+
+}