ST_DISTANCE – Frågespråk i Cosmos DB (i Azure och Fabric)

Funktionen ST_DISTANCE returnerar avståndet mellan två GeoJSON Point-, Polygon-, MultiPolygon- eller LineString-uttryck.

Funktionen ST_DISTANCE returnerar ett numeriskt värde som representerar avståndet mellan två GeoJSON-objekt i Azure Cosmos DB för NoSQL.

Syntax

ST_DISTANCE(<spatial_expr_1>, <spatial_expr_2>)

Arguments

	Description
spatial_expr_1	Alla giltiga GeoJSON Point-, Polygon-, MultiPolygon- eller LineString-uttryck.
spatial_expr_2	Alla giltiga GeoJSON Point-, Polygon-, MultiPolygon- eller LineString-uttryck.

Returtyper

Returnerar ett numeriskt uttryck som räknar upp avståndet mellan två uttryck.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

Beräkna avståndet mellan punkter

I det här exemplet ST_DISTANCE används funktionen för att beräkna avståndet mellan en kontorsplats och en referenspunkt, vilket returnerar resultatet i kilometer.

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
  }
]

Anmärkningar

• Resultatet uttrycks i mätare för standardreferenssystemet.
• Den här funktionen drar nytta av ett geospatialt index förutom i frågor med aggregeringar.
• GeoJSON-specifikationen kräver att punkter i en Polygon anges i motsols ordning. En Polygon som anges i medsols ordning representerar inversen av regionen inom den.