Opus Motion ★ Star on GitHub

Maps · pin-drop-cluster

Pin drop + clustering map

Map pins drop onto a map region, merge into numbered cluster bubbles, split into single pins as the camera zooms in, then merge again.

A free, MIT-licensed animated map from the Opus Motion Library — 616 motions for Remotion, React and plain HTML.

Pin drop + clustering map: three frames of the animated map, start, middle and end
Pin drop + clustering map — start, middle and end of the 9.0-second motion.

What Pin drop + clustering map is for

Store/user/event locators, "customers worldwide", coverage and density stories, any list of lat/lon points that needs to read as a map with counts.

  • map
  • pins
  • cluster
  • locations
  • geo
  • lat-lon
  • markers
  • store locator
  • density
  • zoom

Details

Category
Animated maps & geo graphics
Length
9.0 s (270 frames at 30 fps)
Formats
16:9, 1:1, 9:16
Weight
light
Transparent overlay
yes
Seamless loop
no
Text props
title subtitle unit
Colour props
background land landStroke ink accent accent2 onAccent
Mood
—
Roles
subject

Use Pin drop + clustering map in Remotion, React or HTML

Remotion project

terminal
# copy this motion into your Remotion project
node cli/mgl.mjs add pin-drop-cluster --to ../my-app/src

# render an mp4 (run in the library folder)
node cli/mgl.mjs render pin-drop-cluster --props '{"title":"Locations","subtitle":"Every point, grouped by density","unit":"locations","background":"#0B1220","land":"#17243C","landStroke":"#2F4468","ink":"#E8EEF9","accent":"#FF7A59","accent2":"#4CC9F0","onAccent":"#0B1220"}'

# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export pin-drop-cluster --as webm-alpha --props '{"title":"Locations","subtitle":"Every point, grouped by density","unit":"locations","background":"#0B1220","land":"#17243C","landStroke":"#2F4468","ink":"#E8EEF9","accent":"#FF7A59","accent2":"#4CC9F0","onAccent":"#0B1220"}'

React / Next.js

tsx
import {MotionPlayer} from 'opus-motion-library/web';

<MotionPlayer
  motion="pin-drop-cluster"
  props={{
    title: 'Locations',
    subtitle: 'Every point, grouped by density',
    unit: 'locations',
    background: '#0B1220',
    land: '#17243C',
    landStroke: '#2F4468',
    ink: '#E8EEF9',
    accent: '#FF7A59',
    accent2: '#4CC9F0',
    onAccent: '#0B1220',
  }}
  playOnView
  loop="auto"
/>

Plain HTML / WordPress

html
<script src="opus-motion.element.js" defer></script>

<opus-motion motion="pin-drop-cluster"
  props='{"title":"Locations","subtitle":"Every point, grouped by density","unit":"locations","background":"#0B1220","land":"#17243C","landStroke":"#2F4468","ink":"#E8EEF9","accent":"#FF7A59","accent2":"#4CC9F0","onAccent":"#0B1220"}'>
</opus-motion>

Compose spec (multi-scene video)

json
{
  "width": 1920,
  "height": 1080,
  "fps": 30,
  "scenes": [
    {
      "motion": "pin-drop-cluster",
      "props": {
        "title": "Locations",
        "subtitle": "Every point, grouped by density",
        "unit": "locations",
        "background": "#0B1220",
        "land": "#17243C",
        "landStroke": "#2F4468",
        "ink": "#E8EEF9",
        "accent": "#FF7A59",
        "accent2": "#4CC9F0",
        "onAccent": "#0B1220"
      }
    }
  ]
}

Pin drop + clustering map props

17 parameters — change any of them to make the motion yours.

PropDefaultWhat it does
points[{"lat":45.96,"lon":-1.14},{"lat":48.21,"lon":0.89},{"lat":46.76,"lon":-1.21},{"lat":49…array of {lat, lon, label?}; the camera auto-fits them (labels show when a pin is single and zoomed in)
title"Locations"headline, top left
subtitle"Every point, grouped by density"line under the headline
unit"locations"noun for the big counter (locations, stores, users)
clusterSize120cluster radius in px (1080 scale): bigger merges more
zoom2.2camera zoom-in factor for the split beat
pinSize58pin height in px (1080 scale)
speed1timeline speed multiplier
startAt0frame to start at
background"#0B1220"map ocean colour, or "transparent"
land"#17243C"land fill
landStroke"#2F4468"coastline + graticule colour
ink"#E8EEF9"text colour
accent"#FF7A59"pin colour
accent2"#4CC9F0"cluster bubble colour
onAccent"#0B1220"text/dot colour drawn on accent shapes
fontFamily"stub"CSS font-family

Notes & credits

Technique sources:

  • original (round 3)