[DOCS-15351] [Server] Make geospatial coordinate ordering notice more prominent Created: 19/May/22  Updated: 30/Oct/23  Resolved: 02/Aug/22

Status: Closed
Project: Documentation
Component/s: manual, Server
Affects Version/s: 4.2.0, 4.4.0, 5.0.0, 5.3.0, 6.0.0
Fix Version/s: Server_Docs_20231030

Type: Improvement Priority: Minor - P4
Reporter: Matt Dale Assignee: Lauren Tran
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Related
is related to GODRIVER-2429 GeoJSON uses lat/long in the wrong order Closed
is related to SERVER-27548 The order of Coordinates [longitude, ... Closed
Participants:
Days since reply: 1 year, 27 weeks, 6 days ago
Epic Link: DOCSP-11702

 Description   

There has been recent confusion about the ordering of coordinates in geospatial data in MongoDB, including this blog post (see related GODRIVER-2429) that started as a bug report but ended up being an issue related to expected coordinate order (i.e. order of latitude, longitude in points). Before it was resolved, it was shared on Hacker News and was popular enough to make the front page.

While the Geospatial Queries, GeoJSON, and $near manual pages describe that MongoDB uses coordinate order (longitude, latitude), users may assume a coordinate order based on experience with other systems and may gloss over that information. A more prominent notice of the coordinate order that MongoDB expects could reduce confusion. Please add a more prominent notice (e.g. a "Note" or "Warning" block) that the MongoDB coordinate order is (longitude, latitude) to all manual pages that describe geospatial data and operations.

Relevant pages (that I could find):

For more context about coordinate order, check out this wiki article about axis order confusion, this website dedicated to grouping geospatial formats/tools based on what coordinate order they use, and this article about the history of coordinate order in different industries.



 Comments   
Comment by Githook User [ 28/Jul/22 ]

Author:

{'name': 'ltran-mdb', 'email': '107217639+ltran-mdb@users.noreply.github.com', 'username': 'ltran-mdb'}

Message: DOCS 15351 - emphasizing latitude and longitude order (#1504)

  • DOCS-15351 emphasizing latitude and longitude order
  • DOCS-15351 emphasizing latitude and longitude order
  • DOCS-15351 emphasizing longitude and latitude order
  • DOCS-15351 emphasizing longitude and latitude order
Comment by Joe Drumgoole (Inactive) [ 20/May/22 ]

cc : jonathan.destefano@mongodb.com 

Generated at Thu Feb 08 08:12:39 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.