ST_AREA (consulta NoSQL)
SE APLICA A: NoSQL
Devuelve el área total de una expresión Polygon o MultiPolygon de GeoJSON.
Nota
Para obtener más información, consulte Datos de ubicación geoespaciales y GeoJSON.
Sintaxis
ST_AREA(<spatial_expr>)
Argumentos
Descripción | |
---|---|
spatial_expr |
Cualquier expresión GeoJSON Polygon o MultiPolygon válida. |
Tipos de valores devueltos
Devuelve una expresión numérica que enumera el área total de un conjunto de puntos.
Ejemplos
El ejemplo siguiente muestra cómo devolver el área de un polígono.
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
}
]
Comentarios
- El resultado se expresa en metros cuadrados para el sistema de referencia predeterminado.
- El uso de esta función para calcular el área de cero o de figuras unidimensionales como GeoJSON Points y LineStrings da como resultado un área de
0
. - La especificación GeoJSON requiere que los puntos dentro de un polígono se especifiquen en sentido contrario a las agujas del reloj. Un elemento Polygon cuyos puntos se hayan especificado en el sentido de las agujas del reloj representa el inverso de la región dentro de él.
Contenido relacionado
- System functions (Funciones del sistema)
ST_WITHIN