ST_Distance

Pour les géométries d’entrée, ST_Distance renvoie la distance euclidienne minimale entre les projections 2D des deux valeurs géométriques d’entrée.

Pour les géométries 3DM, 3DZ, 4D, ST_Distance renvoie la distance euclidienne entre les projections 2D de deux valeurs géométriques en entrée.

Pour les géographies d’entrée, ST_Distance renvoie la distance géodésique des deux points 2D. L’unité de distance est exprimée en mètres. Pour les zones géographiques autres que les points et les points vides, une erreur est renvoyée.

Syntaxe

ST_Distance(geo1, geo2)

Arguments

geo1

Valeur de type de données GEOMETRY ou GEOGRAPHY ou expression qui est évaluée sur un type GEOMETRY ou GEOGRAPHY. Le type de données de geo1 doit être identique à geo2.

geo2

Valeur de type de données GEOMETRY ou GEOGRAPHY ou expression qui est évaluée sur un type GEOMETRY ou GEOGRAPHY. Le type de données de geo2 doit être identique à geo1.

Type de retour

DOUBLE PRECISION dans les mêmes unités que les géométries ou les géographies d’entrée.

Si geo1 ou geo2 est null ou vide, null est renvoyé.

Si geo1 et geo2 n’ont pas la même valeur pour l’identifiant de système de référence spatiale (SRID), une erreur est renvoyée.

Si geo1 ou geo2 est une collection géométrique, une erreur est renvoyée.

Exemples

Le SQL suivant renvoie la distance entre deux polygones.

SELECT ST_Distance(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 -3,-2 -1,0 -3,-1 -3))'));

  st_distance
-----------
1.4142135623731               

Le SQL suivant renvoie la distance (en mètres) entre la porte de Brandebourg et le bâtiment du Reichstag à Berlin à l’aide d’un type de données GEOGRAPHY.

SELECT ST_Distance(ST_GeogFromText('POINT(13.37761826722198 52.516411678282445)'), ST_GeogFromText('POINT(13.377950831464005 52.51705102546893)'));

   st_distance
------------------
 74.64129172609631