Buscar geoespacialmente

Overview

En esta guía, puedes aprender a buscar datos geoespaciales utilizando el driver de 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 para ejercitar perros en Nueva York

• Puntos en un grafo

Esta guía incluye las siguientes secciones:

• Almacene datos geoespaciales describe los formatos de datos que puede usar 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 la 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, a partir de los datos de ejemplo 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 sobre campos que contengan datos geoespaciales, puedes realizar queries 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 aprender más sobre cómo trabajar con datos geoespaciales, consulte las siguientes páginas del manual de Servidor:

• Datos geoespaciales

• GeoJSON