---
schema_version: "1"
id: 2e9d0e9e6e5899a966dddaba91e0e4d07f96d239e655c9af46375e1d478c2ee0
title: Fonctions spatiales
collection: tableau
version: next
locale: fr-ca
portal_url: https://docs.salesforce.com/tableau/next/fr-ca/public/desktop/functions_functions_spatial.md
canonical_url: https://help.tableau.com/v0.0/public/desktop/fr-ca/functions_functions_spatial.htm
source_site: help.tableau.com
content_type: documentation
content_hash: d37434dfad3a9c961339408fbb676c4c19846932df5f22edac678fe1acc83bc2
description: Reference for spatial functions such as BUFFER, DISTANCE, and INTERSECTS.
---
[Passer au contenu principal](#main-content)

# Fonctions spatiales

Les fonctions spatiales vous permettent d’effectuer une analyse spatiale avancée et de combiner des fichiers de données spatiales avec des données dans d’autres formats comme des fichiers texte ou des feuilles de calcul. Par exemple, vous pouvez avoir un fichier de données spatiales des districts municipaux et un fichier texte contenant les coordonnées de latitude et de longitude des nids-de-poule déclarés. Vous pouvez utiliser un calcul spatial lors de la création de votre source de données afin de lier ces fichiers et d’analyser quel district prend le plus de temps pour réparer les nids-de-poule.

Vous pouvez également créer une ligne reliant deux points de données pour les cartes origine-destination. Par exemple, vous pouvez avoir une feuille de calcul de données sur les transports en commun qui vous indique où les navetteurs ont commencé et terminé leurs trajets. Vous pouvez utiliser un calcul spatial pour voir les chemins empruntés par les navetteurs.

## Fonctions de spatiales disponibles dans Tableau

### AREA

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>AREA(Spatial Polygon, 'units')</code></td></tr><tr><td>Résultat</td><td>Nombre</td></tr><tr><td>Définition</td><td>Renvoie la surface totale d’un <code>&lt;spatial polygon&gt;</code>.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">AREA([Geometry], 'feet')</pre></td></tr><tr><td>Remarques</td><td><p>Noms d’unités prises en charge (doivent être entre guillemets dans le calcul, par exemple <code>'miles'</code>)&nbsp;:</p><ul><li><i>mètres</i>&nbsp;: mètres, m</li><li><i>kilomètres</i>&nbsp;: kilomètres, km</li><li><i>milles</i>&nbsp;: milles, mi</li><li><i>pieds</i>&nbsp;: pieds, pi</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>Syntaxe</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>mètres</i>&nbsp;: mètres, m</li><li><i>kilomètres</i>&nbsp;: kilomètres, km</li><li><i>milles</i>&nbsp;: milles, mi</li><li><i>pieds</i>&nbsp;: pieds, pi</li></ul></td></tr><tr><td>Résultat</td><td>Géométrie</td></tr><tr><td>Définition</td><td><p>Dans le cas des points spatiaux, renvoie une forme de polygone centrée sur un <code>&lt;spatial point&gt;</code>, avec un rayon déterminé par les valeurs <code>&lt;distance&gt;</code> et <code>&lt;unit&gt;</code>.</p><p>Pour les chaînes de lignes, calcule les polygones formés en incluant tous les points situés dans le rayon de distance de la chaîne de lignes.</p><p>Pour les polygones, calcule un polygone qui correspond soit à un encart (distance négative), soit à un début (distance positive) de chaque polygone donné.</p></td></tr><tr><td>Exemple</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>Remarques</td><td><p>Noms d’unités prises en charge (doivent être entre guillemets dans le calcul, par exemple <code>'miles'</code>)&nbsp;:</p><ul><li><i>mètres</i>&nbsp;: mètres, m</li><li><i>kilomètres</i>&nbsp;: kilomètres, km</li><li><i>milles</i>&nbsp;: milles, mi</li><li><i>pieds</i>&nbsp;: pieds, pi</li></ul></td></tr></tbody></table>

### DIFFÉRENCE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>DIFFERENCE(Spatial, Spatial)</code></td></tr><tr><td>Résultat</td><td>Polygone spatial</td></tr><tr><td>Définition</td><td>Calcule les parties des zones géographiques restantes lorsque toutes les zones géographiques du deuxième argument sont extraites du premier argument dans des zones qui se chevauchent. Rejette les zones géographiques du deuxième argument dans les zones qui ne se chevauchent pas.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">DIFFERENCE(Spatial Polygon1, Spatial Polygon2)</pre></td></tr><tr><td>Remarques</td><td><p>Prend en charge les polygones et les multipolygones spatiaux, mais pas les lignes ni les points spatiaux.</p></td></tr></tbody></table>

### DISTANCE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>DISTANCE(SpatialPoint1, SpatialPoint2, 'units')</code></td></tr><tr><td>Résultat</td><td>Nombre</td></tr><tr><td>Définition</td><td>Renvoie la mesure de distance entre deux points dans une unité <code>&lt;unit&gt;</code> spécifiée.</td></tr><tr><td>Exemple</td><td><pre>DISTANCE([Origin Point],[Destination Point], 'km')</pre></td></tr><tr><td>Remarques</td><td><p>Noms d’unités prises en charge (doivent être entre guillemets dans le calcul, par exemple <code>'miles'</code>)&nbsp;:</p><ul><li><i>mètres</i>&nbsp;: mètres, m</li><li><i>kilomètres</i>&nbsp;: kilomètres, km</li><li><i>milles</i>&nbsp;: milles, mi</li><li><i>pieds</i>&nbsp;: pieds, pi</li></ul></td></tr><tr><td>Limites de la base de données</td><td>Cette fonction ne peut être créée qu’avec une connexion en direct, mais elle continuera à fonctionner si une source de données est convertie en un extrait.</td></tr></tbody></table>

### INTERSECTION

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>INTERSECTION (spatial, spatial)</code></td></tr><tr><td>Résultat</td><td>Polygones</td></tr><tr><td>Définition</td><td>Calcule et renvoie les parties des zones géographiques du deuxième argument qui chevauchent les zones géographiques du premier argument.</td></tr><tr><td>Exemple</td><td><tt>INTERSECTION (Polygone spatial1, Polygone spatial2)</tt></td></tr><tr><td>Remarques</td><td>Prend en charge les polygones et les multipolygones spatiaux, mais pas les lignes ni les points spatiaux.</td></tr></tbody></table>

### INTERSECTIONS

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>INTERSECTS (geometry1, geometry2)</code></td></tr><tr><td>Résultat</td><td>Booléen</td></tr><tr><td>Définition</td><td>Renvoie une valeur true ou false indiquant si deux géométries se chevauchent dans l’espace.</td></tr><tr><td>Remarques</td><td>Combinaisons prises en charge&nbsp;: point/polygone, ligne/polygone et polygone/polygone.</td></tr></tbody></table>

### LENGTH

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>LENGTH(geometry, 'units')</code></td></tr><tr><td>Résultat</td><td>Nombre</td></tr><tr><td>Définition</td><td>Renvoie la longueur du chemin géodésique de la ou des chaînes de ligne dans la <code>&lt;geometry&gt;</code> en utilisant les <code>&lt;units&gt;</code> données.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">LENGTH([Spatial], 'metres')</pre></td></tr><tr><td>Remarques</td><td>Le résultat est <code>&lt;NaN&gt;</code> si l’argument géométrie n’a pas de chaîne de lignes, bien que d’autres éléments soient autorisés.</td></tr></tbody></table>

### MAKELINE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>MAKELINE(SpatialPoint1, SpatialPoint2)</code></td></tr><tr><td>Résultat</td><td>Géométrie (ligne)</td></tr><tr><td>Définition</td><td>Génère un repère de ligne entre deux points</td></tr><tr><td>Exemple</td><td><pre>MAKELINE(MAKEPOINT(47.59, -122.32), MAKEPOINT(48.5, -123.1))</pre></td></tr><tr><td>Remarques</td><td>Utile pour la création des cartes origine-destination.</td></tr></tbody></table>

### MAKEPOINT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>MAKEPOINT(latitude, longitude, [SRID])</code></td></tr><tr><td>Résultat</td><td>Géométrie (point)</td></tr><tr><td>Définition</td><td><p>Convertit les données des colonnes de <code>&lt;latitude&gt;</code> et de <code>&lt;longitude&gt;</code> en objets spatiaux.</p><p>Si l’argument facultatif <code>&lt;SRID&gt;</code> est ajouté, il est possible de saisir d’autres coordonnées géographiques projetées.</p></td></tr><tr><td>Exemple</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>Remarques</td><td><p><code>MAKEPOINT</code> ne peut pas utiliser les champs de latitude et de longitude générés automatiquement. La source de données doit contenir les coordonnées en natif.</p><p><code>SRID</code> est un identificateur de référence spatiale qui utilise les <a href="https://epsg.io/" target="_blank">codes du système de référence ESPG</a> pour spécifier les systèmes de coordonnées. Si <code>SRID</code> n’est pas spécifié, WGS84 est supposé et les paramètres sont traités comme latitude/longitude en degrés.</p><p>Vous pouvez utiliser <code>MAKEPOINT</code> pour activer spatialement une source de données afin qu’elle puisse être liée à un fichier de données spatiales à l’aide d’une jointure de données spatiales. Pour plus d’information, consultez <a href="https://help.tableau.com/v0.0/public/desktop/fr-ca/maps_spatial_join.htm" class="xref">Lier des fichiers de données spatiales dans 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>Syntaxe</td><td><code>NO_CUTOUTS (spatial)</code></td></tr><tr><td>Résultat</td><td>Polygone spatial corrigé</td></tr><tr><td>Définition</td><td>Renvoie un polygone spatial corrigé si l’interprétation d’une terre plate nécessite des inversions de polygone. Dans le cas contraire, renvoie la valeur d’origine.</td></tr><tr><td>Remarques</td><td><p>Les formats de fichier de données spatiales comme Keyhole Markup Language (.kml) nécessitent que les limites de polygone suivent une direction de coordonnées spécifique. Si un ensemble de données trace des limites à l’envers, Tableau interprète l’espace extérieur comme la forme. <code>NO_CUTOUTS</code> réorganise ces coordonnées pour restaurer la disposition correcte.</p></td></tr></tbody></table>

### OUTLINE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>OUTLINE(spatial polygon)</code></td></tr><tr><td>Résultat</td><td>Géométrie</td></tr><tr><td>Définition</td><td>Convertit une géométrie de polygone en chaînes de lignes.</td></tr><tr><td>Remarques</td><td><p>Utile pour créer un calque séparé pour un contour avec un style différent de celui du remplissage.</p><p>Prend en charge les polygones dans les multipolygones.</p></td></tr></tbody></table>

### PARSE\_WKT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>PARSE_WKT (String)</code></td></tr><tr><td>Résultat</td><td>Spatiale (Géographie)</td></tr><tr><td>Définition</td><td>Convertit un champ de chaîne de texte contenant des représentations au format WKT (Well Known Text) d’entités géographiques (comme des points, des chaînes de lignes ou des polygones) en une valeur spatiale.</td></tr><tr><td>Remarques</td><td><p>Les coordonnées sont supposées utiliser la latitude et la longitude&nbsp;WGS-84. Pour plus d’informations sur le format WKT, consultez <a href="https://fr.wikipedia.org/wiki/Well-known_text">Well-Known Text</a>.</p></td></tr></tbody></table>

### SHAPETYPE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>SHAPETYPE(geometry)</code></td></tr><tr><td>Résultat</td><td>Chaîne</td></tr><tr><td>Définition</td><td>Renvoie une chaîne décrivant la structure de la <code>&lt;geometry&gt;</code> spatiale, par exemple Empty, Point, MultiPoint, LineString, MultiLinestring, Polygon, MultiPolygon, Mixed et des valeurs non prises en charge.</td></tr><tr><td>Exemple</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>Syntaxe</td><td><code>SYMDIFFERENCE(spatial, spatial)</code></td></tr><tr><td>Résultat</td><td>Géométrie</td></tr><tr><td>Définition</td><td>Calcule toutes les parties des zones géographiques du deuxième argument qui chevauchent les zones géographiques du premier argument et rejette des deux arguments. Renvoie les parties restantes des zones géographiques des deux arguments.</td></tr><tr><td>Exemple</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>Syntaxe</td><td><code>UNION(spatial 1, [spatial 2])</code></td></tr><tr><td>Résultat</td><td>Géométrie</td></tr><tr><td>Définition</td><td>Combine les géométries spatiales en fusionnant les limites adjacentes ou qui se chevauchent pour former une seule géométrie spatiale.</td></tr><tr><td>Remarques</td><td><p>Lorsqu’il est utilisé avec un argument (<code>UNION(spatial)</code>), <code>UNION </code>agit comme une fonction d’agrégation qui fusionne, sur l’ensemble des lignes, tous les objets spatiaux d’un champ.</p><p>Lorsqu’il est utilisé avec deux arguments (<code>UNION(spatial1, spatial2)</code>), <code>UNION </code>fusionne deux champs spatiaux ou deux géométries distincts.</p><p>Pour les points et les chaînes de lignes, <code>UNION </code>combine tous les éléments en une seule collection. Pour les polygones, les formes qui se chevauchent ou se touches sont fusionnées en un seul polygone ou multipolygone.</p></td></tr></tbody></table>

### VALIDATE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>VALIDATE(spatial geometry)</code></td></tr><tr><td>Résultat</td><td>Géométrie</td></tr><tr><td>Définition</td><td>Confirme l'exactitude topologique de la géométrie dans votre valeur spatiale. Si la valeur ne peut pas être utilisée pour l’analyse en raison de problèmes tels que l’intersection du périmètre d’un polygone avec lui-même, le résultat sera nul. Si la géométrie est correcte, le résultat sera la géométrie d'origine.</td></tr><tr><td>Exemple</td><td><p><code>UNION(VALIDATE([Geometry]))</code></p></td></tr></tbody></table>

## Utiliser un calcul spatial

### Créer une source de données spatiales à l’aide de MAKEPOINT

Vous pouvez utiliser MAKEPOINT pour activer spatialement une source de données afin qu’elle puisse être liée à un fichier de données spatiales à l’aide d’une jointure de données spatiales. Pour utiliser MAKEPOINT, vos données doivent contenir des coordonnées de latitude et de longitude.

1. Ouvrez Tableau et connectez-vous à une source de données spatiales.
2. Sous Connexions, cliquez sur Ajouter pour ajouter une deuxième source de données non spatiales.
    
    Les deux sources de données spatiales sont ajoutées à l’espace de travail.
    
    > [!TIP]
    > 
    > Conseil : Pour faire apparaître la boîte de dialogue Jointure, double-cliquez (contrôle-clic sur Mac) sur une source de données sur l’espace de travail.
3. Faites glisser la source de données non spatiale vers la boîte de dialogue Jointure.
4. Cliquez sur l’icône Jointure.
5. Dans la boîte de dialogue Jointure qui s’affiche, procédez comme suit :
    - Sélectionnez un type de jointure.
    - Dans Source de données, sélectionnez un champ de données spatiales par lequel effectuer la jointure. Une icône de globe s’affiche à côté des champs de données spatiales.
6. Pour la source de données non spatiales, sélectionnez Créer un calcul de jointure comme clause de jointure.  
    ![La boîte de dialogue de jointure avec l’option Créer un calcul de jointure.](/tableau/next/fr-ca/public/desktop/fr-ca/Img/maps_spatialcalcs_csvspatial.png)
    
    Le calcul devrait se présenter ainsi :
    
    `MAKEPOINT(Latitude,Longitude)`
7. Sélectionnez OK.
8. Sélectionnez l’opérateur de clause de jointure Intersections pour créer une source de données pour l’analyse spatiale.
9. Une fois que vous avez fini, fermez la boîte de dialogue de jointure.

Pour plus d’informations sur les jointures de données spatiales, consultez [Lier des fichiers de données spatiales dans Tableau](https://help.tableau.com/v0.0/public/desktop/fr-ca/maps_spatial_join.htm).

### Créer une visualisation à l’aide de MAKEPOINT

Dans Tableau Desktop, téléchargez le classeur Flight Path sur Tableau Public ([disponible ici](https://public.tableau.com/views/UseSpatialFunctionsMakeLineExampleWorkbook/FinishedFlightpaths? :embed=y& :display_count=yes&publish=yes& :origin=viz_share_link)).

1. Accédez à une nouvelle feuille de calcul.
2. Sélectionnez Analyse > Créer un champ calculé.
3. Dans le calcul qui s’ouvre, procédez comme suit :

- Nommez le champ calculé Itinéraires de vol
- Entrez la formule suivante

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

Cette formule prend les coordonnées de latitude et de longitude des villes d’origine et de destination, et les transforme en points géographiques pour l’analyse spatiale. Ces coordonnées sont utilisées pour créer des lignes à deux points entre l’origine et la destination.

7. Lorsque vous avez terminé, cliquez sur OK.

Le nouveau champ calculé apparaît sous Dimensions dans le volet Données. Comme vos autres champs, vous pouvez l’utiliser dans une ou plusieurs visualisations.

9. Dans le volet Données, double-cliquez sur Itinéraires de vol pour l’ajouter à votre visualisation. Il sera automatiquement rendu sous forme de carte.

![Une carte montrant les itinéraires de vol aux États-Unis et au Mexique.](/tableau/next/fr-ca/public/desktop/fr-ca/Img/maps_spatialcalcs_flight.png)

Le calcul produit automatiquement des lignes géodésiques courbes lorsque les lignes s’étendent sur de plus grandes zones du globe.

### Visualiser une zone avec BUFFER

Dans Tableau Desktop, téléchargez le classeur Flight Path sur Tableau Public ([disponible ici](https://public.tableau.com/views/UseSpatialFunctionsMakeLineExampleWorkbook/FinishedFlightpaths? :embed=y& :display_count=yes&publish=yes& :origin=viz_share_link)).

1. Accédez à une nouvelle feuille de calcul.
2. Faites un clic droit dans le volet Données, puis sélectionnez Créer un paramètre.
3. Dans la boîte de dialogue Paramètres qui s’ouvre, définissez les options ci-dessous :
    
    - Nommez le paramètre Buffer Distance
    - Définissez le Type de données sur Entier
    - Définissez Valeurs autorisées sur Plage
    - Fixez la plage minimale à 100, la plage maximale à 1000 et la taille d’incrément à 100.
    
    ![Boîte de dialogue Créer un paramètre avec le nom défini sur la distance du tampon, le type de données défini sur entier, les valeurs autorisées définies sur plage, la plage minimum définie sur 100, la plage maximum définie sur 1 000 et la taille d’incrément définie sur 100.](/tableau/next/fr-ca/public/desktop/fr-ca/Img/map_buffer_2.png)
4. Lorsque vous avez terminé, cliquez sur OK.

Ce paramètre nous permet de personnaliser le rayon de notre tampon, allant de 100 à 1000 miles. Faites un clic droit sur un paramètre et sélectionnez Afficher le paramètre.

6. Sélectionnez Analyse > Créer un champ calculé.
7. Dans le calcul qui s’ouvre, procédez comme suit :

- Nommez le champ calculé Buffer.
- Entrez la formule suivante

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

Le calcul BUFFER prend des données spatiales ponctuelles et les convertit en formes avec un rayon en miles déterminé par le paramètre de la distance du tampon.

Remarque : puisque BUFFER ne peut être utilisé qu’avec des données spatiales ponctuelles, nous convertissons les données de latitude et de longitude en un point avec Makepoint, comme le montre l’exemple précédent.

12. Lorsque vous avez terminé, cliquez sur OK.

Le nouveau champ calculé apparaît dans le volet Données. Comme vos autres champs, vous pouvez l’utiliser dans une ou plusieurs visualisations.

14. Dans le volet Données, double-cliquez sur Buffer pour l’ajouter à votre visualisation. Il sera automatiquement rendu sous forme de carte.
15. Faites glisser Destination vers le volet Couleur de la fiche Repères pour compléter la visualisation.

![Fiche tampon avec des repères de type carte.](/tableau/next/fr-ca/public/desktop/fr-ca/Img/map_buffer_1.png)

**Remarque :** si votre vue ne ressemble pas à l’image ci-dessus, assurez-vous que le type de repère est défini sur Carte et non sur Cercle. Pour plus d’informations sur le type de repère, consultez [Modifier le type de repères dans la vue](https://help.tableau.com/v0.0/public/desktop/fr-ca/viewparts_marks_marktypes.htm).