map-waypoints

Queries and visualizes a CARLA map's road network through the Map and Waypoint API.

3|Updated Jul 20, 2026
One-click install
npx skills add https://github.com/carla-simulator/carla-agentic-tools --skill map-waypoints-carla-simulator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: map-waypoints
Source: https://github.com/carla-simulator/carla-agentic-tools/tree/main/skills/python-api/map-waypoints
Command: npx skills add https://github.com/carla-simulator/carla-agentic-tools --skill map-waypoints-carla-simulator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires carla, and includes scripts (resource) and references (resource) components.

What problem does it solve? Understanding a CARLA map's road layout normally requires writing ad-hoc Python against the Map/Waypoint API, and resolving phrases like "the 4-way junction in the middle" into a specific junction id is tedious guesswork. This Skill turns the loaded map into structured data — stats, junction lists with centre/bearing/arm counts, lane facts — so an agent can answer natural-language map questions and visually confirm the modelled topology matches the rendered one. ## Core Features & Use Cases - Map rundown: summary produces road/lane counts, extent, junction breakdown, density classification, and a one-paragraph prose description ready to relay. - Topology and junction visualization: topology --draw and junctions --draw overlay the road graph and labelled junction boxes via world.debug to verify the model against the rendered map. - Natural-language element resolution: junctions lists every junction with arm count, distance-to-centre, and bearing so phrases like "the northern 4-way junction" resolve to a concrete id. - Point queries and navigation: waypoint --at returns lane facts at a coordinate; navigate walks next() along a lane with optional drawing. - Use Case: A user asks "highlight the 4-way junction in the middle of Town10" — run junctions --arms 4, pick the smallest distance-to-centre, then draw it to confirm. ## Quick Start Ask the agent to give you a rundown of the currently loaded CARLA map's topology, or to find and highlight a specific junction such as the 4-way one nearest the centre.

Frequently Asked Questions about map-waypoints

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

FAQPage Schema
How do I get a summary of a CARLA map's road network?▼

Run the summary command of the waypoints script after sourcing env.sh. It samples waypoints every 3 metres via generate_waypoints and reports road and lane counts, map extent, junction breakdown, density classification, and a prose rundown paragraph.

How do I find a specific junction in a CARLA map from a description?▼

Run the junctions command to list every junction with id, arm count, centre coordinates, distance from map centre, and bearing. Filter by arms for phrases like "4-way", pick the smallest distance for "in the middle", then use --draw to visually confirm.

Does CARLA map topology drawing work on a headless server?▼

No, debug-draw overlays are invisible on a headless -nullrhi server because there is no rendered view. Text queries like summary, junctions, and waypoint work headless; use a rendered server for topology or junction drawing.

Why does landmark.waypoint return None in CARLA 0.10.0?▼

On the CARLA 0.10.0 UE5 line, Landmark.waypoint is always None even though all other landmark fields populate normally. Get the road position from the landmark itself using map.get_waypoint_xodr with road_id and s, or map.get_waypoint on the landmark transform location.

Why is the CARLA map summary slow on large towns?▼

Large maps like Town11, Town12, and Town13 have huge road networks, and summary samples waypoints every 3 metres across all of them. It still completes; increase the STAT_STEP constant in the script for a faster, coarser pass.

What are the prerequisites for querying the CARLA Waypoint API?▼

You need the carla Python module importable by the active interpreter and a reachable, already-running CARLA server at CARLA_HOST and CARLA_PORT. The check_env.sh script verifies both and warns on client/server version mismatches.