ST_AREA (запрос NoSQL)
ОБЛАСТЬ ПРИМЕНЕНИЯ: NoSQL
Возвращает общую область выражения GeoJSON Polygon или MultiPolygon.
Примечание.
Дополнительные сведения см. в разделе геопространственные и геопространственные данные расположения GeoJSON.
Синтаксис
ST_AREA(<spatial_expr>)
Аргументы
Description | |
---|---|
spatial_expr |
Любое допустимое выражение GeoJSON Polygon или MultiPolygon. |
Типы возвращаемых данных
Возвращает числовое выражение, которое перечисляет общую область набора точек.
Примеры
В следующем примере показано, как вернуть область многоугольника.
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 требуется, чтобы точки в многоугольнике были указаны в порядке против часовой стрелки. Если точки указаны в порядке по часовой стрелке, то многоугольник представляет регион, расположенный снаружи от него.