Catégories :

Fonctions géospatiales

ST_INTERSECTION

En tenant compte de deux objets GEOGRAPHY d’entrée, renvoie un objet GEOGRAPHY qui représente la forme de l’ensemble des points qui sont communs aux deux objets d’entrée (c’est-à-dire l’intersection des deux objets).

Voir aussi :

ST_INTERSECTION_AGG , ST_UNION , ST_DIFFERENCE , ST_SYMDIFFERENCE

Syntaxe

ST_INTERSECTION( <geography_expression_1> , <geography_expression_2> )
Copy

Arguments

geography_expression_1

Un objet GEOGRAPHY.

geography_expression_2

Un objet GEOGRAPHY.

Renvoie

La fonction renvoie une valeur de type GEOGRAPHY.

Notes sur l’utilisation

  • Si un sommet d’un objet d’entrée se trouve sur la limite de l’autre objet d’entrée (à l’exclusion des sommets), la sortie peut inclure ou non ce point de sommet.

    Par exemple, supposons que geography_expression_1 soit POINT(1 1) et que geography_expression_2 soit LINESTRING(1 0, 1 2). Dans ce cas, geography_expression_1 est sur la limite de geography_expression_2 mais n’en est pas un sommet.

    Dans cet exemple, la sortie attendue est POINT(1 1), mais la sortie réelle pourrait être une géographie vide (représentée par NULL).

    Pour aider à détecter et à contourner ces cas, une idée potentielle consiste à utiliser ST_DWITHIN pour déterminer si la distance minimale entre les deux objets d’entrée est 0. Par exemple, vous pouvez vérifier si un point se trouve au sommet d’un LineString en vérifiant si la distance minimale entre les deux objets est égale à zéro :

    SELECT TO_GEOGRAPHY('POLYGON((0 0, 1 0, 2 1, 1 2, 2 3, 1 4, 0 4, 0 0))') AS polygon,
           TO_GEOGRAPHY('POINT(0 2)') AS point,
           ST_DWITHIN(polygon, point, 0) AS point_is_on_top_of_polygon,
           ST_INTERSECTION(polygon, point);
    
    Copy

    Cette instruction produit le résultat suivant :

    +--------------------------------------------+------------+----------------------------+---------------------------------+
    | POLYGON                                    | POINT      | POINT_IS_ON_TOP_OF_POLYGON | ST_INTERSECTION(POLYGON, POINT) |
    |--------------------------------------------+------------+----------------------------+---------------------------------|
    | POLYGON((0 0,1 0,2 1,1 2,2 3,1 4,0 4,0 0)) | POINT(0 2) | True                       | NULL                            |
    +--------------------------------------------+------------+----------------------------+---------------------------------+
    
    Copy

    Il n’est pas garanti que la fonction produise des résultats normalisés et/ou minimaux. Par exemple, une sortie peut consister en un LineString contenant plusieurs points qui ne forment en fait qu’un seul segment droit.

Exemples

L’exemple suivant renvoie un objet GEOGRAPHY qui représente l’intersection de deux objets GEOGRAPHY en entrée :

ALTER SESSION SET GEOGRAPHY_OUTPUT_FORMAT = 'WKT';

SELECT ST_INTERSECTION(
  TO_GEOGRAPHY('POLYGON((0 0, 1 0, 2 1, 1 2, 2 3, 1 4, 0 4, 0 0))'),
  TO_GEOGRAPHY('POLYGON((3 0, 3 4, 2 4, 1 3, 2 2, 1 1, 2 0, 3 0))'))
AS intersection_of_objects;
Copy

Cet exemple produit le résultat suivant :

+-----------------------------------------------------------------------------------------------------------------------------------------+
| INTERSECTION_OF_OBJECTS                                                                                                                 |
|-----------------------------------------------------------------------------------------------------------------------------------------|
| MULTIPOLYGON(((1.5 0.5000571198,2 1,1.5 1.500171359,1 1,1.5 0.5000571198)),((1.5 2.500285599,2 3,1.5 3.500399839,1 3,1.5 2.500285599))) |
+-----------------------------------------------------------------------------------------------------------------------------------------+
Copy

Les images suivantes illustrent les différences dans les zones qui représentent les objets d’entrée et de sortie :

Entrée

Sortie

Zones des objets d'entrée transmis à ST_INTERSECTION Zones des objets de sortie renvoyés par ST_INTERSECTION