次の方法で共有

ST_DISTANCE (NoSQL クエリ)

  • [アーティクル]

適用対象: NoSQL

2 つの GeoJSON Point、Polygon、MultiPolygon、または LineString 式間の距離を返します。

注意

詳細については、「地理空間と GeoJSON 位置情報データ」を参照してください。

構文

ST_DISTANCE(<spatial_expr_1>, <spatial_expr_2>)

引数

説明
spatial_expr_1 有効な GeoJSON Point、Polygon、MultiPolygon、または LineString 式です。
spatial_expr_2 有効な GeoJSON Point、Polygon、MultiPolygon、または LineString 式です。

戻り値の型

2 つの式の間の距離を列挙する数値式を返します。

例

次の例では、2 つの項目を含むコンテナーが存在することを前提としています。

[
  {
    "name": "Headquarters",
    "location": {
      "type": "Point",
      "coordinates": [
        -122.12826822304672,
        47.63980239335718
      ]
    },
    "category": "business-offices"
  },
  {
    "name": "Research and development",
    "location": {
      "type": "Point",
      "coordinates": [
        -96.84368664765994,
        46.81297794314663
      ]
    },
    "category": "business-offices"
  }
]

この例では、関数をフィルターとして使用して、指定した距離内の項目を返す方法を示します。

SELECT
    o.name,
    ST_DISTANCE(o.location, {
        "type": "Point", 
        "coordinates": [-122.11758113953535, 47.66901087006131]
    }) / 1000 AS distanceKilometers
FROM
    offices o
WHERE
    o.category = "business-offices"

[
  {
    "name": "Headquarters",
    "distanceKilometers": 3.345269817267368
  },
  {
    "name": "Research and development",
    "distanceKilometers": 1907.438421299902
  }
]

注釈

  • この結果、既定の参照システムのメートル単位で表されます。
  • この関数は、集計を使用したクエリを除き、地理空間インデックスの恩恵を受けます。
  • GeoJSON 仕様では、Polygon 内のポイントを反時計回りの順序で指定する必要があります。 時計回りに指定された Polygon は、その中の領域を逆にしたものを表します。

関連するコンテンツ