API - Download-Adresse der meta-Daten abrufen

Diese Schnittstelle wird verwendet, um über mapId die Download-Ressourceninformationen der mit der angegebenen Spatial Map verknüpften metadata (meta) abzurufen.

1. Grundlegende Schnittstelleninformationen

• Schnittstellenadresse: https://armap-api-<cn1,na1>.easyar.com/map/meta/{mapId}
• Anforderungsmethode: GET
• Antwortformat: */* (normalerweise application/json)

2. Authentifizierungsmethode

Diese Schnittstelle unterstützt die folgenden zwei Authentifizierungsmodi:

1. Token-basierte Authentifizierung:
   • Header: Authorization: [token]
   • Parameter: AppId muss enthalten sein.
2. Signaturbasierte (Signature) Authentifizierung:
   • Verwenden Sie APIKey, APISecret und AppId, um eine Signatur zur Prüfung zu generieren.
   • Den detaillierten Algorithmus zur Signaturberechnung finden Sie unter API Key-Signaturmethode.

3. Anforderungsparameter

3.1 Path parameters

Parametername	Typ	Erforderlich	Beschreibung
mapId	String	Ja	Eindeutige Kennung der räumlichen Karte (MapId).

4. Antwortdatenstruktur (Resource)

Wenn die Anforderung erfolgreich ist (statusCode ist 0), enthält das zurückgegebene result ein Resource-Objekt, das auf die metadata-Datei verweist.

Feldname	Typ	Beschreibung
statusCode	Integer	Statuscode. 0 bedeutet Erfolg.
msg	String	Statusbeschreibungsinformationen.
timestamp	DateTime	Zeitstempel der Serverantwort.
result	Object	Map-Objekt, das das Kartendatenarray und Paginierungsstatistiken enthält.

Resource-Objektstruktur:

Feldname	Typ	Beschreibung
filename	String	Dateiname der metadata-Datei.
url	Object (URL)	Objekt mit detaillierten Download-Adressinformationen wie protocol, host und path.
file	Object (File)	Physische Eigenschaftsinformationen der Datei, z. B. path und size.
readable	Boolean	Ob diese Ressource lesbar ist.
open	Boolean	Ob diese Ressource derzeit geöffnet ist.

5. Status codes

Http Code	Bedeutung	Beschreibung
200	OK	Anforderung erfolgreich.
401	Unauthorized	Authentifizierung fehlgeschlagen. Prüfen Sie Token oder Signatur.
403	Forbidden	Keine Berechtigung zum Zugriff auf diese Ressource.
404	Not Found	Die angegebene Karte oder metadata wurde nicht gefunden.

Status Code-Fehlercodes

• Beschreibung der Fehlercodes für Sparse Spatial Map APIs

6. Beispielantwort (JSON)

{
  "statusCode": 0,
  "msg": "success",
  "timestamp": "2026-01-30T10:00:00Z",
  "result": {
    "filename": "map_metadata.json",
    "url": {
      "protocol": "https",
      "host": "armap-api-cn1.easyar.com",
      "path": "/download/path/to/meta",
      "query": "token=..."
    },
    "readable": true,
    "open": false
  }
}