API —— Obtenir l'URL de téléchargement des métadonnées

Cette interface permet d'obtenir les informations de ressource de téléchargement des métadonnées (meta) associées à une carte spatiale spécifique via son mapId.

1. Informations de base sur l'interface

• URL 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 deux modes d'authentification :

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

3. Paramètres de la 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).

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

Lorsque la requête réussit (statusCode = 0), le résultat result contiendra un objet Resource pointant vers le fichier de métadonnées.

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 Map contenant le tableau de données de carte et les informations de pagination.

Structure de l'objet Resource :

Nom du champ	Type	Description
filename	String	Nom du fichier de métadonnées.
url	Object (URL)	Objet contenant les détails de l'URL de téléchargement (protocole, hôte, chemin, etc.).
file	Object (File)	Informations sur les attributs physiques du fichier (chemin, taille, etc.).
readable	Boolean	Indique si la ressource est lisible.
open	Boolean	Indique si la ressource est actuellement ouverte.

5. Codes d'état (Status Codes)

Code HTTP	Signification	Explication
200	OK	Requête réussie.
401	Unauthorized	Échec de l'authentification. Vérifiez le token ou la signature.
403	Forbidden	Accès non autorisé à la ressource.
404	Not Found	Carte ou métadonnées spécifiées introuvables.

Codes d'erreur Status Code

• Explication des codes d'erreur des APIs de carte spatiale éparse

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