# atlashot — data on maps, from a link

Turn `{region: value}` data into a shareable choropleth map image with a single GET URL. No account, no API key, no code execution.

## One complete example

```
https://atlashot.pages.dev/m?map=europe&title=Electricity+prices+2026&unit=EUR/MWh&source=ENTSO-E&d=AT:241,BE:189.5,DE:210,FR:198,PL:150,ES:165,IT:220,NL:195,SE:96,NO:88
```

Opening that URL renders a colored map of Europe with a title, legend, and unit label, and offers branded SVG/PNG downloads.

Add `&format=svg` to the same URL to get the raw SVG image back (for direct embedding), or `&format=json` for machine-readable diagnostics.

## URL anatomy

`https://atlashot.pages.dev/m?map=<mapset>&d=<CODE:value,...>&title=...`

## Parameters

| param | required | type | default | allowed | meaning |
|---|---|---|---|---|---|
| `map` | **yes** | string | — | a map set id from the table below (e.g. world, europe, us, ro) | Which map to draw. |
| `d` | **yes** | string | — | comma-separated CODE:value pairs | The data. CODE is ISO 3166-1 alpha-2 for countries (DE, FR) or ISO 3166-2 for subdivisions (US-CA, RO-CJ). Values: numbers for color scales, or short text labels for categorical maps. Aliases accepted per map set: plain region names everywhere; ISO alpha-3 + ISO numeric (world, europe); EL/UK NUTS-0 (europe); FIPS numeric + bare postal (us); NUTS-3 codes + bare county codes (ro). |
| `title` | no | string | none | any text (URL-encoded, + for space) | Map title, rendered into the image. |
| `subtitle` | no | string | none | any text | Smaller line under the title. |
| `unit` | no | string | none | any short text | Unit label shown with the legend (e.g. EUR/MWh, %). |
| `source` | no | string | none | any short text | Data source credit, rendered next to the attribution. |
| `palette` | no | string | blues (numeric), rdbu (mixed-sign), tableau (text) | blues, greens, oranges, purples, reds, viridis, rdbu, brbg, puor, tableau | Color palette. Sequential for all-positive numbers, diverging (rdbu/brbg/puor) for mixed-sign, tableau for categories. |
| `scale` | no | string | quantile (quantize over a symmetric domain for mixed-sign data) | quantile, quantize, linear, threshold:10,20,50 | How values map to color classes. threshold takes explicit cut points. |
| `classes` | no | integer | 5 | 3–9 | Number of color classes. |
| `domain` | no | string | data min,max (symmetric around 0 for mixed-sign data) | min,max (two numbers) | Override the scale extent. |
| `format` | no | string | ,.2~f | a d3-format specifier (.1f, .0%, ~s) — or the reserved values json and svg | Number format for legend labels. Reserved values change the response instead: format=json returns machine-readable diagnostics (application/json); format=svg returns the map itself as a raw SVG image (image/svg+xml), directly embeddable in <img> tags. |
| `embed` | no | flag | 0 | 1 | Render only the map (for iframes) — no page chrome. |
| `v` | no | integer | 1 | 1 | URL format version. |

## Map sets

| id | coverage | regions | region codes |
|---|---|---|---|
| `world` | World — countries | 175 | [codes](https://atlashot.pages.dev/docs/maps/world.md) |
| `europe` | Europe — countries | 46 | [codes](https://atlashot.pages.dev/docs/maps/europe.md) |
| `us` | United States — states | 51 | [codes](https://atlashot.pages.dev/docs/maps/us.md) |
| `ro` | Romania — județe | 42 | [codes](https://atlashot.pages.dev/docs/maps/ro.md) |

## Examples

### European electricity prices (sequential scale, unit)

Country codes are ISO alpha-2; unit shows in the legend.

```
https://atlashot.pages.dev/m?map=europe&title=Electricity+prices+2026&unit=EUR/MWh&source=ENTSO-E&d=AT:241,BE:189.5,DE:210,FR:198,PL:150,ES:165,IT:220,NL:195,SE:96,NO:88
```

### World temperature anomaly (diverging, mixed-sign)

Mixed-sign values pick the diverging red-blue palette automatically.

```
https://atlashot.pages.dev/m?map=world&title=Temperature+anomaly&unit=%C2%B0C+vs+1991-2020&d=US:1.2,CA:1.8,RU:2.1,BR:0.6,AU:0.9,IN:0.7,CN:1.1,ZA:0.8,AR:-0.2,GL:2.9
```

### US states, categorical values

Text values make a categorical map; codes are US-XX.

```
https://atlashot.pages.dev/m?map=us&title=Time+zones+(sample)&d=US-CA:Pacific,US-NV:Pacific,US-CO:Mountain,US-TX:Central,US-IL:Central,US-NY:Eastern,US-FL:Eastern
```

### Romanian counties with explicit thresholds

Subdivision codes are RO-XX; threshold sets the class cut points.

```
https://atlashot.pages.dev/m?map=ro&title=Population+density&unit=per+km%C2%B2&scale=threshold:50,100,200&d=RO-B:8093,RO-CJ:105,RO-TM:80,RO-IS:146,RO-CT:96,RO-BV:115
```

### Percent-formatted, fixed domain

format styles legend labels; domain fixes the scale extent.

```
https://atlashot.pages.dev/m?map=europe&title=Renewables+share&scale=quantize&format=.0%25&domain=0,1&d=NO:0.98,SE:0.68,FR:0.25,DE:0.46,PL:0.21,ES:0.5
```

## Instructions for AI agents

- Region codes are ISO codes, not names: RO-CJ not "Cluj county", US-CA not "California" — names usually resolve as a courtesy, but ISO codes are the contract. Do not invent codes.
- Subdivision codes include the country prefix: US-CA, RO-CJ — never bare CA or CJ in documentation examples (bare forms resolve, but are ambiguous across map sets).
- Do not invent parameters. The full list is above; anything else is ignored with a warning.
- Keep URLs under 2,000 characters (hard limit 4,000). Every listed map set fits comfortably: a full world dataset is ~1,600 characters.
- Values are plain numbers (189.5) or short text labels (high) — no percent signs, no thousands separators, no quotes inside d=; labels must not contain , ; : = or newline characters (the d= grammar reserves them).
- Use commas between pairs and a colon inside each pair: d=DE:83.2,FR:68.6 — spaces are allowed but must be URL-encoded (+).
- The URL is data, not code: never base64/deflate the payload; write it out plainly.
- To verify a URL before sharing it, append &format=json and fetch it: the response is real JSON (application/json) reporting ok, matched/total, unmatched codes with suggestions, and a corrected example. HTTP 400 means required parameters are missing or wrong.

## Errors and diagnostics

Rendering is forgiving: bad rows are skipped with a warning, the rest of the map renders. Diagnostics are available three ways:
1. A visible banner on the page (humans).
2. An embedded `<script type="application/json" id="diagnostics">` block in the rendered page (agents that fetch and execute the page).
3. `&format=json`: the same URL returns a true JSON response (`application/json`) — `{ok, map, matched, total, unmatched: [{input, suggestion}], errors, warnings, fix, example, docs_url}`. HTTP 200 when the map renders (warnings included), HTTP 400 when required parameters are missing or wrong.

A JSON Schema for the request payload: https://atlashot.pages.dev/schema/map-request.schema.json
An OpenAPI 3.1 description of GET /m: https://atlashot.pages.dev/openapi.json
Machine-readable docs: https://atlashot.pages.dev/llms.txt (index) · https://atlashot.pages.dev/llms-full.txt (everything inlined)


---

# World — countries (`map=world`) — region codes

175 regions. The first column is the canonical code for `d=`; the second lists accepted aliases (normalized: uppercase, no diacritics/punctuation).

| code | aliases |
|---|---|
| `AE` | 784, AE, ARE, UNITEDARABEMIRATES |
| `AF` | 004, AF, AFG, AFGHANISTAN, ISLAMICREPUBLICOFAFGHANISTAN |
| `AL` | 008, AL, ALB, ALBANIA, REPUBLICOFALBANIA |
| `AM` | 051, AM, ARM, ARMENIA, REPUBLICOFARMENIA |
| `AO` | 024, AGO, ANGOLA, AO, REPUBLICOFANGOLA |
| `AQ` | 010, ANTARCTICA, AQ, ATA |
| `AR` | 032, AR, ARG, ARGENTINA, ARGENTINEREPUBLIC |
| `AT` | 040, AT, AUSTRIA, AUT, REPUBLICOFAUSTRIA |
| `AU` | 036, AU, AUS, AUSTRALIA, COMMONWEALTHOFAUSTRALIA |
| `AZ` | 031, AZ, AZE, AZERBAIJAN, REPUBLICOFAZERBAIJAN |
| `BA` | 070, BA, BIH, BOSNIAANDHERZ, BOSNIAANDHERZEGOVINA |
| `BD` | 050, BANGLADESH, BD, BGD, PEOPLESREPUBLICOFBANGLADESH |
| `BE` | 056, BE, BEL, BELGIUM, KINGDOMOFBELGIUM |
| `BF` | 854, BF, BFA, BURKINAFASO |
| `BG` | 100, BG, BGR, BULGARIA, REPUBLICOFBULGARIA |
| `BI` | 108, BDI, BI, BURUNDI, REPUBLICOFBURUNDI |
| `BJ` | 204, BEN, BENIN, BJ, REPUBLICOFBENIN |
| `BN` | 096, BN, BRN, BRUNEI, NATIONOFBRUNEIABODEOFPEACE |
| `BO` | 068, BO, BOL, BOLIVIA, PLURINATIONALSTATEOFBOLIVIA |
| `BR` | 076, BR, BRA, BRAZIL, FEDERATIVEREPUBLICOFBRAZIL |
| `BS` | 044, BAHAMAS, BHS, BS, COMMONWEALTHOFTHEBAHAMAS |
| `BT` | 064, BHUTAN, BT, BTN, KINGDOMOFBHUTAN |
| `BW` | 072, BOTSWANA, BW, BWA, REPUBLICOFBOTSWANA |
| `BY` | 112, BELARUS, BLR, BY, REPUBLICOFBELARUS |
| `BZ` | 084, BELIZE, BLZ, BZ |
| `CA` | 124, CA, CAN, CANADA |
| `CD` | 180, CD, COD, DEMOCRATICREPUBLICOFTHECONGO, DEMREPCONGO, DRCONGO |
| `CF` | 140, CAF, CENTRALAFRICANREP, CENTRALAFRICANREPUBLIC, CF |
| `CG` | 178, CG, COG, CONGO, REPUBLICOFTHECONGO |
| `CH` | 756, CH, CHE, SWISSCONFEDERATION, SWITZERLAND |
| `CI` | 384, CI, CIV, COTEDIVOIRE, IVORYCOAST, REPUBLICOFCOTEDIVOIRE |
| `CL` | 152, CHILE, CHL, CL, REPUBLICOFCHILE |
| `CM` | 120, CAMEROON, CM, CMR, REPUBLICOFCAMEROON |
| `CN` | 156, CHINA, CHN, CN, PEOPLESREPUBLICOFCHINA |
| `CO` | 170, CO, COL, COLOMBIA, REPUBLICOFCOLOMBIA |
| `CR` | 188, COSTARICA, CR, CRI, REPUBLICOFCOSTARICA |
| `CU` | 192, CU, CUB, CUBA, REPUBLICOFCUBA |
| `CY` | 196, CY, CYP, CYPRUS, REPUBLICOFCYPRUS |
| `CZ` | 203, CZ, CZE, CZECHIA, CZECHREPUBLIC |
| `DE` | 276, DE, DEU, FEDERALREPUBLICOFGERMANY, GERMANY |
| `DJ` | 262, DJ, DJI, DJIBOUTI, REPUBLICOFDJIBOUTI |
| `DK` | 208, DENMARK, DK, DNK, KINGDOMOFDENMARK |
| `DO` | 214, DO, DOM, DOMINICANREP, DOMINICANREPUBLIC |
| `DZ` | 012, ALGERIA, DZ, DZA, PEOPLESDEMOCRATICREPUBLICOFALGERIA |
| `EC` | 218, EC, ECU, ECUADOR, REPUBLICOFECUADOR |
| `EE` | 233, EE, EST, ESTONIA, REPUBLICOFESTONIA |
| `EG` | 818, ARABREPUBLICOFEGYPT, EG, EGY, EGYPT |
| `EH` | 732, EH, ESH, SAHRAWIARABDEMOCRATICREPUBLIC, WESTERNSAHARA, WSAHARA |
| `ER` | 232, ER, ERI, ERITREA, STATEOFERITREA |
| `ES` | 724, ES, ESP, KINGDOMOFSPAIN, SPAIN |
| `ET` | 231, ET, ETH, ETHIOPIA, FEDERALDEMOCRATICREPUBLICOFETHIOPIA |
| `FI` | 246, FI, FIN, FINLAND, REPUBLICOFFINLAND |
| `FJ` | 242, FIJI, FJ, FJI, REPUBLICOFFIJI |
| `FK` | 238, FALKLANDIS, FALKLANDISLANDS, FK, FLK |
| `FR` | 250, FR, FRA, FRANCE, FRENCHREPUBLIC |
| `GA` | 266, GA, GAB, GABON, GABONESEREPUBLIC |
| `GB` | 826, GB, GBR, UK, UNITEDKINGDOM, UNITEDKINGDOMOFGREATBRITAINANDNORTHERNIRELAND |
| `GE` | 268, GE, GEO, GEORGIA |
| `GH` | 288, GH, GHA, GHANA, REPUBLICOFGHANA |
| `GL` | 304, GL, GREENLAND, GRL |
| `GM` | 270, GAMBIA, GM, GMB, REPUBLICOFTHEGAMBIA |
| `GN` | 324, GIN, GN, GUINEA, REPUBLICOFGUINEA |
| `GQ` | 226, EQGUINEA, EQUATORIALGUINEA, GNQ, GQ, REPUBLICOFEQUATORIALGUINEA |
| `GR` | 300, EL, GR, GRC, GREECE, HELLENICREPUBLIC |
| `GT` | 320, GT, GTM, GUATEMALA, REPUBLICOFGUATEMALA |
| `GW` | 624, GNB, GUINEABISSAU, GW, REPUBLICOFGUINEABISSAU |
| `GY` | 328, COOPERATIVEREPUBLICOFGUYANA, GUY, GUYANA, GY |
| `HN` | 340, HN, HND, HONDURAS, REPUBLICOFHONDURAS |
| `HR` | 191, CROATIA, HR, HRV, REPUBLICOFCROATIA |
| `HT` | 332, HAITI, HT, HTI, REPUBLICOFHAITI |
| `HU` | 348, HU, HUN, HUNGARY |
| `ID` | 360, ID, IDN, INDONESIA, REPUBLICOFINDONESIA |
| `IE` | 372, IE, IRELAND, IRL, REPUBLICOFIRELAND |
| `IL` | 376, IL, ISR, ISRAEL, STATEOFISRAEL |
| `IN` | 356, IN, IND, INDIA, REPUBLICOFINDIA |
| `IQ` | 368, IQ, IRAQ, IRQ, REPUBLICOFIRAQ |
| `IR` | 364, IR, IRAN, IRN, ISLAMICREPUBLICOFIRAN |
| `IS` | 352, ICELAND, IS, ISL |
| `IT` | 380, IT, ITA, ITALIANREPUBLIC, ITALY |
| `JM` | 388, JAM, JAMAICA, JM |
| `JO` | 400, HASHEMITEKINGDOMOFJORDAN, JO, JOR, JORDAN |
| `JP` | 392, JAPAN, JP, JPN |
| `KE` | 404, KE, KEN, KENYA, REPUBLICOFKENYA |
| `KG` | 417, KG, KGZ, KYRGYZREPUBLIC, KYRGYZSTAN |
| `KH` | 116, CAMBODIA, KH, KHM, KINGDOMOFCAMBODIA |
| `KP` | 408, DEMOCRATICPEOPLESREPUBLICOFKOREA, KP, NORTHKOREA, PRK |
| `KR` | 410, KOR, KR, REPUBLICOFKOREA, SOUTHKOREA |
| `KW` | 414, KUWAIT, KW, KWT, STATEOFKUWAIT |
| `KZ` | 398, KAZ, KAZAKHSTAN, KZ, REPUBLICOFKAZAKHSTAN |
| `LA` | 418, LA, LAO, LAOPEOPLESDEMOCRATICREPUBLIC, LAOS |
| `LB` | 422, LB, LBN, LEBANESEREPUBLIC, LEBANON |
| `LK` | 144, DEMOCRATICSOCIALISTREPUBLICOFSRILANKA, LK, LKA, SRILANKA |
| `LR` | 430, LBR, LIBERIA, LR, REPUBLICOFLIBERIA |
| `LS` | 426, KINGDOMOFLESOTHO, LESOTHO, LS, LSO |
| `LT` | 440, LITHUANIA, LT, LTU, REPUBLICOFLITHUANIA |
| `LU` | 442, GRANDDUCHYOFLUXEMBOURG, LU, LUX, LUXEMBOURG |
| `LV` | 428, LATVIA, LV, LVA, REPUBLICOFLATVIA |
| `LY` | 434, LBY, LIBYA, LY, STATEOFLIBYA |
| `MA` | 504, KINGDOMOFMOROCCO, MA, MAR, MOROCCO |
| `MD` | 498, MD, MDA, MOLDOVA, REPUBLICOFMOLDOVA |
| `ME` | 499, ME, MNE, MONTENEGRO |
| `MG` | 450, MADAGASCAR, MDG, MG, REPUBLICOFMADAGASCAR |
| `MK` | 807, MACEDONIA, MK, MKD, NORTHMACEDONIA, REPUBLICOFNORTHMACEDONIA |
| `ML` | 466, MALI, ML, MLI, REPUBLICOFMALI |
| `MM` | 104, MM, MMR, MYANMAR, REPUBLICOFTHEUNIONOFMYANMAR |
| `MN` | 496, MN, MNG, MONGOLIA |
| `MR` | 478, ISLAMICREPUBLICOFMAURITANIA, MAURITANIA, MR, MRT |
| `MW` | 454, MALAWI, MW, MWI, REPUBLICOFMALAWI |
| `MX` | 484, MEX, MEXICO, MX, UNITEDMEXICANSTATES |
| `MY` | 458, MALAYSIA, MY, MYS |
| `MZ` | 508, MOZ, MOZAMBIQUE, MZ, REPUBLICOFMOZAMBIQUE |
| `NA` | 516, NA, NAM, NAMIBIA, REPUBLICOFNAMIBIA |
| `NC` | 540, NC, NCL, NEWCALEDONIA |
| `NE` | 562, NE, NER, NIGER, REPUBLICOFNIGER |
| `NG` | 566, FEDERALREPUBLICOFNIGERIA, NG, NGA, NIGERIA |
| `NI` | 558, NI, NIC, NICARAGUA, REPUBLICOFNICARAGUA |
| `NL` | 528, KINGDOMOFTHENETHERLANDS, NETHERLANDS, NL, NLD |
| `NO` | 578, KINGDOMOFNORWAY, NO, NOR, NORWAY |
| `NP` | 524, FEDERALDEMOCRATICREPUBLICOFNEPAL, NEPAL, NP, NPL |
| `NZ` | 554, NEWZEALAND, NZ, NZL |
| `OM` | 512, OM, OMAN, OMN, SULTANATEOFOMAN |
| `PA` | 591, PA, PAN, PANAMA, REPUBLICOFPANAMA |
| `PE` | 604, PE, PER, PERU, REPUBLICOFPERU |
| `PG` | 598, INDEPENDENTSTATEOFPAPUANEWGUINEA, PAPUANEWGUINEA, PG, PNG |
| `PH` | 608, PH, PHILIPPINES, PHL, REPUBLICOFTHEPHILIPPINES |
| `PK` | 586, ISLAMICREPUBLICOFPAKISTAN, PAK, PAKISTAN, PK |
| `PL` | 616, PL, POL, POLAND, REPUBLICOFPOLAND |
| `PR` | 630, COMMONWEALTHOFPUERTORICO, PR, PRI, PUERTORICO |
| `PS` | 275, PALESTINE, PS, PSE, STATEOFPALESTINE |
| `PT` | 620, PORTUGAL, PORTUGUESEREPUBLIC, PRT, PT |
| `PY` | 600, PARAGUAY, PRY, PY, REPUBLICOFPARAGUAY |
| `QA` | 634, QA, QAT, QATAR, STATEOFQATAR |
| `RO` | 642, RO, ROMANIA, ROU |
| `RS` | 688, REPUBLICOFSERBIA, RS, SERBIA, SRB |
| `RU` | 643, RU, RUS, RUSSIA, RUSSIANFEDERATION |
| `RW` | 646, REPUBLICOFRWANDA, RW, RWA, RWANDA |
| `SA` | 682, KINGDOMOFSAUDIARABIA, SA, SAU, SAUDIARABIA |
| `SB` | 090, SB, SLB, SOLOMONIS, SOLOMONISLANDS |
| `SD` | 729, REPUBLICOFTHESUDAN, SD, SDN, SUDAN |
| `SE` | 752, KINGDOMOFSWEDEN, SE, SWE, SWEDEN |
| `SI` | 705, REPUBLICOFSLOVENIA, SI, SLOVENIA, SVN |
| `SK` | 703, SK, SLOVAKIA, SLOVAKREPUBLIC, SVK |
| `SL` | 694, REPUBLICOFSIERRALEONE, SIERRALEONE, SL, SLE |
| `SN` | 686, REPUBLICOFSENEGAL, SEN, SENEGAL, SN |
| `SO` | 706, FEDERALREPUBLICOFSOMALIA, SO, SOM, SOMALIA |
| `SR` | 740, REPUBLICOFSURINAME, SR, SUR, SURINAME |
| `SS` | 728, REPUBLICOFSOUTHSUDAN, SOUTHSUDAN, SS, SSD, SSUDAN |
| `SV` | 222, ELSALVADOR, REPUBLICOFELSALVADOR, SLV, SV |
| `SY` | 760, SY, SYR, SYRIA, SYRIANARABREPUBLIC |
| `SZ` | 748, ESWATINI, KINGDOMOFESWATINI, SWZ, SZ |
| `TD` | 148, CHAD, REPUBLICOFCHAD, TCD, TD |
| `TF` | 260, ATF, FRENCHSOUTHERNANDANTARCTICLANDS, FRSANTARCTICLANDS, TERRITORYOFTHEFRENCHSOUTHERNANDANTARCTICLANDS, TF |
| `TG` | 768, TG, TGO, TOGO, TOGOLESEREPUBLIC |
| `TH` | 764, KINGDOMOFTHAILAND, TH, THA, THAILAND |
| `TJ` | 762, REPUBLICOFTAJIKISTAN, TAJIKISTAN, TJ, TJK |
| `TL` | 626, DEMOCRATICREPUBLICOFTIMORLESTE, TIMORLESTE, TL, TLS |
| `TM` | 795, TKM, TM, TURKMENISTAN |
| `TN` | 788, TN, TUN, TUNISIA, TUNISIANREPUBLIC |
| `TR` | 792, REPUBLICOFTURKIYE, TR, TUR, TURKEY, TURKIYE |
| `TT` | 780, REPUBLICOFTRINIDADANDTOBAGO, TRINIDADANDTOBAGO, TT, TTO |
| `TW` | 158, REPUBLICOFCHINATAIWAN, TAIWAN, TW, TWN |
| `TZ` | 834, TANZANIA, TZ, TZA, UNITEDREPUBLICOFTANZANIA |
| `UA` | 804, UA, UKR, UKRAINE |
| `UG` | 800, REPUBLICOFUGANDA, UG, UGA, UGANDA |
| `US` | 840, UNITEDSTATES, UNITEDSTATESOFAMERICA, US, USA |
| `UY` | 858, ORIENTALREPUBLICOFURUGUAY, URUGUAY, URY, UY |
| `UZ` | 860, REPUBLICOFUZBEKISTAN, UZ, UZB, UZBEKISTAN |
| `VE` | 862, BOLIVARIANREPUBLICOFVENEZUELA, VE, VEN, VENEZUELA |
| `VN` | 704, SOCIALISTREPUBLICOFVIETNAM, VIETNAM, VN, VNM |
| `VU` | 548, REPUBLICOFVANUATU, VANUATU, VU, VUT |
| `XK` | KOSOVO, REPUBLICOFKOSOVO, UNK, XK |
| `YE` | 887, REPUBLICOFYEMEN, YE, YEM, YEMEN |
| `ZA` | 710, REPUBLICOFSOUTHAFRICA, SOUTHAFRICA, ZA, ZAF |
| `ZM` | 894, REPUBLICOFZAMBIA, ZAMBIA, ZM, ZMB |
| `ZW` | 716, REPUBLICOFZIMBABWE, ZIMBABWE, ZW, ZWE |


---

# Europe — countries (`map=europe`) — region codes

46 regions. The first column is the canonical code for `d=`; the second lists accepted aliases (normalized: uppercase, no diacritics/punctuation).

| code | aliases |
|---|---|
| `AD` | 020, AD, AND, ANDORRA, PRINCIPALITYOFANDORRA |
| `AL` | 008, AL, ALB, ALBANIA, REPUBLICOFALBANIA |
| `AT` | 040, AT, AUSTRIA, AUT, REPUBLICOFAUSTRIA |
| `BA` | 070, BA, BIH, BOSNIAANDHERZ, BOSNIAANDHERZEGOVINA |
| `BE` | 056, BE, BEL, BELGIUM, KINGDOMOFBELGIUM |
| `BG` | 100, BG, BGR, BULGARIA, REPUBLICOFBULGARIA |
| `BY` | 112, BELARUS, BLR, BY, REPUBLICOFBELARUS |
| `CH` | 756, CH, CHE, SWISSCONFEDERATION, SWITZERLAND |
| `CY` | 196, CY, CYP, CYPRUS, REPUBLICOFCYPRUS |
| `CZ` | 203, CZ, CZE, CZECHIA, CZECHREPUBLIC |
| `DE` | 276, DE, DEU, FEDERALREPUBLICOFGERMANY, GERMANY |
| `DK` | 208, DENMARK, DK, DNK, KINGDOMOFDENMARK |
| `EE` | 233, EE, EST, ESTONIA, REPUBLICOFESTONIA |
| `ES` | 724, ES, ESP, KINGDOMOFSPAIN, SPAIN |
| `FI` | 246, FI, FIN, FINLAND, REPUBLICOFFINLAND |
| `FR` | 250, FR, FRA, FRANCE, FRENCHREPUBLIC |
| `GB` | 826, GB, GBR, UK, UNITEDKINGDOM, UNITEDKINGDOMOFGREATBRITAINANDNORTHERNIRELAND |
| `GR` | 300, EL, GR, GRC, GREECE, HELLENICREPUBLIC |
| `HR` | 191, CROATIA, HR, HRV, REPUBLICOFCROATIA |
| `HU` | 348, HU, HUN, HUNGARY |
| `IE` | 372, IE, IRELAND, IRL, REPUBLICOFIRELAND |
| `IS` | 352, ICELAND, IS, ISL |
| `IT` | 380, IT, ITA, ITALIANREPUBLIC, ITALY |
| `LI` | 438, LI, LIE, LIECHTENSTEIN, PRINCIPALITYOFLIECHTENSTEIN |
| `LT` | 440, LITHUANIA, LT, LTU, REPUBLICOFLITHUANIA |
| `LU` | 442, GRANDDUCHYOFLUXEMBOURG, LU, LUX, LUXEMBOURG |
| `LV` | 428, LATVIA, LV, LVA, REPUBLICOFLATVIA |
| `MC` | 492, MC, MCO, MONACO, PRINCIPALITYOFMONACO |
| `MD` | 498, MD, MDA, MOLDOVA, REPUBLICOFMOLDOVA |
| `ME` | 499, ME, MNE, MONTENEGRO |
| `MK` | 807, MACEDONIA, MK, MKD, NORTHMACEDONIA, REPUBLICOFNORTHMACEDONIA |
| `MT` | 470, MALTA, MLT, MT, REPUBLICOFMALTA |
| `NL` | 528, KINGDOMOFTHENETHERLANDS, NETHERLANDS, NL, NLD |
| `NO` | 578, KINGDOMOFNORWAY, NO, NOR, NORWAY |
| `PL` | 616, PL, POL, POLAND, REPUBLICOFPOLAND |
| `PT` | 620, PORTUGAL, PORTUGUESEREPUBLIC, PRT, PT |
| `RO` | 642, RO, ROMANIA, ROU |
| `RS` | 688, REPUBLICOFSERBIA, RS, SERBIA, SRB |
| `RU` | 643, RU, RUS, RUSSIA, RUSSIANFEDERATION |
| `SE` | 752, KINGDOMOFSWEDEN, SE, SWE, SWEDEN |
| `SI` | 705, REPUBLICOFSLOVENIA, SI, SLOVENIA, SVN |
| `SK` | 703, SK, SLOVAKIA, SLOVAKREPUBLIC, SVK |
| `SM` | 674, MOSTSERENEREPUBLICOFSANMARINO, SANMARINO, SM, SMR |
| `TR` | 792, REPUBLICOFTURKIYE, TR, TUR, TURKEY, TURKIYE |
| `UA` | 804, UA, UKR, UKRAINE |
| `XK` | KOSOVO, REPUBLICOFKOSOVO, UNK, XK |


---

# United States — states (`map=us`) — region codes

51 regions. The first column is the canonical code for `d=`; the second lists accepted aliases (normalized: uppercase, no diacritics/punctuation).

| code | aliases |
|---|---|
| `US-AK` | 02, AK, ALASKA, USAK |
| `US-AL` | 01, AL, ALABAMA, USAL |
| `US-AR` | 05, AR, ARKANSAS, USAR |
| `US-AZ` | 04, ARIZONA, AZ, USAZ |
| `US-CA` | 06, CA, CALIFORNIA, USCA |
| `US-CO` | 08, CO, COLORADO, USCO |
| `US-CT` | 09, CONNECTICUT, CT, USCT |
| `US-DC` | 11, DC, DISTRICTOFCOLUMBIA, USDC |
| `US-DE` | 10, DE, DELAWARE, USDE |
| `US-FL` | 12, FL, FLORIDA, USFL |
| `US-GA` | 13, GA, GEORGIA, USGA |
| `US-HI` | 15, HAWAII, HI, USHI |
| `US-IA` | 19, IA, IOWA, USIA |
| `US-ID` | 16, ID, IDAHO, USID |
| `US-IL` | 17, IL, ILLINOIS, USIL |
| `US-IN` | 18, IN, INDIANA, USIN |
| `US-KS` | 20, KANSAS, KS, USKS |
| `US-KY` | 21, KENTUCKY, KY, USKY |
| `US-LA` | 22, LA, LOUISIANA, USLA |
| `US-MA` | 25, MA, MASSACHUSETTS, USMA |
| `US-MD` | 24, MARYLAND, MD, USMD |
| `US-ME` | 23, MAINE, ME, USME |
| `US-MI` | 26, MI, MICHIGAN, USMI |
| `US-MN` | 27, MINNESOTA, MN, USMN |
| `US-MO` | 29, MISSOURI, MO, USMO |
| `US-MS` | 28, MISSISSIPPI, MS, USMS |
| `US-MT` | 30, MONTANA, MT, USMT |
| `US-NC` | 37, NC, NORTHCAROLINA, USNC |
| `US-ND` | 38, ND, NORTHDAKOTA, USND |
| `US-NE` | 31, NE, NEBRASKA, USNE |
| `US-NH` | 33, NEWHAMPSHIRE, NH, USNH |
| `US-NJ` | 34, NEWJERSEY, NJ, USNJ |
| `US-NM` | 35, NEWMEXICO, NM, USNM |
| `US-NV` | 32, NEVADA, NV, USNV |
| `US-NY` | 36, NEWYORK, NY, USNY |
| `US-OH` | 39, OH, OHIO, USOH |
| `US-OK` | 40, OK, OKLAHOMA, USOK |
| `US-OR` | 41, OR, OREGON, USOR |
| `US-PA` | 42, PA, PENNSYLVANIA, USPA |
| `US-RI` | 44, RHODEISLAND, RI, USRI |
| `US-SC` | 45, SC, SOUTHCAROLINA, USSC |
| `US-SD` | 46, SD, SOUTHDAKOTA, USSD |
| `US-TN` | 47, TENNESSEE, TN, USTN |
| `US-TX` | 48, TEXAS, TX, USTX |
| `US-UT` | 49, USUT, UT, UTAH |
| `US-VA` | 51, USVA, VA, VIRGINIA |
| `US-VT` | 50, USVT, VERMONT, VT |
| `US-WA` | 53, USWA, WA, WASHINGTON |
| `US-WI` | 55, USWI, WI, WISCONSIN |
| `US-WV` | 54, USWV, WESTVIRGINIA, WV |
| `US-WY` | 56, USWY, WY, WYOMING |


---

# Romania — județe (`map=ro`) — region codes

42 regions. The first column is the canonical code for `d=`; the second lists accepted aliases (normalized: uppercase, no diacritics/punctuation).

| code | aliases |
|---|---|
| `RO-AB` | AB, ALBA, RO121, ROAB |
| `RO-AG` | AG, ARGES, RO311, ROAG |
| `RO-AR` | AR, ARAD, RO421, ROAR |
| `RO-B` | B, BUCHAREST, BUCURESTI, RO321, ROB |
| `RO-BC` | BACAU, BC, RO211, ROBC |
| `RO-BH` | BH, BIHOR, RO111, ROBH |
| `RO-BN` | BISTRITANASAUD, BN, RO112, ROBN |
| `RO-BR` | BR, BRAILA, RO221, ROBR |
| `RO-BT` | BOTOSANI, BT, RO212, ROBT |
| `RO-BV` | BRASOV, BV, RO122, ROBV |
| `RO-BZ` | BUZAU, BZ, RO222, ROBZ |
| `RO-CJ` | CJ, CLUJ, RO113, ROCJ |
| `RO-CL` | CALARASI, CL, RO312, ROCL |
| `RO-CS` | CARASSEVERIN, CS, RO422, ROCS |
| `RO-CT` | CONSTANTA, CT, RO223, ROCT |
| `RO-CV` | COVASNA, CV, RO123, ROCV |
| `RO-DB` | DAMBOVITA, DB, RO313, RODB |
| `RO-DJ` | DJ, DOLJ, RO411, RODJ |
| `RO-GJ` | GJ, GORJ, RO412, ROGJ |
| `RO-GL` | GALATI, GL, RO224, ROGL |
| `RO-GR` | GIURGIU, GR, RO314, ROGR |
| `RO-HD` | HD, HUNEDOARA, RO423, ROHD |
| `RO-HR` | HARGHITA, HR, RO124, ROHR |
| `RO-IF` | IF, ILFOV, RO322, ROIF |
| `RO-IL` | IALOMITA, IL, RO315, ROIL |
| `RO-IS` | IASI, IS, RO213, ROIS |
| `RO-MH` | MEHEDINTI, MH, RO413, ROMH |
| `RO-MM` | MARAMURES, MM, RO114, ROMM |
| `RO-MS` | MS, MURES, RO125, ROMS |
| `RO-NT` | NEAMT, NT, RO214, RONT |
| `RO-OT` | OLT, OT, RO414, ROOT |
| `RO-PH` | PH, PRAHOVA, RO316, ROPH |
| `RO-SB` | RO126, ROSB, SB, SIBIU |
| `RO-SJ` | RO116, ROSJ, SALAJ, SJ |
| `RO-SM` | RO115, ROSM, SATUMARE, SM |
| `RO-SV` | RO215, ROSV, SUCEAVA, SV |
| `RO-TL` | RO225, ROTL, TL, TULCEA |
| `RO-TM` | RO424, ROTM, TIMIS, TM |
| `RO-TR` | RO317, ROTR, TELEORMAN, TR |
| `RO-VL` | RO415, ROVL, VALCEA, VL |
| `RO-VN` | RO226, ROVN, VN, VRANCEA |
| `RO-VS` | RO216, ROVS, VASLUI, VS |