Udostępnij przez

ST_AREA — Język zapytań w usłudze Cosmos DB (na platformie Azure i w sieci szkieletowej)

  • Dotyczy: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

Funkcja ST_AREA zwraca całkowity obszar wyrażenia Wielokątnego lub Wielopolygonu GeoJSON.

Funkcja ST_AREA zwraca wartość liczbową reprezentującą całkowity obszar polygonu GeoJSON lub MultiPolygon w usłudze Azure Cosmos DB for NoSQL.

Składnia

ST_AREA(<spatial_expr>)

Arguments

Description
spatial_expr Dowolne prawidłowe wyrażenie wielokątne lub wielopolygonowe GeoJSON.

Typy zwracane

Zwraca wyrażenie liczbowe, które wylicza łączny obszar zestawu punktów.

Przykłady

Ta sekcja zawiera przykłady użycia tej konstrukcji języka zapytań.

Obliczanie obszaru wielokąta

W tym przykładzie ST_AREA funkcja jest używana do zwracania obszaru wielokąta 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
  }
]

Uwagi

  • Wynik jest wyrażony w metrach kwadratowych dla domyślnego systemu odniesienia.
  • Użycie tej funkcji w celu obliczenia obszaru liczb zerowych lub jednowymiarowych, takich jak punkty GeoJSON i LineStrings, powoduje wyświetlenie obszaru 0.
  • Specyfikacja GeoJSON wymaga, aby punkty w obrębie wielokąta zostały określone w kolejności odwrotnej do ruchu wskazówek zegara. Wielokąt określony w kolejności wskazówek zegara reprezentuje odwrotność regionu w nim.
  • Last updated on