地圖（Maps） · lua

These functions relate to[Maps](https://wow.gamepedia.com/Map "Map")and were reworked in[Patch 8.0.1](https://wow.gamepedia.com/Patch_8.0.1 "Patch 8.0.1"). [C\_Map.GetAreaInfo](https://wow.gamepedia.com/API_C_Map.GetAreaInfo "API C Map.GetAreaInfo")(areaID) - Returns a map subzone name. [C\_Map.GetBestMapForUnit](https://wow.gamepedia.com/API_C_Map.GetBestMapForUnit "API C Map.GetBestMapForUnit")("unitToken") - Returns the current UI map for the given unit. Only works for the player and party members. [C\_Map.GetBountySetMaps](https://wow.gamepedia.com/API_C_Map.GetBountySetMaps "API C Map.GetBountySetMaps")(bountySetID) - Returns the maps for a bounty. [C\_Map.GetFallbackWorldMapID](https://wow.gamepedia.com/API_C_Map.GetFallbackWorldMapID "API C Map.GetFallbackWorldMapID")() - Returns the world map id. [C\_Map.GetMapArtBackgroundAtlas](https://wow.gamepedia.com/API_C_Map.GetMapArtBackgroundAtlas "API C Map.GetMapArtBackgroundAtlas")(uiMapID) - Returns the background atlas for a map. [C\_Map.GetMapArtHelpTextPosition](https://wow.gamepedia.com/API_C_Map.GetMapArtHelpTextPosition "API C Map.GetMapArtHelpTextPosition")(uiMapID) - Returns the position for the "Click to Zoom In" hint text on flight maps. [C\_Map.GetMapArtID](https://wow.gamepedia.com/API_C_Map.GetMapArtID "API C Map.GetMapArtID")(uiMapID) - Returns the art for a (phased) map. [C\_Map.GetMapArtLayerTextures](https://wow.gamepedia.com/API_C_Map.GetMapArtLayerTextures "API C Map.GetMapArtLayerTextures")(uiMapID, layerIndex) - Returns the art layer textures for a map. [C\_Map.GetMapArtLayers](https://wow.gamepedia.com/API_C_Map.GetMapArtLayers "API C Map.GetMapArtLayers")(uiMapID) - Returns the art layers for a map. [C\_Map.GetMapBannersForMap](https://wow.gamepedia.com/API_C_Map.GetMapBannersForMap "API C Map.GetMapBannersForMap")(uiMapID) - Returns the poi banners for a map. [C\_Map.GetMapChildrenInfo](https://wow.gamepedia.com/API_C_Map.GetMapChildrenInfo "API C Map.GetMapChildrenInfo")(uiMapID \[, mapType\]\[, allDescendants\]) - Returns information on the sub-maps of the given uiMapID, optionally restricted to a specific "map type", and/or recursive. [C\_Map.GetMapDisplayInfo](https://wow.gamepedia.com/API_C_Map.GetMapDisplayInfo "API C Map.GetMapDisplayInfo")(uiMapID) - Returns whether group member pins should be hidden. [C\_Map.GetMapGroupID](https://wow.gamepedia.com/API_C_Map.GetMapGroupID "API C Map.GetMapGroupID")(uiMapID) - Returns the map group for a map. [C\_Map.GetMapGroupMembersInfo](https://wow.gamepedia.com/API_C_Map.GetMapGroupMembersInfo "API C Map.GetMapGroupMembersInfo")(uiMapGroupID) - Returns the floors for a map group. [C\_Map.GetMapHighlightInfoAtPosition](https://wow.gamepedia.com/API_C_Map.GetMapHighlightInfoAtPosition "API C Map.GetMapHighlightInfoAtPosition")(uiMapID, x, y) - Returns a map highlight pin for a location. [C\_Map.GetMapInfo](https://wow.gamepedia.com/API_C_Map.GetMapInfo "API C Map.GetMapInfo")(uiMapID) - Returns map information. [C\_Map.GetMapInfoAtPosition](https://wow.gamepedia.com/API_C_Map.GetMapInfoAtPosition "API C Map.GetMapInfoAtPosition")(uiMapID, x, y) - Returns map info for a location on the map. [C\_Map.GetMapLevels](https://wow.gamepedia.com/API_C_Map.GetMapLevels "API C Map.GetMapLevels")(uiMapID) - Returns the suggested player and battle pet levels for a map. [C\_Map.GetMapLinksForMap](https://wow.gamepedia.com/API_C_Map.GetMapLinksForMap "API C Map.GetMapLinksForMap")(uiMapID) - Returns the map pins that link to another map. [C\_Map.GetMapPosFromWorldPos](https://wow.gamepedia.com/API_C_Map.GetMapPosFromWorldPos "API C Map.GetMapPosFromWorldPos")(continentID, worldPosition \[, overrideUiMapID\]) - Translates a world map position to a map position. [C\_Map.GetMapRectOnMap](https://wow.gamepedia.com/API_C_Map.GetMapRectOnMap "API C Map.GetMapRectOnMap")(uiMapID, topUiMapID) - Returns the map rectangle location for a map on its parent map. [C\_Map.GetPlayerMapPosition](https://wow.gamepedia.com/API_C_Map.GetPlayerMapPosition "API C Map.GetPlayerMapPosition")(uiMapID, "unitToken") - Returns the location of the given unit. Only works for the player and party members. [C\_Map.GetWorldPosFromMapPos](https://wow.gamepedia.com/API_C_Map.GetWorldPosFromMapPos "API C Map.GetWorldPosFromMapPos")(uiMapID, mapPosition) - Translates a world map position to a map position. [C\_Map.MapHasArt](https://wow.gamepedia.com/API_C_Map.MapHasArt "API C Map.MapHasArt")(uiMapID) - Returns true if the map has art and can be displayed by the FrameXML. [C\_Map.RequestPreloadMap](https://wow.gamepedia.com/API_C_Map.RequestPreloadMap "API C Map.RequestPreloadMap")(uiMapID) - Preloads textures for a map. [C\_MapExplorationInfo.GetExploredAreaIDsAtPosition](https://wow.gamepedia.com/API_C_MapExplorationInfo.GetExploredAreaIDsAtPosition "API C MapExplorationInfo.GetExploredAreaIDsAtPosition")(uiMapID, normalizedPosition) - Returns the explored areas for the location on a map. [C\_MapExplorationInfo.GetExploredMapTextures](https://wow.gamepedia.com/API_C_MapExplorationInfo.GetExploredMapTextures "API C MapExplorationInfo.GetExploredMapTextures")(uiMapID) - Returns explored map textures for a map. [C\_FogOfWar.GetFogOfWarForMap](https://wow.gamepedia.com/API_C_FogOfWar.GetFogOfWarForMap "API C FogOfWar.GetFogOfWarForMap")(uiMapID) - Returns the fog of war ID for an (Island Expedition) map. [C\_FogOfWar.GetFogOfWarInfo](https://wow.gamepedia.com/API_C_FogOfWar.GetFogOfWarInfo "API C FogOfWar.GetFogOfWarInfo")(fogOfWarID) - Returns fog of war info for an (Island Expedition) map. [GetMinimapZoneText](https://wow.gamepedia.com/API_GetMinimapZoneText "API GetMinimapZoneText")() - Returns the zone text, that is displayed over the minimap. [GetPlayerFacing](https://wow.gamepedia.com/API_GetPlayerFacing "API GetPlayerFacing")() - Returns the direction the player is facing. [GetRealZoneText](https://wow.gamepedia.com/API_GetRealZoneText "API GetRealZoneText")(\[mapID\]) - Returns either instance name or zone name. [GetSubZoneText](https://wow.gamepedia.com/API_GetSubZoneText "API GetSubZoneText")() - Returns the subzone text (e.g. "The Canals"). [GetZonePVPInfo](https://wow.gamepedia.com/API_GetZonePVPInfo "API GetZonePVPInfo")() - Returns PVP info for the current zone. [GetZoneText](https://wow.gamepedia.com/API_GetZoneText "API GetZoneText")() - Returns the zone text (e.g. "Stormwind City"). [UnitPosition](https://wow.gamepedia.com/API_UnitPosition "API UnitPosition")("unit") - Returns the position of a unit within the current world area. UI[WorldMapFrame:AddDataProvider](https://www.townlong-yak.com/framexml/live/go/MapCanvasMixin:AddDataProvider)(dataProvider) - Adds a map data provider. UI[WorldMapFrame:GetMapID](https://www.townlong-yak.com/framexml/live/go/MapCanvasMixin:GetMapID)() - Returns the currently viewed world map. UI[WorldMapFrame:SetMapID](https://www.townlong-yak.com/framexml/live/go/MapCanvasMixin:SetMapID)(uiMapID) - Sets the world map. UI[WorldMapFrame:EnumerateAllPins](https://www.townlong-yak.com/framexml/live/go/MapCanvasMixin:EnumerateAllPins)() - Enumerates through all map pins. UI[MapUtil.GetMapParentInfo](https://www.townlong-yak.com/framexml/8.1.5/MapUtil.lua#9)(mapID, mapType \[, topMost\]) - Returns the parent map object. UI[MapUtil.GetDisplayableMapForPlayer](https://www.townlong-yak.com/framexml/8.1.5/MapUtil.lua#56)() - Returns the lowest map for a player that has valid map art. Points of Interest [C\_AreaPoiInfo.GetAreaPOIForMap](https://wow.gamepedia.com/API_C_AreaPoiInfo.GetAreaPOIForMap "API C AreaPoiInfo.GetAreaPOIForMap")(uiMapID) - Returns area points of interest for a map. [C\_AreaPoiInfo.GetAreaPOIInfo](https://wow.gamepedia.com/API_C_AreaPoiInfo.GetAreaPOIInfo "API C AreaPoiInfo.GetAreaPOIInfo")(uiMapID, areaPoiID) - Returns area point of interest info. [C\_AreaPoiInfo.GetAreaPOISecondsLeft](https://wow.gamepedia.com/API_C_AreaPoiInfo.GetAreaPOISecondsLeft "API C AreaPoiInfo.GetAreaPOISecondsLeft")(areaPoiID) - Returns the time left for an area poi. [C\_AreaPoiInfo.IsAreaPOITimed](https://wow.gamepedia.com/API_C_AreaPoiInfo.IsAreaPOITimed "API C AreaPoiInfo.IsAreaPOITimed")(areaPoiID) - Returns whether an area poi is timed. [GetPOITextureCoords](https://wow.gamepedia.com/index.php?title=API_GetPOITextureCoords&action=edit&redlink=1 "API GetPOITextureCoords (page does not exist)")(textureIndex) [SetPOIIconOverlapDistance](https://wow.gamepedia.com/index.php?title=API_SetPOIIconOverlapDistance&action=edit&redlink=1 "API SetPOIIconOverlapDistance (page does not exist)")(index) - Unused in FrameXML. [SetPOIIconOverlapPushDistance](https://wow.gamepedia.com/index.php?title=API_SetPOIIconOverlapPushDistance&action=edit&redlink=1 "API SetPOIIconOverlapPushDistance (page does not exist)")(index) - Unused in FrameXML. DEPRECATED (8.1.0)[C\_AreaPoiInfo.GetAreaPOITimeLeft](https://wow.gamepedia.com/API_C_AreaPoiInfo.GetAreaPOITimeLeft "API C AreaPoiInfo.GetAreaPOITimeLeft")(areaPoiID) These functions relate to[Vignettes](https://wow.gamepedia.com/Vignette "Vignette"). [C\_VignetteInfo.FindBestUniqueVignette](https://wow.gamepedia.com/API_C_VignetteInfo.FindBestUniqueVignette "API C VignetteInfo.FindBestUniqueVignette")(vignetteGUIDs) [C\_VignetteInfo.GetVignetteInfo](https://wow.gamepedia.com/API_C_VignetteInfo.GetVignetteInfo "API C VignetteInfo.GetVignetteInfo")("vignetteGUID") [C\_VignetteInfo.GetVignettePosition](https://wow.gamepedia.com/API_C_VignetteInfo.GetVignettePosition "API C VignetteInfo.GetVignettePosition")("vignetteGUID", uiMapID) [C\_VignetteInfo.GetVignettes](https://wow.gamepedia.com/API_C_VignetteInfo.GetVignettes "API C VignetteInfo.GetVignettes")()