API:2/maps

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:

Continents, regions, floors reported by this endpoint often (predominantly for story instances) do not align with the available /v2/continents endpoint data. (ref)