Trabajar con datos geoespaciales

Overview

En esta guía, aprenderá a trabajar con datos geoespaciales: formatos de datos, índices y consultas. Los datos geoespaciales representan una ubicación geográfica en la superficie de la Tierra o datos 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

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.

[]float64{-73.986805, 40.7620853}

bson.D{{"center", []int16{0, 0}}}

Índices geoespaciales

Para habilitar las consultas sobre 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

indexModel := mongo.IndexModel{
    Keys:    bson.D{{"location", "2dsphere"}},
}
name, err := coll.Indexes().CreateOne(context.TODO(), indexModel)
if err != nil {
    panic(err)
}

indexModel := mongo.IndexModel{
    Keys:    bson.D{{"location.coordinates", "2d"}},
}
name, err := coll.Indexes().CreateOne(context.TODO(), indexModel)
if err != nil {
    panic(err)
}

Query geoespacial

Para realizar una consulta geoespacial, cree un filtro de consulta con un nombre de campo y un operador de consulta geoespacial. Puede especificar opciones adicionales para ciertos operadores de consulta geoespacial para limitar los documentos devueltos.

Si aún no lo ha hecho, deberá crear un índice geoespacial para habilitar las consultas geoespaciales.

Ejemplos

Los siguientes ejemplos utilizan el conjunto de datos de ejemplo de MongoDB Atlas. Puede cargar conjuntos de datos de ejemplo en su base de datos en la versión gratuita de MongoDB Atlas siguiendo la Guía de introducción a Atlas o importar el conjunto de datos de ejemplo a una instancia local de MongoDB.

Los ejemplos utilizan la colección theaters de la base de datos sample_mflix del conjunto de datos de muestra. La colección theaters contiene un índice 2dsphere en el campo location.geo.

mongoDBHQ := bson.D{{"type", "Point"}, {"coordinates", []float64{-73.986805, 40.7620853}}}
filter := bson.D{
    {"location.geo", bson.D{
        {"$near", bson.D{
            {"$geometry", mongoDBHQ},
            {"$maxDistance", 1000},
        }},
    }},
}
var places []bson.D
output, err := coll.Find(context.TODO(), filter)
if err = output.All(context.TODO(), &places); err != nil {
    panic(err)
}
for _, place := range places {
            res, _ := bson.MarshalExtJSON(place, false, false)
            fmt.Println(string(res))
    }

{"_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]}}}

mongoDBHQ := bson.D{{"type", "Point"}, {"coordinates", []float64{-73.986805, 40.7620853}}}
    filter := bson.D{
            {"location.geo",
                    bson.D{
                            {"$nearSphere", bson.D{
                                    {"$geometry", mongoDBHQ},
                                    {"$minDistance", 2000},
                                    {"$maxDistance", 3000},
                            }},
                    }},
    }
    var places []bson.D
    output, err := coll.Find(context.TODO(), filter)
    if err = output.All(context.TODO(), &places); err != nil {
            panic(err)
    }
    for _, place := range places {
            res, _ := bson.MarshalExtJSON(place, false, false)
            fmt.Println(string(res))
    }

{"_id":{...},"theaterId":482,"location":{...},"geo":{"type":"Point","coordinates":[-73.99295,40.74194]}}}

Recursos adicionales

• Para obtener más información sobre cómo trabajar con datos geoespaciales, consulte la entrada manual de datos geoespaciales.

• Para obtener más información sobre los tipos GeoJSON admitidos, consulte la entrada del manual GeoJSON.

• Para obtener más información sobre los operadores de consultas geoespaciales, consulte la entrada manual para consultas geoespaciales.

• Para obtener más información sobre cómo trabajar con índices con el controlador Go, consulte la guía de índice.