Hoy: datos sin referencia
- Direcciones duplicadas con grafías distintas.
- Registros sin coordenadas: imposible ubicarlos en el mapa.
- Provincia y municipio escritos a mano en cada sistema.
- Conciliación territorial manual, lenta y frágil.
Direcciones y geocodificación para Cuba
Direcciones cubanas normalizadas y geocodificadas, listas para su sistema.
cuplaces convierte direcciones cubanas en coordenadas, y coordenadas en direcciones: calle, entre calles, municipio y provincia. La misma consulta da siempre el mismo resultado.
Base PostgreSQL + PostGIS propia Instalable en sus servidores Datos de OpenStreetMap
© OpenStreetMap
Mapa de La Habana. Use las teclas de flecha para desplazarse y los signos más y menos para acercar o alejar.
La Habana › Cerro › Suzarte
Entre calles Salvador y San Carlos
Coordenadas 23.105930, −82.381972
Respuesta determinista, sin servicios externos
16 Provincias
168 Municipios
12.100 Nombres de calles
73.900 Tramos viales
Cifras de la base de referencia actual, generada desde OpenStreetMap.
El problema
Sus datos son buenos. La referencia geográfica es lo que falta.
En la mayoría de las instituciones cubanas la información existe, pero llega escrita de mil formas distintas: «Calle 23» y «C. 23», «Plaza de la Revolución» y «plaza de la revolucion», abreviaturas, acentos omitidos y sin coordenadas. Sin una referencia canónica, consolidar por territorio se vuelve un trabajo manual y frágil.
Con cuplaces: una capa canónica
- Normalización determinista de nombres, alias y abreviaturas.
- Coordenadas lat/lon para cada dirección resuelta.
- Árbol administrativo provincia → municipio.
- Calle y entre calles a partir de unas coordenadas.
Capacidades
Lo esencial para trabajar con direcciones cubanas
Una API REST versionada y determinista. La misma dirección produce siempre el mismo resultado, sin llamadas a servicios externos en tiempo de ejecución.
Geocodificación directa
Convierte provincia, municipio y calle en coordenadas lat/lon en WGS84.
Geocodificación inversa
Obtiene la calle más cercana a un punto y las dos calles entre las que se encuentra, o la esquina si está en un cruce.
Resolución de intersecciones
Encuentra el punto exacto donde se cruzan dos calles de un mismo municipio.
Normalización de direcciones
Unifica acentos, mayúsculas, abreviaturas y alias hacia una forma canónica única.
Árbol administrativo
Provincias, municipios y calles listos para alimentar formularios y filtros.
Acceso por API key
Claves por cliente, uso atribuido y revocación inmediata.
Casos de uso
Pensado para instituciones que operan sobre el territorio
Cualquier organización con datos distribuidos geográficamente puede apoyarse en cuplaces como capa de referencia común.
Conciliación de inventario con territorio
Contraste clientes, instalaciones o servicios contra el árbol administrativo y detecte direcciones inconsistentes o faltantes.
Análisis de cobertura y despliegue
Agrupe por provincia, municipio o calle para conocer la densidad y planificar la red sobre datos geográficos reales.
Atención al cliente y CRM
Valide y complete direcciones en el momento del registro, reduciendo errores de captura desde el primer contacto.
Reportes e indicadores por territorio
Consolide métricas por división político-administrativa con una nomenclatura única y comparable entre áreas.
Integración
Una API REST sencilla de integrar
Seis endpoints versionados, respuestas JSON y autenticación por cabecera. Cada consulta se resuelve con sus propios datos, sin llamar a servicios externos.
Todas las peticiones requieren la cabecera
X-API-Key.
Cada cliente recibe su propia clave.
- GET /api/v1/provinces
- GET /api/v1/provinces/{id}/municipalities
- GET /api/v1/municipalities/{id}/streets
- GET /api/v1/intersections
- GET /api/v1/geocode
- GET /api/v1/reverse-geocoding
# Geocodificar una esquina
curl -H "X-API-Key: ck_••••••••" \
"https://cuplaces-api.eventosparaiso.com/api/v1/geocode?province=La%20Habana&municipality=Plaza%20de%20la%20Revoluci%C3%B3n&street=Calle%2023&cross_street=Calle%2012"{
"province": "La Habana",
"municipality": "Plaza de la Revolución",
"street": "Calle 23",
"cross_street": "Calle 12",
"latitude": 23.1271792,
"longitude": -82.3995931
}
Si un componente no se resuelve, la API responde 404 con un
error estructurado en lugar de devolver una aproximación.
Cobertura y confianza
Sus datos de referencia, bajo su control
Los datos de referencia viven en una base geoespacial propia, no en un servicio externo. Instalada en sus servidores, su institución conserva el control de la información y de la disponibilidad del servicio.
Los datos se quedan con usted
Base PostgreSQL/PostGIS propia, instalable en sus propios servidores.
Respuestas deterministas
Misma entrada, misma salida. El resultado no depende de terceros ni de Internet.
Control de acceso
Claves almacenadas de forma segura, revocación inmediata y uso atribuido por cliente.
Datos actualizables
Se actualizan desde OpenStreetMap con un proceso repetible y admiten correcciones propias.
15 provincias y el municipio especial
- Pinar del Río
- Artemisa
- La Habana
- Mayabeque
- Matanzas
- Villa Clara
- Cienfuegos
- Sancti Spíritus
- Ciego de Ávila
- Camagüey
- Las Tunas
- Holguín
- Granma
- Santiago de Cuba
- Guantánamo
- Isla de la Juventud
La cobertura de OpenStreetMap en Cuba es desigual: algunas zonas tienen menos calles que otras. La base admite correcciones propias sin depender de terceros.
Solicite acceso a la API
Cuéntenos qué direcciones necesita ubicar o validar y le contactamos para coordinar una demostración y el acceso institucional. También ofrecemos la instalación en sus propios servidores.
- [email protected]
- Acceso institucional o instalación en sus servidores