Table of Contents

API - Cercare mappe Spatial Map

Questa interfaccia viene usata per cercare mappe Spatial Map. Tutti i parametri di ricerca sono facoltativi. Quando si usano più campi per la ricerca, il sistema collega le condizioni con logica "AND".

1. Informazioni di base dell'interfaccia

  • Indirizzo dell'interfaccia: https://armap-api-<cn1,na1>.easyar.com/map
  • 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, AppId e parametri 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 Query parameters

Tutti i parametri di ricerca sono facoltativi.

Nome parametro Tipo Obbligatorio Valore predefinito Descrizione
gps String No - Cerca mappe vicino a questa coordinata GPS.
range Number No 1.0 Intervallo di ricerca (unità: km). Deve essere usato insieme al parametro gps.
name String No - Cerca per nome mappa.
tag String No - Cerca per tag mappa.

4. Struttura dati della risposta (ARMapDTO)

Quando la richiesta ha successo (statusCode è 0), il result restituito contiene un array di oggetti mappa che soddisfano le condizioni.

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 Array Array contenente oggetti ARMapDTO.

Struttura dell'oggetto ARMapDTO

Nome campo Tipo Descrizione
mapId String Identificatore univoco della mappa.
name String Nome della mappa.
status String Stato attuale della mappa.
size Integer (int64) Dimensione del file della mappa.
gps String Informazioni sulle coordinate GPS associate alla mappa.
tag String Tag della mappa.
meta String Metadata personalizzati.
created DateTime Ora di creazione.
modified DateTime Ora dell'ultima modifica.

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.

Codici errore Status Code

6. Risposta di esempio (JSON)

{
  "statusCode": 0,
  "msg": "success",
  "timestamp": "2026-01-30T10:00:00Z",
  "result": [
    {
      "mapId": "e61db301-e80f-4025-b822-9a00eb48d8d2",
      "name": "office_scene",
      "status": "active",
      "gps": "121.4541,31.2221",
      "tag": "indoor"
    }
  ]
}