Buscar geoespacialmente

Overview

En esta guía, aprenderá a buscar datos geoespaciales con el controlador Rust. Los datos geoespaciales representan una ubicación geográfica en la superficie de la Tierra o en un plano euclidiano.

Algunos ejemplos de datos geoespaciales incluyen:

• Ubicaciones de cines

• Fronteras de los países

• Rutas de paseos en bicicleta

• Áreas de ejercicio para perros en la ciudad de Nueva York

• Puntos en un gráfico

Esta guía incluye las siguientes secciones:

• Almacenar datos geoespaciales describe los formatos de datos que puede utilizar para representar datos geoespaciales

• Índices geoespaciales describe cómo crear un índice en campos que almacenan datos geoespaciales

• Consultas geoespaciales describe cómo consultar datos geoespaciales almacenados en campos indexados

• Información adicional proporciona enlaces a recursos y documentación de API para los tipos y métodos mencionados en esta guía.

Almacenar datos geoespaciales

Todos los datos geoespaciales en MongoDB se almacenan en uno de los siguientes formatos:

• GeoJSON, un formato que representa datos geoespaciales en una esfera similar a la Tierra

• Par de coordenadas heredado, un formato que representa datos geoespaciales en un plano euclidiano

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

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

Índices geoespaciales

Antes de consultar datos geoespaciales, debe crear un índice que se corresponda con el formato de los datos. Los siguientes tipos de índice permiten realizar consultas geoespaciales:

• 2dsphere para datos GeoJSON

• 2d para pares de coordenadas heredados

Las siguientes secciones sobre los índices 2dsphere y 2d incluyen ejemplos de código que utilizan la colección theaters en la base de datos sample_mflix de los datos de muestra de 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"

Query geoespacial

Después de crear un índice 2dsphere o 2d en los campos que contienen datos geoespaciales, puede realizar consultas geoespaciales que accedan a esos campos.

Para consultar datos geoespaciales, cree un filtro de query con un nombre de campo y un operador del query geoespacial. Puedes especificar opciones para ciertos operadores del query geoespaciales para limitar los documentos devueltos.

Las siguientes secciones sobre consultas geoespaciales incluyen ejemplos de código que utilizan la colección theaters en la base de datos sample_mflix de los datos de ejemplo de Atlas. Supongamos que la colección theaters tiene un índice 2dsphere en el 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] } } }

Información Adicional

Para aprender más sobre las operaciones find, consulte la guía Recuperar Datos.

Para obtener más información sobre cómo trabajar con datos geoespaciales, consulte las siguientes páginas del manual del servidor:

• Datos geoespaciales

• GeoJSON