Data
Every file the map reads, one row per source (several sources can share a file). Sizes and sha256 hashes are the exact bytes served from /data/; they are generated by the build (catalog.json) and checked in CI, so a download can be verified against this page.
Downloads are limited to openly licensed sources (CC BY 4.0, public domain, and CEPII BACI under the Etalab Open Licence 2.0) and the project's own route-share table — 11 of 15 files. Energy Institute reserves are shown in the app but not redistributed. Each source's licence, what we redistribute and what you may do with it are summarised in LICENSE-DATA.md (plain language, not legal advice).
The asset table: the map reads assets.parquet, which is view-only because it mixes 89 OpenStreetMap (ODbL, share-alike) refinery rows with CC BY and public-domain rows. Download assets_open.parquet instead: every other row (19,871 extraction sites, refineries, storage sites, ports and LNG terminals from GEM, LNG-T3 and NETL), same columns, with each row's source. Single layers can also be exported from the map's Share / cite menu, with their source and licence in the file header.
Keep the attribution line with any CC BY 4.0 data you reuse (see required attributions).
| Dataset · layers | Source · licence | As of | Rows | File | Download |
|---|---|---|---|---|---|
Monthly crude + LNG imports (as reported) comtrade_monthly trade_monthly | UN Comtrade UN Comtrade terms; re-dissemination limited Data: UN Comtrade | 2026-09-17 | 8,839 | comtrade_monthly.parquet 146 KB sha256 141876459b71… | View-only. UN Comtrade limits re-dissemination of its data, so the monthly series is shown in the app and not offered for download; get it from https://comtradeplus.un.org/ with your own free key. |
EU gas storage + LNG terminal daily series gie_daily gas_storagelng_send_out | Gas Infrastructure Europe — AGSI + ALSI Free with registration; attribution required Data: GIE AGSI / ALSI | 2026-09-17 | 188,767 | gie_daily.parquet 755 KB sha256 b51a4f0ad29e… | View-only. Gas Infrastructure Europe publishes this free to anyone with a registration key, under its own terms rather than an open licence, so it is shown in the app and not offered for download; get it from https://agsi.gie.eu/ with your own key. |
Country-year reserves + production ei_country_year reservesreserves:gasproduction | Energy Institute Statistical Review of World Energy Free to quote with attribution; extensive reproduction needs EI permission Data: Energy Institute Statistical Review of World Energy 2026 | 2026-07-01 | 4,836 | country_year_series.parquet 39 KB sha256 aa1a4df50760… | View-only. The Energy Institute asks for permission before extensive reproduction of its tables, so the series is shown in the app, not offered for download; get it from the Energy Institute. |
Oil & gas extraction sites (GEM) gem_extraction extraction | Global Energy Monitor CC BY 4.0 Data: Global Energy Monitor, CC BY 4.0 | 2026-03-01 | 7,055 | assets.parquet 709 KB · shared with 6 other entries sha256 e91dfa1e288a… | View-only. assets.parquet also contains OpenStreetMap rows under ODbL (Open Database License), so the file is not offered as-is. These rows are in assets_open.parquet, which is downloadable. |
Oil refineries (NETL GOGI, primary) netl_refineries refineries | National Energy Technology Laboratory (US DOE) US Government work, public domain (17 USC §105) Data: NETL Global Oil & Gas Infrastructure (GOGI), US DOE | 2026-05-17 | 1,075 | assets.parquet 709 KB · shared with 6 other entries sha256 e91dfa1e288a… | View-only. assets.parquet also contains OpenStreetMap rows under ODbL (Open Database License), so the file is not offered as-is. These rows are in assets_open.parquet, which is downloadable. The refineries layer includes those rows too, so it is view-only. |
Oil refineries (OpenStreetMap, supplement to NETL) osm_refineries refineries | OpenStreetMap ODbL (Open Database License) © OpenStreetMap contributors, ODbL | 2026-09-17 | 89 | assets.parquet 709 KB · shared with 6 other entries sha256 e91dfa1e288a… | View-only. ODbL (share-alike) rows; downloads are limited to CC BY 4.0 and public-domain sources, so these rows are left out of assets_open.parquet (the NETL refinery rows are in it). |
Oil & gas storage (NETL GOGI) netl_storage storage | National Energy Technology Laboratory (US DOE) US Government work, public domain (17 USC §105) Data: NETL Global Oil & Gas Infrastructure (GOGI), US DOE | 2026-05-17 | 7,733 | assets.parquet 709 KB · shared with 6 other entries sha256 e91dfa1e288a… | View-only. assets.parquet also contains OpenStreetMap rows under ODbL (Open Database License), so the file is not offered as-is. These rows are in assets_open.parquet, which is downloadable. |
Oil & gas ports (NETL GOGI) netl_ports ports | National Energy Technology Laboratory (US DOE) US Government work, public domain (17 USC §105) Data: NETL Global Oil & Gas Infrastructure (GOGI), US DOE | 2026-05-17 | 3,694 | assets.parquet 709 KB · shared with 6 other entries sha256 e91dfa1e288a… | View-only. assets.parquet also contains OpenStreetMap rows under ODbL (Open Database License), so the file is not offered as-is. These rows are in assets_open.parquet, which is downloadable. |
LNG terminals (LNG-T3, primary) lng_t3_terminals lng_terminals | Zhou, C. 2026, LNG-T3 (Zenodo) CC BY 4.0 Data: Zhou, C. 2026, LNG-T3 (Zenodo 10.5281/zenodo.19571058), CC BY 4.0 | 2026-04-01 | 305 | assets.parquet 709 KB · shared with 6 other entries sha256 e91dfa1e288a… | View-only. assets.parquet also contains OpenStreetMap rows under ODbL (Open Database License), so the file is not offered as-is. These rows are in assets_open.parquet, which is downloadable. |
LNG terminals (GEM GGIT, supplement to LNG-T3) gem_lng_terminals lng_terminals | Global Energy Monitor CC BY 4.0 Data: Global Energy Monitor, CC BY 4.0 | 2026-02-20 | 9 | assets.parquet 709 KB · shared with 6 other entries sha256 e91dfa1e288a… | View-only. assets.parquet also contains OpenStreetMap rows under ODbL (Open Database License), so the file is not offered as-is. These rows are in assets_open.parquet, which is downloadable. |
Asset table, open subset (every assets.parquet row except OpenStreetMap) assets_open Download-only copy of the map's asset table | Global Energy Monitor, LNG-T3 and NETL — see the source column CC BY 4.0 (GEM, LNG-T3) + public domain (NETL); attribution required Data: Global Energy Monitor, CC BY 4.0 Data: NETL Global Oil & Gas Infrastructure (GOGI), US DOE Data: Zhou, C. 2026, LNG-T3 (Zenodo 10.5281/zenodo.19571058), CC BY 4.0 | 2026-05-17 | 19,871 | assets_open.parquet 703 KB sha256 1c1b1fa71d95… | Download |
Crude/NGL pipelines (GEM GOIT; simplified GeoJSON) gem_oil_pipelines pipelines | Global Energy Monitor CC BY 4.0 Data: Global Energy Monitor, CC BY 4.0 | 2025-04-09 | 1,185 | pipelines.geojson 7.7 MB · shared with 1 other entry sha256 3141fe28fb89… | Download |
Gas pipelines (GEM GGIT; simplified GeoJSON) gem_gas_pipelines gas_pipelines | Global Energy Monitor CC BY 4.0 Data: Global Energy Monitor, CC BY 4.0 | 2026-02-20 | 2,772 | pipelines.geojson 7.7 MB · shared with 1 other entry sha256 3141fe28fb89… | Download |
US shale-region production, annual (EIA STEO history) eia_steo_shale_regions shale_regions | US Energy Information Administration — STEO US Government work, public domain (17 USC §105) Data: US Energy Information Administration (STEO); county shapes: US Census Bureau | 2026-09-09 | 170 | shale_region_year.parquet 6.4 KB sha256 c6e962f93b0b… | Download |
US shale-region outlines (EIA DPR counties, Census 1:20m) eia_shale_region_shapes shale_regions | US Energy Information Administration — DPR regions; US Census Bureau US Government work, public domain (17 USC §105) Data: US Energy Information Administration (STEO); county shapes: US Census Bureau | 2024-05-13 | 5 | shale_regions.geojson 11 KB sha256 7a73d2b7c3bd… | Download |
Oil & gas basins (NETL GOGI; simplified GeoJSON) netl_basins basins | National Energy Technology Laboratory (US DOE) US Government work, public domain (17 USC §105) Data: NETL Global Oil & Gas Infrastructure (GOGI), US DOE | 2026-05-17 | 1,046 | basins.geojson 6.7 MB sha256 67f1e588a3bc… | Download |
Crude oil + LNG bilateral trade (HS 2709 + 271111) baci_2709 tradescenario:hormuzscenario:hormuz-lngscenario:druzhbascenario:btcscenario:cpcscenario:malaccascenario:malacca-lngscenario:suezscenario:suez-lngscenario:bab_el_mandebscenario:bab_el_mandeb-lngscenario:turkish_straitsscenario:keystonescenario:enbridge_mainlinescenario:espo_spur | BACI (CEPII) Etalab Open Licence 2.0; cite Gaulier & Zignago (2010) Data: CEPII BACI (release V202601); cite Gaulier & Zignago (2010) | 2026-01-01 | 53,727 | trade_flow.parquet 841 KB sha256 1058bf486980… | Download |
Disruption routing shares (chokepoints + pipelines; per-row citations) disruption_route scenario:hormuzscenario:hormuz-lngscenario:druzhbascenario:btcscenario:cpcscenario:malaccascenario:malacca-lngscenario:suezscenario:suez-lngscenario:bab_el_mandebscenario:bab_el_mandeb-lngscenario:turkish_straitsscenario:keystonescenario:enbridge_mainlinescenario:espo_spur | EIA / IEA / Argus Media (Kpler) / GEM — see source_* columns Hand-set shares derived from public reports; per-row citations | 2026-09-19 | 522 | disruption_route.parquet 16 KB sha256 0e2ddc260fab… | Download |
Country geometries (1:110m admin-0) natural_earth_countries basemapreserves | Natural Earth Public domain | 2024-10-01 | 177 | countries.geojson 454 KB sha256 7e11c5d15f5c… | Download |
LNG carrier voyages (LNG-T3) lng_t3_voyages lng_voyagesscenario:hormuz-lng | Zhou, C. 2026, LNG-T3 (Zenodo) CC BY 4.0 Data: Zhou, C. 2026, LNG-T3 (Zenodo 10.5281/zenodo.19571058), CC BY 4.0 | 2026-04-01 | 17,592 | lng_voyage.parquet 268 KB sha256 74aeae7e6adb… | Download |
LNG trade-daily arrivals/departures (LNG-T3) — reproducibility artefact lng_t3_trade_daily Not read by the app — reproducibility artefact | Zhou, C. 2026, LNG-T3 (Zenodo) CC BY 4.0 Data: Zhou, C. 2026, LNG-T3 (Zenodo 10.5281/zenodo.19571058), CC BY 4.0 | 2026-04-01 | 16,691 | lng_trade_daily.parquet 110 KB sha256 dd754bc61873… | Download |
LNG terminal-daily throughput (LNG-T3) — reproducibility artefact lng_t3_terminal_daily Not read by the app — reproducibility artefact | Zhou, C. 2026, LNG-T3 (Zenodo) CC BY 4.0 Data: Zhou, C. 2026, LNG-T3 (Zenodo 10.5281/zenodo.19571058), CC BY 4.0 | 2026-04-01 | 16,115 | lng_terminal_daily.parquet 47 KB sha256 3f112f8a9668… | Download |
How to cite
APA
Nag, N. (2026). Global Energy Map (Version 1.1.0) [Computer software]. https://energymap.marain.space
BibTeX
@software{nag2026global,
author = {Nag, Narendra},
title = {{Global Energy Map}},
year = {2026},
version = {1.1.0},
url = {https://energymap.marain.space}
}To cite a specific map view, open Share / cite on the map: it adds the view URL, the access date and the as-of date of every source behind the visible layers. Cite the underlying datasets to their publishers as well — each file's source is on the Data page and in CITATION.cff (Global Energy Map 1.1.0).
Embed the map
Add &embed=1to any shared view's URL (or use Share / cite → Copy embed code on the map itself) to drop it into an <iframe>. Embed mode removes the header, intro card and phone banner and replaces the map footer with a one-line attribution bar that keeps the required licence credits (Global Energy Monitor, LNG-T3, NETL, Energy Institute, CEPII BACI, OpenStreetMap) visible, plus an "Open full map" link back to the same view. The commodity toggle stays — it is how a reader interrogates the view — unless you add &controls=0for a static figure; the "as of" chip (for a link pinned to a past year) is always shown, since it is the caption that makes the numbers on screen readable.
<iframe src="https://energymap.marain.space/?mode=scenarios&scenario=hormuz&commodity=oil&year=2023&embed=1" width="100%" height="560" loading="lazy" title="Global Energy Map" style="border:0"></iframe>
Keep the attribution bar visible in whatever frame or CSS you wrap the iframe in — it is how the CC BY 4.0 sources are credited on the embedding page.