🌍 TERRA — Atlas interactivo 3D

Un globo terráqueo 3D interactivo donde puedes explorar el planeta, hacer clic en cualquier país y ver su información más relevante (capital, idiomas, población, moneda, superficie, región y más). Incluye narración por voz en español para escuchar la descripción de cada país.

---

✨ Características

• Globo 3D navegable: rota, acerca y aleja con el ratón o el dedo.
• Países interactivos: pasa el cursor para resaltar y haz clic para abrir la ficha del país.
• Ficha de información: capital, población, idiomas, región, superficie, densidad, moneda, gentilicio y fronteras.
• Narración por voz 🔊: escucha la descripción del país con la Web Speech API del navegador (no requiere claves ni servicios externos).
• Buscador: encuentra cualquier país por su nombre y vuela hacia él.
• Rotación automática, vista de reinicio e indicador de coordenadas.
• Responsive: en móvil la ficha aparece como hoja inferior.

---

🚀 Publicar en GitHub Pages (paso a paso)

1. Crea un repositorio nuevo en GitHub (por ejemplo terra-atlas-3d).
2. Sube todos los archivos de esta carpeta al repositorio:

   index.html
   styles.css
   app.js
   data.js
   .nojekyll
   README.md
   

   Puedes arrastrarlos en la web de GitHub (Add file → Upload files) o por consola:

   git init
   git add .
   git commit -m "TERRA: atlas interactivo 3D"
   git branch -M main
   git remote add origin https://github.com/TU_USUARIO/terra-atlas-3d.git
   git push -u origin main

3. En GitHub ve a Settings → Pages.
4. En Build and deployment → Source elige Deploy from a branch.
5. Selecciona la rama main y la carpeta / (root), y pulsa Save.
6. Espera ~1 minuto. Tu atlas estará disponible en:

   https://TU_USUARIO.github.io/terra-atlas-3d/
   

El archivo .nojekyll evita que GitHub procese el sitio con Jekyll, garantizando que todos los archivos se sirvan tal cual.

---

💻 Probar en tu computadora

Como los datos están en data.js (no se cargan por fetch), basta con abrir index.html haciendo doble clic.

Necesitas conexión a internet la primera vez para que el navegador descargue la librería del globo (globe.gl) y las texturas de la Tierra desde un CDN.

Si prefieres un servidor local:

python3 -m http.server 8000
# luego abre http://localhost:8000

---

🗂️ Estructura del proyecto

Archivo	Descripción
index.html	Estructura de la página y carga de librerías.
styles.css	Estilos (estética de instrumento astronómico).
app.js	Lógica: globo, interacciones, buscador y narración por voz.
data.js	Geometría de los países + datos (capital, idiomas, población…).
.nojekyll	Indica a GitHub Pages que no use Jekyll.

---

🔧 Personalización rápida

• Textura del planeta: en app.js, cambia earth-dark.jpg por earth-night.jpg, earth-blue-marble.jpg o earth-day.jpg.
• Colores: edita las variables CSS al inicio de styles.css (--amber, --cyan, etc.).
• Voz / idioma de narración: en app.js, la función loadVoices() selecciona una voz en español; puedes ajustar el lang del SpeechSynthesisUtterance.
• Velocidad de rotación: controls.autoRotateSpeed en app.js.

---

📚 Fuentes de datos y créditos

• Geometría y población estimada: Natural Earth (dominio público).
• Datos enriquecidos (capital, idiomas, moneda, superficie, banderas): mledoze/countries (ODbL).
• Globo 3D: globe.gl sobre Three.js.
• Narración: Web Speech API (nativa del navegador).

Los datos de población son estimaciones y pueden no reflejar las cifras más recientes. Territorios de reconocimiento parcial (p. ej. Chipre del Norte, Somalilandia) se muestran asociados al Estado reconocido.

---

📝 Licencia

Código bajo licencia MIT. Respeta las licencias de las fuentes de datos enlazadas arriba.