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 de dados geoespaciais, você deve primeiro criar um índice de suporte. Os seguintes tipos de índice que 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 queries 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 Comece a usar o 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)
}
fmt.Println(places)

[
  [{_id ObjectID(...)} {theaterId 1908} {location [{address [...]} {geo [{type Point} {coordinates [-73.983487 40.76078]}]}]}]
  [{_id ObjectID(...)} {theaterId 1448} {location [{address [...]} {geo [{type Point} {coordinates [-73.982094 40.76988]}]}]}]
]

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
err := coll.Find(context.TODO(), filter).Decode(&places)
if err != nil {
    panic(err)
}
fmt.Println(places)

[[{_id ObjectID(...)} {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 o guia de índice.