Overlay Documentation

The Metadata
Architecture

November 18, 2026
By Ali Hassan

In spatial storytelling, the map provides the stage, but the metadata overlays provide the Authority.

When a camera flies over a 3D landscape, it creates a sense of awe and discovery. However, wonder alone does not build credibility. To transform a pretty camera flight into a high-performance production, you must anchor your narrative with data. This is achieved through two distinct visual layers in our Studio: Stat Cards and Focus Cards.

New creators often make the mistake of using these tools interchangeably, resulting in visual clutter and cognitive overload for the viewer. Mastering the art of metadata requires understanding the psychological difference between a "Number" and a "Narrative." This 1,650-word masterclass, authored by production specialist Ali Hassan, provides the tactical framework for using on-screen overlays to drive retention, build trust, and deliver information with cinematic precision.

The Quantitative Anchor: Stat Cards

Stat Cards are designed for quantitative data—information that can be expressed in numbers, percentages, or units. Their primary function is to provide a "Visual Shock" or immediate proof of the narration's claims. Because the brain processes numbers faster than sentences, Stat Cards are your primary tool for high-energy social media hooks.

A professional Stat Card follows the "Value-First" principle. The number should be the largest element on the screen, followed by a concise uppercase label (e.g., "POPULATION"). This hierarchy ensures that even a viewer scrolling past on a silent phone can understand the scale of the location within 600 milliseconds.

Numerical Shock

Ideal for population, median price, temperature, or elevation. Numbers build immediate data authority.

Social Retention

On platforms like TikTok, a flashing Stat Card acts as a visual anchor that keeps the eye from swiping away.

The Qualitative Narrative: Focus Cards

Focus Cards serve a different cognitive purpose. They are designed for qualitative context—short sentences or phrases that explain the "Why" behind a location. While a Stat Card tells you how much, a Focus Card tells you what happened.

These cards are essential for documentary B-roll and educational content where the nuances of history, culture, or geography cannot be summarized by a single number. However, Focus Cards require more "Reading Budget." They should only appear during extended "Hold" phases where the camera is performing a slow orbit, giving the viewer's brain the necessary bandwidth to transition from observing the map to reading the text.

The Hierarchy of Metadata

Use Stat Cards for...Heights, Weights, Costs, Populations, Dates, and Distances.
Use Focus Cards for...Historical context, cultural highlights, and 'Deep Dive' narrative facts.
The Golden RuleNever use both simultaneously on the same screen. Pick one 'Beat' per location.

The 1.5-Second Timing Protocol

In professional cinematography, timing is everything. A common amateur mistake is to have the metadata cards appear the instant the camera begins its flight. This is a technical failure because the viewer’s eye is busy tracking the moving terrain; it cannot read text at the same time.

Our production engine utilizes the 1.5-Second Delay Rule. For a Stat Card to be effective, it should appear approximately 1,500 milliseconds after the camera has landed and settled at its target location. This allows the viewer to process the geographic arrival first, then shift their focus to the quantitative data.

For Focus Cards, the delay should be even longer—approximately 2 to 3 seconds. By delaying the text, you create a secondary "Discovery Beat" in the production that mirrors the natural rhythm of a professional documentary. It keeps the viewer engaged by providing a continuous stream of new information rather than dumping it all in a single frame.

Styling Architecture: Color & Iconography

The visual design of your cards should be a reflection of your production's Editorial Voice. We provide a full suite of style overrides for every card, allowing you to match your branding with precision.

  1. 01
    The Accent Color

    Your card's accent color should typically match the boundary highlight color of the scene. This creates a visual 'Bond' between the data and the place, making the production feel like a cohesive GIS survey.

  2. 02
    Semantic Iconography

    Icons are non-verbal signals. Use high-contrast icons that mirror the data type (e.g., a 'TrendingUp' icon for growth, a 'Home' icon for real estate). This speeds up viewer comprehension on small mobile screens.

  3. 03
    Box Styling: Glass vs. Solid

    For high-end productions, use a semi-transparent black background with a blur filter (Glassmorphism). This allows the map's texture to remain visible beneath the card, maintaining the sense of immersion while providing a readable canvas for text.

Industry Frameworks: Real Estate vs. Travel

Different industries require different metadata strategies. Your choice of cards should be dictated by the Buyer's Intent of your audience.

In Real Estate, the buyer is looking for rational proof. Use Stat Cards for median price growth and rental yields. Use a Focus Card at the very end of the flight to highlight a specific cultural proximity (e.g., "Walking distance to the Arts District").

In Travel Storytelling, the viewer is looking for emotional discovery. Use Stat Cards for temperatures or altitudes to build the "Atmosphere." Use Focus Cards to reveal "Hidden Gems"—locations that aren't on the standard tourist map. By tailoring your metadata to these intents, you transform your video from a generic flyover into a tactical conversion tool.

The 'Safe Zone' Rule

When exporting for TikTok (9:16), ensure your cards are positioned within the middle 60% of the screen. Our engine handles basic centering, but you must avoid the far top and bottom where platform UI elements (like captions and usernames) will obscure your data. A professional production always respects the 'Safe Zone'.

Audit Checklist for Metadata Integrity

Before you initiate your final render, perform a Metadata Audit. Every card in your project should pass these three tests:

  • Readability: Is the text legible on a 6-inch phone screen at 50% brightness?
  • Verification: Is the number sourced from a GIS-verified or high-authority database?
  • Sync: Does the card appear after the camera has stopped its primary motion?

By following this architecture, you ensure that your production carries the same weight as a professional news or documentary piece. Metadata is the difference between a video that is simply "watched" and a video that is "believed."

Anchor Your Story
With Data Authority

The stage is set. Access the Studio now and start layering your production with high-fidelity metadata.