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.