---
schema_version: "1"
id: 936008eb9245dab8c9401553a5a2788dc6beee4dae323470b5f08a7b7e61798b
title: Funzioni spaziali
collection: tableau
version: current
locale: it-it
portal_url: https://docs.salesforce.com/tableau/current/it-it/pro/desktop/functions_functions_spatial.md
canonical_url: https://help.tableau.com/current/pro/desktop/it-it/functions_functions_spatial.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 3bff1295867708e1ec3efc5cbf3932e4b0d85f3905ddfd1d9348e7314e88c1cb
description: Reference for spatial functions such as BUFFER, DISTANCE, and INTERSECTS.
---
[Passa al contenuto principale](#main-content)

# Funzioni spaziali

Le funzioni spaziali ti consentono di eseguire analisi spaziali avanzate e di combinare file spaziali con dati in altri formati, come file di testo o fogli di calcolo. Ad esempio, potresti avere un file spaziale dei distretti comunali e un file di testo contenente le coordinate di latitudine e longitudine delle buche segnalate. Puoi utilizzare un calcolo spaziale quando crei l’origine dati per creare un join con questi file e analizzare quale distretto richiede più tempo per la riparazione delle buche.

Puoi anche creare una linea che collega due punti dati per le mappe di origine e destinazione. Per esempio, potresti avere un foglio di calcolo con i dati del trasporto pubblico che ti dice dove i pendolari iniziano e terminano i loro spostamenti. Puoi utilizzare un calcolo spaziale per vedere quali percorsi stanno prendendo i pendolari.

## Funzioni spaziali disponibili in Tableau

### AREA

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>AREA(Spatial Polygon, 'units')</code></td></tr><tr><td>Output</td><td>Numero</td></tr><tr><td>Definizione</td><td>Restituisce l’area della superficie totale di <code>&lt;spatial polygon&gt;</code>.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">AREA([Geometry], 'feet')</pre></td></tr><tr><td>Note</td><td><p>Nomi delle unità supportate (devono essere racchiusi tra virgolette nel calcolo, ad esempio <code>'miles'</code>):</p><ul><li><i>meters</i>: meters, metres, m</li><li><i>kilometers</i>: kilometers, kilometres, km</li><li><i>miles</i>: miles, mi</li><li><i>feet</i>: feet, ft</li></ul><p></p></td></tr></tbody></table>

### BUFFER

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>BUFFER(Spatial point, distance, 'units')</code><p><code>BUFFER(Spatial linestring, distance, 'units')</code></p><p><code>BUFFER(Spatial polygon, distance, 'units')</code></p><ul><li><i>meters</i>: meters, metres, m</li><li><i>kilometers</i>: kilometers, kilometres, km</li><li><i>miles</i>: miles, mi</li><li><i>feet</i>: feet, ft</li></ul></td></tr><tr><td>Output</td><td>Geometria</td></tr><tr><td>Definizione</td><td><p>Per i punti spaziali, restituisce una forma poligonale centrata su <code>&lt;spatial point&gt;</code>, con un raggio determinato dai valori <code>&lt;distance&gt;</code> e <code>&lt;unit&gt;</code>.</p><p>Per le stringhe lineari, calcola i poligoni formati includendo tutti i punti entro il raggio di distanza dalla stringa lineare.</p><p>Per i poligoni, calcola un poligono che è un valore interno (distanza negativa) o iniziale (distanza positiva) di ogni poligono specificato.</p></td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">BUFFER([Spatial Point Geometry], 25, 'mi')</pre><pre xml:space="preserve">BUFFER(MAKEPOINT(47.59, -122.32), 3, 'km')</pre><pre xml:space="preserve">BUFFER(MAKELINE(MAKEPOINT(0, 20),MAKEPOINT (30, 30)),20,'km'))</pre></td></tr><tr><td>Note</td><td><p>Nomi delle unità supportate (devono essere racchiusi tra virgolette nel calcolo, ad esempio <code>'miles'</code>):</p><ul><li><i>meters</i>: meters, metres, m</li><li><i>kilometers</i>: kilometers, kilometres, km</li><li><i>miles</i>: miles, mi</li><li><i>feet</i>: feet, ft</li></ul></td></tr></tbody></table>

### DIFFERENCE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>DIFFERENCE(Spatial, Spatial)</code></td></tr><tr><td>Output</td><td>Poligono spaziale</td></tr><tr><td>Definizione</td><td>Calcola le porzioni di regioni rimanenti quando tutte le regioni nel secondo argomento vengono ricavate dal primo argomento in aree sovrapposte.Scarta le regioni del secondo argomento nelle aree che non si sovrappongono.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">DIFFERENCE(Spatial Polygon1, Spatial Polygon2)</pre></td></tr><tr><td>Note</td><td><p>Supporta poligoni e multipoligoni spaziali, punti o linee non spaziali.</p></td></tr></tbody></table>

### DISTANCE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>DISTANCE(SpatialPoint1, SpatialPoint2, 'units')</code></td></tr><tr><td>Output</td><td>Numero</td></tr><tr><td>Definizione</td><td>Restituisce la misura della distanza tra due punti nell’unità <code>&lt;unit&gt;</code> specificata.</td></tr><tr><td>Esempio</td><td><pre>DISTANCE([Origin Point],[Destination Point], 'km')</pre></td></tr><tr><td>Note</td><td><p>Nomi delle unità supportate (devono essere racchiusi tra virgolette nel calcolo, ad esempio <code>'miles'</code>):</p><ul><li><i>meters</i>: meters, metres, m</li><li><i>kilometers</i>: kilometers, kilometres, km</li><li><i>miles</i>: miles, mi</li><li><i>feet</i>: feet, ft</li></ul></td></tr><tr><td>Limitazioni del database</td><td>Questa funzione può essere creata solo con una connessione live, ma continuerà a funzionare se l’origine dati viene convertita in un’estrazione.</td></tr></tbody></table>

### INTERSECTION

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>INTERSECTION (spatial, spatial)</code></td></tr><tr><td>Output</td><td>Poligono</td></tr><tr><td>Definizione</td><td>Calcola e restituisce le porzioni delle regioni nel secondo argomento che si sovrappongono alle regioni nel primo argomento.</td></tr><tr><td>Esempio</td><td><tt>INTERSECTION (Spatial Polygon1, Spatial Polygon2)</tt></td></tr><tr><td>Note</td><td>Supporta poligoni e multipoligoni spaziali, punti o linee non spaziali.</td></tr></tbody></table>

### INTERSECTS

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>INTERSECTS (geometry1, geometry2)</code></td></tr><tr><td>Output</td><td>Booleano</td></tr><tr><td>Definizione</td><td>Restituisce True o False per indicare se due geometrie si sovrappongono nello spazio.</td></tr><tr><td>Note</td><td>Combinazioni supportate: punto/poligono, linea/poligono e poligono/poligono.</td></tr></tbody></table>

### LENGTH

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>LENGTH(geometry, 'units')</code></td></tr><tr><td>Output</td><td>Numero</td></tr><tr><td>Definizione</td><td>Restituisce la lunghezza del percorso geodetico della stringa o delle stringhe lineari in <code>&lt;geometry&gt;</code> utilizzando le unità <code>&lt;units&gt;</code> specificate.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">LENGTH([Spatial], 'metres')</pre></td></tr><tr><td>Note</td><td>Il risultato è <code>&lt;NaN&gt;</code> se l’argomento della geometria non ha stringhe lineari, sebbene siano consentiti altri elementi.</td></tr></tbody></table>

### MAKELINE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>MAKELINE(SpatialPoint1, SpatialPoint2)</code></td></tr><tr><td>Output</td><td>Geometria (linea)</td></tr><tr><td>Definizione</td><td>Genera un indicatore lineare tra due punti</td></tr><tr><td>Esempio</td><td><pre>MAKELINE(MAKEPOINT(47.59, -122.32), MAKEPOINT(48.5, -123.1))</pre></td></tr><tr><td>Note</td><td>Utile per creare mappe di origine-destinazione.</td></tr></tbody></table>

### MAKEPOINT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>MAKEPOINT(latitude, longitude, [SRID])</code></td></tr><tr><td>Output</td><td>Geometria (punto)</td></tr><tr><td>Definizione</td><td><p>Converte i dati delle colonne <code>&lt;latitude&gt;</code> e <code>&lt;longitude&gt;</code> in oggetti spaziali.</p><p>Se viene aggiunto l’argomento facoltativo <code>&lt;SRID&gt;</code>, gli input possono essere altre coordinate geografiche proiettate.</p></td></tr><tr><td>Esempio</td><td><pre>MAKEPOINT(48.5, -123.1)</pre><pre xml:space="preserve">MAKEPOINT([AirportLatitude], [AirportLongitude])</pre><pre xml:space="preserve">MAKEPOINT([Xcoord],[Ycoord], 3493)</pre></td></tr><tr><td>Note</td><td><p><code>MAKEPOINT</code> non può utilizzare campi di latitudine e longitudine generati automaticamente.L’origine dati deve contenere le coordinate in modo nativo.</p><p><code>SRID</code> è un identificatore spaziale di riferimento che utilizza i <a href="https://epsg.io/" target="_blank">codici del sistema di riferimento ESPG</a> per specificare i sistemi di coordinate.Se <code>SRID</code> non è specificato, si presuppone WGS84 e i parametri sono trattati come latitudine/longitudine in gradi.</p><p>Puoi utilizzare <code>MAKEPOINT</code> per abilitare spazialmente un’origine dati in modo che possa essere collegata con un file spaziale utilizzando un join spaziale.Per maggiori informazioni, consulta <a href="https://help.tableau.com/current/pro/desktop/it-it/maps_spatial_join.htm" class="xref">Creare un join dei file spaziali in Tableau</a>.</p></td></tr></tbody></table>

### NO\_CUTOUTS

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>NO_CUTOUTS (spatial)</code></td></tr><tr><td>Output</td><td>Poligono spaziale corretto</td></tr><tr><td>Definizione</td><td>Restituisce un poligono spaziale corretto se l’interpretazione della terra piatta richiede l’inversione dei poligoni; in caso contrario, restituisce l’oggetto originale.</td></tr><tr><td>Note</td><td><p>I formati di file spaziali come Keyhole Markup Language (.kml) richiedono che i contorni dei poligoni seguano una direzione di coordinate specifica.Se un insieme di dati disegna i contorni al contrario, Tableau interpreta lo spazio esterno come forma.<code>NO_CUTOUTS</code> riordina queste coordinate per ripristinare il layout corretto.</p></td></tr></tbody></table>

### OUTLINE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>OUTLINE(spatial polygon)</code></td></tr><tr><td>Output</td><td>Geometria</td></tr><tr><td>Definizione</td><td>Converte una geometria poligonale in stringhe lineari.</td></tr><tr><td>Note</td><td><p>Utile per creare un livello separato per un contorno a cui è possibile applicare uno stile diverso rispetto al riempimento.</p><p>Supporta i poligoni all’interno di multipoligoni.</p></td></tr></tbody></table>

### PARSE\_WKT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>PARSE_WKT (String)</code></td></tr><tr><td>Output</td><td>Oggetto spaziale (geografia)</td></tr><tr><td>Definizione</td><td>Converte un campo stringa di testo contenente WKT (Well-Known Text) di entità geografiche (come punti, stringhe lineari o poligoni) in un valore spaziale.</td></tr><tr><td>Note</td><td><p>Si presuppone che le coordinate utilizzino la latitudine e la longitudine WGS-84.Per maggiori informazioni su WKT, consulta <a href="https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry">Rappresentazione WKT della geometria</a> (in inglese).</p></td></tr></tbody></table>

### SHAPETYPE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>SHAPETYPE(geometry)</code></td></tr><tr><td>Output</td><td>Stringa</td></tr><tr><td>Definizione</td><td>Restituisce una stringa che descrive la struttura della geometria spaziale <code>&lt;geometry&gt;</code>, ad esempio vuoto, punto, multipunto, stringa lineare, stringa lineare multipla, poligono, multipoligono, misto e non supportato.</td></tr><tr><td>Esempio</td><td><pre xml:space="preserve">SHAPETYPE(MAKEPOINT(48.5, -123.1)) = "Point"</pre></td></tr></tbody></table>

### SYMDIFFERENCE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>SYMDIFFERENCE(spatial, spatial)</code></td></tr><tr><td>Output</td><td>Geometria</td></tr><tr><td>Definizione</td><td>Calcola tutte le porzioni di regioni del secondo argomento che si sovrappongono alle regioni del primo argomento e le scarta da entrambi.Restituisce le porzioni rimanenti delle regioni da entrambi gli argomenti.</td></tr><tr><td>Esempio</td><td><p><code>SYMDIFFERENCE(Spatial Polygon1, Spatial Polygon2)</code></p></td></tr></tbody></table>

### UNION

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>UNION(spatial 1, [spatial 2])</code></td></tr><tr><td>Output</td><td>Geometria</td></tr><tr><td>Definizione</td><td>Combina le geometrie spaziali dissolvendo i confini adiacenti o sovrapposti in un’unica geometria spaziale.</td></tr><tr><td>Note</td><td><p>Quando viene utilizzata con un argomento (<code>UNION(spatial)</code>), <code>UNION </code>opera come funzione di aggregazione che unisce tutti gli oggetti spaziali in un campo su più righe.</p><p>Se viene utilizzata con due argomenti (<code>UNION(spatial1, spatial2)</code>), <code>UNION </code>unisce due geometrie o due campi spaziali distinti.</p><p>Per punti e stringhe lineari, <code>UNION </code>combina tutti gli elementi in un’unica raccolta.Per i poligoni, le forme che si sovrappongono o si toccano si dissolvono in un singolo poligono o multipoligono.</p></td></tr></tbody></table>

### VALIDATE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintassi</td><td><code>VALIDATE(spatial geometry)</code></td></tr><tr><td>Output</td><td>Geometria</td></tr><tr><td>Definizione</td><td>Conferma la correttezza topologica della geometria nel valore spaziale.Se il valore non può essere utilizzato per l'analisi a causa di problemi quali l'intersezione del perimetro di un poligono, il risultato sarà NULL.Se la geometria è corretta, il risultato sarà la geometria originale.</td></tr><tr><td>Esempio</td><td><p><code>UNION(VALIDATE([Geometry]))</code></p></td></tr></tbody></table>

## Utilizzare un calcolo spaziale

### Creare un’origine dati spaziale utilizzando MAKEPOINT

Puoi utilizzare MAKEPOINT per abilitare spazialmente un’origine dati in modo che possa essere collegata con un file spaziale utilizzando un join spaziale. Per utilizzare MAKEPOINT, i dati devono contenere le coordinate di latitudine e longitudine.

1. Apri Tableau e connettiti a un’origine dati spaziale.
2. In Connessioni, fai clic su Aggiungi per aggiungere una seconda origine dati non spaziale.
    
    Le due origini dati vengono aggiunte al canvas.
    
    > [!TIP]
    > 
    > Suggerimento: per visualizzare la finestra di dialogo Unisci, fai doppio clic (control-clic su Mac) su un’origine dati nel canvas.
3. Trascina l’origine dati non spaziale nella finestra di dialogo Join.
4. Fai clic sull’icona Crea join.
5. Nella finestra di dialogo Crea join che viene visualizzata, procedi come segue:
    - Seleziona un tipo di join.
    - In Origine dati, seleziona un campo spaziale dal tuo file spaziale per la creazione del join. I campi spaziali sono preceduti da un’icona a forma di mondo.
6. Per l’origine dati non spaziale, seleziona Crea calcolo di join come clausola di unione.  
    ![Finestra di dialogo Crea join con l’opzione Crea calcolo di join.](/tableau/current/it-it/pro/desktop/it-it/Img/maps_spatialcalcs_csvspatial.png)
    
    Il calcolo dovrebbe presentarsi in questo modo:
    
    `MAKEPOINT(Latitude,Longitude)`
7. Seleziona OK.
8. Seleziona l’operatore della clausola di unione Interseca per creare un’origine dati per l’analisi spaziale.
9. Al termine, chiudi la finestra di dialogo Crea join.

Per maggiori informazioni sui join spaziali, consulta [Creare un join dei file spaziali in Tableau](https://help.tableau.com/current/pro/desktop/it-it/maps_spatial_join.htm).

### Creare una visualizzazione utilizzando MAKELINE

In Tableau Desktop, scarica la cartella di lavoro Rotte aeree da Tableau Public, [disponibile qui](https://public.tableau.com/views/UseSpatialFunctionsMakeLineExampleWorkbook/FinishedFlightpaths?:embed=y&:display_count=yes&publish=yes&:origin=viz_share_link).

1. Passa a un nuovo foglio di lavoro.
2. Seleziona Analisi > Crea campo calcolato.
3. Nel di calcolo che si apre, esegui le seguenti operazioni:

- Denomina il campo calcolato Rotte aeree.
- Immetti la seguente formula:

`MAKELINE(MAKEPOINT([Lat],[Lng]),MAKEPOINT([Dest Lat],[Dest Lng]))`

La formula prende in considerazione le coordinate di latitudine e longitudine della città di origine e di quella di destinazione e le trasforma in punti geografici per l’analisi spaziale. Queste coordinate vengono utilizzate per costruire linee con due punti tra origine e destinazione.

7. Al termine, fai clic su OK.

Visualizzerai il nuovo campo calcolato sotto Dimensioni nel riquadro Dati. Proprio come gli altri campi, puoi utilizzarlo in una o più visualizzazioni.

9. Dal riquadro Dati, fai doppio clic su Rotte aeree per aggiungerlo alla tua visualizzazione, che dovrebbe essere mostrata automaticamente come una mappa.

![Mappa che illustra le rotte aeree negli Stati Uniti e in Messico.](/tableau/current/it-it/pro/desktop/it-it/Img/maps_spatialcalcs_flight.png)

Il calcolo produce automaticamente linee geodetiche curve quando le linee si estendono su distanze maggiori del globo.

### Visualizzare un’area con BUFFER

In Tableau Desktop, scarica la cartella di lavoro Rotte aeree da Tableau Public, [disponibile qui](https://public.tableau.com/views/UseSpatialFunctionsMakeLineExampleWorkbook/FinishedFlightpaths?:embed=y&:display_count=yes&publish=yes&:origin=viz_share_link).

1. Passa a un nuovo foglio di lavoro.
2. Fai clic con il pulsante destro del mouse sul riquadro Dati e seleziona Crea parametro.
3. Nella finestra di dialogo Parametri visualizzata, imposta le opzioni seguenti:
    
    - Denomina il parametro Buffer Distance
    - Imposta Tipo di dati su Numero intero
    - Imposta Valori consentiti su Intervallo
    - Imposta l’intervallo minimo su 100, l’intervallo massimo su 1000 e la dimensione del passaggio su 100.
    
    ![Finestra di dialogo Crea parametro con il nome impostato su Buffer Distance, tipo di dati impostato su Numero intero, Valori consentiti impostato su Intervallo, intervallo minimo impostato su 100, intervallo massimo impostato su 1000 e dimensione del passaggio impostata su 100.](/tableau/current/it-it/pro/desktop/it-it/Img/map_buffer_2.png)
4. Al termine, fai clic su OK.

Questo parametro consente di personalizzare il raggio del buffer, da 100 a 1000 miglia. Fai clic con il pulsante destro del mouse sul parametro e seleziona Mostra parametro.

6. Seleziona Analisi > Crea campo calcolato.
7. Nel di calcolo che si apre, esegui le seguenti operazioni:

- Denomina il campo calcolato Buffer
- Immetti la seguente formula:

`BUFFER(MAKEPOINT([Dest Lat],[Dest Lng]),[Buffer Distance],"miles")`

Il calcolo Buffer prende i dati del punto spaziale e li converte in forme con un raggio in miglia determinato dal parametro Buffer Distance.

Nota: poiché IL BUFFER può essere utilizzato solo con dati di punti spaziali, stiamo convertendo i dati di latitudine e longitudine in un punto con Makepoint, come dimostrato nell’esempio precedente.

12. Al termine, fai clic su OK.

il nuovo campo calcolato compare nel riquadro Dati. Proprio come gli altri campi, puoi utilizzarlo in una o più visualizzazioni.

14. Nel riquadro Dati, fai doppio clic su Buffer per aggiungerlo alla tua visualizzazione, che dovrebbe essere resa automaticamente come una mappa.
15. Trascina la Destinazione nel pannello Colore della scheda Indicatori per completare la visualizzazione.

![Mappa buffer con indicatori del tipo di mappa.](/tableau/current/it-it/pro/desktop/it-it/Img/map_buffer_1.png)

**Nota:** se la vista non ha un aspetto simile all’immagine precedente, assicurati che il Tipo di indicatore sia impostato su Mappa e non su Cerchio. Per maggiori informazioni sul tipo di indicatore, consulta [Modificare il tipo di indicatore nella vista](https://help.tableau.com/current/pro/desktop/it-it/viewparts_marks_marktypes.htm).