Communitygithub.com

Globo Premium

Vuelos de cámara sobre un globo terráqueo 3D con imágenes satelitales reales (desde el espacio hasta el punto exacto), pins con tarjetas, etiquetas de región, rutas animadas sólidas o punteadas, relieve 3D de montañas y la Tierra de noche con las luces de las ciudades, para videos verticales 9:16 y horizontales 16:9. Úsalo cuando un video deba mostrar DÓNDE está algo, un viaje, una ruta, un vuelo de un lugar a otro, un mapa o un globo.

¿Qué es Globo Premium?

Globo Premium es una skill para agentes de IA (como Claude Code, Cursor o Codex) que genera videos de mapas 3D con imágenes satelitales reales, permitiendo visualizar ubicaciones, rutas de viaje, vuelos entre lugares y globos terráqueos. Está basada en MapLibre GL renderizado en Chromium sin interfaz gráfica, cuadro por cuadro, produciendo archivos MP4 sin audio (la voz, efectos y música se añaden en la edición posterior). Soporta formatos de video vertical 9:16 y horizontal 16:9, e incluye características avanzadas como pins con tarjetas informativas, etiquetas de región, rutas animadas (sólidas o punteadas), relieve 3D de montañas y capa nocturna con luces de ciudades (NASA Black Marble). El agente de IA recibe un archivo JSON que define la trayectoria de la cámara, los pins, las rutas y el estilo, y la skill se encarga de todo el renderizado sin necesidad de configurar cuentas ni descargar mapas previamente; las teselas se obtienen automáticamente de servidores públicos durante el renderizado. Es ideal para creadores de contenido, documentalistas y desarrolladores que quieran integrar visualizaciones geográficas profesionales en sus proyectos de video.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/danilopalomba/globo-premium/tree/main/skills/globo-premium

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Globo Premium?

Motor: la carpeta motore/ de esta skill (MapLibre GL en Chromium headless, fotograma por fotograma: sin saltos, sin teselas perdidas). Genera un MP4 mudo: la voz, efectos y música se añaden en la edición.

Primera vez: si en la carpeta de la skill falta node_modules, ejecuta bash instala.sh (verifica Node 18+ y ffmpeg, instala Playwright y su Chromium). No es necesario descargar ni configurar mapas: sin claves, sin cuenta, las teselas llegan solas desde servidores públicos durante el render (se necesita internet).

G="<carpeta de esta skill>/motore"        # la carpeta base de la skill (donde está este SKILL.md)
node $G/render.mjs viaje.json borrador.mp4 --escala 0.5 --fps 15 --hoja hoja.jpg   # SIEMPRE primero: borrador + hoja de 16 fotogramas
node $G/render.mjs viaje.json clip.mp4                                             # definitivo (w×h del archivo, 30 fps)
#   --desde 3 --hasta 6  para renderizar solo un tramo

Un borrador de 8 s en 9:16 requiere aproximadamente un minuto y encuadra exactamente como el definitivo. Mira la hoja antes del definitivo: pins dentro del cuadro, ruta visible, sin recuadros.

El archivo del viaje

Ejemplos listos en motore/esempi/: notte_roma_tokyo.json (noche + ruta, 9:16), marco_polo.json (ruta por etapas), everest.json (montaña 3D), derinkuyu.json (vuelo + relieve, 16:9), derinkuyu_spazio_169.json (desde el espacio hasta un punto) y las versiones _169.

  • w, h, fps, duracion; en 9:16 pon u: 1.45 (escala de textos y pins).
  • camara: claves {t, lng, lat, zoom, pitch, bearing}, interpoladas con una curva monótona. Zoom 1-1,3 globo entero · 2,85-3,2 globo que llena el 9:16 · 4-5 país · 8 región · 11-12,5 ciudad. Pitch máximo ~52.
  • etiquetas: pin (texto CORTO, abajo, lng, lat, desde, hasta, altura) o region. La tarjeta del pin está ENCIMA del punto: mantén el centro de la cámara al norte del pin (pin en la mitad inferior), de lo contrario, con pitch alto la tarjeta sale del cuadro.
  • rutas: puntos [[lng,lat]…], desde/hasta, estilo solido|punteado, nota (píldora) con nota_desde, nota_dx, nota_dy y nota_pos [lng,lat] (predeterminado: a mitad de camino entre inicio y fin; en rutas largas, colócala en un punto de la ruta). Para rutas largas usa puntos sobre el círculo máximo y haz que la cabeza de la ruta siga a la cámara (claves a lo largo del recorrido), de lo contrario la línea sale del 9:16.
  • estilo: "noche": NASA Black Marble 2016 (luces de las ciudades; zoom máximo 8, por lo tanto sin primeros planos de ciudades).
  • terreno: exageración del relieve (1,4-1,6 montañas, 0 océanos). sombras: false sobre el océano.
  • blue_marble (predeterminado encendido): desde lejos NASA Blue Marble, desde cerca Sentinel-2, con fundido entre los zooms blue_marble_zoom (predeterminado [7, 8.2]). Elimina los recuadros del mapa satelital. En las montañas de Asia (Everest, Tíbet) usa [9.4, 10.6]; blue_marble: false solo Sentinel-2.
  • Las tarjetas de los pins y las notas se mantienen siempre dentro del cuadro por sí solas (si no caben encima del punto, van debajo); si el punto sale del cuadro, la tarjeta sale con él.
  • creditos: texto de créditos en la parte inferior izquierda (predeterminado en italiano; ponlo en inglés o en tu idioma si es necesario, sin quitar las fuentes).

Recetas

  • Vuelo de A a B (clasificaciones, «dónde está»): A zoom 3,2 pitch 15 → medio camino zoom 1,9 → B zoom 6-6,8 pitch 30, en 3 s.
  • Viaje histórico: etapas reales como puntos, estilo solido (el punteado claro se pierde sobre los desiertos), nota con años o km, cámara que sigue.
  • Montaña: inicio desde zoom ~3,2 desde arriba, descenso a 8,6 con pitch 38, llegada a 11 con pitch 50, centro un poco al norte de la cima.
  • Noche: rutas y pins resaltan mucho; ideal para vuelos intercontinentales.

Límites conocidos

  • Los recuadros del mapa satelital (dato EOX) sobre Tíbet/China/India están cubiertos por Blue Marble hasta el zoom de blue_marble_zoom: si todavía se ve un recuadro, sube esos dos valores.
  • Las islas pequeñas en medio del océano más allá del zoom ~6 muestran un recuadro más claro: detente en 5,8-6,6.
  • Las etiquetas largas salen del 9:16: 1-2 palabras en el texto, el resto en abajo.

Licencias

Ver CREDITOS.md en la raíz del repositorio. Usa solo la capa EOX 2016 (CC BY 4.0, uso comercial con crédito); NUNCA las capas EOX 2018+ (no comerciales). Noche: NASA Black Marble 2016. Desde lejos: NASA Blue Marble. Relieve: AWS Terrain Tiles (Mapzen). Copia los créditos en la descripción del video.

Skills relacionados