[outdated] Replace usage of map* with zone*

[sirinsidiator]

Please do away with the mapId/index/name. They make some things like getting the mapType from a zoneIndex impossible and some of the functions are confusing at first because they do not return what one would expect.

* GetCurrentMapIndex()
** _Returns:_ *luaindex:nilable* _index_

This function could just be replaced by GetCurrentMapZoneIndex() which already returns the zoneIndex.

* GetCyrodiilMapIndex()
** _Returns:_ *luaindex:nilable* _index_

* GetImperialCityMapIndex()
** _Returns:_ *luaindex:nilable* _index_

These two should also just return the zoneIndex.

* GetMapNameByIndex(*luaindex* _mapIndex_)
** _Returns:_ *string* _mapName_

This one is nasty because mapName is not always the same as zoneName. Please consider just using the zone name instead and drop map name completely. GetMapName and GetPlayerLocationName are the same.

* GetNumMaps()
** _Returns:_ *integer* _numMaps_

This should become GetNumZones() and return the amount of zones. Currently there is no such function for zones and we have to use an ugly hack like this to get all zones:

local zoneIndex = 1
while true do
    local zoneName = GetZoneNameByIndex(zoneIndex)
    if(zoneName == "") then break end
    -- do something
    zoneIndex = zoneIndex + 1
end

* GetMapInfo(*luaindex* _index_)
** _Returns:_ *string* _name_, *[UIMapType|#UIMapType]* _mapType_, *[MapContentType|#MapContentType]* _mapContentType_, *integer* _zoneId_, *string* _description_

This function should take a zoneIndex and return an additional boolean "showInLocationTab". Nasty fact: the zoneId it returns is actually the mapId. Really confusing.

* GetZoneDescription(*integer* _zoneId_)
** _Returns:_ *string* _description_

This one takes the fake zoneId from the previous method to return the description. Not sure why it is even necessary.

* GetMapParentCategories(*luaindex* _index_)
** _Uses variable returns..._
** _Returns:_ *string* _categoryName_, *luaindex* _categoryIndex_

Should again just take the zoneIndex.

* WouldProcessMapClick(*number* _normalizedClickX_, *number* _normalizedClickY_)
** _Returns:_ *bool* _wouldProcess_, *luaindex:nilable* _resultingMapIndex_

Should return a zoneIndex.

Not sure if I missed any functions, but please consider this going forward.
In the meantime it would be very helpful if there were functions to get the mapType and mapContentType for a zoneId or maybe just to convert between mapIndex and zoneIndex.