Tu ubicación, dentro de un mapa interactivo.
Convierte unas coordenadas en una vista que puedes abrir, compartir o insertar en otra aplicación con un iframe.
Crea tu API keycurl "https://maps-api.nexode.app/v1/maps" \
-H "X-API-Key: TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Mi ubicación","center":{"latitude":-12.119906,"longitude":-77.028971},"zoom":14}'Permiso de la clave: maps. Cada petición admitida consume una unidad del plan.
Qué incluye el visor
El visor de Mapora utiliza MapLibre y cartografía vectorial mundial de OpenStreetMap/Protomaps alojada por Mapora. Permite acercar, alejar, desplazarse, volver a las ubicaciones y abrir pantalla completa cuando el navegador lo admite. Puedes enviar hasta 200 marcadores con latitude, longitude y label. Los controles funcionan con teclado y el movimiento reducido se respeta automáticamente.
Cómo insertarlo en otra web
El endpoint devuelve url, embedHtml, expiresAt y la especificación normalizada del mapa. Utiliza url para abrir una vista independiente o copia embedHtml en la página que debe mostrarla. También puedes generarlo visualmente desde la sección Mapas del panel. La clave necesita el permiso maps; las claves antiguas conservan sus permisos y no adquieren esta operación automáticamente.
Un enlace de lectura, sin compartir la clave
La URL contiene un token de lectura para ese mapa, no tu API key. Cualquier persona que tenga el enlace puede ver la ubicación: compártelo solo cuando ese alcance sea apropiado. El enlace dura 7 días por defecto; expiresIn permite configurar de 60 segundos a 30 días. Revocar la clave que lo creó o suspender la cuenta impide cargar sus mapas. Una vista ya cargada en un navegador no se borra de ese dispositivo.
Peticiones y límites de la cartografía
Generar un mapa consume una petición autenticada admitida. Abrir el visor, moverlo y hacer zoom no añade peticiones al consumo de Mapora. Los mosaicos, fuentes e iconos cartográficos se sirven mediante Mapora. La API admite estilos claro, oscuro y escala de grises, color de marca, agrupación de marcadores, polígonos y geometrías de rutas. No incluye imágenes satelitales, mapas sin conexión ni descarga masiva de la cartografía.
Autenticación, cuotas y errores
Envía la clave en X-API-Key o Authorization: Bearer. HTTP 401 indica una clave ausente o inválida; 403, falta de permiso o cuenta suspendida; 429, cuota o velocidad excedida. Consulta las cabeceras de cuota y respeta Retry-After. El panel muestra tu plan y consumo real.