Join us at MongoDB.local London on 7 May to unlock new possibilities for your data. Use WEB50 to save 50%.
Register now >
Docs Menu
Docs Home
/ /
Driver C#/.NET
Docs Home
/
Librerías de clientes
/
C#
/
Driver C#/.NET
Docs Home
/
Librerías de clientes
/
C#
/
Driver C#/.NET

Buscar geoespacialmente

Overview

En esta guía, puede aprender cómo 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 para ejercitar perros en Nueva York

  • Puntos en un grafo

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.

  • legacy coordinate pairs, 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 (requerido)

  • Latitud en la segunda posición (obligatoria).

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

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

GeoJson.Position(-73.986805, 40.7620853)

Alternativamente, puedes usar 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 colocando primero la longitud y segundo la latitud. Asegúrate de verificar qué formato 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.

Aquí tienes algunos tipos comunes de GeoJSON 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: un arreglo de dos o más posiciones que forma una serie de segmentos de línea. Una LineString puede representar un camino, ruta, 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)
    )

  • Polygonun arreglo de posiciones en el que la primera y la última posición son iguales y encierran un espacio. El siguiente Polygon representa aproximadamente el terreno 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 de GeoJSON.

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

Legacy Coordinate Pairs

Utiliza pares de coordenadas obsoletos para almacenar datos que representen información geoespacial en un plano bidimensional.

Los pares de coordenadas heredados se representan mediante un arreglo de dos valores, en el que el primero representa el valor del eje x y el segundo, el valor del eje y.

Para obtener más información sobre legacy coordinate pairs, consulta la página del manual del servidor MongoDB sobre legacy coordinate pairs.

Í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:

  • 2dspherepara datos GeoJSON

  • 2d, used for legacy coordinate pairs

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

Operadores del query

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

  • $near

  • $geoWithin

  • $nearSphere

  • $geoIntersects (requiere un índice dsphere 2)

Cuando se usa el operador $near, puede especificar los siguientes operadores de distancia:

  • $minDistance

  • $maxDistance

Al utilizar el operador $geoWithin, se pueden 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 muestra de MongoDB Atlas. Para obtener este conjunto de datos de muestra, consulta Cómo empezar con el controlador .NET/C#.

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.

Query por Proximidad

El siguiente ejemplo query documentos con un campo location.geo dentro de un radio de 1000 metros de la sede de MongoDB en Nueva York. Devuelve documentos de los más cercanos a los más lejanos.

// 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

Configurar las operaciones CRUD

Next

Tutorial: Crear una API RESTful

En esta página