Compartilhar via

ST_AREA (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Retorna a área total de uma expressão Polygon ou MultiPolygon do GeoJSON.

Observação

Para obter mais informações, confira os Dados de localização Geoespacial e GeoJSON.

Sintaxe

ST_AREA(<spatial_expr>)

Argumentos

Descrição
spatial_expr É qualquer expressão válida de objeto Polygon ou MultiPolygon do GeoJSON.

Tipos de retorno

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
  }
]

Comentários

  • Ela é expressa em metros quadrados no sistema de referência padrão.
  • O uso dessa função para calcular a área de figuras zero ou unidimensionais, comoPontos e LineStrings do GeoJSON, resulta em uma área de 0.
  • A especificação GeoJSON requer que os pontos em um polígono sejam especificados no sentido anti-horário. Um Polígono especificado no sentido horário representa o inverso da região dentro dele.

Conteúdo relacionado