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.