Communitygithub.com

globo-premium

3D 지구본 위의 카메라 비행 – 실제 위성 이미지(우주에서 정확한 지점까지), 핀 지도, 지역 레이블, 실선 또는 점선 애니메이션 경로, 3D 산악 지형, 도시 불빛이 보이는 야간 지구를 9:16 세로 및 16:9 가로 영상으로 제작합니다. 어떤 장소의 위치, 여정, 경로, 지도 또는 지구본을 보여주는 영상이 필요할 때 사용하세요.

globo-premium란 무엇인가요?

Globo Premium은 MapLibre GL을 Chromium 헤드리스에서 프레임 단위로 렌더링하여 실제 위성 이미지가 포함된 3D 지구본 비행 영상을 생성하는 AI 에이전트 스킬입니다. 이 스킬은 Claude Code, Cursor, Codex 등과 같은 AI 코딩 도구와 함께 작동하도록 설계되었습니다. 주요 기능으로는 핀 지도, 지역 레이블, 실선 또는 점선 애니메이션 경로, 3D 산악 지형, NASA 블랙 마블 야간 조명 레이어 등이 있으며, 9:16 세로 및 16:9 가로 비율을 모두 지원합니다. 사용자는 JSON 파일로 카메라 움직임, 경로, 핀, 스타일을 정의할 수 있으며, 스킬은 이를 MP4 비디오 클립으로 변환합니다. 빠른 피드백을 위한 저해상도 미리보기(보조 + 스틸 시트)와 최종 고품질 렌더링 워크플로를 제공합니다. 이 스킬은 특히 여정 지도, 역사적 경로, 장소 소개, 야간 비행 장면 등에 적합하며, 외부 API 키나 계정 없이 공개 타일 서버를 사용합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/danilopalomba/globo-premium/tree/main/skills/globo-premium

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Globo premium

엔진: 이 스킬의 motore/ 폴더 (MapLibre GL in Chromium headless, 프레임 단위: 건너뜀 없음, 타일 누락 없음). 무음 MP4 출력: 음성, 효과 및 음악은 편집 시 추가.

처음 사용: 스킬 폴더에 node_modules가 없으면 bash installa.sh 실행 (Node 18+ 및 ffmpeg 확인, Playwright 및 해당 Chromium 설치). 지도를 다운로드하거나 구성할 필요 없음: 키 없음, 계정 없음, 타일은 렌더링 중 공개 서버에서 자동으로 가져옴 (인터넷 필요).

G="<스킬 폴더>/motore"        # 스킬 기본 폴더 (이 SKILL.md가 있는 곳)
node $G/render.mjs viaggio.json bozza.mp4 --scala 0.5 --fps 15 --foglio foglio.jpg   # 항상 먼저: 16프레임으로 보조 + 시트
node $G/render.mjs viaggio.json clip.mp4                                             # 최종 (파일 w×h, 30fps)
#   --da 3 --a 6  특정 구간만 렌더링

9:16에서 8초 보조는 약 1분이 소요되며 최종과 정확히 같은 프레임을 잡습니다. 최종 전에 시트를 확인하세요: 핀이 프레임 안에 있는지, 경로가 보이는지, 사각형이 없는지.

여정 파일

motore/esempi/에 준비된 예제: notte_roma_tokyo.json (야간 + 경로, 9:16), marco_polo.json (단계별 경로), everest.json (3D 산), derinkuyu.json (비행 + 지형, 16:9), derinkuyu_spazio_169.json (우주에서 지점까지) 및 _169 버전.

  • w, h, fps, durata; 9:16에서는 u: 1.45 (텍스트 및 핀 스케일).
  • camera: 키 {t, lng, lat, zoom, pitch, bearing}, 단조 곡선으로 보간. Zoom 1-1.3 전체 지구본 · 2.85-3.2 지구본이 9:16을 채움 · 4-5 국가 · 8 지역 · 11-12.5 도시. 최대 pitch ~52.
  • etichette: pin (testo 짧게, sotto, lng, lat, da, a, altezza) 또는 regione. 핀 카드는 지점 위에 위치: 카메라 중심을 핀 북쪽에 유지 (핀이 아래쪽 절반에 있도록), 그렇지 않으면 높은 pitch에서 카드가 프레임 밖으로 나감.
  • percorsi: punti [[lng,lat]…], da/a, stile pieno|tratteggio, nota (알약) with nota_da, nota_dx, nota_dy 및 nota_pos [lng,lat] (기본값: 출발지와 도착지 중간; 긴 경로에서는 경로 상의 한 지점에 배치). 긴 경로의 경우 대원 위의 점을 사용하고 카메라가 경로 헤드를 따라가도록 (경로를 따라 키 배치), 그렇지 않으면 선이 9:16 프레임 밖으로 나감.
  • stile: "notte": NASA Black Marble 2016 (도시 불빛; 최대 zoom 8, 따라서 도시 클로즈업 없음).
  • terreno: 지형 exaggeration (1.4-1.6 산, 0 바다). ombre: false 바다 위.
  • blue_marble (기본값 켜짐): 멀리서 NASA Blue Marble, 가까이서 Sentinel-2, zoom 간 페이드 blue_marble_zoom (기본값 [7, 8.2]). 위성 지도 타일의 사각형을 제거합니다. 아시아 산맥 (에베레스트, 티베트)에서는 [9.4, 10.6] 사용; blue_marble: false는 Sentinel-2만.
  • 핀 카드와 메모는 항상 자체적으로 프레임 안에 유지됨 (지점 위에 들어가지 않으면 아래로 이동); 지점이 프레임 밖으로 나가면 카드도 함께 나감.
  • crediti: 왼쪽 하단의 크레딧 텍스트 (기본값 이탈리아어; 필요시 영어 또는 사용자 언어로 설정, 출처는 제거하지 말 것).

레시피

  • A에서 B로 비행 (순위, "위치"): A zoom 3.2, pitch 15 → 중간 zoom 1.9 → B zoom 6-6.8, pitch 30, 3초.
  • 역사적 여정: 실제 단계를 점으로, 스타일 pieno (밝은 점선은 사막에서 사라짐), 연도 또는 km가 있는 메모, 카메라가 따라감.
  • 산: 출발 zoom ~3.2 위에서, 8.6으로 하강하며 pitch 38, 11에 도착하며 pitch 50, 중심은 정상 약간 북쪽.
  • 야간: 경로와 핀이 잘 드러남; 대륙간 비행에 이상적.

알려진 제한 사항

  • 티베트/중국/인도 상공의 위성 지도 타일 (EOX 데이터)은 blue_marine_zoom까지 Blue Marble로 덮임: 여전히 사각형이 보이면 두 값을 높이세요.
  • 바다 한가운데의 작은 섬은 zoom ~6 이상에서 더 밝은 사각형을 보임: 5.8-6.6에서 멈추세요.
  • 긴 레이블은 9:16 프레임 밖으로 나감: testo에 1-2 단어, 나머지는 sotto에.

라이선스

저장소 루트의 CREDITI.md 참조. EOX 2016 레이어만 사용 (CC BY 4.0, 크레딧과 함께 상업적 사용 가능); EOX 2018+ 레이어는 절대 사용 금지 (비상업적). 야간: NASA Black Marble 2016. 원거리: NASA Blue Marble. 지형: AWS Terrain Tiles (Mapzen). 크레딧을 비디오 설명에 복사하세요.

관련 스킬