MAPG-6 introduce and unify geo calculations

src/Util/Geo/Bounds.php

@@ -2,6 +2,8 @@
 
 class Bounds
 {
+    const ONE_DEGREE_OF_LATITUDE_IN_METER = 111132.954;
+
     private float $southLat;
     private float $westLng;
 
@@ -19,7 +21,7 @@ class Bounds
         return $instance;
     }
 
-    public static function createDirectly(float $southLat, $westLng, $northLat, $eastLng): Bounds
+    public static function createDirectly(float $southLat, float $westLng, float $northLat, float $eastLng): Bounds
     {
         $instance = new static();
 
@@ -61,6 +63,18 @@ class Bounds
         }
     }
 
+    public function calculateApproximateArea(): float
+    {
+        $dLat = $this->northLat - $this->southLat;
+        $dLng = $this->eastLng - $this->westLng;
+
+        $m = $dLat * static::ONE_DEGREE_OF_LATITUDE_IN_METER;
+        $a = $dLng * static::ONE_DEGREE_OF_LATITUDE_IN_METER * cos(deg2rad($this->northLat));
+        $c = $dLng * static::ONE_DEGREE_OF_LATITUDE_IN_METER * cos(deg2rad($this->southLat));
+
+        return $m * ($a + $c) / 2;
+    }
+
     public function toJson(): string
     {
         if (!$this->initialized) {

src/Util/Geo/Position.php

@@ -2,6 +2,8 @@
 
 class Position
 {
+    const EARTH_RADIUS_IN_METER = 6371000;
+
     private float $lat;
     private float $lng;
 
@@ -21,6 +23,24 @@ class Position
         return $this->lng;
     }
 
+    public function calculateDistanceTo(Position $otherPosition): float
+    {
+        $lat1 = deg2rad($this->lat);
+        $lng1 = deg2rad($this->lng);
+        $lat2 = deg2rad($otherPosition->lat);
+        $lng2 = deg2rad($otherPosition->lng);
+
+        $angleCos = cos($lat1) * cos($lat2) * cos($lng2 - $lng1) + sin($lat1) * sin($lat2);
+
+        if ($angleCos > 1.0) {
+            $angleCos = 1.0;
+        }
+
+        $angle = acos($angleCos);
+
+        return $angle * static::EARTH_RADIUS_IN_METER;
+    }
+
     public function toArray(): array
     {
         return [