Getting Started with GeoTasker

GeoTasker makes it easy to create animated geospatial story videos using natural language. Just describe what you want, and AI handles the rest.

What You Can Create

With GeoTasker, you can create videos that:

• Tell geographic stories with animated map movements and annotations
• Visualize data through choropleth maps and charts
• Engage audiences with professional narration and background music

Your First Video: A Simple Example

Let's create a video showing the capitals of Europe. Here's a sample prompt:

Create a 30-second video tour of European capitals. Start with London,
then fly to Paris, Berlin, and Rome. Show each city name with a marker
and add a brief fun fact about each capital.

What GeoTasker Does

1. Parses your intent - Understands you want a map tour with annotations
2. Generates the story - Creates a structured video plan with segments
3. Renders the video - Produces an MP4 with smooth map animations
4. Adds narration - Synthesizes natural-sounding voiceover
5. Applies music - Adds appropriate background music

See It in Action

Watch how GeoTasker takes a prompt, generates a story plan, and renders the final video — all through a simple chat interface:

Video Output

And here's the finished video:

Advanced Features

Once you're comfortable with basic videos, explore these advanced features:

Code Example

If you're integrating GeoTasker into your application, here's a basic API example:

import time
import requests

API_KEY = "gt_live_your_key_here"
headers = {"X-API-Key": API_KEY}

# Generate a video from a text prompt
resp = requests.post(
  "https://geotasker.ai/api/v1/generate",
  headers=headers,
  json={
      "prompt": "Create a 30-second tour of European capitals",
      "options": {
          "resolution": "1080p",
          "music_style": "Cinematic"
      }
  }
)
task = resp.json()
print(f"Task created: {task['id']}")

# Poll until the video is ready
while True:
  status = requests.get(
      f"https://geotasker.ai/api/v1/videos/{task['id']}",
      headers=headers
  ).json()
  print(f"Status: {status['status']} | Progress: {status.get('progress', '-')}%")

  if status["status"] == "completed":
      print(f"Video ready: {status['video_url']}")
      break
  elif status["status"] == "failed":
      print(f"Error: {status.get('error')}")
      break

  time.sleep(5)

Next Steps

Ready to create your own map videos? Here's what to do next:

1. Sign up at geotasker.ai
2. Write your first prompt describing the video you want
3. Iterate and refine based on the output
4. Share your creation with the world!

Questions? Join our community on Discord or leave a comment below. We'd love to see what you create!