다음을 통해 공유

ST_WITHIN - Cosmos DB의 쿼리 언어(Azure 및 패브릭)

  • 적용 대상: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

함수는 ST_WITHIN 첫 번째 인수에 지정된 GeoJSON 개체가 두 번째 인수의 GeoJSON 개체 내에 있는지 여부를 나타내는 부울 식을 반환합니다.

이 함수는 ST_WITHIN 한 GeoJSON 개체가 NoSQL용 Azure Cosmos DB의 다른 개체 내에 있는지 여부를 나타내는 부울을 반환합니다.

구문

ST_WITHIN(<spatial_expr_1>, <spatial_expr_2>)

Arguments

Description
spatial_expr_1 유효한 GeoJSON 지점, 다각형, MultiPolygon 또는 LineString 식입니다.
spatial_expr_2 유효한 GeoJSON 지점, 다각형, MultiPolygon 또는 LineString 식입니다.

반환 형식

부울 값을 반환합니다.

예시

이 섹션에는 이 쿼리 언어 구문을 사용하는 방법에 대한 예제가 포함되어 있습니다.

점이 다각형 내에 있는지 확인

이 예제 ST_WITHIN 에서는 GeoJSON 지점이 다각형 내에 있는지 확인하는 데 함수를 사용합니다.

SELECT VALUE {
  isHeadquartersWithinCampus: ST_WITHIN({
      "type": "Point",
      "coordinates": [
          -122.12824857332558,
          47.6395516675712
      ]
  }, {            
      "type": "Polygon",
      "coordinates": [ [
          [
            -122.13236581015025,
            47.64606476313813
          ],
          [
            -122.13221982500913,
            47.633757091363975
          ],
          [
            -122.11840598103835,
            47.641749416109235
          ],
          [
            -122.12061400629656,
            47.64589264786028
          ],
          [
            -122.13236581015025,
            47.64606476313813
          ]
      ] ]
  })
}

[
  {
    "isHeadquartersWithinCampus": true
  }
]

비고

  • 이 함수는 집계가 있는 쿼리를 제외하고 지리 공간적 인덱스의 이점을 활용합니다.
  • GeoJSON 사양을 사용하려면 다각형 내의 점을 시계 반대 방향으로 지정해야 합니다. 시계 방향으로 지정된 다각형은 그 안에 있는 영역의 역을 나타냅니다.
  • Last updated on