AI Edit per QGIS: la guida completa


Trasforma le immagini aeree del tuo canvas
QGIS in modifiche, mappe pulite e dati vettoriali, tutto a partire da semplici prompt in linguaggio naturale. Disegna un rettangolo, descrivi la modifica, e il risultato torna sulla mappa, perfettamente allineato. Questa guida percorre l'intero strumento: la tua prima modifica, la libreria di prompt, Markup, Vectorize e le immagini di riferimento.
Esempi
Sposta il cursore su ciascun esempio: l'immagine aerea originale è a sinistra, il risultato dell'IA a destra.








Installare in QGIS
Installa AI Edit dal repository delle estensioni QGIS: apri Plugins -> Gestisci e installa plugin, cerca AI Edit e clicca su Installa. Funziona su QGIS 3 e 4, su Windows, macOS e Linux, ed è basato sul modello Nano Banana 2.
Apri poi il pannello e clicca su Sign in / Sign up. Si apre il browser, crei un account (email, Google o Microsoft), e il plugin si collega da solo, senza carta di credito, con modifiche gratuite per iniziare.
La tua prima modifica
Avvia e disegna la tua zona
Clicca sul pulsante verde Launch AI Edit, poi tieni premuto il tasto sinistro del mouse e traccia un rettangolo sulla mappa sull'area che vuoi modificare.
Descrivi la modifica
Digita un prompt, oppure apri la Library per scegliere un modello già pronto. Mantieni il rettangolo circa quadrato e non troppo grande.

Scegli il livello di dettaglio
| Dettaglio | Risoluzione | Piano |
|---|---|---|
| Standard | 1K | Gratis |
| Dettagliato | 2K | Pro |
| Massimo | 4K | Pro |
Genera
Clicca su Generate. Pochi secondi dopo, il risultato viene aggiunto come nuovo raster georeferenziato, esattamente sopra la tua zona.

Il pannello conserva ogni versione (Original, V1, V2 e così via). Scegline una come base, scrivi un nuovo prompt e genera per affinare. Il pulsante Before / after fa scorrere tra input e output.

La libreria di prompt
Clicca su Library per esplorare modelli già pronti, ognuno con un'anteprima prima/dopo e un prompt modificabile. Sono raggruppati per tema: Cartografia, Urbano, Segment, Copertura del suolo, Pulizia, Forestale, Agricoltura, Clima, Energia e altro.

Markup
Markup ti permette di disegnare sulla tua zona per indicare all'IA dove intervenire. I tuoi segni guidano la modifica e vengono rimossi dal risultato. Usalo per una modifica in un punto specifico, non su tutta l'immagine.
Apri Markup e scegli uno strumento
Con una zona disegnata, clicca sul pulsante matita, poi scegli uno strumento (matita, freccia, cerchio) e un colore.

Disegna sulla mappa
Qui, un contorno viola tracciato attorno ai tetti delle serre che vogliamo coprire.

Prompt e generazione
Fai riferimento al tuo segno per colore, poi genera. Ad esempio:
Aggiungi pannelli solari sui tetti all'interno del segno viola. Lascia tutto il resto invariato.


Vectorize
Vectorize trasforma un risultato IA a colori pieni (edifici, classi di copertura del suolo, particelle) in veri poligoni vettoriali che puoi selezionare, misurare, stilizzare ed esportare. Usalo dopo un modello Segment o Copertura del suolo, quando ti servono entità GIS, non solo un'immagine.
Esegui una segmentazione, poi clicca su Vectorize
Su un risultato come Segment all buildings (edifici in rosso), clicca su Vectorize this result.

Confermi il colore ed esegui
Il pannello precompila il colore da estrarre. Clicca su Vectorize, oppure usa Pick on map per campionare un colore diverso.

Affina in tempo reale
Regola la tolleranza, elimina il rumore, semplifica i contorni e arrotonda gli angoli. Le modifiche si ricalcolano istantaneamente sullo stesso livello.


Ogni entità porta un set di attributi pulito (feature_id, class_name, class_color e una area_m2 geodetica) ed è salvata in un GeoPackage nella tua cartella di output, pronta per l'analisi.

Immagini e livelli di riferimento
I riferimenti danno all'IA un contesto extra ritagliato sulla tua zona ma mai mostrato sul canvas. Usali per controllare lo stile, replicare una legenda cromatica o fornire dati reali. Il piano gratuito consente un riferimento; Pro ne consente diversi.
Un'immagine di riferimento
Aggancia un'immagine dal disco: un campione di stile, un aspetto target, o una legenda cromatica. Un uso comune è una mappa di uso del suolo con la tua legenda esatta, abbinata a un prompt come:
Trasforma in una mappa di uso del suolo nello stile del riferimento.
L'output rispetta quindi la tua tavolozza ogni volta.


Un livello QGIS come riferimento
Questa è la parte che vale la pena capire bene. L'IA lavora a partire da due cose insieme: l'immagine aerea visibile sul tuo canvas (l'input che modifica) e qualsiasi livello di riferimento che le fornisci a parte. Il punto delicato è che un riferimento deve rimanere fuori dalla vista visibile, altrimenti viene renderizzato nell'immagine di input invece di essere inviato come contesto.
Qui, la configurazione prevede una basemap Google Satellite sopra (l'unica cosa che il canvas mostra) con un livello OSM Standard mantenuto sotto. Il livello OSM non viene mai disegnato nell'input; viene invece trascinato sul prompt come immagine di riferimento.

Trascina il livello OSM sul campo del prompt (oppure usa Ref image). Viene ritagliato esattamente sulla tua zona e inviato come contesto, perfettamente allineato con l'input aereo ma mai mostrato sulla mappa. Ora il modello vede l'immagine aerea e sa con precisione dove si trova ogni impronta di edificio.


Il motivo per cui è potente: ogni riferimento è co-localizzato, ritagliato sulla stessa zona e allineato allo stesso terreno del tuo input. Puoi quindi impilarne diversi e il modello li legge come un'unica scena sincronizzata: un DEM o un terreno 3D per l'altimetria, più riprese aeree o satellitari dello stesso luogo, livelli di curve di livello, acqua o uso del suolo. Ogni livello aggiuntivo è una fonte di contesto allineata in più, e più materiale ha il modello a disposizione, più accurato e ben allineato è il suo risultato.
Gratis vs Pro
L'intera libreria di prompt, Markup, Vectorize e i riferimenti funzionano sul piano gratuito. Pro alza i limiti: risoluzione più alta, più immagini di riferimento per modifica, e un plafond mensile maggiore.
La risoluzione è quella che cambia il risultato stesso. Un'impostazione più alta aumenta il numero di pixel su entrambi i lati, l'immagine di input che il modello legge e il risultato che restituisce, quindi risolve dettagli che semplicemente non esistono a 1K e torna più nitido, più pulito e meglio allineato.
~1024 px · ~1 MP
Bozza ed esplorazione
Gratis~2048 px · ~4 MP
Bordi più nitidi e puliti
Pro~4096 px · ~16 MP
Dettaglio massimo, allineamento migliore
ProOgni quadrato rappresenta un blocco di pixel. Un livello superiore ne contiene di più su entrambi i lati: un'immagine di input più grande che il modello legge e un risultato più grande che genera, così i dettagli fini vengono preservati.

Consigli
- Imposta la basemap e lo zoom prima di disegnare: i pixel visibili sono l'input.
- Mantieni le zone piuttosto quadrate e di dimensioni moderate per i risultati più nitidi.
- Per le mappe a colori pieni che intendi vettorializzare, richiedi riempimenti solidi e contorni netti.
- Mantieni i livelli di riferimento nascosti.
Hai bisogno di aiuto? Usa il menu ? nel pannello per il tutorial, i termini di servizio, e per segnalare un problema.