ST_AREA - Lenguaje de consulta en Cosmos DB (en Azure y Fabric)

La ST_AREA función devuelve el área total de una expresión GeoJSON Polygon o MultiPolygon.

La ST_AREA función devuelve un valor numérico que representa el área total de un polígono GeoJSON o MultiPolygon en Azure Cosmos DB para NoSQL.

Syntax

ST_AREA(<spatial_expr>)

Arguments

Tipos de retorno

Devuelve una expresión numérica que enumera el área total de un conjunto de puntos.

Examples

Esta sección contiene ejemplos de cómo usar esta construcción del lenguaje de consulta.

Cálculo del área de un polígono

En este ejemplo, la ST_AREA función se usa para devolver el área de un 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
  }
]

Observaciones

• El resultado se expresa en metros cuadrados para el sistema de referencia predeterminado.
• El uso de esta función para calcular el área de cero o figuras unidimensionales, como puntos GeoJSON y LineStrings, da como resultado un área de 0.
• La especificación GeoJSON requiere que se especifiquen puntos dentro de un polígono en orden contrario a las agujas del reloj. Un polígono especificado en el orden de las agujas del reloj representa el inverso de la región dentro de ella.