Map & Navigation API (Retail — Patch 12.0.0)

Comprehensive reference for all map, navigation, and location APIs in WoW Retail.

Source: https://warcraft.wiki.gg/wiki/World_of_Warcraft_API Current as of: Patch 12.0.0 (Build 65655) — January 28, 2026 Scope: Retail only.

Scope

• •C_Map — Map data, coordinates, map IDs, areas
• •C_MapExplorationInfo — Fog of war / exploration data
• •C_AreaPoiInfo — Area Points of Interest
• •C_TaxiMap — Flight master/taxi routes
• •C_Vignette — Vignettes (rare mobs, treasures)
• •C_SuperTrackManager — Super tracking (waypoint tracking)
• •C_Navigation — In-game navigation system
• •C_ZoneAbility — Zone-specific abilities
• •C_FogOfWar — Fog of war system
• •Minimap — Minimap functions
• •C_NamePlateManager — Nameplate management

C_Map — Core Map System

Map Info & IDs

Map Types (Enum.UIMapType)

C_MapExplorationInfo — Exploration

C_AreaPoiInfo — Area Points of Interest

POI Info Fields

• •areaPoiID — Unique POI ID
• •position — {x, y} on map
• •name — Display name
• •description — Description text
• •textureIndex — POI icon index
• •atlasName — Atlas for icon
• •uiTextureKit — Texture kit
• •tooltipWidgetSet — Tooltip widget set
• •iconWidgetSet — Icon widget set
• •availableInPlayerChoice — Available in player choice

C_TaxiMap — Flight Paths / Taxi

C_Vignette — Vignettes (Rare Mobs, Treasures, Events)

Vignette Info Fields

• •vignetteGUID — Unique identifier
• •objectGUID — Object GUID (unit, object, etc.)
• •name — Display name
• •atlasName — Icon atlas
• •type — Vignette type (Normal, PvPBounty, Torghast, etc.)
• •isDead — Is the linked unit dead?
• •onWorldMap — Shows on world map?
• •onMinimap — Shows on minimap?
• •hasTooltip — Has mouseover tooltip?
• •inFogOfWar — In unexplored area?
• •widgetSetID — UI widget set

C_SuperTrackManager — Waypoint Super Tracking

C_Navigation — In-Game Navigation

C_ZoneAbility

C_FogOfWar

Minimap Functions

C_NamePlateManager / Nameplates

12.0.0 Note: Nameplates in instances are tightly restricted. Enemy nameplate unit tokens may expose only secret values for health, casting, etc.

Coordinate Conversion

Map Position Object

C_Map.GetPlayerMapPosition() returns a Vector2DMixin with:

local pos = C_Map.GetPlayerMapPosition(mapID, "player")
if pos then
    local x, y = pos:GetXY()
    -- x, y are 0-1 normalized coordinates on the map
    print(string.format("%.2f, %.2f", x * 100, y * 100))
end

Convert Between Maps

-- Get player position on the current best map
local mapID = C_Map.GetBestMapForUnit("player")
if mapID then
    local pos = C_Map.GetPlayerMapPosition(mapID, "player")
    if pos then
        -- Convert to world coordinates
        local continentID, worldPos = C_Map.GetWorldPosFromMapPos(mapID, pos)
        -- Convert back to a different map
        local otherMapID, otherPos = C_Map.GetMapPosFromWorldPos(continentID, worldPos)
    end
end

User Waypoint

-- Set a waypoint on the map
local mapID = C_Map.GetBestMapForUnit("player")
if C_Map.CanSetUserWaypointOnMap(mapID) then
    local point = UiMapPoint.CreateFromCoordinates(mapID, 0.5, 0.5)
    C_Map.SetUserWaypoint(point)
    C_SuperTrack.SetSuperTrackedUserWaypoint(true)
end

Key Events

Gotchas & Restrictions

1. •GetPlayerMapPosition returns nil — Returns nil for units in instances where position tracking is restricted or for invalid map IDs.
2. •Map coordinates are 0-1 normalized — Not world coordinates. Use GetWorldPosFromMapPos() to convert.
3. •uiMapID vs areaID — These are different ID systems. C_Map.GetAreaInfo() takes areaID, not uiMapID.
4. •Nameplate secrets in 12.0.0 — In instances, enemy nameplate unit data (health, casting, name) may be secret values.
5. •TakeTaxiNode hardware event — Requires a hardware event to execute (must be called from a click handler).
6. •Vignette GUIDs are transient — Vignette GUIDs change when you zone or reload. Don't persist them.
7. •Map group = floors — Dungeon maps with multiple floors use map groups. Each floor is a separate uiMapID in the group.
8. •Waypoint limit — Only one user waypoint can exist at a time. Setting a new one replaces the old.