ST_AREA – Dotazovací jazyk ve službě Cosmos DB (v Azure a prostředcích infrastruktury)

Funkce ST_AREA vrátí celkovou oblast výrazu GeoJSON Polygon nebo MultiPolygon.

Funkce ST_AREA vrátí číselnou hodnotu představující celkovou oblast Polygonu GeoJSON nebo MultiPolygonu ve službě Azure Cosmos DB for NoSQL.

Syntaxe

ST_AREA(<spatial_expr>)

Arguments

	Description
spatial_expr	Libovolný platný výraz GeoJSON Polygon nebo MultiPolygon.

Návratové typy

Vrátí číselný výraz, který vyčíslí celkovou oblast množiny bodů.

Examples

Tato část obsahuje příklady použití tohoto konstruktoru dotazovacího jazyka.

Výpočet oblasti mnohoúhelníku

V tomto příkladu ST_AREA se funkce používá k vrácení oblasti polygonu 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
  }
]

Poznámky

• Výsledek je vyjádřen ve čtverečních metrech pro výchozí referenční systém.
• Tato funkce slouží k výpočtu oblasti nulových nebo jednorozměrných obrázků, jako jsou GeoJSON Points a LineStrings, výsledkem je oblast 0.
• Specifikace GeoJSON vyžaduje, aby body v polygonu byly zadány v proti směru hodinových ručiček. Mnohoúhelník zadaný v pořadí hodinových ručiček představuje inverzní funkci oblasti v ní.