Support lunar coordinate transformations

[adityapande-1995]

🎉 New feature

Summary

This PR adds a method to accept the spherical coordinates from the world, and calculate DEM sizes accordingly.
Logic is added to GeoReference() method to perform appropriate transformation for lunar surface.

Extending the same logic as lunar coordinate transformations, we can support transformations for custom surfaces as well.

Test it

Added a simple test to Dem_TEST.cc. The GeoReference method is private currently, and I'm not sure how to verify those coordinate transformations externally.

TODO :

• I think the isNonEarthDem flag should be renamed to isUnknownDem or something, since we do support lunar dems now. Open to suggestions !

Depends on :

• Compute distance between points on a general celestial body gz-math#434
• SphericalCoordinates: make query methods const gz-math#452

Checklist

• Signed all commits for DCO
• Added tests
• Added example and/or tutorial
• Updated documentation (as needed)
• Updated migration guide (as needed)
• Consider updating Python bindings (if the library has them)
• codecheck passed (See contributing)
• All tests passed (See test coverage)
• While waiting for a review on your PR, please help review another open pull request to support the maintainers

Note to maintainers: Remember to use Squash-Merge and edit the commit message to match the pull request summary while retaining Signed-off-by messages.

🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸🔸

[ahcorde]

Document new method

[codecov]

Codecov Report

Merging #377 (ba01d65) into main (4136c0a) will increase coverage by 0.03%.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##             main     #377      +/-   ##
==========================================
+ Coverage   77.82%   77.85%   +0.03%     
==========================================
  Files          85       85              
  Lines       10776    10783       +7     
==========================================
+ Hits         8386     8395       +9     
+ Misses       2390     2388       -2     

Impacted Files	Coverage Δ
geospatial/src/Dem.cc	92.37% <100.00%> (+1.17%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 4136c0a...ba01d65. Read the comment docs.

[jennuine]

Are the SetUnknownDEM and UknownDEM functions needed anymore? I believe with your gz-math and sdformat updates, these methods aren't necessary anymore and can be removed

Also, can you update the comments for both the GeoReference* functions, removing WGS84?

gz-common/geospatial/include/gz/common/geospatial/Dem.hh

Lines 85 to 86 in ffb8607

	/// \brief Get the georeferenced coordinates (lat, long) of the terrain's
	/// origin in WGS84.

[adityapande-1995]

Are the SetUnknownDEM and UknownDEM functions needed anymore? I believe with your gz-math and sdformat updates, these methods aren't necessary anymore and can be removed

Also, can you update the comments for both the GeoReference* functions, removing WGS84?

gz-common/geospatial/include/gz/common/geospatial/Dem.hh

Lines 85 to 86 in ffb8607

	/// \brief Get the georeferenced coordinates (lat, long) of the terrain's
	/// origin in WGS84.

Done 97b1c6d

[jennuine]

LGTM, nice work! One minor comment

[mjcarroll]

This looks good to me as well, thanks @jennuine for taking the lift on reviews here!