Table of Contents

API - Ottenere l'indirizzo di download dei dati meta

Questa interfaccia viene usata per ottenere, tramite mapId, le informazioni della risorsa di download dei metadata (meta) associati alla Spatial Map specificata.

1. Informazioni di base dell'interfaccia

  • Indirizzo dell'interfaccia: https://armap-api-<cn1,na1>.easyar.com/map/meta/{mapId}
  • Metodo di richiesta: GET
  • Formato di risposta: */* (di solito application/json)

2. Metodo di autenticazione

Questa interfaccia supporta le due modalità di autenticazione seguenti:

  1. Autenticazione basata su Token:
    • Header: Authorization: [token]
    • Parametro: deve includere AppId.
  2. Autenticazione basata su firma (Signature):
    • Usare APIKey, APISecret e AppId per generare una firma per la verifica.
    • Per l'algoritmo dettagliato di calcolo della firma, fare riferimento a metodo di firma API Key.

3. Parametri di richiesta

3.1 Path parameters

Nome parametro Tipo Obbligatorio Descrizione
mapId String Sì Identificatore univoco della mappa spaziale (MapId).

4. Struttura dati della risposta (Resource)

Quando la richiesta ha successo (statusCode è 0), il result restituito contiene un oggetto Resource che punta al file metadata.

Nome campo Tipo Descrizione
statusCode Integer Codice di stato. 0 indica successo.
msg String Informazioni descrittive dello stato.
timestamp DateTime Timestamp della risposta del server.
result Object Oggetto Map che contiene l'array di dati della mappa e le statistiche di paginazione.

Struttura dell'oggetto Resource:

Nome campo Tipo Descrizione
filename String Nome del file metadata.
url Object (URL) Oggetto che contiene informazioni dettagliate sull'indirizzo di download, come protocol, host e path.
file Object (File) Informazioni sulle proprietà fisiche del file, come path e size.
readable Boolean Se la risorsa è leggibile.
open Boolean Se la risorsa è attualmente aperta.

5. Status codes

Http Code Significato Descrizione
200 OK Richiesta riuscita.
401 Unauthorized Autenticazione non riuscita. Controllare Token o firma.
403 Forbidden Nessuna autorizzazione ad accedere a questa risorsa.
404 Not Found La mappa o i metadata specificati non sono stati trovati.

Codici errore Status Code

6. Risposta di esempio (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
  }
}