Data API & Schema
Static JSON endpoints — no auth required. Updated on every build.
Static endpoint table
| Route | Format | Description |
|---|---|---|
| /data/stranded-sites.geojson | GeoJSON | 2,611 site FeatureCollection (ECCC + coords) |
| /data/live-stats.json | JSON | Build aggregates, top sites, impact, value model, version |
| /data/sites.json | JSON | Legacy/summary site list (if present) |
| /status.json | JSON | Health, version, site count, build metadata |
| /manifest.json | JSON | PWA manifest and shortcuts |
| /sitemap.xml | XML | Crawlable route index |
| /robots.txt | text | Crawler rules |
Map URL query parameters
Deep-link filters and site focus on /map. Combine params as needed.
| Param | Type | Description |
|---|---|---|
| site | string | Focus map on a site by ghgrp_id / id (e.g. G10161) |
| province | string | Filter to one province (e.g. Alberta) |
| provinces | string | Comma-separated province list |
| minScore | number | Minimum Stranded Score (0–100) |
| minEmission | number | Minimum emission kg CH₄/day |
| maxEmission | number | Maximum emission kg CH₄/day |
| sources | string | Comma-separated source_type values |
| mission | string | Comma-separated site IDs to load into mission portfolio |
| radius | number | Radius filter in km (requires lat + lng) |
| lat | number | Radius center latitude (WGS84) |
| lng | number | Radius center longitude (WGS84) |
Example: /map?province=Alberta&minScore=80
GET /data/stranded-sites.geojson
2,611 FeatureCollection. Key properties:
emission_rate_kg_day— daily methane vent rateprovince,source_type,confidencech4_tonnes_year,distance_to_grid_kmghgrp_id— unique site identifier
GET /data/live-stats.json
Auto-generated aggregates: provinces, gensets, impact, top sites, value model.
provinces[] fields
| Field | Type | Description |
|---|---|---|
| name | string | Full province name (e.g. Alberta) |
| count | number | Number of sites in province |
| pct | number | Share of total site count (%) |
Also includes totals, impact, valueModel, topSites, emissionTiers, confidenceCounts, and generatedAt.
GET /status.json
Health check: version, build time, site count.
curl examples
# Download full GeoJSON dataset
curl -sS https://stranded.giveabit.io/data/stranded-sites.geojson \
-o stranded-sites.geojson
# Fetch live build aggregates
curl -sS https://stranded.giveabit.io/data/live-stats.json | jq '.siteCount, .totals.avgStrandedScore'
# Province breakdown
curl -sS https://stranded.giveabit.io/data/live-stats.json | jq '.provinces[] | {name, count, pct}'
# Health / version
curl -sS https://stranded.giveabit.io/status.json | jq '.'Source: ECCC Open Data
Try it on the map →