ST_AREA (consulta NoSQL)
APLICA-SE A: NoSQL
Devolve a área total de uma expressão GeoJSON Polygon ou MultiPolygon .
Nota
Para obter mais informações, veja Dados de localização Geoespaciais e GeoJSON.
Sintaxe
ST_AREA(<spatial_expr>)
Argumentos
Description | |
---|---|
spatial_expr |
Qualquer expressão GeoJSON Polygon ou MultiPolygon válida. |
Tipos de devolução
Devolve uma expressão numérica que enumera a área total de um conjunto de pontos.
Exemplos
O exemplo seguinte mostra como devolver 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 predefinido.
- Utilizar esta função para calcular a área de zero ou figuras unidimensionais, como Pontos GeoJSON e LineStrings , resulta numa área de
0
. - A especificação GeoJSON requer que os pontos dentro de um Polígono sejam especificados por ordem contra-relógio. Um Polígono especificado na ordem dos ponteiros do relógio representa o inverso da região dentro da mesma.