Table of Contents

API —— ottenere l'URL di download dei metadati

Questa interfaccia viene utilizzata per ottenere le informazioni sulla risorsa di download dei metadati associati a una Spatial Map (mappa spaziale) tramite mapId.

1. Informazioni di base dell'interfaccia

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

2. Metodo di autenticazione

Questa interfaccia supporta due modalità di autenticazione:

  1. Autenticazione basata su Token:
    • Header: Authorization: [token]
    • Parametri: richiede AppId.
  2. Autenticazione basata su Firma (Signature):
    • Utilizza APIKey, APISecret e AppId per generare una firma di verifica.
    • Per l'algoritmo dettagliato di calcolo della firma, fare riferimento a Metodo di firma API Key.

3. Parametri della richiesta

3.1 Parametri del percorso (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 risultato result conterrà un oggetto Resource che punta al file dei metadati.

Struttura della risposta principale:

Nome campo Tipo Descrizione
statusCode Integer Codice di stato. 0 indica successo.
msg String Messaggio descrittivo dello stato.
timestamp DateTime Timestamp della risposta del server.
result Object Oggetto Map contenente l'array dei dati della mappa e informazioni di paginazione.

Struttura dell'oggetto Resource:

Nome campo Tipo Descrizione
filename String Nome del file dei metadati.
url Object (URL) Oggetto contenente informazioni dettagliate sull'URL di download (protocollo, host, percorso, ecc.).
file Object (File) Informazioni sugli attributi fisici del file (es. percorso, dimensione).
readable Boolean Indica se la risorsa è leggibile.
open Boolean Indica se la risorsa è attualmente aperta.

5. Codici di stato (Status Codes)

Codice HTTP Significato Spiegazione
200 OK Richiesta riuscita.
401 Unauthorized Autenticazione fallita, verificare il Token o la firma.
403 Forbidden Accesso alla risorsa non autorizzato.
404 Not Found Mappa o metadati specificati non trovati.

Spiegazione codici errore Status Code

6. Esempio di risposta (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
  }
}