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.