add geo_bound aggregation (#1271)

Author: cobak78

CHANGELOG.md

@@ -46,6 +46,7 @@ All notable changes to this project will be documented in this file based on the
 - added `\Elastica\Query\AbstractGeoShape::RELATION_WITHIN`
 - Date math in index names is now escaped in URI
 - Added a check for paths that already have date math escaped
+- added `\Elastica\Aggregation\GeoBounds` to retrieve viewport with geo_points on it
 
 ### Improvements
 

lib/Elastica/Aggregation/GeoBounds.php

@@ -0,0 +1,32 @@
+<?php
+namespace Elastica\Aggregation;
+
+/**
+ * Class GeoBounds.
+ *
+ * @link https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-metrics-geobounds-aggregation.html
+ */
+class GeoBounds extends AbstractAggregation
+{
+    /**
+     * @param string $name  the name of this aggregation
+     * @param string $field the field on which to perform this aggregation
+     */
+    public function __construct($name, $field)
+    {
+        parent::__construct($name);
+        $this->setField($field);
+    }
+
+    /**
+     * Set the field for this aggregation.
+     *
+     * @param string $field the name of the document field on which to perform this aggregation
+     *
+     * @return $this
+     */
+    public function setField($field)
+    {
+        return $this->setParam('field', $field);
+    }
+}

test/lib/Elastica/Test/Aggregation/GeoBoundsTest.php

@@ -0,0 +1,47 @@
+<?php
+namespace Elastica\Test\Aggregation;
+
+use Elastica\Aggregation\GeoBounds;
+use Elastica\Document;
+use Elastica\Query;
+use Elastica\Type\Mapping;
+
+class GeoBoundsTest extends BaseAggregationTest
+{
+    protected function _getIndexForTest()
+    {
+        $index = $this->_createIndex();
+        $type = $index->getType('test');
+
+        $type->setMapping(new Mapping(null, [
+            'location' => ['type' => 'geo_point'],
+        ]));
+
+        $type->addDocuments([
+            new Document(1, ['location' => ['lat' => 32.849437, 'lon' => -117.271732]]),
+            new Document(2, ['location' => ['lat' => 32.798320, 'lon' => -117.246648]]),
+            new Document(3, ['location' => ['lat' => 37.782439, 'lon' => -122.392560]]),
+        ]);
+
+        $index->refresh();
+
+        return $index;
+    }
+
+    /**
+     * @group functional
+     */
+    public function testGeoBoundsAggregation()
+    {
+        $agg = new GeoBounds('viewport', 'location');
+
+        $query = new Query();
+        $query->addAggregation($agg);
+        $results = $this->_getIndexForTest()->search($query)->getAggregation('viewport');
+
+        $this->assertEquals(37.782438984141, $results['bounds']['top_left']['lat']);
+        $this->assertEquals(-122.39256000146, $results['bounds']['top_left']['lon']);
+        $this->assertEquals(32.798319971189, $results['bounds']['bottom_right']['lat']);
+        $this->assertEquals(-117.24664804526, $results['bounds']['bottom_right']['lon']);
+    }
+}