ST_AREA - Cosmos DB'de sorgu dili (Azure ve Doku'da)

İşlev, ST_AREA GeoJSON Çokgen veya MultiPolygon ifadesinin toplam alanını döndürür.

İşlev, ST_AREA Azure Cosmos DB'de GeoJSON ÇokGeninin veya MultiPolygon'un toplam alanını temsil eden sayısal bir değer döndürür.

Sözdizimi

ST_AREA(<spatial_expr>)

Arguments

Description
spatial_expr Geçerli herhangi bir GeoJSON Çokgen veya MultiPolygon ifadesi.

Dönüş türleri

Bir nokta kümesinin toplam alanını numaralandıran sayısal bir ifade döndürür.

Örnekler

Bu bölüm, bu sorgu dili yapısının nasıl kullanılacağına örnekler içerir.

Çokgenin alanını hesaplama

Bu örnekte işlevi, ST_AREA GeoJSON çokgeninin alanını döndürmek için kullanılır.

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

Açıklamalar

  • Sonuç, varsayılan başvuru sistemi için metrekare cinsinden ifade edilir.
  • GeoJSON Noktaları ve LineStrings gibi sıfır veya tek boyutlu rakamların alanını hesaplamak için bu işlevin kullanılması bir alanına neden olur 0.
  • GeoJSON belirtimi, çokgen içindeki noktaların saat yönünün tersine belirtilmesi gerekir. Saat yönünde belirtilen çokgen, içindeki bölgenin tersini temsil eder.