次の方法で共有


geometry インスタンスの拡張メソッド

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric の SQL データベース

SQL Server では、Open Geospatial Consortium (OGC) 標準メソッドを超える ジオメトリ インスタンスの拡張メソッドがサポートされています。 これらの拡張メソッドは、Z (標高) 値と M (メジャー) 値、正確なバッファー操作、簡略化された表現、拡張 WKT/WKB 形式など、平面ジオメトリック データを操作するための追加機能を提供します。

拡張メソッドと OGC メソッド

OGC メソッドは OpenGIS 仕様で定義された標準化された空間操作を提供しますが、拡張メソッドは SQL Server 固有の機能強化を提供します。

  • OGC メソッド: 他の地理空間システムとの相互運用性のための標準化された操作。 標準コンプライアンスが必要な場合に使用します。
  • 拡張メソッド: 追加の機能、パフォーマンスの最適化、OGC 標準でカバーされていない機能 (円弧、Z/M 値、高度なバッファー制御など) のサポートを提供する SQL Server 固有の操作。

ほとんどの空間タスクでは、OGC メソッドが必要な機能を提供します。 追加の機能が必要な場合は、拡張メソッドを使用します。

拡張表現形式

これらのメソッドは、Z (標高) 値と M (メジャー) 値のサポートなど、ジオメトリ データを表す代替形式を提供します。

メソッド Description
AsBinaryZM (geometry データ型) Z (標高) 値と M (メジャー) 値で拡張された OGC Well-Known バイナリ (WKB) 表現を返します。
AsTextZM (geometry データ型) Z (標高) 値と M (メジャー) 値で拡張された OGC Well-Known Text (WKT) 表現を返します。
AsGml (geometry データ型) ジオメトリ インスタンスの Geography Markup Language (GML) 表現を返します。
ToString (geometry データ型) Z 値と M 値で拡張されたジオメトリ インスタンスの文字列形式を返します。

Z 座標と M 座標アクセス

これらのメソッドは、ジオメトリ インスタンスの Z (標高) と M (メジャー) の値にアクセスし、3D 空間データと 4D 空間データをサポートします。

メソッド Description
Z (geometry データ型) ジオメトリ インスタンスの Z (標高) 値を返します。 定義されていない場合は Null。
M (geometry データ型) ジオメトリ インスタンスの M (メジャー) 値を返します。 定義されていない場合は Null。
HasZ (geometry データ型) ジオメトリ インスタンスに Z 値を持つ点が少なくとも 1 つ含まれている場合は、1 を返します。
HasM (geometry データ型) ジオメトリ インスタンスに M 値を持つ点が少なくとも 1 つ含まれている場合は、1 を返します。

高度なバッファー操作

これらのメソッドは、標準の OGC STBuffer メソッドよりもバッファー計算をより詳細に制御できます。

メソッド Description
BufferWithTolerance (geometry データ型) ジオメトリ インスタンスから指定した距離内のすべての点を表すジオメトリ オブジェクトを、精度を明示的に許容制御して返します。
BufferWithCurves (geometry データ型) 指定した距離内のすべてのポイントを表すジオメトリ インスタンスを返し、結果内の円弧セグメントを保持します。

ジオメトリの簡略化

これらのメソッドは、さまざまなスケールでのパフォーマンスの最適化と視覚化に役立つ、簡略化されたバージョンのジオメトリ インスタンスを作成します。

メソッド Description
Reduce (geometry データ型) 指定した許容値で Douglas-Peucker アルゴリズムを実行することによって生成されるジオメトリ インスタンスの簡略化された近似値を返します。
CurveToLineWithTolerance (geometry データ型) 円弧セグメントを含むジオメトリ インスタンスの多角形近似を、明示的な許容値コントロールを使用して返します。

空間リレーションシップ クエリ

これらのメソッドは、高度な空間リレーションシップ クエリを実行します。

メソッド Description
ShortestLineTo (geography データ型) 2 つのジオメトリ インスタンス間の最短距離を表す 2 つの点を持つ LineString インスタンスを返します。

有効性と型チェック

これらのメソッドは、詳細な有効性チェックと型情報を提供します。

メソッド Description
IsValidDetailed (geometry データ型) 無効なジオメトリ インスタンスの問題を特定するのに役立つメッセージを返します。
MakeValid (geometry データ型) 無効なジオメトリ インスタンスを、有効な OGC 型の有効なインスタンスに変換します。
InstanceOf (geometry データ型) geometry インスタンスが指定した型の場合は 1 を返します。
IsNull (geometry データ型) ジオメトリ インスタンスが null の場合は 1 を返します。

空間操作

これらのメソッドは、強化された機能を使用して空間操作を実行します。

メソッド Description
Filter (geometry データ型) ジオメトリ インスタンスが別のインスタンスと交差するかどうかを判断するための、インデックスのみの高速交差メソッドを提供します。

バージョン互換性

これらのメソッドは、SQL Server バージョンの互換性に関する情報を提供します。

メソッド Description
MinDbCompatibilityLevel (geometry データ型) geometry データ型を認識するデータベースの最小互換性レベルを返します。