wow-api-map-navigation（WOW API MAP navigation 搜索）

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.