ST_AREA (consulta NoSQL)
APLICA-SE A: NoSQL
Retorna a área total de uma expressão GeoJSON Polygon ou MultiPolygon .
Nota
Para obter mais informações, consulte Dados de localização geoespaciais e GeoJSON.
Sintaxe
ST_AREA(<spatial_expr>)
Argumentos
Description | |
---|---|
spatial_expr |
Qualquer expressão válida GeoJSON Polygon ou MultiPolygon . |
Tipos de devolução
Retorna uma expressão numérica que enumera a área total de um conjunto de pontos.
Exemplos
O exemplo a seguir mostra como retornar a área de um 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
}
]
Observações
- O resultado é expresso em metros quadrados para o sistema de referência por defeito.
- Usar essa função para calcular a área de zero ou figuras unidimensionais como GeoJSON Points e LineStrings resulta em uma área de
0
. - A especificação GeoJSON requer que os pontos dentro de um Polígono sejam especificados em ordem anti-horário. Um Polígono especificado em ordem horária representa o inverso da região dentro dele.