Udostępnij za pośrednictwem


ST_AREA (zapytanie NoSQL)

DOTYCZY: NoSQL

Zwraca całkowity obszar wyrażenia Wielokątnego lub Wielopolygonu GeoJSON.

Uwaga

Aby uzyskać więcej informacji, zobacz Geospatial and GeoJSON location data (Dane lokalizacji geoprzestrzennych i geoJSON).

Składnia

ST_AREA(<spatial_expr>)

Argumenty

opis
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

W poniższym przykładzie pokazano, jak zwrócić obszar wielokąta.

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.