Amazon Redshift ne prendra plus en charge l'utilisation des UDF Python après le 30 juin 2026. Nous allons commencer à l'appliquer par étapes. Pour plus d'informations sur les détails de la fin de vie de Python et des options de migration, consultez [ le billet de ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/) blog publié le 30 juin 2025. 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# ST\_Distance
<a name="ST_Distance-function"></a>

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
<a name="ST_Distance-function-syntax"></a>

```
ST_Distance(geo1, geo2)
```

## Arguments
<a name="ST_Distance-function-arguments"></a>

 *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
<a name="ST_Distance-function-return"></a>

`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
<a name="ST_Distance-function-examples"></a>

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
```