API —— Mise à jour des informations de carte Spatial Map

Cette interface met à jour les informations de la carte via le mapId spécifié. Elle prend en charge une mise à jour de type HTTP PATCH, c'est-à-dire que seuls les paramètres fournis dans la requête sont modifiés, les paramètres non fournis restent inchangés.

1. Informations de base de l'interface

• URL de l'interface : https://armap-api-<cn1,na1>.easyar.com/map/{mapId}
• Méthode de requête : PUT
• Format de requête : multipart/form-data
• Format de réponse : */* (généralement application/json)

2. Méthode d'authentification

Cette interface prend en charge deux modes d'authentification :

1. Authentification basée sur Token :
   • Header : Authorization: [token]
   • Paramètre : Doit inclure AppId.
2. Authentification basée sur la signature (Signature) :
   • Utilise APIKey, APISecret, AppId et les paramètres pour générer une signature de vérification.
   • Pour l'algorithme détaillé de calcul de la signature, reportez-vous à Méthode de signature API Key.

3. Paramètres de requête

3.1 Paramètres de chemin (Path Parameters)

Nom du paramètre	Type	Obligatoire	Description
mapId	String	Oui	Identifiant unique de la carte spatiale (MapId).

3.2 Paramètres de formulaire (Form Parameters)

En raison du format multipart/form-data, les paramètres suivants doivent être soumis via des champs de formulaire.

Nom du paramètre	Type	Obligatoire	Description
file	Fichier	Non	Nouveau fichier de données de carte.
name	String	Non	Nom d'affichage de la carte.
gps	String	Non	Coordonnées GPS associées à la carte (ex : "121.4541,31.2221").
tag	String	Non	Étiquette de la carte.
meta	String	Non	Métadonnées personnalisées (généralement une chaîne encodée en Base64).
clusterInfo	String	Non	Informations relatives au cluster.
emeBlocklist	String	Non	Configuration de la liste noire EME, par défaut "[]".

4. Structure des données de réponse (ARMapDTO)

Lorsque la requête réussit (statusCode est 0), le résultat result contiendra les détails de l'objet carte mis à jour.

Nom du champ	Type	Description
statusCode	Integer	Code d'état. 0 indique le succès.
msg	String	Message descriptif de l'état.
timestamp	DateTime	Horodatage de la réponse du serveur.
result	Object	Objet ARMapDTO mis à jour.

Structure de l'objet ARMapDTO

Nom du champ	Type	Description
mapId	String	Identifiant unique de la carte.
name	String	Nom de la carte.
status	String	État actuel de la carte.
size	Integer (int64)	Taille du fichier de carte (en octets).
gps	String	Informations de coordonnées GPS associées à la carte.
tag	String	Étiquette de la carte.
meta	String	Métadonnées personnalisées.
md5	String	Code de vérification MD5 du fichier de carte mis à jour.
modified	DateTime	Dernière heure de modification.

5. Codes d'état (Status Codes)

Code Http	Signification	Explication
200	OK	Requête réussie.
201	Created	Mise à jour réussie et enregistrements associés créés.
401	Unauthorized	Échec de l'authentification, vérifiez le Token ou la signature.
403	Forbidden	Accès non autorisé à la ressource.
404	Not Found	mapId spécifié introuvable.

Explication des codes d'erreur Status Code

• Explication des codes d'erreur des APIs de cartes spatiales éparses

6. Exemple de réponse (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"
  }
}