ST_WITHIN (Azure Cosmos DB)

ПРИМЕНИМО К: API SQL

Возвращает логическое выражение, указывающее, пересекается ли объект GeoJSON (Point, Polygon, MultiPolygon или LineString), указанный в первом аргументе, со вторым объектом GeoJSON (Point, Polygon, MultiPolygon или LineString).

Синтаксис

ST_WITHIN (<spatial_expr>, <spatial_expr>)  

Аргументы

spatial_expr
Любое выражение объекта GeoJSON (Point, Polygon или LineString).

Типы возвращаемых данных

Возвращает логическое значение.

Примеры

В следующем примере показано, как найти все документы семейства внутри многоугольника с помощью функции ST_WITHIN.

SELECT f.id
FROM Families f
WHERE ST_WITHIN(f.location, {  
    'type':'Polygon',
    'coordinates': [[[31.8, -5], [32, -5], [32, -4.7], [31.8, -4.7], [31.8, -5]]]  
})  

Результирующий набор:

[{ "id": "WakefieldFamily" }]  

Remarks

Эта системная функция будет использовать геопространственное индексирование, за исключением запросов со статистическими выражениями.

Примечание

Спецификация геоjson требует, чтобы точки в многоугольнике были указаны в порядке по часовой стрелке. Если точки указаны в порядке по часовой стрелке, то многоугольник представляет регион, расположенный снаружи от него.

Дальнейшие действия