Georender API Documentation

A REST API that converts geographic coordinates into cinematic MP4 map animations. Send coordinates, receive broadcast-quality animated map videos.

What is Georender?

Georender is an API-first map animation platform designed for content creators, newsrooms, and developers. Instead of spending hours in After Effects or hiring motion designers, you send an API request with waypoints and receive a polished, broadcast-quality video in under 90 seconds.

Key Features

• 4 Render Modes: Route animation, region focus, multi-route, and country data visualization
• 7 Map Styles: Maritime Dark, Satellite, Satellite Streets, Geopolitics, Minimal, Standard, Outdoors
• Smart Routing: Maritime routing (follows shipping lanes), road routing, and manual (great circle)
• Professional Output: Up to 4K @ 60fps with 3D terrain and cinematic camera movements
• HUD Elements: Distance counters, progress bars, minimaps, and custom text overlays
• Webhooks: Get notified when your render completes
• SDKs: Official Python and Node.js libraries

Quick Example

Here's the simplest possible API request:

POST /v1/render
Authorization: Bearer gr_live_xxxxxxxxxxxx
Content-Type: application/json

{
  "waypoints": [
    { "lat": 29.9792, "lng": 32.5731, "label": "Suez Canal" },
    { "lat": 12.3567, "lng": 43.6028, "label": "Bab el-Mandeb" }
  ]
}

Response:

{
  "job_id": "job_8f3k2m9x",
  "status": "queued",
  "estimated_duration_seconds": 36,
  "status_url": "https://api.georender.io/v1/status/job_8f3k2m9x"
}

Getting Started

1. Quick Start Guide - Create your first render in 5 minutes
2. Authentication - Get your API key and start making requests
3. Render Modes - Learn about the 4 different animation types

Use Cases

Georender is built for:

• YouTube Creators: Shipping/geopolitics channels, news analysis, documentary-style content
• Newsrooms: Breaking news maps, supply chain stories, conflict coverage
• Educators: Geography lessons, trade route history, climate visualization
• Logistics: Supply chain presentations, route optimization visuals, client demos

API Versioning

All endpoints are versioned using URL path prefixes. The current version is v1.

https://api.georender.io/v1/render
https://api.georender.io/v1/status/{job_id}
https://api.georender.io/v1/styles