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 para ejercitar perros en Nueva York

• Puntos en un grafo

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.

• Legacy Pair De Coordenadas, 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 en datos geoespaciales, deberás crear un índice que corresponda al formato de los datos. Los siguientes tipos de índice permiten 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 un query geoespacial, crea un filtro de query con un nombre de campo y un operador del query geoespacial. Puedes especificar opciones adicionales para ciertos operadores del query geoespaciales 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 muestra de MongoDB Atlas. Puedes cargar conjuntos de datos de muestra en tu base de datos usando el nivel gratuito de MongoDB Atlas siguiendo los pasos en Cómo comenzar con Atlas o puedes importar el conjunto de datos de muestra en una instancia local de MongoDB.

Los ejemplos utilizan la colección theaters en 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, consulta la entrada del manual de datos geoespaciales.

• Para obtener más información sobre los tipos de GeoJSON admitidos, consulta la entrada en el manual de GeoJSON.

• Para obtener más información sobre los operadores del query geoespacial, consulta la entrada del manual sobre queries geoespaciales.

• Para obtener más información sobre cómo trabajar con índices con el controlador de Go, consulte el index guide.