Categorias:: Funções geoespaciais

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 Serviço de otimização de pesquisa.

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