Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

No version for distro ardent showing humble. Known supported distros are highlighted in the buttons above.

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

No version for distro bouncy showing humble. Known supported distros are highlighted in the buttons above.

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

No version for distro crystal showing humble. Known supported distros are highlighted in the buttons above.

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

No version for distro eloquent showing humble. Known supported distros are highlighted in the buttons above.

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

No version for distro dashing showing humble. Known supported distros are highlighted in the buttons above.

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

No version for distro foxy showing humble. Known supported distros are highlighted in the buttons above.

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

No version for distro lunar showing humble. Known supported distros are highlighted in the buttons above.

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

No version for distro jade showing humble. Known supported distros are highlighted in the buttons above.

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

No version for distro indigo showing humble. Known supported distros are highlighted in the buttons above.

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

No version for distro hydro showing humble. Known supported distros are highlighted in the buttons above.

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version ros2-devel
Last Updated 2026-11-19
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 4.3.0
mapviz_interfaces 4.3.0
mapviz_plugins 4.3.0
multires_image 4.3.0
tile_map 4.3.0

README

Mapviz

Mapviz is a ROS based visualization tool with a plug-in system similar to RViz focused on visualizing 2D data.

Mapviz showing USGS satellite imagery from the Tile Map plugin in 2.5D, with trees standing up from the map, a lidar point cloud, a route, and a vehicle icon

Usage

View the documentation for usage information.

Carto API Key

The Tile Map plugin’s default Carto source requires an API key.

  1. Sign up or log in at carto.com/basemaps/apikey and create a key. Note there are limits on non-commercial vs. commercial usage.
  2. In the Tile Map plugin, select Carto as the source, paste the key into the Carto API Key field and click Save.
  3. Save the Mapviz config to keep the key; it is stored as carto_api_key, e.g.
   - type: mapviz_plugins/tile_map
     config:
       carto_api_key: "<your key>"
       source: Carto
   

v4.0.0 Special Note

v4.0.0 introduced several breaking changes.

  • Many header files had their extensions changed from .h to .hpp to conform to ROS conventions.
  • The UI and ROS callbacks were split into separate threads. This significantly impacts the plugin architecture. Please see the documentation for instructions on how to safely apply these changes and for examples of plugins that use the new architecture.

Plugins

Mapviz comes with these plugins.

Plugin Subscribes to Description
attitude_indicator geometry_msgs/Pose
nav_msgs/Odometry
sensor_msgs/Imu
Shows the vehicle’s roll, pitch, and heading on an aircraft-style attitude indicator.
coordinate_picker None Converts the points you click into a frame of your choice, lists them, and copies the latest one to the clipboard.
disparity stereo_msgs/DisparityImage Shows a stereo disparity image over the map.
draw_marker None Lets you draw points, lines, or polygons on the map and publishes them as a visualization_msgs/Marker.
draw_polygon None Lets you draw a polygon on the map and publishes it as a geometry_msgs/PolygonStamped.
float std_msgs/Float32
std_msgs/Float64
marti_common_msgs/Float32Stamped
marti_common_msgs/Float64Stamped
marti_sensor_msgs/Velocity
Shows the latest number from a topic as text at a fixed spot on the map.
gps gps_msgs/GPSFix Plots GPS fixes on the map as points, lines, or arrows.
grid None Draws a grid of evenly spaced lines over the map.
image sensor_msgs/Image Shows a camera image at a chosen spot on the map view.
laserscan sensor_msgs/LaserScan Draws laser scan returns, colored by intensity, range, or position.
marker visualization_msgs/Marker
visualization_msgs/MarkerArray
Draws RViz-style markers such as arrows, lines, shapes, and text.
measuring None Measures the distance between points you click on the map.
move_base None Lets you click on the map to set the robot’s initial pose or send it a Nav2 navigation goal.
multires_image None Displays a large georeferenced image from disk.
navsat sensor_msgs/NavSatFix Plots GPS fixes from NavSatFix messages on the map.
occupancy_grid nav_msgs/OccupancyGrid
map_msgs/OccupancyGridUpdate
Displays occupancy grid maps.
odometry nav_msgs/Odometry Draws the robot’s position and heading from odometry, with an optional trail of past positions.
path nav_msgs/Path Draws a path as a line on the map.
plan_route marti_nav_msgs/PlanRoute Lets you click waypoints, asks a route planning service for a route through them, and publishes the result.
point_click_publisher None Publishes a geometry_msgs/PointStamped for every point you click on the map.
pointcloud2 sensor_msgs/PointCloud2 Draws point clouds from above, colored by a field such as height or intensity.
pose geometry_msgs/PoseStamped Draws a pose as an arrow, with an optional trail of past poses.
robot_image None Draws a picture of your robot from an image file.
robot_model std_msgs/String Draws a top-down view of the robot’s URDF model.
route marti_nav_msgs/Route
marti_nav_msgs/RoutePosition
Draws a route and the vehicle’s current position along it.
speedometer nav_msgs/Odometry Shows the vehicle’s speed on a dial.
string std_msgs/String
marti_common_msgs/StringStamped
Shows the latest text message at a fixed spot on the map.
textured_marker marti_visualization_msgs/TexturedMarker
marti_visualization_msgs/TexturedMarkerArray
Draws images that marker messages place on the map.
tf_frame tf tree Draws where a TF frame is, with an optional trail as it moves.
tile_map None Shows map or satellite imagery from tile servers such as OpenStreetMap, Carto, Stadia, Bing, or USGS, optionally in 2.5D with shaded terrain and buildings and trees that stand up from the map, or with contour lines as a topographic map.

Build Status

Branches

  Humble Jazzy Kilted Lyrical Rolling
Branch humble jazzy kilted lyrical rolling

Released Versions

  Humble Jazzy Kilted Lyrical Rolling
Version ROS2 Humble ROS2 Jazzy ROS2 Kilted ROS2 Lyrical ROS2 Rolling

CI

  Humble Jazzy Kilted Lyrical Rolling
testing humble testing jazzy testing kilted testing lyrical testing rolling testing
main humble main jazzy main kilted main lyrical main not built

amd64 dev

  Humble Jazzy Kilted Lyrical Rolling
mapviz dev dev dev dev dev

amd64 bin

File truncated at 100 lines see the full file

Repo symbol

mapviz repository

mapviz mapviz_plugins multires_image tile_map

ROS Distro
kinetic

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version master
Last Updated 2024-09-06
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 1.4.3
mapviz_plugins 1.4.3
multires_image 1.4.3
tile_map 1.4.3

README

Mapviz

| Noetic | | :— | | Build Status |

Mapviz is a ROS based visualization tool with a plug-in system similar to RVIZ focused on visualizing 2D data.

Usage

View the documentation for usage information.

Repo symbol

mapviz repository

mapviz mapviz_plugins multires_image tile_map

ROS Distro
melodic

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version master
Last Updated 2024-09-06
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 1.4.3
mapviz_plugins 1.4.3
multires_image 1.4.3
tile_map 1.4.3

README

Mapviz

| Noetic | | :— | | Build Status |

Mapviz is a ROS based visualization tool with a plug-in system similar to RVIZ focused on visualizing 2D data.

Usage

View the documentation for usage information.

Repo symbol

mapviz repository

mapviz mapviz_plugins multires_image tile_map

ROS Distro
noetic

Repository Summary

Checkout URI https://github.com/swri-robotics/mapviz.git
VCS Type git
VCS Version master
Last Updated 2024-09-06
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Packages

Name Version
mapviz 1.4.3
mapviz_plugins 1.4.3
multires_image 1.4.3
tile_map 1.4.3

README

Mapviz

| Noetic | | :— | | Build Status |

Mapviz is a ROS based visualization tool with a plug-in system similar to RVIZ focused on visualizing 2D data.

Usage

View the documentation for usage information.