Region Focus Mode

Zooms into a specific geographic region without route animation. Perfect for highlighting locations, chokepoints, or areas of interest.

Basic Example

{
  "mode": "region_focus",
  "region_focus": {
    "center": { "lat": 30.0444, "lng": 31.2357 },
    "name": "Suez Canal",
    "start_zoom": 2,
    "end_zoom": 8,
    "rotation_degrees": 15
  },
  "style": "satellite",
  "duration": 10
}

Region Focus Settings

Property	Type	Required	Description
`center`	object	required	`{ lat, lng }` - Focus point coordinates
`name`	string	optional	Region name (displayed on map)
`start_zoom`	number	optional	Starting zoom level (default: 2)
`end_zoom`	number	optional	Ending zoom level (default: 5)
`rotation_degrees`	number	optional	Camera rotation angle (default: 0)

Region Labels

Add labels to identify surrounding areas or features:

{
  "mode": "region_focus",
  "region_focus": {
    "center": { "lat": 30.0444, "lng": 31.2357 },
    "name": "Suez Canal"
  },
  "region_labels": [
    { "text": "Mediterranean Sea", "lat": 32.5, "lng": 30.0 },
    { "text": "Red Sea", "lat": 25.0, "lng": 35.0 },
    { "text": "Port Said", "lat": 31.25, "lng": 32.3, "emphasis": "waypoint" }
  ]
}

Label Properties

Property	Type	Description
`text`	string	Label text
`lat`	number	Latitude position
`lng`	number	Longitude position
`emphasis`	enum	`standard`, `waypoint`, `chokepoint`

Custom Label Styling

{
  "region_labels": [
    {
      "text": "Strait of Hormuz",
      "lat": 26.5,
      "lng": 56.5,
      "emphasis": "chokepoint",
      "style": {
        "text_color": "#FFFFFF",
        "background_color": "rgba(230, 57, 70, 0.8)",
        "font_size": 16,
        "font_weight": "bold"
      }
    }
  ]
}

Use Cases

Chokepoint introductions: Dramatic zoom into Suez, Panama, Hormuz
Location reveals: "And this is where it happened..."
Geographic context: Show surrounding waters, countries, features
Satellite imagery: High-detail views of ports, facilities, terrain

Recommended Styles

Style	Best For
`satellite`	Real-world imagery, terrain detail
`satellite-streets`	Imagery with place names
`geopolitics`	Country boundaries, political context
`outdoors`	Topographic features, elevation

Complete Example

{
  "mode": "region_focus",
  "region_focus": {
    "center": { "lat": 26.5667, "lng": 56.25 },
    "name": "Strait of Hormuz",
    "start_zoom": 2,
    "end_zoom": 9,
    "rotation_degrees": 20
  },
  "region_labels": [
    { "text": "Persian Gulf", "lat": 27.5, "lng": 51.5 },
    { "text": "Gulf of Oman", "lat": 24.5, "lng": 58.5 },
    { "text": "Iran", "lat": 28.5, "lng": 54.0 },
    { "text": "UAE", "lat": 24.5, "lng": 54.0 },
    { "text": "Oman", "lat": 23.5, "lng": 57.5 }
  ],
  "style": "satellite",
  "duration": 12,
  "terrain": {
    "enabled": true,
    "exaggeration": 1.5
  },
  "text_overlays": [
    {
      "text": "20% of global oil passes through here",
      "position": "bottom-center",
      "start_time": 6,
      "font_size": 28,
      "animation": "fade"
    }
  ]
}