API - Obtenir l'adresse de téléchargement des données meta

Cette interface sert à obtenir, via mapId, les informations de ressource de téléchargement des metadata (meta) associées à la Spatial Map spécifiée.

1. Informations de base de l'interface

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

2. Méthode d'authentification

Cette interface prend en charge les deux modes d'authentification suivants:

1. Authentification basée sur Token:
   • Header: Authorization: [token]
   • Paramètre: AppId doit être inclus.
2. Authentification basée sur la signature (Signature):
   • Utilisez APIKey, APISecret et AppId pour générer une signature pour la vérification.
   • Pour l'algorithme détaillé de calcul de signature, consultez méthode de signature API Key.

3. Paramètres de requête

3.1 Path parameters

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

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

Lorsque la requête réussit (statusCode vaut 0), le result renvoyé contient un objet Resource pointant vers le fichier metadata.

Nom du champ	Type	Description
statusCode	Integer	Code d'état. 0 indique la réussite.
msg	String	Informations de description de l'état.
timestamp	DateTime	Horodatage de la réponse du serveur.
result	Object	Objet Map contenant le tableau des données de carte et les statistiques de pagination.

Structure de l'objet Resource:

Nom du champ	Type	Description
filename	String	Nom du fichier metadata.
url	Object (URL)	Objet contenant les informations détaillées de l'adresse de téléchargement, comme protocol, host et path.
file	Object (File)	Informations de propriétés physiques du fichier, telles que path et size.
readable	Boolean	Indique si cette ressource est lisible.
open	Boolean	Indique si cette ressource est actuellement ouverte.

5. Status codes

Http Code	Signification	Description
200	OK	Requête réussie.
401	Unauthorized	Échec de l'authentification. Vérifiez le Token ou la signature.
403	Forbidden	Aucun droit d'accès à cette ressource.
404	Not Found	La carte ou les metadata spécifiées sont introuvables.

Codes d'erreur Status Code

• Description des codes d'erreur de Sparse Spatial Map APIs

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