Docs Menu
Docs Home
/ /
Fundamentals
Docs Home
/ /
Driver C#/.NET
/
Fundamentals
Docs Home
/
Librerías de clientes
/
C#
/
Driver C#/.NET
/
Fundamentals

Buscar geoespacialmente

Overview

En esta guía, puede 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.

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

Formatos de 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.

  • Pares de coordenadas heredados, un formato que representa datos geoespaciales en un plano euclidiano.

GeoJSON

Utiliza GeoJSON para almacenar datos que representen información geoespacial en una esfera similar a la Tierra. GeoJSON se compone de una o más posiciones y un tipo.

Posiciones

Una posición representa una única ubicación y existe en el código como una matriz que contiene los siguientes valores:

  • Longitud en la primera posición (obligatorio)

  • Latitud en la segunda posición (obligatorio)

  • Elevación en la tercera posición (opcional)

La siguiente es la posición de la sede de MongoDB en la ciudad de Nueva York, NY.

GeoJson.Position(-73.986805, 40.7620853)

Alternativamente, puede utilizar el GeoJson.Geographic() Método para construir un par de coordenadas.

GeoJson.Geographic(-73.986805, 40.7620853)

Importante

Longitud luego latitud

GeoJSON ordena las coordenadas con la longitud primero y la latitud después. Asegúrate de verificar el formato que usan las demás herramientas con las que trabajas, ya que muchas herramientas populares, como OpenStreetMap y Google Maps, listan las coordenadas con la latitud primero y la longitud después.

Tipos

El tipo de tu objeto GeoJSON determina la forma geométrica que representa. Las formas geométricas se componen de posiciones.

A continuación se muestran algunos tipos GeoJSON comunes y cómo puedes especificarlos con posiciones:

  • Point: una sola posición. El siguiente Point representa la ubicación de la sede de MongoDB:

    GeoJson.Point(GeoJson.Position(-73.986805, 40.7620853))

  • LineString: una matriz de dos o más posiciones que forma una serie de segmentos de línea. Un LineString puede representar una ruta, una frontera o cualquier otro dato geoespacial lineal. El siguiente LineString representa un segmento de la Gran Muralla China:

    GeoJson.LineString
    (
       GeoJson.Position(116.572, 40.430),
       GeoJson.Position(116.570, 40.434),
       GeoJson.Position(116.567, 40.436),
       GeoJson.Position(116.566, 40.441)
    )

  • Polygon: una matriz de posiciones donde la primera y la última son iguales y encierran espacio. El siguiente Polygon representa aproximadamente el territorio dentro de la Ciudad del Vaticano:

    GeoJson.Polygon
    (
        GeoJson.Position(12.446086, 41.901977),
        GeoJson.Position(12.457952, 41.901559),
        GeoJson.Position(12.455375, 41.907351),
        GeoJson.Position(12.449863, 41.905186),
        GeoJson.Position(12.446086, 41.901977)
    }

Para obtener más información sobre los tipos GeoJSON que puede utilizar en MongoDB, consulte la Entrada manual GeoJSON.

Para obtener más información sobre el formato GeoJSON, consulte la especificación oficial IETF.

Legacy Coordinate Pairs

Utilice pares de coordenadas heredadas para almacenar datos que representan información geoespacial en un plano bidimensional.

Los pares de coordenadas heredados están representados por una matriz de dos valores, en la que el primero representa el valor del eje x y el segundo representa el valor del eje y.

Para obtener más información sobre pares de coordenadas heredados, consulte la página del manual del servidor MongoDB sobre pares de coordenadas heredados.

Í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, utilizado para datos GeoJSON

  • 2d, utilizado para pares de coordenadas heredados

Para obtener más información sobre cómo crear índices geoespaciales, consulte la Sección Índices geoespaciales de la guía Índices.

Operadores del query

Para consultar datos geoespaciales, utiliza uno de estos operadores del query:

  • $near

  • $geoWithin

  • $nearSphere

  • $geoIntersects (requiereun 2índice dsphere)

Al utilizar el operador $near, puede especificar los siguientes operadores de distancia:

  • $minDistance

  • $maxDistance

Al utilizar el operador $geoWithin, puede especificar los siguientes operadores de forma:

  • $box

  • $polygon

  • $center

  • $centerSphere

Para obtener más información sobre los operadores de consulta geoespacial, consulte Operadores de consulta geoespacial en el manual del servidor.

Ejemplos

Los siguientes ejemplos utilizan el conjunto de datos de ejemplo de MongoDB Atlas. Para obtener este conjunto de datos de ejemplo, consulte la Guía de inicio rápido.

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.

Consulta por proximidad

El siguiente ejemplo busca documentos con un valor de campo location.geo a menos de 1000 metros de la sede de MongoDB en Nueva York. Devuelve los documentos desde el más cercano hasta el más lejano.

// Point representation of the MongoDB Headquarters
var point = GeoJson.Point(GeoJson.Position(-73.986805, 40.7620853));
// Specifies a maxDistance of 1000 meters and a minDistance of 0 meters
var filter = Builders<Theater>.Filter.Near(m => m.Location.Geo, point, 1000.0, 0.0);
// Only fetches the _id and theaterId fields
var projection = Builders<Theater>.Projection.Include("theaterId");
var results = collection.Find(filter).Project(projection);

Los resultados del ejemplo anterior contienen los siguientes documentos:

{ "_id" : ObjectId("59a47287cfa9a3a73e51e8e2"), "theaterId" : 1908 }
{ "_id" : ObjectId("59a47286cfa9a3a73e51e838"), "theaterId" : 1448 }

Consulta por polígono

El siguiente ejemplo query documentos con un valor de campo location.geo que existe dentro de los límites de Manhattan.

// Polygon representation of Manhattan
var polygon = GeoJson.Polygon
(
   GeoJson.Position(-73.925492, 40.877410),
   GeoJson.Position(-73.910372, 40.872366),
   GeoJson.Position(-73.935127, 40.834020),
   GeoJson.Position(-73.929049, 40.798569),
   GeoJson.Position(-73.976485, 40.711432),
   GeoJson.Position(-74.015747, 40.701229),
   GeoJson.Position(-74.018859, 40.708367),
   GeoJson.Position(-74.008007, 40.754307),
   GeoJson.Position(-73.925492, 40.877410)
);
var filter = Builders<Theater>.Filter.GeoWithin(m => m.Location.Geo, polygon);
// Only fetches the _id and theaterId fields
var projection = Builders<Theater>.Projection.Include("theaterId");
var results = collection.Find(filter).Project(projection);

Los resultados del ejemplo anterior contienen los siguientes documentos:

{ "_id" : ObjectId("59a47287cfa9a3a73e51e8e2"), "theaterId" : 1908 }
{ "_id" : ObjectId("59a47287cfa9a3a73e51eccb"), "theaterId" : 835 }
{ "_id" : ObjectId("59a47286cfa9a3a73e51e838"), "theaterId" : 1448 }
{ "_id" : ObjectId("59a47286cfa9a3a73e51e744"), "theaterId" : 1028 }
{ "_id" : ObjectId("59a47287cfa9a3a73e51ebe1"), "theaterId" : 609 }
{ "_id" : ObjectId("59a47287cfa9a3a73e51e8ed"), "theaterId" : 1906 }
{ "_id" : ObjectId("59a47287cfa9a3a73e51e87d"), "theaterId" : 1531 }
{ "_id" : ObjectId("59a47287cfa9a3a73e51eb63"), "theaterId" : 482 }

Recursos adicionales

Volver

Encriptación en uso

Next

Almacene archivos grandes

En esta página