Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Query para localizações que cruzam um objeto GeoJSON

Você pode consultar os dados de localização que se cruzam com um objeto GeoJSON. Por exemplo, considere um aplicativo que armazena coordenadas de postos de gasolina. Você pode criar um GeoJSON LineString que representa uma viagem de estrada e fazer uma query dos postos de gasolina na rota da viagem.

Para executar query de dados de localização que interseccionam com um objeto GeoJSON, utilize o operador $geoIntersects :

db.<collection>.find( {
<location field> : {
$geoIntersects : {
$geometry : {
type : "<GeoJSON object type>",
coordinates : [ <coordinates> ]
}
}
}
} )
  • Quando você especificar coordenadas de longitude e latitude, liste primeiro a longitude e depois a latitude.

    • Os valores de longitude válidos estão entre -180 e 180, ambos inclusos.

    • Os valores de latitude válidos estão entre -90 e 90, ambos inclusos.

  • Uma localização se cruza com um objeto se ela compartilha pelo menos um ponto com o objeto especificado. Isso inclui objetos que têm uma borda compartilhada.

  • $geoIntersects não exige um índice geoespacial. No entanto, um índice geoespacial melhora o desempenho da query. Somente o índice geoespacial 2dsphere suporta $geoIntersects. Para mais informações, consulte Criar um índice 2dsphere.

Crie uma coleção gasStations que contenha estes documento:

db.gasStations.insertMany( [
{
loc: { type: "Point", coordinates: [ -106.31, 35.65 ] },
state: "New Mexico",
country: "United States",
name: "Horizons Gas Station"
},
{
loc: { type: "Point", coordinates: [ -122.62, 40.75 ] },
state: "California",
country: "United States",
name: "Car and Truck Rest Area"
},
{
loc: { type: "Point", coordinates: [ -72.71, 44.15 ] },
state: "Vermont",
country: "United States",
name: "Ready Gas and Snacks"
}
] )

A seguinte query $geoIntersects especifica um LineString contendo quatro pontos e retorna documentos que interseccionam com a linha:

db.gasStations.find( {
loc: {
$geoIntersects: {
$geometry: {
type: "LineString",
coordinates: [
[ -105.82, 33.87 ],
[ -106.01, 34.09 ],
[ -106.31, 35.65 ],
[ -107.39, 35.98 ]
]
}
}
}
} )

Saída:

[
{
_id: ObjectId("63f658d45e5eefbdfef81ca4"),
loc: { type: 'Point', coordinates: [ -106.31, 35.65 ] },
state: 'New Mexico',
country: 'United States',
name: 'Horizons Gas Station'
}
]