elasticsearch/docs/reference/query-languages/query-dsl/query-dsl-span-near-query.md
Craig Taverner 94cad286bc
Restructure query-languages docs files for clarity (#124797)
In a few previous PR's we restructured the ES|QL docs to make it possible to generate them dynamically.

This PR just moves a few files around to make the query languages docs easier to work with, and a little more organized like the ES|QL docs.

A bit part of this was setting up redirects to the new locations, so other repo's could correctly link to the elasticsearch docs.
2025-03-17 17:58:58 +01:00

30 lines
847 B
Markdown

---
navigation_title: "Span near"
mapped_pages:
- https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-span-near-query.html
---
# Span near query [query-dsl-span-near-query]
Matches spans which are near one another. One can specify *slop*, the maximum number of intervening unmatched positions, as well as whether matches are required to be in-order. Here is an example:
```console
GET /_search
{
"query": {
"span_near": {
"clauses": [
{ "span_term": { "field": "value1" } },
{ "span_term": { "field": "value2" } },
{ "span_term": { "field": "value3" } }
],
"slop": 12,
"in_order": false
}
}
}
```
The `clauses` element is a list of one or more other span type queries and the `slop` controls the maximum number of intervening unmatched positions permitted.