---
schema_version: "1"
id: 8c7d268d503f442a2370adf33a4ab395a4856671953202cb3caadc71f65d3a23
title: Funções espaciais
collection: tableau
version: next
locale: pt-br
portal_url: https://docs.salesforce.com/tableau/next/pt-br/public/desktop/functions_functions_spatial.md
canonical_url: https://help.tableau.com/v0.0/public/desktop/pt-br/functions_functions_spatial.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 1ced6e5aaccf61acf93243a44ecc570b9ff830ae570bd7911ca2669599290793
description: Reference for spatial functions such as BUFFER, DISTANCE, and INTERSECTS.
---
[Pular para o conteúdo principal](#main-content)

# Funções espaciais

As funções espaciais permitem executar a análise espacial avançada e combinar arquivos espaciais com dados em outros formatos, como arquivos de texto ou planilhas. Por exemplo, você pode ter um arquivo espacial de distritos da câmara municipal e um arquivo de texto que contém coordenadas de latitude e longitude de buracos relatados. Você pode usar um cálculo espacial ao criar sua fonte de dados para unir esses arquivos e analisar qual distrito leva mais tempo para reparar os buracos.

Você também pode criar uma linha que conecta dois pontos de dados para mapas de origem-destino. Por exemplo, você pode ter uma planilha de dados de transporte público que informa onde os passageiros começaram e terminaram suas viagens. Você pode usar um cálculo espacial para ver quais caminhos os passageiros estão tomando.

## Funções Espaciais disponíveis no Tableau

### ÁREA

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>AREA(Spatial Polygon, 'units')</code></td></tr><tr><td>Saída</td><td>Número</td></tr><tr><td>Definição</td><td>Retorna a área total da superfície de um <code>&lt;spatial polygon&gt;</code>.</td></tr><tr><td>Exemplo</td><td><pre xml:space="preserve">AREA([Geometry], 'feet')</pre></td></tr><tr><td>Observações</td><td><p>Nomes de unidades aceitas (devem estar entre aspas no cálculo, como <code>'miles'</code>):</p><ul><li><i>metros</i>: metros, m</li><li><i>quilômetros</i>: quilômetros, km</li><li><i>milhas</i>: milhas, mi</li><li><i>pés</i>: pés</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>Sintaxe</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>metros</i>: metros, m</li><li><i>quilômetros</i>: quilômetros, km</li><li><i>milhas</i>: milhas, mi</li><li><i>pés</i>: pés</li></ul></td></tr><tr><td>Saída</td><td>Geometria</td></tr><tr><td>Definição</td><td><p>Para pontos espaciais, retorna uma forma poligonal centrada sobre um <code>&lt;spatial point&gt;</code>, com raio determinado pelos valores <code>&lt;distance&gt;</code> e <code>&lt;unit&gt;</code>.</p><p>Para cadeias de caracteres de linhas, calcula os polígonos formados incluindo todos os pontos dentro da distância do raio da cadeia de caracteres de linhas.</p><p>Para polígonos, calcula um polígono que é um recuo (distância negativa) ou um avanço (distância positiva) de cada polígono fornecido.</p></td></tr><tr><td>Exemplo</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>Observações</td><td><p>Nomes de unidades aceitas (devem estar entre aspas no cálculo, como <code>'miles'</code>):</p><ul><li><i>metros</i>: metros, m</li><li><i>quilômetros</i>: quilômetros, km</li><li><i>milhas</i>: milhas, mi</li><li><i>pés</i>: pés</li></ul></td></tr></tbody></table>

### DIFFERENCE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>DIFFERENCE(Spatial, Spatial)</code></td></tr><tr><td>Saída</td><td>Polígono espacial</td></tr><tr><td>Definição</td><td>Calcula as porções de regiões restantes quando todas as regiões no segundo argumento são extraídas do primeiro argumento em áreas que se sobrepõem.Descarta regiões do segundo argumento em áreas que não se sobrepõem.</td></tr><tr><td>Exemplo</td><td><pre xml:space="preserve">DIFFERENCE(Spatial Polygon1, Spatial Polygon2)</pre></td></tr><tr><td>Observações</td><td><p>Aceita polígonos e multipolígonos espaciais, pontos ou linhas não espaciais.</p></td></tr></tbody></table>

### DISTÂNCIA

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>DISTANCE(SpatialPoint1, SpatialPoint2, 'units')</code></td></tr><tr><td>Saída</td><td>Número</td></tr><tr><td>Definição</td><td>Retorna a medida da distância entre dois pontos na <code>&lt;unit&gt;</code> especificada.</td></tr><tr><td>Exemplo</td><td><pre>DISTANCE([Origin Point],[Destination Point], 'km')</pre></td></tr><tr><td>Observações</td><td><p>Nomes de unidades aceitas (devem estar entre aspas no cálculo, como <code>'miles'</code>):</p><ul><li><i>metros</i>: metros, m</li><li><i>quilômetros</i>: quilômetros, km</li><li><i>milhas</i>: milhas, mi</li><li><i>pés</i>: pés</li></ul></td></tr><tr><td>Limitações do banco de dados</td><td>Essa função só pode ser criada com uma conexão em tempo real, mas continuará a funcionar se uma fonte de dados for convertida em uma extração.</td></tr></tbody></table>

### INTERSECTION

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>INTERSECTION (spatial, spatial)</code></td></tr><tr><td>Saída</td><td>Polígono</td></tr><tr><td>Definição</td><td>Calcula e retorna as partes de regiões no segundo argumento que se sobrepõem às regiões no primeiro argumento.</td></tr><tr><td>Exemplo</td><td><tt>INTERSECTION (Spatial Polygon1, Spatial Polygon2)</tt></td></tr><tr><td>Observações</td><td>Aceita polígonos e multipolígonos espaciais, pontos ou linhas não espaciais.</td></tr></tbody></table>

### INTERSECTS

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>INTERSECTS (geometry1, geometry2)</code></td></tr><tr><td>Saída</td><td>Booliano</td></tr><tr><td>Definição</td><td>Retorna true ou false indicando se duas geometrias se sobrepõem no espaço.</td></tr><tr><td>Observações</td><td>Combinações suportadas: ponto/polígono, linha/polígono e polígono/polígono.</td></tr></tbody></table>

### LENGTH

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>LENGTH(geometry, 'units')</code></td></tr><tr><td>Saída</td><td>Número</td></tr><tr><td>Definição</td><td>Retorna o comprimento do caminho geodésico da sequência de linhas ou sequências no <code>&lt;geometry&gt;</code> usando <code>&lt;units&gt;</code> fornecido.</td></tr><tr><td>Exemplo</td><td><pre xml:space="preserve">LENGTH([Spatial], 'metres')</pre></td></tr><tr><td>Observações</td><td>O resultado será <code>&lt;NaN&gt;</code> se o argumento de geometria não tiver cadeias de linha, embora outros elementos sejam permitidos.</td></tr></tbody></table>

### MAKELINE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>MAKELINE(SpatialPoint1, SpatialPoint2)</code></td></tr><tr><td>Saída</td><td>Geometria (linha)</td></tr><tr><td>Definição</td><td>Gera uma marca de linha entre dois pontos</td></tr><tr><td>Exemplo</td><td><pre>MAKELINE(MAKEPOINT(47.59, -122.32), MAKEPOINT(48.5, -123.1))</pre></td></tr><tr><td>Observações</td><td>Útil para construir mapas de origem-destino.</td></tr></tbody></table>

### MAKEPOINT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>MAKEPOINT(latitude, longitude, [SRID])</code></td></tr><tr><td>Saída</td><td>Geometria (ponto)</td></tr><tr><td>Definição</td><td><p>Converte dados das colunas <code>&lt;latitude&gt;</code> e <code>&lt;longitude&gt;</code> em objetos espaciais.</p><p>Se o argumento opcional <code>&lt;SRID&gt;</code> é adicionado, as entradas podem ser outras coordenadas geográficas projetadas.</p></td></tr><tr><td>Exemplo</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>Observações</td><td><p><code>MAKEPOINT</code> não pode usar os campos de latitude e longitude gerados automaticamente.A fonte de dados deve conter as coordenadas nativamente.</p><p><code>SRID</code> é um identificador de referência espacial que utiliza os códigos do <a href="https://epsg.io/" target="_blank">sistema de referência ESPG</a> para especificar sistemas de coordenadas.Se o <code>SRID</code> não for especificado, o WGS84 será considerado e os parâmetros serão tratados como latitude/longitude em graus.</p><p>Você pode usar o <code>MAKEPOINT</code> para ativar espacialmente uma fonte de dados para que ela possa ser unida a um arquivo espacial, utilizando uma ligação espacial.Para obter mais informações, consulte <a href="https://help.tableau.com/v0.0/public/desktop/pt-br/maps_spatial_join.htm" class="xref">Unir arquivos espaciais no 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>Sintaxe</td><td><code>NO_CUTOUTS (spatial)</code></td></tr><tr><td>Saída</td><td>Polígono espacial corrigido</td></tr><tr><td>Definição</td><td>Retorna um polígono espacial corrigido se uma interpretação de terra simples exigir inversões de polígono; caso contrário, retorna o original.</td></tr><tr><td>Observações</td><td><p>Formatos de arquivo espaciais como Keyhole Markup Language (.kml) exigem limites de polígono para seguir uma direção de coordenada específica.Se um conjunto de dados desenha limites ao contrário, o Tableau interpretará o espaço externo como a forma.<code>NO_CUTOUTS</code> reordena essas coordenadas para restaurar o layout correto.</p></td></tr></tbody></table>

### OUTLINE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>OUTLINE(spatial polygon)</code></td></tr><tr><td>Saída</td><td>Geometria</td></tr><tr><td>Definição</td><td>Converte uma geometria poligonal em cadeias de linhas.</td></tr><tr><td>Observações</td><td><p>Útil para criar uma camada separada para um contorno que pode ter um estilo diferente do preenchimento.</p><p>Aceita polígonos dentro de multipolígonos.</p></td></tr></tbody></table>

### PARSE\_WKT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>PARSE_WKT (String)</code></td></tr><tr><td>Saída</td><td>Espacial (Geografia)</td></tr><tr><td>Definição</td><td>Converte um campo de cadeia de caracteres de texto que contém representações de texto conhecidas (WKT) de entidades geográficas (como pontos, cadeias de linhas ou polígonos) em um valor espacial.</td></tr><tr><td>Observações</td><td><p>Presume-se que as coordenadas usem a latitude e longitude WGS-84.Para obter mais informações sobre o WKT, consulte <a href="https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry">Representação de texto conhecida da Geometria</a>.</p></td></tr></tbody></table>

### SHAPETYPE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>SHAPETYPE(geometry)</code></td></tr><tr><td>Saída</td><td>Cadeia de caracteres</td></tr><tr><td>Definição</td><td>Retorna uma cadeia de caracteres descrevendo a estrutura do espaço <code>&lt;geometry&gt;</code>, como Empty, Point, MultiPoint, LineString, MultiLinestring, Polygon, MultiPolygon, Mixed e unsupported (Vazio, Ponto, Multiponto, Cadeia de caracteres de linha, Cadeia de caracteres de várias linhas, Polígono, VáriosPolígonos, Combinado e sem suporte).</td></tr><tr><td>Exemplo</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>Sintaxe</td><td><code>SYMDIFFERENCE(spatial, spatial)</code></td></tr><tr><td>Saída</td><td>Geometria</td></tr><tr><td>Definição</td><td>Calcula quaisquer porções de regiões do segundo argumento que se sobrepõem às regiões do primeiro argumento e descarta ambas.Retorna as porções restantes das regiões de ambos os argumentos.</td></tr><tr><td>Exemplo</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>Sintaxe</td><td><code>UNION(spatial 1, [spatial 2])</code></td></tr><tr><td>Saída</td><td>Geometria</td></tr><tr><td>Definição</td><td>Combina geometrias espaciais dissolvendo limites adjacentes ou sobrepostos em uma única geometria espacial.</td></tr><tr><td>Observações</td><td><p>Quando usado com um argumento (<code>UNION(spatial)</code>), <code>UNION </code>atua como uma função de agregação que mescla todos os objetos espaciais em um campo entre linhas.</p><p>Quando usado com dois argumentos (<code>UNION(spatial1, spatial2)</code>), o <code>UNION </code>mescla dois campos espaciais ou geometrias distintas.</p><p>Para pontos e linestrings, <code>UNION </code>combina todos os elementos em uma única coleção.Para polígonos, formas sobrepostas ou que se tocam se dissolvem em um único polígono ou multipolígono.</p></td></tr></tbody></table>

### VALIDATE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Sintaxe</td><td><code>VALIDATE(spatial geometry)</code></td></tr><tr><td>Saída</td><td>Geometria</td></tr><tr><td>Definição</td><td>Confirma a correção topológica da geometria no seu valor espacial.Se o valor não puder ser usado para análise devido a problemas como o perímetro de um polígono se cruzando, o resultado será nulo.Se a geometria estiver correta, o resultado será a geometria original.</td></tr><tr><td>Exemplo</td><td><p><code>UNION(VALIDATE([Geometry]))</code></p></td></tr></tbody></table>

## Usar um cálculo de espacial

### Criar uma fonte de dados espaciais usando o MakePoint

Você pode usar o MAKEPOINT para ativar espacialmente uma fonte de dados para que ela possa ser unida a um arquivo espacial, utilizando uma ligação espacial. Para utilizar o MAKEPOINT, os dados devem conter coordenadas de latitude e longitude.

1. Abra o Tableau e se conecte a fonte de dados espaciais.
2. Em Conexões, clique em Adicionar para adicionar uma segunda fonte de dados não espaciais.
    
    As duas fontes de dados são adicionadas ao canvas.
    
    > [!TIP]
    > 
    > Dica: para que a caixa de diálogo União de colunas seja exibida, clique duas vezes (clique com controle no Mac) em uma fonte de dados na tela.
3. Arraste a fonte de dados não espacial para a caixa de diálogo União de colunas.
4. Clique no ícone Unir colunas.
5. Na caixa de diálogo Unir exibida, faça o seguinte:
    - Selecione um tipo de união.
    - Em Fonte de dados, selecione um campo espacial no arquivo espacial para unir. Os campos espaciais têm um ícone de globo ao lado deles.
6. Para a fonte de dados não espaciais, selecione Criar cálculo de união como a cláusula de união.  
    ![A caixa de diálogo de união com opção para Criar cálculo de união.](/tableau/next/pt-br/public/desktop/pt-br/Img/maps_spatialcalcs_csvspatial.png)
    
    O cálculo deve ficar mais ou menos assim:
    
    `MAKEPOINT(Latitude,Longitude)`
7. Selecione OK.
8. Selecione o operador de cláusula de união de colunas de Intersects para criar uma fonte de dados para análise espacial.
9. Ao concluir, feche a caixa de diálogo Unir.

Para obter mais informações sobre uniões espaciais, consulte [Unir arquivos espaciais no Tableau](https://help.tableau.com/v0.0/public/desktop/pt-br/maps_spatial_join.htm)

### Criar uma visualização usando o MakeLine

No Tableau Desktop, baixe a pasta de trabalho do Percursos de voo do Tableau Public, [disponível aqui](https://public.tableau.com/views/UseSpatialFunctionsMakeLineExampleWorkbook/FinishedFlightpaths?:embed=y&:display_count=yes&publish=yes&:origin=viz_share_link).

1. Navegue até uma nova planilha.
2. Selecione Análise > Criar campo calculado.
3. No de cálculo aberto, faça o seguinte:

- Nomeie o campo calculado Percursos de voo.
- Insira a fórmula a seguir

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

Essa fórmula usa coordenadas de latitude e longitude de suas cidades de origem e destino e as transforma em pontos geográficos para análise espacial. Estas coordenadas são utilizadas para construir linhas de dois pontos entre origem e destino.

7. Ao terminar, clique em OK.

O novo campo calculado aparece em Dimensões no painel Dados. Assim como os outros campos, é possível usá-lo em uma ou mais visualizações.

9. No painel Dados, clique duas vezes em Percursos de Voo para adicioná-lo à visualização, a qual deve renderizar automaticamente como um mapa.

![Um mapa ilustrando rotas de voo dentro dos Estados Unidos e do México.](/tableau/next/pt-br/public/desktop/pt-br/Img/maps_spatialcalcs_flight.png)

O cálculo produz automaticamente linhas geodésicas curvas quando as linhas se propagam por extensões mais longas do globo.

### Visualizar uma área com BUFFER

No Tableau Desktop, baixe a pasta de trabalho do Percursos de voo do Tableau Public, [disponível aqui](https://public.tableau.com/views/UseSpatialFunctionsMakeLineExampleWorkbook/FinishedFlightpaths?:embed=y&:display_count=yes&publish=yes&:origin=viz_share_link).

1. Navegue até uma nova planilha.
2. Clique com o botão direito do mouse no painel Dados e selecione Criar parâmetro.
3. Na caixa de diálogo Parâmetro exibida, defina as opções abaixo:
    
    - Nomeie o parâmetro Distância do buffer
    - Defina o Tipo de dados como Inteiro
    - Defina os Valores permitidos como Intervalo
    - Defina a faixa Mínima para 100, a faixa Máxima até 1.000 e o tamanho de etapas para 100.
    
    ![Caixa de diálogo Criar parâmetro com o nome definido como distância do buffer, tipo de dados definido como inteiro, valores permitidos definidos como intervalo, intervalo mínimo definido como 100, intervalo máximo definido como 1000 e tamanho da etapa definido como 100.](/tableau/next/pt-br/public/desktop/pt-br/Img/map_buffer_2.png)
4. Ao terminar, clique em OK.

Esse parâmetro nos permite personalizar o raio do buffer, variando de 100 a 1.000 milhas. Clique com o botão direito do mouse no parâmetro e selecione Mostrar o parâmetro.

6. Selecione Análise > Criar campo calculado.
7. No de cálculo aberto, faça o seguinte:

- Nomeie o Buffer do campo calculado
- Insira a fórmula a seguir

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

O cálculo do BUFFER utiliza os dados espaciais do ponto e converte-os em formas com um raio em milhas, determinado pelo parâmetro Distância do buffer.

Observação: como o BUFFER pode ser usado apenas com dados espaciais do ponto, estamos convertendo os dados de latitude e longitude em um ponto com o Makepoint, como demonstrado no exemplo anterior.

12. Ao terminar, clique em OK.

O novo campo calculado aparece no painel Dados. Assim como os outros campos, é possível usá-lo em uma ou mais visualizações.

14. No painel Dados, clique duas vezes em Buffer para adicioná-lo à visualização, que deve ser automaticamente renderizada como um mapa.
15. Arraste Destino até o painel Cor, no cartão Marcas, para concluir a visualização.

![Mapa de buffer com marcas de tipo de mapa.](/tableau/next/pt-br/public/desktop/pt-br/Img/map_buffer_1.png)

**Observação:** se a exibição não se parecer com a imagem acima, verifique se o tipo de Marca está definido como Mapa e não Círculo. Para obter mais informações sobre os tipos de Marcas, consulte [Alterar o tipo de marca na exibição](https://help.tableau.com/v0.0/public/desktop/pt-br/viewparts_marks_marktypes.htm).