Skip to content

Commit a8a19bf

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 a945ddc commit a8a19bf

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

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

+6-6
Original file line numberDiff line numberDiff line change
@@ -154,12 +154,12 @@ are provided:
154154
[float]
155155
===== Accuracy
156156

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

165165
[float]

0 commit comments

Comments
 (0)