API:2/maps
From Guild Wars 2 Wiki
< API:2
Jump to navigationJump to search
/v2/maps
- HTTP method
- GET
- Format
- json
- API version
- version 2
- Release date
- 2015-02-13
- Scope
- none
- Optional
- none
This resource returns details about maps in the game, including details about floor and translation data on how to translate between world coordinates and map coordinates.
Parameters
- Optional parameters
lang– Show localized texts in the specified language.
Response
If the root endpoint (/v2/maps) is accessed without specifying a map id, a list of all map ids is returned.
If a map id is specified (/v2/maps/<map_id>), the details for that map are returned as an object. When multiple ids are requested using the ids parameter, a list of response objects is returned.
For each requested continent id, an object with the following properties is returned:
id(number) – The map id.name(string) – The map name.min_level(number) – The minimal level of this map.max_level(number) – The maximum level of this map.default_floor(number) – The default floor of this map.type(string) – The map type. Possible values:BlueHome– The home borderlands of the blue worlds in WvW.Center– The map in WvW that resides in the center of the borderlands, Eternal Battlegrounds.EdgeOfTheMists– The Edge of the Mists map in WvW.GreenHome– The home borderlands of the green worlds in WvW.Instance– Instances.JumpPuzzle– At present only a WvW map that houses a jumping puzzle of the same name, Obsidian Sanctum.Public– Open world maps.Pvp– PvP as well as activity maps.RedHome– The home borderlands of the red worlds in WvW.Tutorial– The tutorial missions for newly created characters.Unknown
floors(array) – A list of available floors for this map.region_id(number) – The id of the region this map belongs to.region_name(string, optional) – The name of the region this map belongs to.continent_id(number) – The id of the continent this map belongs to.continent_name(string) – The name of the continent this map belongs to.map_rect(array) – The dimensions of the map, given as the coordinates of the lower-left (SW) and upper-right (NE) corners.continent_rect(array) – The dimensions of the map within the continent coordinate system, given as the coordinates of the upper-left (NW) and lower-right (SE) corners.
- Special types
- Coordinate properties are two-element lists of the x and y position.
- Rectangle properties are two-element lists of coordinates.
Example
https://api.guildwars2.com/v2/maps/15
{
"id": 15,
"name": "Queensdale",
"min_level": 1,
"max_level": 15,
"default_floor": 1,
"type": "Public",
"floors": [ 1, 65, 3, 2, 0 ],
"region_id": 4,
"region_name": "Kryta",
"continent_id": 1,
"continent_name": "Tyria",
"map_rect": [
[ -43008, -27648 ],
[ 43008, 30720 ]
],
"continent_rect": [
[ 9856, 11648 ],
[ 13440, 14080 ]
]
}
Notes
API bug:- Guild hall instances are in the API five times, once for each map cap (the maximum number of players allowed in the guild).
See also
- API:Maps — Help with map calculations and terminology
