Optional orientation when spawning entity using spherical coordinates

[chapulina]

🎉 New feature

• Follow up to 🌐 Spherical coordinates #1008
• Goes with this documentation change: Document pose + spherical coordinates combination on spawn gz-msgs#212

Summary

#1008 added the ability of spawning an entity at a given latitude / longitude. But often, we also want to give the entity a custom 3D orientation (not just heading). With this PR, users can pass a pose.orientation that will be used in combination with lat / lon.

Test it

See the added test, or try calling the service with a custom orientation.

Checklist

• Signed all commits for DCO
• Added tests
• Added example and/or tutorial
• Updated documentation (as needed)
• Updated migration guide (as needed)
• 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.

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

[arjo129]

Tests seem to pass and the logic looks good to me.

[mjcarroll]

LGTM with merge from main and green CI

[chapulina]

There was a sneaky bug detected by the touch plugin test, which was fixed in 10de2d1

[codecov]

Codecov Report

Merging #1263 (6d661ff) into ign-gazebo6 (ae36d83) will increase coverage by 0.00%.
The diff coverage is 85.71%.

@@             Coverage Diff              @@
##           ign-gazebo6    #1263   +/-   ##
============================================
  Coverage        62.24%   62.24%           
============================================
  Files              278      278           
  Lines            23135    23143    +8     
============================================
+ Hits             14400    14406    +6     
- Misses            8735     8737    +2     

Impacted Files	Coverage Δ
src/systems/user_commands/UserCommands.cc	54.27% <85.71%> (+0.25%)	⬆️

---

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 ae36d83...6d661ff. Read the comment docs.

[osrf-triage]

This pull request has been mentioned on Gazebo Community. There might be relevant details there:

https://community.gazebosim.org/t/new-ignition-releases-2022-03-01-citadel-edifice-fortress/1313/1