Communitygithub.com

globo-premium

3D地球儀上でのカメラフライト動画を生成するスキル。実際の衛星画像を使用し、ピン付き地図、地域ラベル、実線・破線のアニメーションパス、3D山岳地形、夜景の都市明かりなどを、9:16縦型・16:9横型動画として出力します。何かの場所、旅路、ルート、地点間の飛行、地図や地球儀を動画で示す必要がある場合に使用します。

globo-premium とは?

このスキルは、実際の衛星画像と地形データを使用して、プロフェッショナルな3D地球儀アニメーション動画を生成します。MapLibre GLをChromiumヘッドレスで駆動し、フレームごとに正確にレンダリングするため、飛びやタイル欠けのない高品質な出力が得られます。対応プラットフォームはClaude CodeなどのAIエージェントで、ジョブファイル(JSON形式)でカメラ移動、ピン、パス、ラベルなどを細かく制御可能です。最初に低解像度でテストレンダリングし、確認用「紙」画像を出力することで、本番レンダリング前に構図や見切れをチェックできるワークフローが特徴です。出力はMP4(音声なし)で、後からナレーションやBGMを編集で追加します。NASA Black Marble夜景、Blue Marble遠景、Sentinel-2近接画層を自動ブレンドし、山岳の3D表現や都市の明かりもリアルに再現します。複数のジョブ例が付属しており、ローマ-東京の夜景飛行、マルコ・ポーロの旅路、エベレスト山岳、宇宙から地上へのズームなど、すぐに試せるテンプレートが用意されています。

対応✓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:音声、効果音、BGMは編集で追加します。

初回: スキルフォルダに 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、30 fps)
#   --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 都市。最大ピッチ ~52。
  • etichette: pin(testo は短く、sotto、lng、lat、da、a、altezza)または regione。 ピンのカードはポイントの 上 に表示:カメラ中心をピンの北側に保つ(ピンは下半分)。そうしないと、高いピッチでカードがフレーム外に出ます。
  • percorsi: punti [[lng,lat]…]、da/a、stile pieno|tratteggio、nota(ピル)に nota_da、nota_dx、nota_dy、nota_pos [lng,lat](デフォルト:出発地と到着地の中間;長いルートではルート上の点に設定)。 長いルートでは大円上の点を使い、ルートの先頭にカメラを追従させる(パスに沿ったキー)。そうしないと線が9:16からはみ出します。
  • stile: "notte": NASA Black Marble 2016(都市の明かり;最大ズーム8。よって都市のクローズアップ不可)。
  • terreno: 地形の強調(1.4-1.6 山岳、0 海洋)。ombre: false は海洋上。
  • blue_marble(デフォルトON):遠距離はNASA Blue Marble、近距離はSentinel-2、ズーム間でフェード。blue_marble_zoom(デフォルト[7, 8.2])。衛星地図のタイル境界を取り除きます。アジアの山岳(エベレスト、チベット)では[9.4, 10.6]を使用。blue_marble: false ならSentinel-2のみ。
  • ピンのカードとノートは常に自動でフレーム内に収まります(ポイントの上に入らない場合は下に表示)。ポイントがフレーム外に出ると、カードも一緒に出ます。
  • crediti: 左下に表示するクレジットテキスト(デフォルトはイタリア語;必要に応じて英語や他の言語に変更。出典は削除しないでください)。

レシピ

  • AからBへの飛行(ランキング、「どこにあるか」):ズーム3.2、ピッチ15 → 中間点ズーム1.9 → Bズーム6-6.8、ピッチ30、3秒。
  • 歴史的な旅:実際の経由地をポイントに、スタイル pieno(点線は砂漠で見えにくい)、注釈に年や距離、カメラは追従。
  • 山岳:上空ズーム~3.2からスタート、8.6に降りてピッチ38、11でピッチ50に到着。中心は頂点のやや北。
  • 夜景:ルートやピンがよく映える。大陸間飛行に最適。

既知の制限

  • 衛星地図タイル(EOXデータ)のチベット・中国・インド周辺の境界は、blue_marble_zoom のズームまでBlue Marbleでカバーされます。それでもタイル境界が見える場合は、その2つの値を上げてください。
  • 海洋上の小さな島はズーム~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)。動画の説明にクレジットをコピーしてください。

関連スキル