ST_AREA — язык запросов в Cosmos DB (в Azure и Fabric)

  • Применяется к: ✅ Azure Cosmos DB, ✅ Cosmos DB in Microsoft Fabric

Функция ST_AREA возвращает общую область выражения GeoJSON Polygon или MultiPolygon.

Функция ST_AREA возвращает числовое значение, представляющее общую область ГеоджСОНА Polygon или MultiPolygon в Azure Cosmos DB.

Синтаксис

ST_AREA(<spatial_expr>)

Arguments

Description
spatial_expr Любое допустимое выражение GeoJSON Polygon или MultiPolygon.

Типы возвращаемых данных

Возвращает числовое выражение, которое перечисляет общую область набора точек.

Примеры

В этом разделе содержатся примеры использования этой конструкции языка запросов.

Вычисление области многоугольника

В этом примере ST_AREA функция используется для возврата области многоугольника 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
  }
]

Замечания

  • Результат выражается в квадратных метрах для эталонной системы по умолчанию.
  • Использование этой функции для вычисления области нулевых или одномерных фигур, таких как GeoJSON Points и LineStrings, приводит к пространству 0.
  • Спецификация GeoJSON требует, чтобы точки в многоугольнике были указаны в порядке по часовой стрелке. Многоугольник, указанный в по часовой стрелке, представляет обратное значение региона внутри него.
  • Last updated on