API:2/maps

From Guild Wars 2 Wiki
Jump to: navigation, 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.
  • 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": 17,
  "default_floor": 1,
  "floors": [ 0, 1, 2 ],
  "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

  • Guild hall instances are in the API five times, once for each map cap (the maximum number of players allowed in the guild).