Delen via


ST_AREA - Querytaal in Cosmos DB (in Azure en Fabric)

De ST_AREA functie retourneert het totale gebied van een GeoJSON Polygon- of MultiPolygon-expressie.

De ST_AREA functie retourneert een numerieke waarde die het totale gebied van een GeoJSON-polygoon of multipolygon in Azure Cosmos DB vertegenwoordigt.

Syntaxis

ST_AREA(<spatial_expr>)

Arguments

Description
spatial_expr Elke geldige GeoJSON-polygoon of multipolygonexpressie.

Retourtypen

Hiermee wordt een numerieke expressie geretourneerd waarmee het totale gebied van een set punten wordt opgesomd.

Voorbeelden

Deze sectie bevat voorbeelden van het gebruik van deze querytaalconstructie.

Het gebied van een veelhoek berekenen

In dit voorbeeld wordt de ST_AREA functie gebruikt om het gebied van een GeoJSON-veelhoek te retourneren.

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

Opmerkingen

  • Het resultaat wordt uitgedrukt in vierkante meters voor het standaardreferentiesysteem.
  • Met deze functie kunt u het gebied van nul of eendimensionale cijfers zoals GeoJSON-punten en LineStrings berekenen in een gebied van 0.
  • De GeoJSON-specificatie vereist dat punten binnen een veelhoek worden opgegeven in volgorde met de klok mee. Een veelhoek die in rechtsom is opgegeven, vertegenwoordigt de inverse van de regio in het gebied.