boundingPolygons() is now part of the GeometryEngine interface

Note that this method is not currently implemented by any of the available geometry engines.

src/Engine/DatabaseEngine.php

@@ -394,4 +394,12 @@ public function maxDistance(Geometry $a, Geometry $b)
     {
         return $this->queryFloat('ST_MaxDistance', [$a, $b]);
     }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function boundingPolygons(Geometry $g)
+    {
+        throw GeometryEngineException::unimplementedMethod(__METHOD__);
+    }
 }

src/Engine/GEOSEngine.php

@@ -453,4 +453,12 @@ public function maxDistance(Geometry $a, Geometry $b)
     {
         throw GeometryEngineException::unimplementedMethod(__METHOD__);
     }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function boundingPolygons(Geometry $g)
+    {
+        throw GeometryEngineException::unimplementedMethod(__METHOD__);
+    }
 }

src/Engine/GeometryEngine.php

@@ -378,4 +378,15 @@ public function simplify(Geometry $g, $tolerance);
      * @throws GeometryEngineException If the operation is not supported by the engine.
      */
     public function maxDistance(Geometry $a, Geometry $b);
+
+    /**
+     * Returns the collection of polygons that bounds the given polygon 'p' for any polygon 'p' in the surface.
+     *
+     * @param Geometry $g
+     *
+     * @return Geometry
+     *
+     * @throws GeometryEngineException If the operation is not supported by the engine.
+     */
+    public function boundingPolygons(Geometry $g);
 }

src/Exception/GeometryEngineException.php

@@ -17,6 +17,18 @@ public static function noEngineSet()
         return new self('A GeometryEngine must be set to support this feature.');
     }
 
+    /**
+     * @param string $methodName
+     *
+     * @return GeometryEngineException
+     */
+    public static function unimplementedMethod($methodName)
+    {
+        $message = sprintf('%s() is currently not implemented.', $methodName);
+
+        return new self($message);
+    }
+
     /**
      * @param \Exception $e
      *

src/Exception/GeometryException.php

@@ -17,18 +17,6 @@ public static function unsupportedPlatform()
         return new self('This platform has an unsupported endianness.');
     }
 
-    /**
-     * @param string $methodName
-     *
-     * @return GeometryException
-     */
-    public static function unimplementedMethod($methodName)
-    {
-        $message = sprintf('%s() is currently not implemented.', $methodName);
-
-        return new static($message);
-    }
-
     /**
      * @param string $geometryType
      *

src/PolyhedralSurface.php

@@ -120,19 +120,17 @@ public function patches()
     /**
      * Returns the collection of polygons in this surface that bounds the given polygon 'p' for any polygon 'p' in the surface.
      *
-     * @todo needs implementation
-     *
      * @noproxy
      *
      * @param Polygon $p
      *
      * @return MultiPolygon
      *
-     * @throws GeometryException
+     * @throws GeometryEngineException If the operation is not supported by the geometry engine.
      */
     public function boundingPolygons(Polygon $p)
     {
-        throw GeometryException::unimplementedMethod(__METHOD__);
+        return GeometryEngineRegistry::get()->boundingPolygons($p);
     }
 
     /**