Animations
GIF and MP4 map zoom animations
Map Zoom Animation
generate_animationCreate smooth map zoom animations that fly from a wide view into a specific location. Supports both GIF and MP4 output formats, multiple map tile styles, configurable FPS and duration, and optional marker coloring. Built using an offline vector map renderer for fast rendering. Includes presets for TikTok (9:16), Instagram Stories (9:16), Instagram Square (1:1), X/Twitter (16:9), and YouTube thumbnails (16:9). Perfect for social media content, presentations, or geographic storytelling.
GIF output uses low FPS (4) for smaller file sizes. MP4 output supports 30 or 60fps for smooth, broadcast-quality animations. Use social media presets for platform-perfect sizing: preset:"tiktok" (1080x1920), preset:"instagram-story" (1080x1920), preset:"instagram-square" (1080x1080), preset:"twitter" (1200x675), preset:"youtube-thumbnail" (1280x720). Or just ask: "Create a TikTok-sized zoom animation into Paris."
Video / Animation Preview
Paris zoom - GIF (OSM)
Tokyo zoom - GIF (OSM)
Tokyo zoom - GIF (Satellite)
Tokyo zoom - GIF (Dark)
London zoom - Green marker
Instagram square formatParameters
| Name | Type | Description | Default |
|---|---|---|---|
typerequired | string | Animation type (currently: map_zoom) | - |
latituderequired | number | Target latitude to zoom into | - |
longituderequired | number | Target longitude to zoom into | - |
zoom_start | number | Starting zoom level (wide view) | 2 |
zoom_end | number | Ending zoom level (close-up) | 12 |
fps | integer | Frames per second (4 for GIF, 30-60 for MP4) | 30 |
duration | number | Animation duration in seconds | 4.0 |
width | integer | Frame width in pixels | 800 |
height | integer | Frame height in pixels | 600 |
output_format | string | Output format: gif or mp4 | gif |
style | string | Map tile style: osm, satellite, carto, carto-dark, topo | osm |
marker_color | string | Hex color for the target marker | - |
preset | string | Social media preset (overrides width/height) | - |
Example Prompts
“Create a zoom animation from world view into Paris as a GIF”
“Generate an MP4 map zoom targeting New York City at 30fps”
“Make a TikTok-format zoom animation into the Colosseum in Rome”
“Create an Instagram Story zoom animation into Tokyo using satellite imagery”
“Generate a Twitter-sized dark-themed zoom into London with a green marker”
“Create an Instagram Square zoom animation into Rio de Janeiro”