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