⏱ Tiempo estimado: 22 minutos
🎯 Rama / Perfil: Aspirantes a frontend que quieren pasar de páginas estáticas a páginas con datos dinámicos.
🧠 Conocimiento previo necesario: Funciones, bucles for...of y el DOM (clases 10, 11 y 17). Concepto de API (clase 23).
💡 ¿Qué vas a lograr? Un widget con la temperatura actual y el pronóstico de 3 días, con estados de carga y error.
🛠 Lo que necesitas antes de empezar
- VS Code con Live Server y tu proyecto → 🔗 code.visualstudio.com
- API de Open-Meteo, gratuita y sin API key → 🔗 open-meteo.com
📋 Pasos
Paso 1: Explora la API en el navegador
Pega esta URL en una pestaña (coordenadas de Medellín; cámbialas por las de tu ciudad):
https://api.open-meteo.com/v1/forecast?latitude=6.25&longitude=-75.56¤t=temperature_2m&daily=temperature_2m_max,temperature_2m_min&timezone=auto
Mira el JSON que devuelve: ahí están current y daily.
🔗 Documentación de la API
Paso 2: Prepara el HTML
html
<section id="clima">
<h2>Clima en Medellín</h2>
<p id="clima-estado">Cargando...</p>
<p id="clima-actual"></p>
<ul id="clima-dias"></ul>
</section>
Paso 3: Pide los datos con async/await
js
const URL_CLIMA =
"https://api.open-meteo.com/v1/forecast?latitude=6.25&longitude=-75.56" +
"¤t=temperature_2m&daily=temperature_2m_max,temperature_2m_min&timezone=auto";
async function cargarClima() {
const estado = document.querySelector("#clima-estado");
try {
const res = await fetch(URL_CLIMA);
if (!res.ok) throw new Error("Respuesta no válida");
const datos = await res.json();
estado.textContent = "";
pintarClima(datos);
} catch (error) {
estado.textContent = "No pudimos cargar el clima. Intenta más tarde.";
}
}
cargarClima();
Paso 4: Pinta los resultados con un bucle
js
function pintarClima(datos) {
document.querySelector("#clima-actual").textContent =
`Ahora: ${datos.current.temperature_2m} °C`;
const lista = document.querySelector("#clima-dias");
lista.innerHTML = "";
const { time, temperature_2m_max, temperature_2m_min } = datos.daily;
for (let i = 0; i < 3; i++) {
const li = document.createElement("li");
li.textContent = `${time[i]}: ${temperature_2m_min[i]}° / ${temperature_2m_max[i]}°`;
lista.appendChild(li);
}
}
Paso 5: Depura con DevTools
Abre la pestaña Network, recarga y localiza la petición a api.open-meteo.com. Prueba a romper la URL a propósito para ver cómo aparece tu mensaje de error (clases 19 y 20).
Paso 6: Publica
bash
git add .
git commit -m "Añade widget de clima con Open-Meteo"
git push
✅ Resultado esperado
Tu página muestra la temperatura actual y el pronóstico de 3 días con datos reales, y maneja correctamente los estados de carga y error. Vercel lo publica con cada git push.
🔥 Tu reto (siguiente acción)
Añade un
<select>para elegir entre 3 ciudades y que el widget se actualice al cambiar. Pista: guarda las coordenadas de cada ciudad en un objeto y reutilizacargarClima. Para buscar coordenadas puedes usar la API de geocodificación.
📚 Recursos para ir más lejos
- Open-Meteo Docs: Más variables como lluvia, viento y humedad.
- async/await (MDN): Cómo funciona el código asíncrono.
Curso Gratis de Programación Básica
COMPARTE ESTE ARTÍCULO Y MUESTRA LO QUE APRENDISTE
