AI Edit per QGIS: la guida completa


Trasforma le immagini aeree del tuo canvas
in modifiche, mappe pulite e dati vettoriali, tutto a partire da semplici prompt in linguaggio naturale. Disegna una zona, 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, Mark up, 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. Ogni didascalia è il tipo di prompt che l'ha prodotto.








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 disegna la tua zona direttamente sulla mappa, punto per punto, attorno all'area che vuoi modificare. Chiudi il poligono cliccando di nuovo sul tuo primo punto: la zona è pronta.
Descrivi la modifica
Digita un prompt, oppure apri la Library per scegliere un modello già pronto.
Scegli il livello di dettaglio
| Dettaglio | Risoluzione | Piano |
|---|---|---|
| Standard | 1K | Gratis |
| Dettagliato | 2K | Pro |
| Massimo | 4K | Pro |
Standard (1K) basta e avanza per fare delle prove. Passa a Dettagliato o Massimo quando il risultato conta: il modello legge e restituisce più pixel, così i dettagli fini sopravvivono. Il quadro completo è in Gratis vs Pro, più in basso.
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, direttamente sulla mappa.
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.
Mark up
Mark up 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 Mark up e scegli uno strumento
Con una zona disegnata, clicca sul pulsante Mark up, poi scegli uno strumento (matita, linea, freccia, cerchio) e un colore.


Disegna sulla mappa
Traccia il tuo segno direttamente sull'immagine: un contorno, una freccia, un cerchio.
Prompt e generazione
Nomina quel colore nel prompt, poi genera.
Il prompt che ha prodotto il risultato qui sotto:
Pianta alberi all'interno del contorno rosa. Lascia tutto il resto invariato.


Vectorize
AI Edit ha due grandi casi d'uso. Il primo, la simulazione: modificare alcuni dettagli di un'immagine esistente conservandone i colori e il livello di dettaglio. Il secondo, la classificazione: rilevare le entità dell'immagine, segmentandola o classificandola. Per questo secondo caso esiste Vectorize: trasforma le zone a colori pieni di un risultato IA (edifici, classi di copertura del suolo, particelle) in veri poligoni vettoriali che puoi selezionare, misurare, stilizzare ed esportare. Rilevamento e classificazione danno il meglio alla scala locale. Per coprire grandi aree, passa al nostro plugin AI Segmentation.
Esegui una segmentazione, poi clicca su Vectorize
Comincia generando una segmentazione: chiedila semplicemente nel prompt ("segment all buildings"), oppure prendi un modello dalla categoria Segment nella Library. Sul risultato (edifici in rosso), clicca su Vectorize this result.

Conferma il colore
Il pannello precompila il colore da estrarre, oppure usa Pick on map per campionarne un altro.

Affina in tempo reale
Regola la tolleranza, elimina il rumore, semplifica i contorni e arrotonda gli angoli: ogni modifica si ricalcola 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. È lo strumento di chi vuole più controllo, e una delle leve più potenti di AI Edit: un riferimento vincola il modello molto più di un prompt da solo, e ti porta molto più in fretta al risultato che hai in mente. Clicca su Ref image, scegli il file, e accompagna il tuo prompt.
Un altro 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
L'IA lavora a partire da due cose: l'immagine visibile sul tuo canvas (l'input che modifica) e i riferimenti che le fornisci a parte. Qualsiasi livello QGIS può fare da riferimento: trascinalo sul campo del prompt (oppure usa Ref image). Viene ritagliato sulla tua zona esatta e inviato separatamente, mai disegnato nell'input.
Per allegare un livello del tuo progetto, clicca su Reference, poi su From the project, e scegli il livello.

Qui l'input è l'immagine aerea di Vaison-la-Romaine (Francia). Il riferimento è un modello digitale del terreno (DTM) della stessa zona, nascosto nel progetto: il nero e il viola sono i punti bassi (il letto del fiume Ouvèze), l'arancione e il giallo chiaro quelli alti.

Il prompt, appoggiato a quel riferimento:
Il riferimento è il terreno della stessa zona: nero e viola = basso, arancione e giallo = alto. Simula una piena maggiore: acqua fangosa sale dal letto del fiume e invade solo le zone nere e viola, fermandosi di colpo dove il terreno diventa arancione o giallo. Non rimuovere edifici, strade o alberi: dove l'acqua sale, restano solo in parte sommersi.


Per vedere quanto l'acqua aderisca al riferimento, confronta il DTM con il risultato:


Lo stesso prompt, senza il DTM come riferimento: l'IA non conosce più il terreno, e l'acqua sommerge quasi tutto, pendii compresi. È tutto il valore di un livello di riferimento: vincola il modello con dati reali.


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, Mark up, 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 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.












