Pesquisar geoespacialmente

Visão geral

Neste guia, você pode aprender como pesquisar dados geoespaciais utilizando o driver Rust. Os dados geoespaciais representam uma localização geográfica na superfície da Terra ou em um plano euclidiano.

Exemplos de dados geoespaciais incluem:

• Localizações de cinemas

• Fronteiras de países

• Rotas de passeios de bicicleta

• Áreas de exercícios para cães na cidade de Nova York

• Pontos em um gráfico

Este guia inclui as seguintes seções:

• Armazenar dados geoespaciais descreve os formatos de dados que você pode utilizar para representar dados geoespaciais

• Índices geoespaciais descreve como criar um índice em campos que armazenam dados geoespaciais

• Consultas geoespaciais descrevem como consultar dados geoespaciais armazenados em campos indexados

• Informações adicionais fornecem links para recursos e documentação da API para os tipos e métodos mencionados neste guia

Armazenar dados geoespaciais

Todos os dados geoespaciais no MongoDB são armazenados em um dos seguintes formatos:

• GeoJSON, um formato que representa dados geoespaciais em uma esfera semelhante à Terra

• Par de Coordenadas Legado, um formato que representa dados geoespaciais em um plano Euclidiano

let coords = vec! [-73.986805, 40.7620853];

let capital = vec! [-77.0369, 38.9072];

Índices geoespaciais

Antes de consultar dados geoespaciais, você deve criar um índice que corresponde ao formato de dados. Os seguintes tipos de índice habilitam query geoespaciais:

• 2dsphere para dados GeoJSON

• 2d para pares de coordenadas legadas

As seções a seguir sobre índices 2dsphere e 2d incluem exemplos de código que usam a coleção theaters no banco de dados sample_mflix dos dados de exemplo do Atlas.

let index = IndexModel::builder()
    .keys(doc! { "location.geo": "2dsphere" })
    .build();
let idx = my_coll.create_index(index).await?;
println!("Created index:\n{}", idx.index_name);

Created index:
location.geo_"2dsphere"

let index = IndexModel::builder()
    .keys(doc! { "location.geo.coordinates": "2d" })
    .build();
let idx = my_coll.create_index(index).await?;
println!("Created index:\n{}", idx.index_name);

Created index:
location.geo.coordinates_"2d"

Consultas geoespaciais

Após criar um índice 2dsphere ou 2d em campo contendo dados geoespaciais, você pode executar query geoespaciais que acessam estes campo.

Para executar query de dados geoespaciais, crie um filtro de query com um nome de campo e um operador de query geoespacial. Você pode especificar opções para determinados operadores de query geoespacial para limitar os documentos retornados.

As seguintes seções sobre query geoespaciais incluem exemplos de código que utilizam a collection theaters no reconhecimento de data center sample_mflix a partir dos dados de amostra do Atlas. Suponha que a collection theaters tenha um índice 2dsphere no campo location.geo .

let mongodb = vec! [-73.986805, 40.7620853];
let query = doc! {"location.geo": 
    doc! { "$near": {
        "$geometry": {
            "type": "Point", "coordinates": mongodb,
            },
        "$maxDistance": 1000,
        }
    }
};
let mut cursor = my_coll.find(query).await?;
while let Some(doc) = cursor.try_next().await? {
    println!("{}", doc);
}

{ "_id":{...},"theaterId":1908,"location":{"address":{...},"geo":{"type":"Point","coordinates":[-73.983487,40.76078] } } }
{ "_id":{...},"theaterId":1448,"location":{"address":{...},"geo":{"type":"Point","coordinates":[-73.982094,40.769882] } } }

let chicago = doc! {
    "type": "Polygon",
    "coordinates": vec![
        vec![
            vec![-87.851, 41.976],
            vec![-87.851, 41.653],
            vec![-87.651, 41.653],
            vec![-87.651, 41.976],
            vec![-87.851, 41.976],
        ]
    ]
};
let query = doc! {"location.geo":
    doc! { "$geoWithin": { "$geometry": chicago }}
};
let mut cursor = my_coll.find(query).await?;
while let Some(doc) = cursor.try_next().await? {
    println!("{}", doc);
}

{ "_id":{...},"theaterId":322,"location":{"address":{...},"geo":{ "type":"Point","coordinates":[-87.849403, 41.90707] } } }
{ "_id":{...},"theaterId":2960,"location":{"address":{...},"geo":{ "type":"Point","coordinates":[-87.811262, 41.847938] } } }
{ "_id":{...},"theaterId":323,"location":{"address":{...},"geo":{ "type":"Point","coordinates":[-87.653557, 41.912025] } } }
{ "_id":{...},"theaterId":320,"location":{"address":{...},"geo":{ "type":"Point","coordinates":[-87.805817, 41.847572] } } }
{ "_id":{...},"theaterId":814,"location":{"address":{...},"geo":{ "type":"Point","coordinates":[-87.670631, 41.919514] } } }

Informações adicionais

Para saber mais sobre como encontrar operações, consulte o guia Recuperar dados .

Para saber mais sobre como trabalhar com dados geoespaciais, consulte as seguintes páginas de manual do servidor:

• Dados geoespaciais

• GeoJSON