Manuale Utente

1. Introduzione

Mappa Facile è una piattaforma cloud per professionisti che usano i droni nel proprio lavoro. In un unico ambiente potete:

• Pianificare la missione di volo su mappa, con griglia di waypoint generata automaticamente, terreno reale e zone D-Flight.
• Eseguire il volo con il vostro drone (esportando il piano in DJI WPML, Litchi CSV, KML o GeoJSON).
• Caricare le immagini e ottenere — senza installare software locale — ortofoto, modelli 3D, nuvole di punti, DSM e DTM.
• Analizzare i risultati su mappa con strumenti GIS integrati (misure, buffer, change detection, statistiche spaziali).

L’elaborazione fotogrammetrica avviene su server dedicati: il vostro computer non deve fare i calcoli. Una volta caricate le immagini, potete chiudere il browser; al termine ricevete una notifica e tornate sui risultati.

2. Account e accesso

2.1 Registrazione

Per registrarvi cliccate Crea un nuovo account dalla home oppure aprite direttamente /signup. Compilate:

• Nome (visualizzato nel profilo).
• Email (sarà l’identificativo di login).
• Password.
• Lingua preferita (italiano / inglese).

Se la piattaforma è in modalità beta compaiono anche due sezioni dedicate:

• Candidatura beta — un’introduzione testuale (minimo 50 caratteri) in cui spiegate chi siete e come usereste Mappa Facile. È obbligatoria ed è letta da un amministratore.
• Profilo social (facoltativo) — link al vostro profilo X, Instagram, Facebook, YouTube, LinkedIn, TikTok o sito web personale/aziendale. Non sono pubblici di default e potete aggiornarli in qualsiasi momento.

2.2 Verifica email

Subito dopo la registrazione ricevete un’email con un link di verifica. Aprendolo confermate l’indirizzo e attivate l’account. Senza verifica non potete accedere alle aree riservate.

2.3 Login

Da /login inserite email e password. Se siete reindirizzati a una pagina protetta (es. /jobs) dopo il login tornerete automaticamente alla pagina che stavate provando ad aprire.

2.4 Reimpostare la password

Sulla pagina di login cliccate Reimposta password: inserite l’email e ricevete un messaggio con un link valido a tempo. Aprendolo accedete a /reset-password e impostate una nuova password. La sessione corrente non viene chiusa automaticamente: per revocare le altre sessioni andate in Impostazioni → Sessioni.

2.5 Modalità beta

Mappa Facile può essere in modalità beta: in questa fase la registrazione è libera ma l’accesso richiede l’approvazione di un amministratore.

Mentre siete in attesa, dopo aver verificato l’email vedete la pagina /auth/beta-pending con:

• Lo stato della candidatura (In attesa, Approvata,Non approvata).
• Il testo dell’introduzione che avete inviato.
• Le note del revisore in caso di rifiuto.
• Un controllo automatico ogni 30 secondi che aggiorna lo stato.

3. La dashboard

La dashboard (/dashboard) è la prima pagina che vedete dopo il login. Riassume in colpo d’occhio l’attività dell’account.

Metriche principali

• Totale Job — quanti lavori avete creato.
• Job Attivi — in coda, in upload o in elaborazione.
• Completati e Falliti.
• Crediti — saldo disponibile.
• Spazio — somma delle dimensioni degli artifact.
• Questo Mese — job creati nel mese corrente.

Job attivo in evidenza

Se avete un lavoro in corso, una card mostra nome, stato (In attesa / Caricamento / Elaborazione) e un link diretto al dettaglio.

Azioni rapide

Otto scorciatoie verso le funzioni più usate: Crea nuovo job, Tutti i job, Pianifica missione, I miei piani di volo, Apri mappa, Strumenti GIS, Analisi avanzata, Statistiche utilizzo.

Job recenti e Storico crediti

Le ultime 5 voci di ciascuna lista, con link «Vedi tutti» per le pagine complete.

4. Lavori (Job)

Un Job è un singolo lavoro di elaborazione: un set di immagini drone caricate insieme, un tipo di processing scelto, e gli artifact prodotti al termine. È il concetto centrale della piattaforma.

4.1 Creare un nuovo job

Da Dashboard → Crea nuovo job oppure da/jobs cliccate Crea Job. Compilate:

• Nome job (obbligatorio, es. «Mappatura cantiere Milano»).
• Descrizione (opzionale; visibile solo a voi).
• Tipo di elaborazione (sei opzioni con costi diversi — vedi tabella seguente).

Sotto al modulo, l’anteprima costo mostra quanti crediti verranno usati e quanti ne avete in saldo.

4.2 Tipi di elaborazione e costi

Il costo è fisso per tipo di elaborazione e non dipende dal numero di immagini caricate.

4.3 Caricare le immagini

Dopo aver creato il job vedete l’area di caricamento. Potete:

• Trascinare i file dalla finestra del sistema operativo (drag & drop), oppure
• Cliccare l’area per aprire il selettore file.

Una barra di avanzamento mostra l’upload di ogni file. Quando tutti sono saliti, cliccate Avvia elaborazione.

Formati e regole

4.4 Monitorare lo stato

Aprendo un job (/jobs/[id]) vedete lo stato in tempo reale. Gli stati possibili sono:

• Bozza (draft) — appena creato, non ancora avviato. Le bozze non avviate scadono dopo 30 giorni.
• In attesa (pending) — in coda al backend.
• Caricamento (uploading) — upload immagini al server di processing.
• In elaborazione (processing) — fotogrammetria in corso. Lo stato si aggiorna automaticamente ogni 5 secondi.
• Completato (completed) — risultati pronti.
• Fallito (failed) — errore nel processing.
• Annullato (cancelled) — interrotto dall’utente o dall’amministratore.

4.5 Risultati e artifact

Quando un job è completato, la sezione Artifactelenca i file prodotti. A seconda del tipo di elaborazione potete trovare:

4.6 Eliminare e riprovare un job

Sulla pagina di dettaglio trovate due pulsanti:

• Elimina Job — rimuove il job e i suoi artifact in modo permanente. I crediti già addebitati non vengono restituiti automaticamente; per richieste di rimborso scrivete all’assistenza.
• Riprova Job — disponibile sui job falliti: ricarica le stesse immagini e rilancia l’elaborazione.

4.7 Limiti e regole

• Massimo 3 job concorrenti per utente (i draft non contano). Se siete al limite, attendete il completamento o annullate un job in coda.
• I draft non avviati scadono dopo 30 giorni.
• Per creare un job serve saldo crediti maggiore di zero; l’addebito effettivo avviene a completamento.

5. Pianificazione voli

L’editor in /flight-planning è un planner cartografico completo: disegnate l’area, scegliete drone e parametri, ottenete una griglia di waypoint pronta da esportare al radiocomando.

5.1 Disegnare l’area di interesse

Sulla mappa (default centrata su Roma) usate la toolbar di disegno:

• Disegna area — cliccate sui vertici del poligono.
• Annulla ultimo punto — torna indietro di un vertice.
• Chiudi poligono — finalizza l’area.
• Cancella tutto — pulisce la mappa.
• Imposta / Sposta / Rimuovi punto di decollo — il waypoint di partenza, da cui parte la pianificazione.

Lo stile mappa si cambia in qualsiasi momento: Stradale, Satellite, Ibrida, Topografica, Outdoor, Chiara, Scura.

5.2 Drone e fotocamera

Selezionate il vostro drone dal catalogo oppure inserite specifiche personalizzate:

• Lunghezza focale (mm)
• Dimensione del sensore (mm)
• Risoluzione immagine (pixel)
• Field of View (FOV)
• Inclinazione gimbal (pitch)

Questi valori determinano l’impronta a terra e la GSD risultante.

5.3 Preset di missione

Per partire rapidamente, scegliete un preset coerente con l’obiettivo:

• Ortomosaico 2D
• Modello 3D
• Facciata (volo verticale a parete)
• Ispezione
• Copertura rapida
• Pannelli solari
• Ispezione tetti
• Cumuli / volumi
• Agricoltura

Ogni preset imposta in automatico parametri sensati (sovrapposizione, altitudine, direzione di volo); restano comunque modificabili.

5.4 Parametri di missione

• Altitudine (metri sopra il punto di decollo).
• Velocità di crociera (m/s).
• Sovrapposizione frontale (%) — tra scatti successivi della stessa strisciata.
• Sovrapposizione laterale (%) — tra strisciate adiacenti.
• Direzione di volo in gradi.

5.5 Statistiche di volo

Aggiornate in tempo reale ad ogni modifica dei parametri:

• Numero di waypoint
• Tempo stimato di volo
• Numero di immagini
• Distanza totale
• Area coperta
• GSD (cm/pixel)
• Impronta della singola immagine

5.6 Altitudine adattiva al terreno

Attivando l’opzione Altitudine adattiva, la quota di ogni waypoint viene calcolata rispetto al terreno reale: la piattaforma interroga un modello di elevazione SRTM ad alta risoluzione e adatta i waypoint per mantenere costante l’altitudine sul suolo. Utile su rilievi, pendii e terreni accidentati.

Il Profilo altitudine è un grafico che mostra la quota di volo dei waypoint sovrapposta al profilo del terreno: vi permette di verificare a colpo d’occhio se ci sono waypoint troppo bassi.

5.7 Spazio aereo D-Flight

L’overlay D-Flight mostra le zone di restrizione ufficiali italiane:

• Filtro per quota: Tutte, ≤ 60 m, ≤ 45 m, ≤ 25 m, Solo no-fly.
• Zone NOTAM temporanee.
• Tag di deroga per indicare se avete autorizzazioni specifiche per quella zona (informativo, non sostituisce la documentazione ufficiale).

5.8 Importazione log telemetria

Potete importare un log di telemetria da un volo già eseguito (max 5 MB) per visualizzarne la traccia sulla mappa, ad esempio per replicare lo stesso percorso o per documentare un volo passato.

5.9 Salvare ed esportare

Cliccando Salva piano assegnate nome e descrizione e lo trovate in I miei piani di volo. Da lì potete esportarlo nei seguenti formati:

6. I miei piani di volo

La libreria personale (/flight-plans) raccoglie tutti i piani salvati. È paginata e dotata di:

• Ricerca per nome.
• Filtro stato: Bozza, Attivo, Archiviato.
• Ordinamento: nome, data, area.

Per ciascun piano vedete nome, area coperta, numero di waypoint, tempo stimato. Le azioni disponibili sono:

• Modifica — riapre il planner pre-caricato.
• Duplica — crea una copia indipendente.
• Elimina.
• Esporta nei formati indicati al punto 5.9.

7. Mappa lavori

La pagina Mappa (/map) plotta tutti i vostri job sulla cartografia. Ogni job appare al posto giusto perché i bounds spaziali vengono ricavati dall’ortofoto al termine dell’elaborazione.

Filtri

• Per stato del job.
• Per intervallo di date di creazione.
• Per bounding box della vista corrente.
• Per raggio intorno a un punto.

Livelli

• Lavori (puntini con stato a colori).
• Piani di Volo.
• Immagini (i singoli scatti).
• Overlay ortofoto con cursore di opacità.
• Rilevamenti AI (quando disponibili).
• Spazio aereo D-Flight.

8. Strumenti GIS

La sezione GIS (/gis) è un set di strumenti di misura interattivi sulla mappa. Tutto quello che disegnate è salvato nella sidebar e può essere esportato.

Strumenti disponibili

• Area — disegnate un poligono e ottenete superficie in m² ed ettari.
• Distanza — disegnate una polilinea e ottenete lunghezza in metri.
• Punto — segnate un punto e ottenete coordinate precise.
• Buffer — selezionate una misura esistente e applicate un buffer (es. fascia di rispetto di 30 m intorno a un edificio).

Sidebar misure

Le misure sono raggruppate in tre liste (Aree, Distanze, Punti). Per ciascuna potete:

• Modificarne il nome.
• Eliminarla.
• Generare un Buffer.

Il pulsante Cancella tutto azzera l’area di lavoro.

Esportazione

• GeoJSON — importabile in QGIS, ArcGIS e simili.
• CSV — apribile in Excel o Google Sheets per elaborazioni tabellari.

9. Analisi avanzata

L’hub /analysis raccoglie tre strumenti di analisi cross-job:

Change detection

Confrontate due job dello stesso sito eseguiti in momenti diversi. Otterrete tre metriche:

• Area aggiunta — copertura nel job recente che prima non c’era.
• Area persa — copertura presente solo nel job precedente.
• Area condivisa — copertura presente in entrambi.

Se i bounds spaziali del job mancano, vengono calcolati al momento.

Statistiche spaziali

Numeri aggregati su un set di job: area totale, densità di copertura, gap (zone non coperte all’interno della bounding box), bounding box complessivo.

Esporta dati

Per ogni job potete esportare:

• Shapefile (.zip) — formato standard GIS;
• Report PDF — riepilogo grafico stampabile.

10. Piani, crediti, fatturazione

10.1 Come funzionano i crediti

Il sistema di consumo è a crediti:

• Ogni job consuma un numero fisso di crediti in base al tipo di elaborazione (5 / 10 / 15 / 25 / 30 / 50 — vedi 4.2).
• Il numero di immagini caricate non influisce sul costo.
• L’addebito avviene al completamento; in caso di fallimento il credito non viene scalato.
• I crediti non scadono.

10.2 Abbonamenti e pacchetti

Da /pricing trovate due famiglie di prodotti.

Abbonamenti mensili

La versione annuale dello stesso piano applica uno sconto del 20% sul prezzo equivalente di 12 mesi.

Pacchetti una tantum

10.3 Bonus iscrizione

Alla prima registrazione ricevete 50 crediti omaggiouna tantum. Quando la piattaforma è in modalità beta, il bonus è moltiplicato (di default ×10, quindi 500 crediti) come ringraziamento per la partecipazione.

10.4 Storico transazioni

Da /billing/history consultate il registro completo dei movimenti, filtrabile per tipo:

• Abbonamento (rinnovo mensile / annuale)
• Acquisto pacchetto
• Bonus benvenuto
• Completamento job (addebito)
• Correzione amministratore
• Rimborso job
• Rimborso Stripe

Per ogni riga: data, tipo, riferimento, importo, saldo dopo l’operazione.

10.5 Gestire l’abbonamento

Da /billing il pulsante Gestisci abbonamentoapre il portale clienti Stripe, dove potete:

• Aggiornare il metodo di pagamento.
• Scaricare le fatture.
• Cambiare piano (upgrade / downgrade).
• Annullare il rinnovo automatico.

11. Impostazioni

Le pagine sotto /settings sono organizzate per area; /settings reindirizza al Profilo.

11.1 Profilo

• Nome visualizzato.
• Email — il cambio richiede una verifica via link sul nuovo indirizzo.
• Bio — fino a 500 caratteri.
• Avatar — JPG, PNG, WEBP o GIF, fino a 2 MB.
• Profilo social — link a X, Instagram, Facebook, YouTube, LinkedIn, TikTok, sito personale o aziendale.

11.2 Account

Contiene la Zona pericolosa per l’eliminazione definitiva dell’account. Per conferma vi viene chiesto di digitare l’email associata. L’operazione è irreversibile: tutti i job, gli artifact e i piani salvati vengono cancellati.

11.3 Notifiche

Toggle individuali per ogni tipo di email transazionale:

• Job completato
• Job fallito
• Crediti in esaurimento
• Riepilogo settimanale
• Aggiornamenti di prodotto

11.4 Sessioni

Elenca tutte le sessioni attive sull’account: dispositivo (dedotto dallo user-agent), indirizzo IP, data di creazione. La sessione corrente è marcata con un badge; sulle altre potete cliccare Revoca per chiuderle subito.

11.5 API token

Per integrazioni con script o flussi automatici potete creare personal access token. Alla creazione il token completo è mostrato una sola volta: copiatelo subito in un luogo sicuro. In qualsiasi momento potete revocare un token esistente.

12. FAQ

Posso chiudere il browser durante l’elaborazione?

Sì. Il processing avviene su server remoti. Tornando sulla piattaforma ritrovate lo stato aggiornato e, se attiva, ricevete l’email di completamento.

Quanto durano i miei crediti?

I crediti non scadono. Si esauriscono solo con il consumo dei job o vengono rimborsati in caso di errori imputabili al servizio.

Cosa succede se un job fallisce?

I crediti non vengono addebitati: l’addebito avviene solo al completamento. Sul job fallito potete cliccare Riprova Job per ritentare.

Posso processare più di 10.000 immagini in un solo job?

No, 10.000 è il limite per singolo job. Per dataset più grandi conviene comunque suddividere il lavoro in blocchi più piccoli per ottenere risultati di qualità migliore.

Perché alcuni miei file vengono rifiutati all’upload?

Probabilmente il nome del file contiene caratteri non consentiti (spazi, accentate, parentesi…) o supera i 100 caratteri. Sono ammesse solo lettere, cifre, punto, trattino, underscore. Vedi 4.3.

Posso importare un piano di volo da app esterne?

L’editor non importa formati di terze parti, ma supporta l’import di log di telemetria per riprodurre la traccia di un volo già eseguito. Vedi 5.8.

Come cambio la lingua dell’interfaccia?

Da Impostazioni → Profilo, campo Lingua preferita.

Cosa fa il portale Stripe?

È il portale ufficiale per gestire pagamenti: cambiare carta, scaricare fatture, modificare o annullare l’abbonamento. Vedi 10.5.

Sono in beta. Quando potrò acquistare crediti?

Quando la modalità beta verrà disattivata. Nel frattempo i pulsanti di acquisto sono visibili ma disabilitati e potete usare il bonus omaggio maggiorato. Vedi 2.5.

Ho perso il token API: posso recuperarlo?

No: il token completo è mostrato una sola volta alla creazione. Revocate quello smarrito dalla pagina API token e createne uno nuovo.