API:2/continents

From Guild Wars 2 Wiki
Jump to navigationJump to search

/v2/continents

HTTP method
GET
Format
json
API version
version 2
Release date
2015-02-13
Scope
none
Optional
none

This resource returns static information about the continents, floors, regions, maps, sectors, points of interest and tasks.

Parameters

Optional parameters
  • lang – The language to display the texts in.
    • Possible values:
en (English, default)
de (German)
es (Spanish)
fr (French)

Subresources

  • <continent_id>/floors
  • <continent_id>/floors/<floor_id>/regions
  • <continent_id>/floors/<floor_id>/regions/<region_id>/maps
  • <continent_id>/floors/<floor_id>/regions/<region_id>/maps/<map_id>/sectors
  • <continent_id>/floors/<floor_id>/regions/<region_id>/maps/<map_id>/pois
  • <continent_id>/floors/<floor_id>/regions/<region_id>/maps/<map_id>/tasks

Response

Top level continent information

If the root endpoint (/v2/continents) is accessed without specifying an id, a list of all ids is returned. 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 id of the continent.
  • name (string) – The name of the continent.
  • continent_dims (array of two numbers) – The width and height dimensions of the continent.
  • min_zoom (number) – The minimal zoom level for use with the map tile service.
  • max_zoom (number) – The maximum zoom level for use with the map tile service.
  • floors (list) – A list of floors ids available for this continent.

Note: There are only two continents, Tyria and Mists.

Floor and lower information

Requesting any resource by specifying a floor id will return all nested subresources too (i.e. specifying the floor id does not just return a list of the regions, it contains a list of all regions as well as all the floors, plus their the markers and sectors within each map). It is not therefore possible to acquire all data from both continents with a single endpoint request.

The first level contains the floor details:

  • texture_dims (dimension) – The dimensions of the texture.
  • clamped_view (rectangle) - If present, it represents a rectangle of downloadable textures. Every tile coordinate outside this rectangle is not available on the tile server.
  • regions (object) – A mapping from region id to an object.

Each region object contains the following properties:

  • name (string) – The region name.
  • label_coord (coordinate) – The coordinates of the region label.
  • continent_rect (rectangle) – The dimensions of the continent, expressed as top-left (NW) and bottom-right (SE) corner coordinates.
  • maps (object) – A mapping from the map id to an object.

Each map object contains the following properties:

  • name (string) – The map name.
  • min_level (number) – The minimum level of the map.
  • max_level (number) – The maximum level of the map.
  • default_floor (number) – The default floor of the map.
  • label_coord (coordinate) – The coordinates of the map label.
  • 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 top-left (NW) and bottom-right (SE) corner coordinates.
  • points_of_interest (list) – A list of points of interest (landmarks, waypoints, vistas, etc).
  • tasks (list) – A list of renown hearts.
  • skill_challenges (list) – A list of skill challenges.
  • sectors (list) – A list of areas within the map.
  • adventures (list) – A list of adventures within the map.
  • mastery_points (list) – A list of mastery insights within the map.

Each element of the points_of_interest list is an object with the following properties:

  • name (string) – The name of the point of interest.
  • type (string) – The type. This can be either "landmark" for actual points of interest, "waypoint" for waypoints, or "vista" for vistas. "unlock" is another less frequently used type, used for anything which is none of the previous three options.
  • floor (number) – The floor of this object.
  • coord (coordinate) – The coordinates of this object.
  • id (number) – The point of interest id.
  • chat_link (string) – The point of interest chat link.
  • icon - Only specified if the type is set to "unlock", provides the render service url for the object's icon.

Each element of the tasks list is an object with the following properties:

  • objective (string) – The objective or name of the heart.
  • level (number) – The level of the heart.
  • coord (coordinate) – The coordinates where it takes place.
  • bounds (list) – A list of coordinates marking the boundary of the heart.
  • id (number) – The renown heart id.
  • chat_link (string) – The renown heart chat link (provides an invalid link if attempting to display ingame).

Each element of the skill_challenges list is an object with the following properties:

  • coord (coordinate) – The coordinates of this hero challenge.
  • id (string) - The hero challenge id, formed of two numbers separated by a dash. The first number represents the expansion (0 for Core Tyria, 1 for Heart of Thorns and 2 for Path of Fire), and therefore could be used to change the hero challenge map marker icon. If the first number and dash prefix is removed from the string, the second number is no longer unique among other hero challenges.

Each element of the sectors list is an object with the following properties:

  • name (string) – The name of the area.
  • level (number) – The level of the area.
  • coord (coordinate) – The coordinates of this area (this is usually the center position).
  • bounds (list) – A list of coordinates marking the boundary of the area.
  • chat_link (string) – The area chat link (provides an invalid link if attempting to display ingame).
  • id (number) – The area id.

Each element of the adventures list is an object with the following properties:

  • coord (coordinate) – The coordinates of the start of the adventure.
  • id (string) – The adventure guid (token length 8-4-4-4-12 with a dash between each group of digits).
  • name (string) – The name of the adventure.
  • description (string) – The description of the adventure.

Each element of the mastery_points list is an object with the following properties:

  • coord (coordinate) – The coordinates of the mastery insight.
  • id (number) – The mastery insight id.
  • region (string) – The region of the mastery insight, which determines its color. Options: "Tyria" (core tyria, red), "Maguuma" (heart of thorns, green), "Desert" (path of fire, purple), "Tundra" (LWS5, blue)
Special types
  • Dimension properties are two-element lists of width and height.
  • 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/continents

[
  1,
  2
]

https://api.guildwars2.com/v2/continents?ids=1

[
  {
    "name": "Tyria",
    "continent_dims": [ 32768, 32768 ],
    "min_zoom": 0,
    "max_zoom": 7,
    "floors": [
      0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, -2, -3,
      -4, -5, -6, -7, -8, -9, -10, -11, -13, -14, -15, -16, 20, 21, 22, 23,
      24, 25, 26, 27, 28, 29, 30, 34, 36, 37, 40, 38, 39, 42, 44, 45
    ],
    "id": 1
  }
]

https://api.guildwars2.com/v2/continents/1

{
  "name": "Tyria",
  "continent_dims": [ 32768, 32768 ],
  "min_zoom": 0,
  "max_zoom": 7,
  "floors": [
    0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, -2, -3,
    -4, -5, -6, -7, -8, -9, -10, -11, -13, -14, -15, -16, 20, 21, 22, 23,
    24, 25, 26, 27, 28, 29, 30, 34, 36, 37, 40, 38, 39, 42, 44, 45
  ],
  "id": 1
}

https://api.guildwars2.com/v2/continents?ids=all

[
  {
    "name": "Tyria",
    "continent_dims": [ 32768, 32768 ],
    "min_zoom": 0,
    "max_zoom": 7,
    "floors": [
      0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, -2, -3,
      -4, -5, -6, -7, -8, -9, -10, -11, -13, -14, -15, -16, 20, 21, 22, 23,
      24, 25, 26, 27, 28, 29, 30, 34, 36, 37, 40, 38, 39, 42, 44, 45
    ],
    "id": 1
  },
  {
    "name": "Mists",
    "continent_dims": [ 16384, 16384 ],
    "min_zoom": 0,
    "max_zoom": 6,
    "floors": [
      1, 3, 5, 6, 7, 9, 10, 13, 14, 18, 19, 21, 22, 23, 24, 25, 26, 27, 28,
      29, 30, -27, -28, -29, -30, -31, 32
    ],
    "id": 2
  }
]

https://api.guildwars2.com/v2/continents/1/floors

[ 
  0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, -2, -3,
  -4, -5, -6, -7, -8, -9, -10, -11, -13, -14, -15, -16, 20, 21, 22, 23,
  24, 25, 26, 27, 28, 29, 30, 34, 36, 37, 40, 38, 39, 42, 44, 45
]

https://api.guildwars2.com/v2/continents/1/floors?ids=1

[
  {
    "texture_dims": [
      49152,
      49152
    ],
    "clamped_view": [
      [
        0,
        0
      ],
      [
        38000,
        48000
      ]
    ],
    "regions": {
      "1": {
        "name": "Shiverpeak Mountains",
        "label_coord": [19840, 13568],
        "continent_rect": [[17664, 8064], [23808, 21376]],
        "maps": {
          "26": {
            "name": "Dredgehaunt Cliffs",
            "min_level": 40,
            "max_level": 50,
            "default_floor": 1,
            "label_coord": [20608, 16576],
            "map_rect": [[-27648, -36864], [27648, 39936]],
            "continent_rect": [[19456, 14976], [21760, 18176]],
            "points_of_interest": {
              "554": {
                "name": "Leaning Grade",
                "type": "landmark",
                "floor": 1,
                "coord": [19889.7, 16594.8],
                "id": 554,
                "chat_link": "[&BCoCAAA=]"
              },
              "598": {
                "name": "Tribulation Waypoint",
                "type": "waypoint",
                "floor": 1,
                "coord": [20121.5, 17733.4],
                "id": 598,
                "chat_link": "[&BFYCAAA=]"
              },
              "1569": {
                "type": "vista",
                "floor": 1,
                "coord": [20371, 16003.8],
                "id": 1569,
                "chat_link": "[&BCEGAAA=]"
              },
              "1732": {
                "name": "Sorrow's Embrace",
                "type": "unlock",
                "floor": 1,
                "coord": [19676.3, 17719.4],
                "id": 1732,
                "chat_link": "[&BMQGAAA=]",
                "icon": "https://render.guildwars2.com/file/943538394A94A491C8632FBEF6203C2013443555/102478.png"
              }
            },
            "tasks": {
              "1": {
                "objective": "Assist Daphne in halting the encroaching corruption.",
                "level": 40,
                "coord": [19644.7, 16604.2],
                "bounds": [
                  [19879.3, 16376.9], [19825.6, 16330.5], [19758.2, 16334.6], [19597, 16428.5], [19547.8, 16495.6], [19545.2, 16681.1], [19584.7, 16912], [19675.6, 17092.4], [19965.5, 17061.1], [20156.7, 16814.3], [20036.3, 16537.6], [19879.3, 16376.9]
                ],
                "id": 1,
                "chat_link": "[&BAEAAAA=]"
              },
              ...
            },
            "skill_challenges": [
              {
                "coord": [
                  20381.6,
                  16613.8
                ],
                "id": "0-29"
              },
              ...
            ],
            "sectors": {
              "513": {
                "name": "Tribulation Rift",
                "level": 50,
                "coord": [
                  19816,
                  17914.8
                ],
                "bounds": [
                  [20190.2, 17907.2], [20069.4, 18061.1], [20072.8, 18275.1], [19871.2, 18310.9], [19599.6, 18257.9], [19683.3, 18120.9], [19607.3, 18060.1], [19611, 18004.7], [19688, 17952.2], [19675.4, 17787.7], [19617.3, 17745.2], [19632.6, 17696.1], [19719.6, 17659.5], [19718.7, 17620.1], [19841.8, 17617.6], [20108.6, 17705], [20165.4, 17769.8], [20190.2, 17907.2]
                ],
                "id": 513,
                "chat_link": "[&BAECAAA=]"
              },
              ...
            },
            "adventures": [],
            "id": 26,
            "mastery_points": [
              {
                "coord": [20422.8, 16848.3
                ],
                "id": 319,
                "region": "Tyria"
              }
            ]
          },
          "27": {
            "name": "Lornar's Pass",
            ...
          }
        },
        "id": 1
      },
      ...
      "20": {
        "name": "Ring of Fire",
        "label_coord": [5200, 26000],
        "continent_rect": [[17664, 8064], [23808, 21376]],
        "maps": {
          ...
        },
        "id": 20
      }
    },
    "id": 1
  }
]

Notes

  • Continents, regions, floors reported by API:2/maps often (predominantly for story instances) do not align with the available continents endpoint data. (ref)
  • Regions added to the game after core tyria have incorrect continent_rects specified. (ref)
  • Maps within the Crystal Desert have no information available on several of the floors suggested by API:2/maps, but are available on floor 49. (ref)
  • Many adventures are missing entirely. (ref)