API/v1/map_floor

/v1/map_floor.json

HTTP-Methode

GET

Format

JSON

API-Version

Version 1

Gibt detaillierte Informationen über eine Kartenebene zurück.

Parameter

Pflichtparameter

• continent_id – ID des Kontinents, momentan nur 1 für "Tyria" und 2 für "Die Nebel"
• floor – ID der gewünschten Ebene

Optionale Parameter

• lang – Sprachenkürzel: de, en, es, fr (Standard: en)

Antwort

Die Antwort enthält ein Objekt mit folgenden Eigenschaften:

• texture_dims (array) – die Kartenabdeckung in X und Y
• clamped_view (array) - Falls vorhanden, ist ein Rechteck mit den Koordinaten der downloadbaren Texturen angegeben. Kacheln mit Koordinaten außerhalb dieses Rechtecks stehen nicht zum Download bereit.
• regions (object) – enthält Objekte, welche der region_id zugeordnet sind

Jedes regions-Objekt besitzt folgende Eigenschaften:

• name (string) – lokalisierter Name der Region
• label_coord (array) – Koordinaten der Regions-Beschriftung
• maps (object) – enthält Objekte, welche der map_id zugeordnet sind

Jedes maps-Objekt besitzt folgende Eigenschaften:

• name (string) – lokalisierter Name der Karte
• min_level (number) – minimale Stufe
• max_level (number) – maximale Stufe
• default_floor (number) – die Standard-floor_id für die Karte
• map_rect (array) – die Abmessungen der Karte
• continent_rect (array) – die Abmessungen der Karte innerhalb des Koordinatensystems des Kontinents
• points_of_interest (array) – ein Array von Objekten mit Informationen zu Sehenswürdigkeiten, Wegmarken and Vistas
• tasks (array) – ein Array von Objekten mit Informationen zu Aufgaben.
• skill_challenges (array) – ein Array von Objekten mit Informationen zu Heldenherausforderungen.
• sectors (array) – ein Array von Objekten mit Informationen zu den Gegenden

Jedes points_of_interest-Objekt enthält die folgenden Eigenschaften:

• poi_id (number) – die zugehörige ID
• name (string) – lokalisierter Name (leer im Falle von Vistas)
• type (string) – Typ, kann entweder landmark für Sehenswürdigkeiten, waypoint für Wegmarken oder vista für Vistas sein.
• floor (number) – die Ebene des Objekts
• coord (string) – die Koordinaten des Objekts

Jedes tasks-Objekt enthält die folgenden Eigenschaften:

• task_id (number) – ID der Aufgabe
• objective (string) – lokalisierter Name
• level (number) – die Stufe der Aufgabe
• coord (array) – die Koordinaten der Aufgabe (bzw. des Aufgaben-NPC)

Jedes skill_challenges-Objekt enthält die folgenden Eigenschaften:

• coord (array) – die Koordinaten der Heldenherausforderung

Jedes sectors-Objekt enthält die folgenden Eigenschaften:

• sector_id (number) – ID der Gegend
• name (string) – lokalisierter Name
• level (number) – Stufe der Gegend
• coord (array) – die Koordinaten der Gegend (üblicherweise der Mittelpunkt)

Anmerkungen

• texture_dims gibt Abmessungen in X und Y ausgehend von der oberen linken Ecke (NW) an.
• Arrays, welche Rechtecke angeben wie etwa clamped_view, enthalten 2 Arrays mit den Koordinaten der oberen linken (NW) und unteren rechten (SE) Ecke.
• Koordinatenangaben gehen idr. vom Nullpunkt der texture_dims aus, also +X nach rechts und +Y nach unten. map_rect bildet hier eine Ausnahme.
• das Koordinatensystem des map_rect wird ingame verwendet und muss zur Verwendung innerhalb der texture_dims umgerechnet werden (siehe auch im offiziellen Forum)

Beispiel

https://api.guildwars2.com/v1/map_floor.json?continent_id=2&floor=5&lang=de

{
  "texture_dims": [16384, 16384],
  "clamped_view": [
    [6782, 4604],
    [8318, 5758]
  ],
  "regions": {
    "6": {
      "name": "Spieler gegen Spieler",
      "label_coord": [2560, 5344],
      "maps": {
        "554": {
          "name": "Der Wald von Niflhel",
          "min_level": 0,
          "max_level": 0,
          "default_floor": 5,
          "map_rect": [
            [-12288, -6144],
            [12288, 9216]
          ],
          "continent_rect": [
            [7038, 4860],
            [8062, 5500]
          ],
          "points_of_interest": [
            {
              "poi_id": 1102,
              "name": "Sammelpunkt Blaues Team",
              "type": "waypoint",
              "floor": 5,
              "coord": [7446.2, 5307.14]
            },
            {
              "poi_id": 1103,
              "name": "Sammelpunkt Rotes Team",
              "type": "waypoint",
              "floor": 5,
              "coord": [7623.86, 5309.97]
            }
          ],
          "tasks": [],
          "skill_challenges": [],
          "sectors": [
            {
              "sector_id": 874,
              "name": "Eroberung: Wald",
              "level": 0,
              "coord": [7524.54, 5166.57]
            }
          ]
        }
      }
    }
  }
}