API:1/maps

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v1/maps.json

HTTP method
GET
Format
json
API version
version 1
Release date
?
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
  • map_id – Only list this map.
  • lang – Show localized texts in the specified language.

Response

The response is an object with the single property maps which contains an object where map ids are mapped to an object, containing the following properties:

  • map_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 (list) – A list of available floors for this map.
  • region_id (number) – The id of the region this map belongs to.
  • region_name (string) – 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 (rectangle) – The dimensions of the map, given as the coordinates of the lower-left (SW) and upper-right (NE) corners.
  • continent_rect (rectangle) – 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/v1/maps.json?map_id=15

{
  "maps": {
    "15": {
      "map_name": "Queensdale",
      "min_level": 1,
      "max_level": 15,
      "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 ]
      ]
    }
  }
}