Consultas geoespaciais

Dados de amostra

Os exemplos neste guia usam a theaters collection no sample_mflix banco de dados dos conjuntos de dados de amostra do Atlas . Para acessar essa collection a partir do seu aplicação Scala, crie um MongoClient que se conecte a um Atlas cluster e atribua os seguintes valores às suas variáveis database e collection:

val database: MongoDatabase = mongoClient.getDatabase("sample_mflix")
val collection: MongoCollection[Document] = database.getCollection("theaters")

Para aprender a criar um cluster MongoDB Atlas gratuito e carregar os conjuntos de dados de amostra, consulte o Guia de Introdução do MongoDB.

Posições GeoJSON

Uma posição representa um único local na Terra e é fornecida como uma array contendo dois ou três valores numéricos:

• Longitude na primeira posição (obrigatório)

• Latitude na segunda posição (obrigatório)

• Elevação na terceira posição (opcional)

Tipos de GeoJSON

O tipo de objeto GeoJSON determina sua forma geométrica. Formas geométricas são compostas por posições.

Aqui estão alguns tipos de GeoJSON comuns e como você pode especificá-los com posições:

• Point: Posição única. Isso pode representar a localização de uma construção.

• LineString: Array de duas ou mais posições, formando uma série de segmentos de linha. Isso pode representar a rota da Grande Muralha da China.

• Polygon: Array de posições em que a primeira e a última posição são iguais, contendo algum espaço. Isso pode representar o território dentro da Cidade do Vaticano.

Para saber mais sobre as formas que você pode usar no MongoDB, consulte GeoJSON no manual do servidor.

Index

Para criar um índice 2dsphere , utilize o auxiliar Indexes.geo2dsphere() para criar uma especificação para o índice 2dsphere . Passe a especificação para o método MongoCollection.createIndex() para criar o índice.

O exemplo seguinte cria um índice 2dsphere no campo "location.geo" na coleção theaters :

val indexObservable = collection.createIndex(Indexes.geo2dsphere("location.geo"))
Await.result(indexObservable.toFuture(), Duration(10, TimeUnit.SECONDS))

Para saber mais sobre índices no driver Scala, consulte o guia Otimizar queries usando índices.

Index

Para dados de query armazenados como legacy coordinate pairs, você deve adicionar o campo contendo legacy coordinate pairs a um índice 2d. O seguinte trecho de código cria um índice 2d no campo coordinates utilizando o objeto Indexes:

val indexObservable = collection.createIndex(Indexes.geo2d("coordinates"))
Await.result(indexObservable.toFuture(), Duration(10, TimeUnit.SECONDS))

Para saber mais sobre índices no driver Scala, consulte o guia Otimizar queries usando índices.

Para mais informações sobre pares de coordenadas legado, consulte a seção pares de coordenadas legado do guia de queries geoespaciais no manual do servidor.

Operadores de Consulta

Para fazer query de seus dados geoespaciais, utilize um dos seguintes operadores de query:

• $near

• $geoWithin

• $nearSphere

• $geoIntersects requer um índice de 2dsphere

Você pode especificar esses operadores de query no driver Scala com os métodos near(), geoWithin(), nearSphere() e geoIntersects() do objeto Filters.

Para saber mais sobre operadores de query geoespacial, consulte a seção Operadores de Query Geoespacial do guia de Queries Geoespaciais no manual do Servidor.

Para ver uma lista completa dos métodos assistente Filters, consulte a documentação da API Filtros.

parâmetros de query

Para especificar uma forma para utilizar em uma query geoespacial, utilize as classes Position, Point, LineString e Polygon do driver Scala.

Para saber mais sobre as classes de forma GeoJSON, consulte a documentação da API do pacote GeoJSON.

Query por proximidade

Para pesquisar e retornar documentos do mais próximo ao mais distante de um ponto, use o método near() do objeto Filters. O método near() constrói uma query com o operador de query $near.

O exemplo a seguir retorna documentos que estão a no máximo 1000 metros da instância GeoJSON Point especificada, classificados do mais próximo para o mais distante:

val refPoint = new Point(new Position(-73.986805, 40.7620853))
val findObservable = collection.find(Filters.near("location.geo", refPoint, Some(1000.0), Some(0.0)))
val results = Await.result(findObservable.toFuture(), Duration(10, TimeUnit.SECONDS))

{"_id": {"$oid": "59a47287cfa9a3a73e51e8e2"}, "theaterId": 1908, "location":
{"address": {"street1": "750 Seventh Ave", "city": "New York", "state": "NY",
"zipcode": "10019"}, "geo": {"type": "Point", "coordinates": [-73.983487, 40.76078]}}}
{"_id": {"$oid": "59a47286cfa9a3a73e51e838"}, "theaterId": 1448, "location":
{"address": {"street1": "1880 Broadway", "city": "New York", "state": "NY",
"zipcode": "10023"}, "geo": {"type": "Point", "coordinates": [-73.982094, 40.769882]}}}

Para saber mais sobre o operador $near, consulte a referência $near no manual do servidor.

Query dentro de um intervalo

Para pesquisar dados geoespaciais dentro de uma forma especificada, use o método geoWithin() do objeto Filters. O método geoWithin() constrói uma query com o operador de query $geoWithin.

O exemplo a seguir pesquisa cinemas em uma seção de Long Island. O exemplo aplica uma projeção para que cada resultado inclua apenas o campo location.address.city e exclua o campo _id:

val longIslandTriangle = new Polygon(Arrays.asList(
    new Position(-72.0, 40.0),
    new Position(-74.0, 41.0),
    new Position(-72.0, 39.0),
    new Position(-72.0, 40.0)
))
val projection = Projections.fields(
    Projections.include("location.address.city"),
    Projections.excludeId()
)
val geoWithinComparison = Filters.geoWithin("location.geo", longIslandTriangle)
val findObservable = collection.find(geoWithinComparison).projection(projection)
val results = Await.result(findObservable.toFuture(), Duration(10, TimeUnit.SECONDS))
results.foreach(doc => println(doc.toJson()))

{"location": {"address": {"city": "Baldwin"}}}
{"location": {"address": {"city": "Levittown"}}}
{"location": {"address": {"city": "Westbury"}}}
{"location": {"address": {"city": "Mount Vernon"}}}
{"location": {"address": {"city": "Massapequa"}}}

A figura a seguir mostra o polígono definido pela variável longIslandTriangle e os pontos que representam as localizações dos cinemas que a query retorna.

Para saber mais sobre o operador $geoWithin, consulte a referência $geoWithin no manual do servidor.