Categorias:: Funções geospaciais

ST_DISJOINT¶

Retorna TRUE se os dois objetos GEOGRAPHY ou os dois objetos GEOMETRY não forem contíguos (ou seja, não compartilharem nenhuma parcela de espaço). ST_DISJOINT é equivalente a NOT ST_INTERSECTS(expr1, expr2).

Nota

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

Consulte também:: ST_INTERSECTS

Sintaxe¶

ST_DISJOINT( <geography_expression_1> , <geography_expression_2> )

ST_DISJOINT( <geometry_expression_1> , <geometry_expression_2> )

Argumentos¶

geography_expression_1: Um objeto GEOGRAPHY.
geography_expression_2: Um objeto GEOGRAPHY.
geometry_expression_1: Um objeto GEOMETRY.
geometry_expression_2: Um objeto GEOMETRY.

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¶

Os exemplos seguintes usam a função ST_DISJOINT para determinar se dois objetos geoespaciais não são contíguos:

-- These two polygons are disjoint and do not intersect.
SELECT ST_DISJOINT(
    TO_GEOGRAPHY('POLYGON((0 0, 2 0, 2 2, 0 2, 0 0))'),
    TO_GEOGRAPHY('POLYGON((3 3, 5 3, 5 5, 3 5, 3 3))')
    );
+---------------------------------------------------------+
| ST_DISJOINT(                                            |
|     TO_GEOGRAPHY('POLYGON((0 0, 2 0, 2 2, 0 2, 0 0))'), |
|     TO_GEOGRAPHY('POLYGON((3 3, 5 3, 5 5, 3 5, 3 3))')  |
|     )                                                   |
|---------------------------------------------------------|
| True                                                    |
+---------------------------------------------------------+

-- These two polygons intersect and are not disjoint.
SELECT ST_DISJOINT(
    TO_GEOGRAPHY('POLYGON((0 0, 2 0, 2 2, 0 2, 0 0))'),
    TO_GEOGRAPHY('POLYGON((1 1, 3 1, 3 3, 1 3, 1 1))')
    );
+---------------------------------------------------------+
| ST_DISJOINT(                                            |
|     TO_GEOGRAPHY('POLYGON((0 0, 2 0, 2 2, 0 2, 0 0))'), |
|     TO_GEOGRAPHY('POLYGON((1 1, 3 1, 3 3, 1 3, 1 1))')  |
|     )                                                   |
|---------------------------------------------------------|
| False                                                   |
+---------------------------------------------------------+