Categorias:: Funções geospaciais

ST_COVEREDBY¶

Retorna TRUE se nenhum ponto em um objeto geoespacial estiver fora de outro objeto geoespacial. Em outras palavras:

O objeto GEOGRAPHY g1 está fora do objeto GEOGRAPHY g2.
O objeto GEOMETRY g1 está fora do objeto GEOMETRY g2.

Isso equivale a ST_COVERS(g2, g1).

Embora ST_COVEREDBY e ST_WITHIN possam parecer semelhantes, as duas funções têm diferenças sutis. Para obter mais detalhes sobre as diferenças entre “covered by” e “within”, consulte o Dimensionally Extended 9-Intersection Model (DE-9IM).

Nota

Esta função não oferece suporte ao uso de um GeometryCollection ou FeatureCollection como valores de entrada.

Dica

Você pode usar o serviço de otimização de pesquisa para melhorar o desempenho de consultas que chamam essa função. Para obter mais detalhes, consulte Search optimization service.

Consulte também:: ST_COVERS, ST_WITHIN

Sintaxe¶

ST_COVEREDBY( <geography_expression_1> , <geography_expression_2> ) ST_COVEREDBY( <geometry_expression_1> , <geometry_expression_2> ) 

Copy

Argumentos¶

geography_expression_1: Um objeto GEOGRAPHY que não é um GeometryCollection ou FeatureCollection.
geography_expression_2: Um objeto GEOGRAPHY que não é um GeometryCollection ou FeatureCollection.
geometry_expression_1: Um objeto GEOMETRY que não é um GeometryCollection ou FeatureCollection.
geometry_expression_2: Um objeto GEOMETRY que não é um GeometryCollection ou FeatureCollection.

Retornos¶

BOOLEAN.

Notas de uso¶

Para objetos GEOMETRY, a função reporta um erro se os dois objetos GEOMETRY de entrada tiverem SRIDs diferentes.

Exemplos¶

Exemplos GEOGRAPHY¶

Isto mostra uma simples utilização da função ST_COVEREDBY:

create table geospatial_table_01 (g1 GEOGRAPHY, g2 GEOGRAPHY); insert into geospatial_table_01 (g1, g2) values ('POLYGON((0 0, 3 0, 3 3, 0 3, 0 0))', 'POLYGON((1 1, 2 1, 2 2, 1 2, 1 1))'); 

Copy

SELECT ST_COVEREDBY(g1, g2) FROM geospatial_table_01; +----------------------+ | ST_COVEREDBY(G1, G2) | |----------------------| | False | +----------------------+ 

Copy