Partager via


ST_AREA (requête NoSQL)

S’APPLIQUE À : NoSQL

Retourne l’aire totale d’une expression GeoJSON Polygone ou À plusieurs polygones.

Notes

Si vous souhaitez obtenir plus d’informations, consultez Données d’emplacement géospatiales et GeoJSON.

Syntaxe

ST_AREA(<spatial_expr>)

Arguments

Description
spatial_expr Toute expression GeoJSON Polygone ou À plusieurs polygones valide.

Types de retour

Retourne une expression numérique qui énumère l’aire totale d’un ensemble de points.

Exemples

L’exemple suivant montre comment retourner l’aire d’un polygone.

SELECT VALUE {
    areaPolygon: ST_AREA({
        "type": "Polygon",
        "coordinates": [ [
            [ 31.8, -5 ],
            [ 32, -5 ],
            [ 32, -4.7 ],
            [ 31.8, -4.7 ],
            [ 31.8, -5 ]
        ] ]
    })
}
[
  {
    "areaPolygon": 735970283.0522614
  }
]

Remarques

  • Le résultat est exprimé en mètres carrés pour le système de référence par défaut.
  • Si elle est utilisée pour calculer l’aire de figures à zéro ou à une dimension telles que des résultats Points et LineStrings dans une aire de 0.
  • La spécification GeoJSON exige que les points d’un polygone soient spécifiés dans le sens inverse des aiguilles d’une montre. Un polygone spécifié dans le sens horaire représente l’inverse de la région qu’il contient.