ST_ISVALID - Cosmos DB のクエリ言語 (Azure と Fabric)

ST_ISVALID関数は、指定した GeoJSON Point、Polygon、MultiPolygon、または LineString 式が有効かどうかを示すブール値を返します。

ST_ISVALID関数は、GeoJSON オブジェクトが Azure Cosmos DB for NoSQL で有効かどうかを示すブール値を返します。

構文

ST_ISVALID(<spatial_expr>)

論争

	Description
spatial_expr	任意の有効な GeoJSON ポイント、Polygon、MultiPolygon、または LineString 式。

戻り値の型

ブール値を返します。

例示

このセクションでは、このクエリ言語コンストラクトを使用する方法の例を示します。

GeoJSON オブジェクトの有効性を確認する

この例では、 ST_ISVALID 関数を使用して、複数の GeoJSON オブジェクトの有効性を確認します。

SELECT VALUE {
  valid: ST_ISVALID({ 
      "type": "Point",
      "coordinates": [-84.38876194345323, 33.75682784306348] 
  }),
  invalid: ST_ISVALID({ 
      "type": "Point",
      "coordinates": [133.75682784306348, -184.38876194345323] 
  })
}

[
  {
    "valid": true,
    "invalid": false
  }
]

注釈

• GeoJSON 仕様では、Polygon 内のポイントを反時計回りの順序で指定する必要があります。 時計回りの順序で指定された多角形は、その中の領域の逆数を表します。