map-server-config

Configure Nav2 map_server to publish OccupancyGrid maps and switch maps at runtime.

18|2|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/wimblerobotics/ros2-copilot-skills --skill map-server-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map-server-config
Source: https://github.com/wimblerobotics/ros2-copilot-skills/tree/main/map-server-config
Command: npx skills add https://github.com/wimblerobotics/ros2-copilot-skills --skill map-server-config

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configures and operates the Nav2 map_server to publish static OccupancyGrid maps and manage runtime map switching, enabling reliable map-based navigation.

Core Features & Use Cases

  • Lifecycle-managed Nav2 map_server integration with nav2_lifecycle_manager for activation and deactivation.
  • Dynamic map loading at runtime via the /map_server/load_map service to switch maps without restart.
  • Coordination with AMCL and costmaps to ensure new maps are used correctly and initial pose can be re-seeded.

Quick Start

Start by loading a YAML map description and starting the map_server under the lifecycle manager to publish /map and support runtime map changes.

Frequently Asked Questions about map-server-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure the Nav2 map_server to publish an OccupancyGrid map?

To configure the Nav2 map_server to publish an OccupancyGrid map, load a YAML map description and start the map_server under the nav2_lifecycle_manager for lifecycle-managed activation and deactivation.

Can I switch maps at runtime with the Nav2 map_server without restarting the node?

Yes, you can switch maps at runtime with the Nav2 map_server without restarting by calling the /map_server/load_map service to dynamically load new OccupancyGrid data.

How does Nav2 map_server coordinate with AMCL and costmaps when loading a new map?

Nav2 map_server coordinates with AMCL and Global/Local costmaps during map loading by ensuring new maps are used correctly and initial pose can be re-seeded for smooth map transitions.

What is the benefit of using nav2_lifecycle_manager for map_server startup?

Using nav2_lifecycle_manager for map_server startup provides lifecycle-managed activation and deactivation, ensuring reliable map-based navigation and controlled state transitions.

Do I need a YAML map description to start the Nav2 map_server?

Yes, you need a YAML map description to start the Nav2 map_server, which uses it to publish static OccupancyGrid maps and support runtime map changes.

Why is my Nav2 map_server not switching maps correctly during runtime?

Runtime map switching issues in Nav2 map_server often occur when AMCL and costmaps are not properly coordinated to use the new map and re-seed the initial pose for smooth transitions.