MongoDB
Explica datos GeoJSON, índices 2dsphere y consultas por cercanía, intersección y contención para ubicaciones y áreas geográficas.
MongoDB almacena y consulta ubicaciones mediante formatos geoespaciales. Para coordenadas terrestres y GeoJSON se utiliza normalmente un índice ; para geometría plana y casos legacy existe .
2dsphere2d{
location: {
type: 'Point',
coordinates: [-74.0721, 4.711]
}
}GeoJSON usa longitud primero y latitud después. Invertir el orden es uno de los errores más frecuentes.
db.stores.createIndex({ location: '2dsphere' });Permite consultas sobre una esfera aproximada y operadores como $near, $geoWithin y $geoIntersects.
Busca resultados ordenados por proximidad:
db.stores.find({
businessId,
location: {
$near: {
$geometry: {
type: 'Point',
coordinates: [longitude, latitude]
},
$maxDistance: 5000
}
}
}).limit(20);$maxDistance se expresa en metros con GeoJSON y 2dsphere. Verifica siempre unidades en la API.
Busca geometrías contenidas dentro de otra:
db.stores.find({
location: {
$geoWithin: {
$geometry: {
type: 'Polygon',
coordinates: [[
[-74.12, 4.65],
[-74.02, 4.65],
[-74.02, 4.75],
[-74.12, 4.75],
[-74.12, 4.65]
]]
}
}
}
});El anillo debe cerrarse repitiendo el primer punto al final.
Devuelve geometrías que intersectan la geometría consultada. Es útil para zonas de cobertura, rutas y polígonos administrativos.
db.deliveryZones.find({
area: {
$geoIntersects: {
$geometry: point
}
}
});En aggregation, $geoNear calcula distancia y normalmente debe ser el primer stage:
db.stores.aggregate([
{
$geoNear: {
near: {
type: 'Point',
coordinates: [longitude, latitude]
},
key: 'location',
distanceField: 'distanceMeters',
maxDistance: 5000,
spherical: true,
query: {
businessId,
active: true
}
}
},
{ $limit: 20 }
]);Incluye tenant y filtros selectivos en query cuando sea compatible.
Tipos comunes:
Point;LineString;Polygon;MultiPoint;MultiLineString;MultiPolygon.La geometría debe cumplir estructura y cierre correctos. Un documento JSON válido no necesariamente contiene una geometría válida.
Valida antes de persistir:
if (longitude < -180 || longitude > 180) throw new Error('Invalid longitude');
if (latitude < -90 || latitude > 90) throw new Error('Invalid latitude');También verifica:
NaN;La distancia geodésica no considera calles, tráfico, puentes o sentidos. Para logística:
MongoDB geospatial
→ candidatos cercanos
servicio de rutas
→ tiempo y distancia real por carreteraNo prometas tiempos de entrega basados solo en línea recta.
Modelo:
{
branchId,
businessId,
area: {
type: 'Polygon',
coordinates: [/* ... */]
},
active: true
}Consulta un punto contra zonas. Debes definir:
Un índice geoespacial puede combinarse con otros campos bajo restricciones:
db.stores.createIndex({
businessId: 1,
location: '2dsphere'
});Confirma con explain() que el query shape obtiene el targeting esperado. El orden y compatibilidad dependen del tipo de consulta.
La ubicación puede ser dato sensible. Aplica:
Para analytics quizá baste una zona o geohash aproximado, no la ubicación exacta.
El coste depende de:
Una consulta de radio enorme puede devolver gran parte de la colección.
Las consultas geoespaciales en clusters sharded tienen restricciones y costes dependientes de versión, shard key y operador. Revisa compatibilidad antes de diseñar una API crítica. La ubicación no siempre es una buena shard key por distribución y cambios.
El punto aparece en otra región del mundo.
El código interpreta kilómetros como metros.
La query falla o produce resultados inesperados.
Debe probarse la semántica del operador.
Necesita modelado cuidadoso.
Decide si el documento se excluye o se procesa aparte.
GPS y geocoding tienen error; no trates centímetros como certeza.
[lat, lng] en vez de [lng, lat];explain().Las consultas geoespaciales requieren más que almacenar dos números. Debes elegir geometría, índice, operador, unidades y reglas de borde. MongoDB resuelve proximidad e intersección; no sustituye un motor de rutas ni una política de privacidad.
$near y $geoWithin?Query planner y execution plans.