Trabalhar com Dados Geoespaciais

Visão geral

Neste guia, você pode aprender como trabalhar com dados geoespaciais; formatos de dados, índices e queries. Os dados geoespaciais representam uma localização geográfica na superfície da Terra, ou dados 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

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.

[]float64{-73.986805, 40.7620853}

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

Índices geoespaciais

Para habilitar a query em dados geoespaciais, você deve criar um índice que corresponda ao formato de dados. Os seguintes tipos de índice habilitam queries geoespaciais:

• 2dsphere para dados GeoJSON

• 2d para pares de coordenadas legadas

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)
}

Consultas geoespaciais

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

Se ainda não tiver feito isso, você deverá criar um índice geoespacial para habilitar as queries geoespaciais.

Exemplos

Os exemplos seguintes utilizam o conjunto de dados de amostra do MongoDB Atlas. Você pode carregar conjuntos de dados de amostra em seu banco de dados na camada gratuita do MongoDB Atlas seguindo o Guia de Introdução ao Atlas ou pode importar o conjunto de dados de amostra para uma instância local do MongoDB.

Os exemplos utilizam a coleção do theaters no banco de dados do sample_mflix a partir do conjunto de dados de amostra. A coleção theaters contém um índice 2dsphere no 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 adicionais

• Para mais informações sobre trabalhar com dados geoespaciais, consulte a entrada manual para dados geoespaciais.

• Para mais informações sobre tipos GeoJSON suportados, consulte a entrada manual GeoJSON.

• Para mais informações sobre operadores de query geoespacial, consulte a entrada manual para queries geoespaciais.

• Para obter mais informações sobre como trabalhar com índices com o driver Go, consulte oguia de índice .