ST_AREA - Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A ST_AREA função retorna a área total de uma expressão GeoJSON Polygon ou MultiPolygon.

A ST_AREA função retorna um valor numérico que representa a área total de um Polígono GeoJSON ou MultiPolygon no Azure Cosmos DB para NoSQL.

Sintaxe

ST_AREA(<spatial_expr>)

Arguments

Tipos de devolução

Retorna uma expressão numérica que enumera a área total de um conjunto de pontos.

Examples

Esta seção contém exemplos de como usar essa construção de linguagem de consulta.

Calcular a área de um polígono

Neste exemplo, a ST_AREA função é usada para retornar a área de um polígono GeoJSON.

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.