› › ›

Агрегация гео-границ

Метрическая агрегация, вычисляющая прямоугольник, содержащий все гео-значения для поля.

Пример:

PUT /museums
{
  "mappings": {
    "properties": {
      "location": {
        "type": "geo_point"
      }
    }
  }
}

POST /museums/_bulk?refresh
{"index":{"_id":1}}
{"location": "52.374081,4.912350", "name": "NEMO Science Museum"}
{"index":{"_id":2}}
{"location": "52.369219,4.901618", "name": "Museum Het Rembrandthuis"}
{"index":{"_id":3}}
{"location": "52.371667,4.914722", "name": "Nederlands Scheepvaartmuseum"}
{"index":{"_id":4}}
{"location": "51.222900,4.405200", "name": "Letterenhuis"}
{"index":{"_id":5}}
{"location": "48.861111,2.336389", "name": "Musée du Louvre"}
{"index":{"_id":6}}
{"location": "48.860000,2.327000", "name": "Musée d'Orsay"}

POST /museums/_search?size=0
{
  "query": {
    "match": { "name": "musée" }
  },
  "aggs": {
    "viewport": {
      "geo_bounds": {
        "field": "location",    
        "wrap_longitude": true  
      }
    }
  }
}

	Агрегация `geo_bounds` указывает поле, используемое для получения границ.
	`wrap_longitude` — необязательный параметр, определяющий, разрешено ли пересечение прямоугольника с международной линией перемены дат. Значение по умолчанию — `true`.

Вышеприведенная агрегация демонстрирует, как вычислить прямоугольник для поля местоположения (location) для всех документов с типом бизнеса «магазин» (shop).

Результат выполнения вышеприведенной агрегации:

{
  ...
  "aggregations": {
    "viewport": {
      "bounds": {
        "top_left": {
          "lat": 48.86111099738628,
          "lon": 2.3269999679178
        },
        "bottom_right": {
          "lat": 48.85999997612089,
          "lon": 2.3363889567553997
        }
      }
    }
  }
}

Агрегация гео-границ для полей `geo_shape`

Агрегация гео-границ также поддерживается для полей geo_shape.

Если wrap_longitude установлено в значение true (значение по умолчанию), прямоугольник может пересекать международную линию перемены дат и возвращать границы, где долгота top_left больше, чем долгота top_right.

Например, долгота правого верхнего угла обычно больше, чем долгота левого нижнего угла географического прямоугольника. Однако, когда область пересекает меридиан 180°, значение долготы левого нижнего угла будет больше значения долготы правого верхнего угла. Дополнительную информацию можно найти на сайте Open Geospatial Consortium в разделе Географический прямоугольник.

Пример:

PUT /places
{
  "mappings": {
    "properties": {
      "geometry": {
        "type": "geo_shape"
      }
    }
  }
}

POST /places/_bulk?refresh
{"index":{"_id":1}}
{"name": "NEMO Science Museum", "geometry": "POINT(4.912350 52.374081)" }
{"index":{"_id":2}}
{"name": "Sportpark De Weeren", "geometry": { "type": "Polygon", "coordinates": [ [ [ 4.965305328369141, 52.39347642069457 ], [ 4.966979026794433, 52.391721758934835 ], [ 4.969425201416015, 52.39238958618537 ], [ 4.967944622039794, 52.39420969150824 ], [ 4.965305328369141, 52.39347642069457 ] ] ] } }

POST /places/_search?size=0
{
  "aggs": {
    "viewport": {
      "geo_bounds": {
        "field": "geometry"
      }
    }
  }
}

{
  ...
  "aggregations": {
    "viewport": {
      "bounds": {
        "top_left": {
          "lat": 52.39420966710895,
          "lon": 4.912349972873926
        },
        "bottom_right": {
          "lat": 52.374080987647176,
          "lon": 4.969425117596984
        }
      }
    }
  }
}

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/search-aggregations-metrics-geobounds-aggregation.html

Агрегация гео-границ

Агрегация гео-границ для полей geo_shape

Агрегация гео-границ для полей `geo_shape`