Skip to content

Commit b93fd50

Browse files
committed
Clarify expectations of false positives/negatives (#27964)
Today this part of the documentation just says that Geo queries are not 100% accurate, but in fact we can be more precise about which kinds of queries see which kinds of error. This commit clarifies this point.
1 parent 269a536 commit b93fd50

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

docs/reference/mapping/types/geo-shape.asciidoc

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -147,12 +147,12 @@ are provided:
147147
[float]
148148
===== Accuracy
149149

150-
Geo_shape does not provide 100% accuracy and depending on how it is
151-
configured it may return some false positives or false negatives for
152-
certain queries. To mitigate this, it is important to select an
153-
appropriate value for the tree_levels parameter and to adjust
154-
expectations accordingly. For example, a point may be near the border of
155-
a particular grid cell and may thus not match a query that only matches the
150+
Geo_shape does not provide 100% accuracy and depending on how it is configured
151+
it may return some false positives for `INTERSECTS`, `WITHIN` and `CONTAINS`
152+
queries, and some false negatives for `DISJOINT` queries. To mitigate this, it
153+
is important to select an appropriate value for the tree_levels parameter and
154+
to adjust expectations accordingly. For example, a point may be near the border
155+
of a particular grid cell and may thus not match a query that only matches the
156156
cell right next to it -- even though the shape is very close to the point.
157157

158158
[float]

0 commit comments

Comments
 (0)