Camera & Animation

Georender provides intelligent camera presets and fine-grained control over camera movements.

Camera Presets

Use presets for automatic camera choreography based on your route characteristics:

{
  "camera": {
    "preset": "global_corridor_reveal",
    "intensity": "bold"
  }
}

Available Presets

Preset	Best For	Description
`global_corridor_reveal`	Long-haul routes (>3000 km)	Dramatic zoom from globe to route
`chokepoint_tension`	Routes through chokepoints	Emphasizes strategic locations
`long_reroute_burden`	Alternative route comparisons	Shows the cost of detours
`tension_build`	Building dramatic tension	Slow zoom into chokepoint
`canal_bottleneck`	Canal transit animations	Detailed canal passage
`chokepoint_focus`	Satellite chokepoint views	Tight focus on strategic points
`static_overview`	No camera movement needed	Fixed camera position

Intensity Levels

Intensity	Description
`soft`	Subtle camera movements
`balanced`	Moderate movements (default)
`bold`	Dramatic camera sweeps
`strong`	Maximum cinematic effect

Custom Camera Settings

For more control, configure individual camera parameters:

{
  "camera": {
    "preset": "chokepoint_tension",
    "mode": "follow",
    "start_zoom": 2,
    "waypoint_zoom": 6,
    "tilt": 30,
    "ease": "cubic-in-out",
    "start_focus_waypoint": "Suez Canal",
    "focus_hold_seconds": 1.5,
    "opening_zoom_boost": 1.2,
    "chokepoint_punch_in": 1.5
  }
}

Property	Type	Description
`mode`	enum	`follow` (track vehicle) or `static`
`start_zoom`	number	Initial zoom level (1-20)
`waypoint_zoom`	number	Zoom level at waypoints
`tilt`	number	Camera tilt angle (0-85 degrees)
`ease`	string	Easing function for transitions
`start_focus_waypoint`	string/int	Which waypoint to focus on at start
`focus_hold_seconds`	number	How long to hold at focus point
`opening_zoom_boost`	number	Extra zoom multiplier at opening
`chokepoint_punch_in`	number	Zoom multiplier at chokepoints

Cinematic Camera Paths

For complex camera choreography in multi-route mode, define keyframes:

{
  "multi_route": {
    "camera_path": [
      { "time": 0, "center": [56.4, 35], "zoom": 1.5, "pitch": 0, "bearing": 0 },
      { "time": 4, "center": [56.4, 26.5], "zoom": 4.5, "pitch": 25, "bearing": 0 },
      { "time": 8, "center": [100, 35], "zoom": 2.2, "pitch": 20, "bearing": 15 },
      { "time": null, "center": [100, 35], "zoom": 2.5, "pitch": 20, "bearing": 15 }
    ],
    "routes_start_at": 4,
    "routes_duration": 5
  }
}

Keyframe Properties

Property	Type	Description
`time`	number/null	Time in seconds (`null` = end of video)
`center`	[lng, lat]	Camera center coordinates
`zoom`	number	Zoom level (1-20)
`pitch`	number	Tilt angle (0-85 degrees)
`bearing`	number	Rotation angle (degrees)

Route Animation Timing

Control when routes start drawing relative to camera movement:

{
  "multi_route": {
    "routes_start_at": 4,
    "routes_duration": 5
  }
}

routes_start_at: Routes begin drawing at this time (seconds)
routes_duration: How long the route drawing animation takes

Tip: Sync routes_start_at with a camera keyframe to reveal routes as the camera arrives at a good vantage point.

Easing Functions

Control the feel of camera transitions:

linear - Constant speed
ease-in - Start slow, end fast
ease-out - Start fast, end slow
ease-in-out - Slow start and end
cubic-in-out - Smooth S-curve (default)