Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

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\$1Distance
<a name="ST_Distance-function"></a>

Pour les géométries d’entrée, ST\$1Distance 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\$1Distance 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\$1Distance 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
```