From 443048aa3c6bc0bfc59788171fd85ac3e8518fa1 Mon Sep 17 00:00:00 2001
From: Aivaras Gotovskis <aivaras.gotovskis@ongr.io>
Date: Tue, 7 Jul 2015 12:43:30 +0300
Subject: [PATCH] Add geo distance filter doc.

---
 docs/Filter/GeoDistance.md | 43 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 docs/Filter/GeoDistance.md

diff --git a/docs/Filter/GeoDistance.md b/docs/Filter/GeoDistance.md
new file mode 100644
index 0000000..8c2ec11
--- /dev/null
+++ b/docs/Filter/GeoDistance.md
@@ -0,0 +1,43 @@
+# Geo Distance Filter
+
+> More info about geo distance filter is in the [official elasticsearch docs][1]
+
+Filters documents that include only hits that exists within a specific distance from a geo point.
+
+## Simple example
+
+```JSON
+{
+    "filtered" : {
+        "query" : {
+            "match_all" : {}
+        },
+        "filter" : {
+            "geo_distance" : {
+                "distance" : "200km",
+                "pin.location" : {
+                    "lat" : 40,
+                    "lon" : -70
+                }
+            }
+        }
+    }
+}
+```
+
+And now the query via DSL:
+
+```php
+$geoDistanceFilter = new GeoDistanceFilter(
+    'pin.location',
+    '200km',
+    ['lat' => 40, 'lon' => -70]
+);
+
+$search = new Search();
+$search->addFilter($geoDistanceFilter);
+
+$queryArray = $search->toArray();
+```
+
+[1]: https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-geo-distance-filter.html
-- 
GitLab