ST_DISTANCE (consulta NoSQL)
APLICA-SE A: NoSQL
Devolve a distância entre duas expressões GeoJSON Point, Polygon, MultiPolygon ou LineString.
Nota
Para obter mais informações, veja Dados de localização Geoespaciais e GeoJSON.
Sintaxe
ST_DISTANCE(<spatial_expr_1>, <spatial_expr_2>)
Argumentos
Description | |
---|---|
spatial_expr_1 |
Qualquer expressão de GeoJSON Point, Polygon, MultiPolygon ou LineString válida. |
spatial_expr_2 |
Qualquer expressão de GeoJSON Point, Polygon, MultiPolygon ou LineString válida. |
Tipos de devolução
Devolve uma expressão numérica que enumera a distância entre duas expressões.
Exemplos
O exemplo seguinte pressupõe que existe um contentor com dois itens.
[
{
"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"
}
]
O exemplo mostra como utilizar a função como um filtro para devolver itens a uma distância especificada.
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
}
]
Observações
- O resultado é expresso em medidores para o sistema de referência predefinido.
- Esta função beneficia de um índice geoespacial , exceto em consultas com agregados.
- A especificação GeoJSON requer que os pontos dentro de um Polígono sejam especificados por ordem contra-relógio. Um Polígono especificado na ordem dos ponteiros do relógio representa o inverso da região dentro da mesma.