Geo-distance query #

Matches documents whose geo_point field lies within a great-circle distance of a centre point. Distances are in metres.

Examples #

POST /my-collection/_search
{
  "query": {
    "geo_distance": {
      "field": "location",
      "lat": 40.73,
      "lon": -74.1,
      "distance_meters": 200000
    }
  }
}

Parameters for geo_distance #

• field
  (Required, string) The geo_point field to filter on.
• lat
  (Required, number) Centre latitude in WGS-84 degrees ([-90, 90]).
• lon
  (Required, number) Centre longitude in WGS-84 degrees ([-180, 180]).
• distance_meters
  (Required, number) Maximum great-circle distance from the centre, in metres (>= 0).