ST_AREA - Langage de requête dans Cosmos DB (dans Azure et Fabric)

La ST_AREA fonction retourne la zone totale d’une expression Polygone GeoJSON ou MultiPolygon.

La ST_AREA fonction retourne une valeur numérique représentant la zone totale d’un polygone GeoJSON ou multipolygon dans Azure Cosmos DB pour NoSQL.

Syntaxe

ST_AREA(<spatial_expr>)

Arguments

Types de retour

Retourne une expression numérique qui énumère la zone totale d’un ensemble de points.

Examples

Cette section contient des exemples d’utilisation de cette construction de langage de requête.

Calculer la zone d’un polygone

Dans cet exemple, la ST_AREA fonction est utilisée pour retourner la zone d’un polygone 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
  }
]

Remarques

• Le résultat est exprimé en mètres carrés pour le système de référence par défaut.
• L’utilisation de cette fonction pour calculer la zone de zéro ou des figures unidimensionnelles comme GeoJSON Points et LineStrings entraîne une zone de 0.
• La spécification GeoJSON exige que les points d’un polygone soient spécifiés dans l’ordre inverse des aiguilles d’une montre. Un polygone spécifié dans l’ordre des aiguilles d’une montre représente l’inverse de la région qu’elle contient.