Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: document precision limitations of geo_bounding_box #30540

Merged
merged 3 commits into from
May 14, 2018
Merged

Docs: document precision limitations of geo_bounding_box #30540

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b01eb6f
Docs: document precision limitations of geo_bounding_box
imotov May 11, 2018
778a535
Add the information about the maximum expected error
imotov May 14, 2018
834d2bd
Merge remote-tracking branch 'elastic/master' into issue-29196-docume…
imotov May 14, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions docs/reference/query-dsl/geo-bounding-box-query.asciidoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -329,3 +329,16 @@ and will not match any documents for this query. This can be useful when
querying multiple indexes which might have different mappings. When set to
`false` (the default value) the query will throw an exception if the field
is not mapped.

[float]
==== Notes on Precision

Geopoints have limited precision and are always rounded down during index time.
During the query time, upper boundaries of the bounding boxes are rounded down,
while lower boundaries are rounded up. As a result, the points along on the
lower bounds (bottom and left edges of the bounding box) might not make it into
the bounding box due to the rounding error. At the same time points alongside
the upper bounds (top and right edges) might be selected by the query even if
they are located slightly outside the edge. The rounding error should be less
than 4.20e-8 degrees on the latitude and less than 8.39e-8 degrees on the
longitude.