Funções espaciais

Funções espaciais podem ser usadas com dados geoespaciais. Por exemplo, elas permitem calcular as distâncias entre dois pontos, a área de um polígono, entre outras coisas.

Também pode haver situações que requerem uma mesclagem de diversos conjuntos de dados geoespaciais baseados em um predicado espacial (dentro, perto de, entre outros), o que pode ser feito por meio de uma condição de mesclagem.

Notas:

Essas funções espaciais não se aplicam a dados tridimensionais. Se você importar dados tridimensionais para um fluxo, apenas as duas primeiras dimensões serão usadas por essas funções. Os valores do eixo Z serão ignorados.
As funções geoespaciais não são suportadas.

Tabela 1. Funções espaciais do CLEM
Função	Resultado	Descrição
`close_to(SHAPE,SHAPE,NUM)`	Booleano	Testa se 2 formas estão dentro de uma certa DISTANCE uma da outra. Se um sistema de coordenadas projetadas for usado, a DISTANCE será em metros. Se nenhum sistema de coordenadas for usado, essa será uma unidade arbitrária.
`crosses(SHAPE,SHAPE)`	Booleano	Testa se 2 formas cruzam uma à outra. Essa função é adequada para 2 formas de linestring ou 1 linestring e um 1 polígono.
`overlap(SHAPE,SHAPE)`	Booleano	Testa se há uma interseção entre 2 polígonos e se a interseção é interior para ambas as formas.
`within(SHAPE,SHAPE)`	Booleano	Testa se a totalidade de SHAPE1 está contida em um POLYGON.
`area(SHAPE)`	Real	Retorna a área do POLYGON especificado. Se um sistema planejado for usado, a função retornará metros quadrados. Se nenhum sistema de coordenadas for usado, essa será uma unidade arbitrária. A forma deve ser POLYGON ou a MULTIPOLYGON.
`num_points(SHAPE,LIST)`	Número inteiro	Retorna o número de pontos de um campo de ponto (MULTIPOINT) que estão contidos dentro dos limites de um POLYGON. SHAPE1 deve ser POLYGON ou MULTIPOLYGON.
`distance(SHAPE,SHAPE)`	Real	Retorna a distância entre SHAPE1 e SHAPE2. Se um sistema de coordenadas projetadas for usado, a função retornará metros. Se nenhum sistema de coordenadas for usado, essa será uma unidade arbitrária. SHAPE1 e SHAPE2 podem ser qualquer tipo de medição geo.