API/v1/map_floor

Aus Guild Wars 2 Wiki
< API‎ | v1
Wechseln zu: Navigation, Suche
/v1/map_floor.json
HTTP-Methode
GET
Format
JSON
API-Version
Version 1


Gibt detaillierte Informationen über eine Kartenebene zurück.

Parameter[Bearbeiten]

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[Bearbeiten]

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:

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[Bearbeiten]

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]
            }
          ]
        }
      }
    }
  }
}