Plataforma de interoperabilidad del SENAMHI · Manual de usuario

1.1 Qué es la plataforma

La plataforma de interoperabilidad reúne las dos formas de llevar los datos del SENAMHI a sus propias herramientas: los servicios espaciales, capas estándar OGC que se abren en cualquier programa SIG, y las APIs REST del observatorio, que entregan los datos en JSON para consultarlos desde un programa. Está en https://observatorio.senamhi.gob.pe/investigadores/interoperabilidad.

Se organiza en cuatro pestañas:

1.2 Qué necesita

2.1 Buscar un servicio

En la pestaña Inicio escriba lo que necesita —por ejemplo, «lluvia», «cuencas» o «pronóstico»— o elija uno de los temas que aparecen debajo del buscador. Los resultados se separan en servicios espaciales y APIs; cada uno abre su ficha.

También puede recorrer el catálogo completo en la pestaña Servicios espaciales, ordenado por tema, o filtrarlo con su propio buscador.

2.2 La ficha del servicio

Cada ficha reúne lo necesario para usar la capa:

• Vista previa en vivo sobre el Perú y su leyenda.
• Espacio de trabajo y nombre de la capa, que se piden al conectarla.
• Geometría, número de elementos, frecuencia de actualización y sistemas de referencia.
• Atributos de cada elemento, con su tipo y su descripción.
• Notas de uso, cuando las hay.

Si el servicio tiene varias capas —por ejemplo, un pronóstico por mes—, elija la que quiera en el selector Capa: el resto de la ficha se ajusta a ella.

2.3 Conectar la capa a su programa

Cada espacio de trabajo tiene su propia dirección. Use la del WMS para ver el mapa y la del WFS para trabajar con los datos:

En la sección Cómo usarlo de la ficha elija su herramienta —QGIS, ArcGIS Pro, ArcGIS Online, Python o Web— y siga los pasos. En QGIS, por ejemplo:

1. Abra Capa › Añadir capa › Añadir capa WMS/WMTS…
2. Pulse Nueva, escriba un nombre y pegue la dirección WMS del espacio de trabajo. Deje la autenticación vacía.
3. Pulse Conectar, elija la capa y pulse Añadir.

2.4 Descargar los datos

Las capas con WFS se descargan con su geometría y sus atributos. En Direcciones de la ficha encontrará los enlaces listos para GeoJSON, Shapefile (ZIP), KML y CSV.

Para descargar sólo una parte, use el panel Consulta WFS de la derecha: elija el formato, el límite de elementos, un encuadre (o una ciudad) y, si lo necesita, un filtro CQL sobre los atributos.

2.5 Ver la capa en GEOSENAMHI

El botón Abrir en GEOSENAMHI de la ficha enciende la capa en el visor de mapas del observatorio. Ahí puede combinarla con otras, consultar un punto, medir, dibujar, imprimir y compartir el mapa con un enlace.

3.1 Crear una cuenta

La cuenta es gratuita y sólo hace falta para la API y los guardados. Entre a Inicio › Crear cuenta gratuita (o a APIs, que la pide) y complete el formulario:

Acepte la declaración de datos personales (Ley N.° 29733), complete la verificación de seguridad y pulse Enviar solicitud.

3.2 Confirmar el correo

1. Abra el correo que le envió la plataforma y pulse el enlace de confirmación.
2. Elija la contraseña con la que ingresará: entre 10 y 72 caracteres, con letras y números.
3. Al guardarla, su correo queda confirmado y la solicitud pasa a revisión.

3.3 Revisión de la solicitud

El SENAMHI revisa cada solicitud antes de habilitar el acceso y le avisa por correo cuando puede ingresar. La cuenta pasa por estos estados:

3.4 Iniciar sesión

En Ingresar escriba su DNI (o su correo, si es extranjero) y su contraseña, complete la verificación de seguridad y pulse Ingresar.

3.5 Recuperar la contraseña

1. En Ingresar pulse ¿Olvidó su contraseña?
2. Escriba su usuario y pulse enviar: le llegará un enlace por correo.
3. Abra el enlace y elija una contraseña nueva. El enlace vence en unos minutos; si venció, pida otro.

3.6 Mi cuenta

Con la sesión iniciada, su nombre aparece en la cabecera de la plataforma; púlselo para abrir Mi cuenta. Ahí encontrará:

• Su API key, con un botón para copiarla.
• Su límite de consultas por día y por minuto.
• Sus datos de contacto, que puede actualizar.
• El formulario para cambiar la contraseña.
• Sus últimos accesos, con la fecha y la IP de cada uno.

4.1 Su API key

Cada consulta a la API lleva su API key en la cabecera apikey. Por ejemplo, con cURL:

curl -s "https://servicios.senamhi.gob.pe/api/…" \
  -H "apikey: SU-API-KEY" \
  -H "Accept: application/json"

4.2 Explorar y probar los endpoints

La pestaña APIs lista los endpoints por grupo. Cada uno muestra su descripción, sus parámetros, una consola para llamarlo con su API key y ver la respuesta, y ejemplos listos en cURL, JavaScript, Python y R. La guía de la API explica la dirección base, el formato de las respuestas, los errores y la especificación OpenAPI.

4.3 Límites de consulta

Cada cuenta tiene un límite de consultas por día y otro por minuto, que se ven en Mi cuenta. Al superarlos, la API rechaza las consultas hasta que empieza el siguiente periodo. Si necesita un límite mayor, solicítelo al SENAMHI explicando el uso.

5.1 Guardar capas y endpoints

Con la sesión iniciada, el botón Guardar de cada ficha —capa o endpoint— lo agrega a Mis guardados, en el panel de la derecha. Desde ahí lo abre de nuevo con un clic o lo quita.

5.2 Llevar las capas a QGIS

Desde Mis guardados, los botones Conexiones WMS y Conexiones WFS descargan un archivo .xml con una conexión por espacio de trabajo, ya con nombre. En QGIS ábralo en Administrador de fuentes de datos › WMS/WMTS (o WFS) › Cargar.