spec: add scatter-map-geographic specification (#3618)

## 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.

---
:robot: *[spec-create
workflow](https://github.com/MarkusNeusinger/pyplots/actions/runs/20872381139)*

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

plots/scatter-map-geographic/specification.md

@@ -0,0 +1,31 @@
+# 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

plots/scatter-map-geographic/specification.yaml

@@ -0,0 +1,29 @@
+# Specification-level metadata for scatter-map-geographic
+# Auto-synced to PostgreSQL on push to main
+
+spec_id: scatter-map-geographic
+title: Scatter Map with Geographic Points
+
+# Specification tracking
+created: 2026-01-10T03:53:51Z
+updated: null
+issue: 3617
+suggested: MarkusNeusinger
+
+# Classification tags (applies to all library implementations)
+# See docs/reference/tagging-system.md for detailed guidelines
+tags:
+  plot_type:
+    - scatter
+    - map
+  data_type:
+    - geospatial
+    - numeric
+  domain:
+    - general
+    - science
+    - business
+  features:
+    - basic
+    - color-mapped
+    - proportional