geo spatial filtres

Author: san4io

README.md

@@ -398,6 +398,9 @@ whereNotBetween($field, $value) | whereNotBetween('price', [100, 200]) | Checks
 whereExists($field) | whereExists('unemployed') | Checks if a value is defined.
 whereNotExists($field) | whereNotExists('unemployed') | Checks if a value isn't defined.  
 whereRegexp($field, $value, $flags = 'ALL') | whereRegexp('name.raw', 'A.+') | Filters records according to a given regular expression. [Here](https://www.elastic.co/guide/en/elasticsearch/reference/5.2/query-dsl-regexp-query.html#regexp-syntax) you can find more about syntax.
+whereGeoDistance($field, $value, $distance) | whereGeoDistance('location', [-70, 40], 1000) | Filters records according to given point and distance from it. [Here](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-geo-distance-query.html) you can find more about syntax.
+whereGeoBoundingBox($field, array $value) | whereGeoBoundingBox('location', ["top_left" =>  [-74.1, 40.73], "bottom_right" => [-71.12, 40.01]) | Filters records within given boundings. [Here](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-geo-bounding-box-query.html) you can find more about syntax.
+whereGeoPolygon($field, array $points) | whereGeoPolygon('location', [[-70, 40],[-80, 30],[-90, 20]]) | Filters records within given polygon. [Here](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-geo-polygon-query.html) you can find more about syntax.
 
 In most cases it's better to use raw fields to filter records, i.e. not analyzed fields.
 

src/Builders/FilterBuilder.php

@@ -114,6 +114,46 @@ public function whereRegexp($field, $value, $flags = 'ALL')
         return $this;
     }
 
+    /**
+     * https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-geo-distance-query.html
+     * @param string $field
+     * @param string $value
+     * @param array|string $distance
+     * @return $this
+     */
+    public function whereGeoDistance($field, $value, $distance)
+    {
+        $this->wheres['must'][] = ['geo_distance' => ['distance' => $distance, $field => $value]];
+
+        return $this;
+    }
+
+    /**
+     * https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-geo-bounding-box-query.html
+     * @param string $field
+     * @param array $value
+     * @return $this
+     */
+    public function whereGeoBoundingBox($field, array $value)
+    {
+        $this->wheres['must'][] = ['geo_bounding_box' => [$field => $value]];
+
+        return $this;
+    }
+
+    /**
+     * https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-geo-polygon-query.html
+     * @param string $field
+     * @param array $points
+     * @return $this
+     */
+    public function whereGeoPolygon($field, array $points)
+    {
+        $this->wheres['must'][] = ['geo_polygon' => [$field => ['points' => $points]]];
+
+        return $this;
+    }
+
     public function orderBy($column, $direction = 'asc')
     {
         $this->orders[] = [$column => strtolower($direction) == 'asc' ? 'asc' : 'desc'];