Skip to content

spec: add scatter-map-geographic specification#3618

Merged
github-actions[bot] merged 1 commit intomainfrom
specification/scatter-map-geographic
Jan 10, 2026
Merged

spec: add scatter-map-geographic specification#3618
github-actions[bot] merged 1 commit intomainfrom
specification/scatter-map-geographic

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

New Specification: scatter-map-geographic

Related to #3617


specification.md

scatter-map-geographic: Scatter Map with Geographic Points

Description

A geographic scatter plot that displays data points on a world or regional map, with each point positioned by its latitude and longitude coordinates. This visualization is ideal for showing spatial distributions of events, locations, or measurements across geographic areas. Points can optionally encode additional variables through size and color, enabling multi-dimensional geographic analysis at a glance.

Applications

  • Visualizing earthquake epicenters or natural disaster locations with magnitude encoded as point size
  • Mapping customer or store locations with sales volume represented by point size and category by color
  • Displaying sensor network readings across a geographic region with measurement values encoded in color
  • Tracking wildlife sightings or species distribution with population counts as point size

Data

  • latitude (numeric) - Geographic latitude coordinate (-90 to 90)
  • longitude (numeric) - Geographic longitude coordinate (-180 to 180)
  • value (numeric, optional) - Variable for color encoding (e.g., measurement, category code)
  • size (numeric, optional) - Variable for point size encoding (e.g., magnitude, count)
  • label (string, optional) - Point label or identifier for tooltips
  • Size: 20-500 points (works well with moderate density; too many points may require clustering)
  • Example: City locations with population and region, earthquake data with magnitude and depth

Notes

  • Use an appropriate map projection (e.g., Natural Earth, Robinson for world maps; Mercator for regional/city scale)
  • Include a basemap showing country boundaries, coastlines, or terrain for geographic context
  • Add a color legend when color encoding is used, and a size legend when size varies
  • Consider using transparency (alpha) to handle overlapping points in dense regions
  • For interactive libraries, enable zoom and pan to explore point clusters
  • Ensure point colors have sufficient contrast against the basemap

Next: Add approved label to the issue to merge this PR.


🤖 spec-create workflow

@github-actions github-actions Bot merged commit ccf1239 into main Jan 10, 2026
4 checks passed
@github-actions github-actions Bot deleted the specification/scatter-map-geographic branch January 10, 2026 03:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants