nobleo/rviz_satellite
Display internet satellite imagery in RViz
What it solves
In Rviz, researchers and engineers often need to see a satellite map behind their robot's position to understand surroundings. This plugin takes a GPS fix (sensor_msgs/msg/NavSatFix) and draws the corresponding map tiles as a background layer, so you can see where the robot is on a real map.
How it works
You add an AerialMap display to your Rviz config and point it at a topic that publishes GPS coordinates. The plugin then requests map tiles from a URL you provide, using the standard OpenStreetMap slip-tile naming scheme (with {z}, {x}, {y} placeholders for zoom and tile coordinates). It downloads and caches these tiles locally (in ~/.cache/rviz_satellite) so repeat views load faster. You can also set a local tile directory via a file:// path for offline use. The plugin supports both remote and local tile servers, and offers options for transparency, zoom level, tile block count, and a timeout to fade the map when GPS messages stop arriving.
Who it's for
ROS 2 users who work with Rviz and need geographic context for their robots—particularly outdoor robots that rely on GPS (e.g., rovers, drones, autonomous vehicles). It's also useful for anyone who wants to visualize navigation data on a real-world map without leaving Rviz.
Highlights
- Subscribes to NavSatFix messages and automatically updates the map view as the GPS position changes
- Uses the widely adopted OpenStreetMap tile convention, so it works with many tile servers (OpenStreetMap, TomTom, Mapbox, etc.)
- Optional local-map mode for regions that are not covered by global tile servers, with manual calibration of origin and zoom scaling
- Supports custom tile servers by simply providing a URL template and optional access tokens
- Includes a demo launch file that makes Rviz circle a chosen GPS point to test the setup
- Configurable display attributes: transparency, draw-behind option, zoom level (recommended 16–19, max 22), adjacent tile blocks (up to 8), and a fade-out timeout
- Caches map tiles locally for offline re-use; cache can be manually cleared if needed
Related
- Project
- Project
- Project
- Project