API: Spatial Map-Informationen aktualisieren

Diese API aktualisiert Karteninformationen über die angegebene mapId. Sie unterstützt eine Aktualisierung ähnlich HTTP PATCH: Nur die in der Anfrage bereitgestellten Parameter werden geändert, nicht bereitgestellte Parameter bleiben unverändert.

1. Grundlegende API-Informationen

API-Adresse: https://armap-api-<cn1,na1>.easyar.com/map/{mapId}
Anfragemethode: PUT
Anfrageformat: multipart/form-data
Antwortformat: */* (normalerweise application/json)

2. Authentifizierung

Diese API unterstützt die folgenden zwei Authentifizierungsmodi:

Token-basierte Authentifizierung:
- Header: Authorization: [token]
- Parameter: AppId muss enthalten sein.
Signature-basierte Authentifizierung:
- Verwenden Sie APIKey, APISecret, AppId und Parameter, um eine signature zur Prüfung zu erzeugen.
- Den detaillierten Algorithmus zur Berechnung der signature finden Sie unter API Key-Signaturmethode.

3. Anfrageparameter

3.1 Path-Parameter (Path Parameters)

Parametername	Typ	Erforderlich	Beschreibung
mapId	String	Ja	Eindeutige Kennung der Spatial Map (MapId).

3.2 Formularparameter (Form Parameters)

Da multipart/form-data verwendet wird, müssen die folgenden Parameter als Formularfelder übermittelt werden.

Parametername	Typ	Erforderlich	Beschreibung
file	File	Nein	Neue Kartendatendatei.
name	String	Nein	Anzeigename der Karte.
gps	String	Nein	Mit der Karte verknüpfte GPS-Koordinaten, z. B. "121.4541,31.2221".
tag	String	Nein	Karten-Tag.
meta	String	Nein	Benutzerdefinierte Metadaten, normalerweise eine Base64-codierte Zeichenfolge.
clusterInfo	String	Nein	Clusterbezogene Informationen.
emeBlocklist	String	Nein	EME-Blocklist-Konfiguration. Standard ist "[]".

4. Antwortdatenstruktur (ARMapDTO)

Bei erfolgreicher Anfrage (statusCode ist 0) enthält das zurückgegebene result Details des aktualisierten Kartenobjekts.

Feldname	Typ	Beschreibung
statusCode	Integer	Statuscode. 0 bedeutet Erfolg.
msg	String	Statusbeschreibung.
timestamp	DateTime	Server-Antwortzeitstempel.
result	Object	Aktualisiertes `ARMapDTO`-Objekt.

ARMapDTO-Objektstruktur

Feldname	Typ	Beschreibung
mapId	String	Eindeutige Kartenkennung.
name	String	Kartenname.
status	String	Aktueller Kartenstatus.
size	Integer (int64)	Kartendateigröße in Byte.
gps	String	Mit der Karte verknüpfte GPS-Koordinateninformationen.
tag	String	Karten-Tag.
meta	String	Benutzerdefinierte Metadaten.
md5	String	MD5-Prüfsumme der aktualisierten Kartendatei.
modified	DateTime	Zeit der letzten Änderung.

5. Statuscodes

Http Code	Bedeutung	Hinweise
200	OK	Anfrage erfolgreich.
201	Created	Aktualisierung erfolgreich und zugehöriger Datensatz erstellt.
401	Unauthorized	Authentifizierung fehlgeschlagen. Prüfen Sie Token oder signature.
403	Forbidden	Keine Berechtigung zum Zugriff auf diese Ressource.
404	Not Found	Die angegebene `mapId` wurde nicht gefunden.

Status Code-Fehlercodes

Beschreibung der Statuscodes der Sparse Spatial Map APIs

6. Beispielantwort (JSON)

{
  "statusCode": 0,
  "msg": "success",
  "timestamp": "2026-01-30T10:00:00Z",
  "result": {
    "mapId": "e61db301-e80f-4025-b822-9a00eb48d8d2",
    "name": "updated_office_scene",
    "status": "active",
    "gps": "121.4541,31.2221",
    "modified": "2026-01-30T10:00:00Z"
  }
}

Table of Contents