Browse documentation
Guides

Offline map pack catalogue

Find every independently optional country, territory and Chilean region pack, exact join key, coverage and offline installation commands.

Implemented in development

The global map enabled native development runtime provides 249 individually optional country/territory outlines, all 16 Chilean regions as separate packs, and 20 separately identified non ISO source map units. It retains existing country subdivision, continental overview and U.S. state packs: 5,243 selectable map layers in 5,192 optional packs in total. Aner Plot is implemented in development and awaits a binary release; the older published research preview cannot run these APIs. Use the matching development runtime and notebook integration.

The worldwide subdivision guide adds 4,838 independent state, province, region and explicitly described source unit packs. Its coverage index checks all 249 geographic units, distinguishes first order and alternative source levels, and records areas without an internal tier or with an unresolved source gap. For example, region.usa.co loads only Colorado, while region.chl.rm loads only one Chilean region.

Find a place by name below, then copy and install only its matching .anermap file on the offline computer. Importing aner.plot reads no boundary data. Constructing plot.map("country.jpn", ...) materializes only Japan's outline. Constructing plot.map("chile.region.rm", ...) materializes only Metropolitana de Santiago. Neither needs world, a continental overview or another country's geometry. The immutable chart retains its selected geometry while chart references remain. Focus, extent and styling share that geometry without rereading pack files.

sh
aner maps list
aner maps install /media/maps/country.jpn.anermap
aner maps install /media/maps/chile.region.rm.anermap
aner
import aner.plot
plot.map("country.jpn", keys: List("JPN"), values: List(12.0))
    .focus("JPN").projection("auto")
    .title("Japan: synthetic example").show()

The plotting guide explains chart construction, optional installation, memory ownership and regional projections. Download the same example as Aner source, VS Code .anernb or Jupyter .ipynb.

The country CSV, coverage JSON and reference checklist contain the complete machine readable inventory and source metadata. These small inventory downloads contain no runtime or map archive. Build matching packs from the source catalogue or obtain the files distributed with a compatible development build:

sh
python3 tools/package_maps.py --pack country.jpn --output build/map-packs
python3 tools/package_maps.py --pack chile.region.rm --output build/map-packs

Packaging, installation and rendering use local files without automatic downloads. National outline packs contain one geographic unit, without administrative subdivisions or streets. For example, country.chl is Chile's national outline; chile is the existing 16 region administrative layer, with its documented continental clip. chile.region.rm holds just one of those administrative features. Focusing CL-RM on a complete chile chart changes its viewport while keeping all 16 already loaded regions.

Coverage and source meaning

The checklist contains every one of the 248 countries or areas in the downloaded UN M49 overview, plus Taiwan, giving 249 ISO coded geographic units. All 193 UN member states and two non member observer states are independently checked. Countries, dependencies and other territories are included: 249 is a geographic unit count. Additional non ISO source units keep separate source IDs. Neither inventory nor source geometry resolves sovereignty or current legal boundaries.

National outlines derive from all 298 Natural Earth 1:10m admin 0 map units at pinned commit ca96624a56bd078437bca8184e78163e5039ad19 (June 2, 2022). Source subunits are grouped into their ISO geographic units; the 20 non ISO units stay separate. No microstate is replaced by a fabricated marker. The source's original generalized coordinates are retained without further simplification, with documented dissolve, ring orientation and source defect handling. Territory coverage follows the geographic unit's source parts, rather than attaching every dependency to its sovereign country.

The source and reference metadata identify exact hashes and exceptions. These are display boundaries from a pinned 2022 snapshot, not a current legal boundary feed. All national outlines together contain 12,700,397 bytes (12.11 MiB) of GeoJSON; a program opens only its chosen one. The largest, Canada, contains 1,575,063 bytes and 68,193 coordinates. Geometry size in the tables means UTF-8 GeoJSON payload, excluding archive metadata and parsed memory overhead.

Sources: UN M49 overview, UN members, UN observers, pinned Natural Earth map units and Natural Earth public domain terms. Detailed transforms and notices remain in the source's map provenance.

Packaging collections

Collections prepare independent files for distribution; they do not cause runtime loading or make their packs dependencies of one another. For example, python3 tools/package_maps.py --collection africa --output build/map-packs prepares 60 individual files, from which a user can install only the chosen country. The existing plot teaching collection stays at 23 packs. The countries collection contains 249 ISO geographic units; source-units prepares the 20 additional source units.

CollectionIndependent packsGrouping
countries249All ISO geographic units
source-units20Non ISO source units, separately identified
chile-regions16Single administrative regions from existing continental Chile geometry
europe51UN M49 Europe
asia51UN M49 Asia plus Taiwan
africa60UN M49 Africa
oceania29UN M49 Oceania
central-america8UN M49 Central America, including Mexico
caribbean28UN M49 Caribbean
south-america16UN M49 South America
northern-america5UN M49 Northern America

Continental collection membership follows the reference checklist, including dependencies as separately coded geographic units. Thus europe is a packaging collection of 51 independent full unit outlines, while plot.map("europe", ...) uses the existing 53 feature clipped European overview. They have different purposes and coverage. Transcontinental countries follow the checklist's single region assignment; the code does not duplicate their geometry among continents.

Country and territory outlines

Each row uses plot.map(pack_id, keys: List(join_key), values: List(value)). A country or territory's full source extent may span remote islands; use an explicit extent for a local comparison. Small country shapes come from the source polygons and remain subject to cartographic generalization.

Europe: 51 geographic units

Country or territoryPack IDJoin keyGeometry bytes
Albaniacountry.albALB13,432
Andorracountry.andAND2,435
Austriacountry.autAUT25,115
Belaruscountry.blrBLR26,906
Belgiumcountry.belBEL15,057
Bosnia and Herzegovinacountry.bihBIH15,005
Bulgariacountry.bgrBGR20,528
Croatiacountry.hrvHRV52,431
Czechiacountry.czeCZE21,453
Denmarkcountry.dnkDNK47,980
Estoniacountry.estEST24,147
Faroe Islandscountry.froFRO11,991
Finlandcountry.finFIN71,721
Francecountry.fraFRA79,698
Germanycountry.deuDEU66,023
Gibraltarcountry.gibGIB1,512
Greececountry.grcGRC134,478
Guernseycountry.ggyGGY2,671
Holy Seecountry.vatVAT1,531
Hungarycountry.hunHUN19,833
Icelandcountry.islISL72,389
Irelandcountry.irlIRL53,861
Isle of Mancountry.imnIMN2,958
Italycountry.itaITA73,437
Jerseycountry.jeyJEY2,376
Latviacountry.lvaLVA13,197
Liechtensteincountry.lieLIE1,980
Lithuaniacountry.ltuLTU13,617
Luxembourgcountry.luxLUX5,465
Maltacountry.mltMLT2,584
Monacocountry.mcoMCO1,617
Montenegrocountry.mneMNE9,184
Netherlands (Kingdom of the)country.nldNLD17,870
North Macedoniacountry.mkdMKD9,297
Norwaycountry.norNOR275,427
Polandcountry.polPOL30,355
Portugalcountry.prtPRT29,318
Republic of Moldovacountry.mdaMDA17,084
Romaniacountry.rouROU27,472
Russian Federationcountry.rusRUS821,618
San Marinocountry.smrSMR1,789
Serbiacountry.srbSRB21,929
Slovakiacountry.svkSVK13,819
Sloveniacountry.svnSVN12,705
Spaincountry.espESP66,041
Svalbard and Jan Mayen Islandscountry.sjmSJM67,779
Swedencountry.sweSWE103,152
Switzerlandcountry.cheCHE17,056
Ukrainecountry.ukrUKR59,319
United Kingdom of Great Britain and Northern Irelandcountry.gbrGBR156,548
Åland Islandscountry.alaALA11,716

Asia: 51 geographic units

Country or territoryPack IDJoin keyGeometry bytes
Afghanistancountry.afgAFG34,702
Armeniacountry.armARM10,830
Azerbaijancountry.azeAZE22,225
Bahraincountry.bhrBHR4,587
Bangladeshcountry.bgdBGD51,112
Bhutancountry.btnBTN8,494
Brunei Darussalamcountry.brnBRN4,790
Cambodiacountry.khmKHM28,913
Chinacountry.chnCHN318,903
China, Hong Kong Special Administrative Regioncountry.hkgHKG10,515
China, Macao Special Administrative Regioncountry.macMAC3,508
Cypruscountry.cypCYP7,933
Democratic People's Republic of Koreacountry.prkPRK42,019
Georgiacountry.geoGEO13,042
Indiacountry.indIND169,395
Indonesiacountry.idnIDN442,244
Iran (Islamic Republic of)country.irnIRN60,837
Iraqcountry.irqIRQ19,755
Israelcountry.isrISR11,586
Japancountry.jpnJPN160,260
Jordancountry.jorJOR9,289
Kazakhstancountry.kazKAZ93,158
Kuwaitcountry.kwtKWT6,794
Kyrgyzstancountry.kgzKGZ27,642
Lao People's Democratic Republiccountry.laoLAO41,475
Lebanoncountry.lbnLBN8,143
Malaysiacountry.mysMYS56,965
Maldivescountry.mdvMDV32,351
Mongoliacountry.mngMNG34,662
Myanmarcountry.mmrMMR101,888
Nepalcountry.nplNPL23,569
Omancountry.omnOMN23,905
Pakistancountry.pakPAK47,968
Philippinescountry.phlPHL168,051
Qatarcountry.qatQAT6,624
Republic of Koreacountry.korKOR71,275
Saudi Arabiacountry.sauSAU52,990
Singaporecountry.sgpSGP2,248
Sri Lankacountry.lkaLKA19,487
State of Palestinecountry.psePSE6,562
Syrian Arab Republiccountry.syrSYR14,979
Taiwancountry.twnTWN14,181
Tajikistancountry.tjkTJK28,791
Thailandcountry.thaTHA74,134
Timor Lestecountry.tlsTLS7,746
Turkmenistancountry.tkmTKM37,656
Türkiyecountry.turTUR80,645
United Arab Emiratescountry.areARE18,812
Uzbekistancountry.uzbUZB37,677
Viet Namcountry.vnmVNM96,109
Yemencountry.yemYEM23,831

Africa: 60 geographic units

Country or territoryPack IDJoin keyGeometry bytes
Algeriacountry.dzaDZA27,825
Angolacountry.agoAGO38,057
Benincountry.benBEN13,891
Botswanacountry.bwaBWA23,169
British Indian Ocean Territorycountry.iotIOT3,673
Burkina Fasocountry.bfaBFA25,023
Burundicountry.bdiBDI8,044
Cabo Verdecountry.cpvCPV11,278
Camerooncountry.cmrCMR31,548
Central African Republiccountry.cafCAF38,766
Chadcountry.tcdTCD27,439
Comoroscountry.comCOM4,278
Congocountry.cogCOG30,118
Côte d’Ivoirecountry.civCIV34,948
Democratic Republic of the Congocountry.codCOD63,448
Djibouticountry.djiDJI5,946
Egyptcountry.egyEGY43,709
Equatorial Guineacountry.gnqGNQ6,409
Eritreacountry.eriERI23,373
Eswatinicountry.swzSWZ3,313
Ethiopiacountry.ethETH24,156
French Southern Territoriescountry.atfATF13,624
Gaboncountry.gabGAB32,037
Gambiacountry.gmbGMB10,623
Ghanacountry.ghaGHA18,476
Guineacountry.ginGIN37,060
Guinea Bissaucountry.gnbGNB30,670
Kenyacountry.kenKEN20,021
Lesothocountry.lsoLSO8,766
Liberiacountry.lbrLBR16,013
Libyacountry.lbyLBY15,711
Madagascarcountry.mdgMDG38,953
Malawicountry.mwiMWI19,797
Malicountry.mliMLI39,622
Mauritaniacountry.mrtMRT27,266
Mauritiuscountry.musMUS3,973
Mayottecountry.mytMYT3,423
Moroccocountry.marMAR23,991
Mozambiquecountry.mozMOZ54,604
Namibiacountry.namNAM28,329
Nigercountry.nerNER23,453
Nigeriacountry.ngaNGA37,371
Rwandacountry.rwaRWA8,354
Réunioncountry.reuREU3,279
Saint Helenacountry.shnSHN3,306
Sao Tome and Principecountry.stpSTP3,308
Senegalcountry.senSEN32,745
Seychellescountry.sycSYC8,665
Sierra Leonecountry.sleSLE16,504
Somaliacountry.somSOM15,662
South Africacountry.zafZAF51,703
South Sudancountry.ssdSSD25,596
Sudancountry.sdnSDN26,890
Togocountry.tgoTGO11,125
Tunisiacountry.tunTUN16,390
Ugandacountry.ugaUGA14,222
United Republic of Tanzaniacountry.tzaTZA40,291
Western Saharacountry.eshESH7,885
Zambiacountry.zmbZMB35,542
Zimbabwecountry.zweZWE18,821

Oceania: 29 geographic units

Country or territoryPack IDJoin keyGeometry bytes
American Samoacountry.asmASM2,921
Australiacountry.ausAUS326,795
Christmas Islandcountry.cxrCXR2,056
Cocos (Keeling) Islandscountry.cckCCK2,000
Cook Islandscountry.cokCOK4,664
Fijicountry.fjiFJI36,808
French Polynesiacountry.pyfPYF27,449
Guamcountry.gumGUM2,477
Heard Island and McDonald Islandscountry.hmdHMD2,645
Kiribaticountry.kirKIR17,592
Marshall Islandscountry.mhlMHL6,118
Micronesia (Federated States of)country.fsmFSM7,051
Naoerocountry.nruNRU1,578
New Caledoniacountry.nclNCL24,899
New Zealandcountry.nzlNZL108,879
Niuecountry.niuNIU2,262
Norfolk Islandcountry.nfkNFK2,003
Northern Mariana Islandscountry.mnpMNP5,619
Palaucountry.plwPLW5,010
Papua New Guineacountry.pngPNG111,683
Pitcairncountry.pcnPCN2,338
Samoacountry.wsmWSM4,657
Solomon Islandscountry.slbSLB51,630
Tokelaucountry.tklTKL1,902
Tongacountry.tonTON6,665
Tuvalucountry.tuvTUV2,992
United States Minor Outlying Islandscountry.umiUMI5,059
Vanuatucountry.vutVUT25,590
Wallis and Futuna Islandscountry.wlfWLF2,348

Americas: 57 geographic units

Country or territoryPack IDJoin keyGeometry bytes
Anguillacountry.aiaAIA2,855
Antigua and Barbudacountry.atgATG4,162
Argentinacountry.argARG112,515
Arubacountry.abwABW1,955
Bahamascountry.bhsBHS38,613
Barbadoscountry.brbBRB2,172
Belizecountry.blzBLZ12,641
Bermudacountry.bmuBMU3,315
Bolivia (Plurinational State of)country.bolBOL36,738
Bonaire, Sint Eustatius and Sabacountry.besBES2,856
Bouvet Islandcountry.bvtBVT1,771
Brazilcountry.braBRA257,509
British Virgin Islandscountry.vgbVGB3,547
Canadacountry.canCAN1,575,063
Cayman Islandscountry.cymCYM3,244
Chilecountry.chlCHL410,952
Colombiacountry.colCOL74,163
Costa Ricacountry.criCRI19,747
Cubacountry.cubCUB62,980
Curaçaocountry.cuwCUW2,372
Dominicacountry.dmaDMA3,085
Dominican Republiccountry.domDOM14,618
Ecuadorcountry.ecuECU35,554
El Salvadorcountry.slvSLV10,059
Falkland Islands (Malvinas)country.flkFLK33,289
French Guianacountry.gufGUF11,978
Greenlandcountry.grlGRL460,430
Grenadacountry.grdGRD2,844
Guadeloupecountry.glpGLP5,386
Guatemalacountry.gtmGTM11,819
Guyanacountry.guyGUY25,795
Haiticountry.htiHTI16,249
Hondurascountry.hndHND28,352
Jamaicacountry.jamJAM7,163
Martiniquecountry.mtqMTQ4,412
Mexicocountry.mexMEX175,781
Montserratcountry.msrMSR1,897
Nicaraguacountry.nicNIC22,736
Panamacountry.panPAN44,950
Paraguaycountry.pryPRY28,443
Perucountry.perPER57,302
Puerto Ricocountry.priPRI8,293
Saint Barthélemycountry.blmBLM1,638
Saint Kitts and Neviscountry.knaKNA2,394
Saint Luciacountry.lcaLCA2,521
Saint Martin (French Part)country.mafMAF1,895
Saint Pierre and Miqueloncountry.spmSPM3,287
Saint Vincent and the Grenadinescountry.vctVCT3,337
Sint Maarten (Dutch part)country.sxmSXM1,589
South Georgia and the South Sandwich Islandscountry.sgsSGS15,425
Surinamecountry.surSUR17,422
Trinidad and Tobagocountry.ttoTTO5,862
Turks and Caicos Islandscountry.tcaTCA6,310
United States of Americacountry.usaUSA846,156
United States Virgin Islandscountry.virVIR3,042
Uruguaycountry.uryURY15,249
Venezuela (Bolivarian Republic of)country.venVEN72,524

Antarctica: 1 geographic unit

Geographic unitPack IDJoin keyGeometry bytes
Antarcticacountry.ataATA563,806

Chile: one region at a time

Each regional pack reuses exactly one feature of the existing simplified continental chile layer, retaining source key and label. The continental extent excludes remote Pacific islands and Antarctic claims. These packs add no provinces, communes or streets.

The Metropolitana de Santiago pack has 3,733 bytes and 108 coordinates, compared with 240,450 bytes and 9,945 coordinates for the complete 16 region Chile layer. A separate regional pack therefore avoids reading or parsing the other 15 features. These are geometry payload counts; allocator reuse, application state and chart references determine actual process memory.

Chilean source regionPack IDJoin keyGeometry bytes
Aisén del General Carlos Ibáñez del Campochile.region.aiCL-AI54,411
Antofagastachile.region.anCL-AN7,052
Arica y Parinacotachile.region.apCL-AP3,448
Atacamachile.region.atCL-AT7,219
Bío Bíochile.region.biCL-BI6,559
Coquimbochile.region.coCL-CO5,950
La Araucaníachile.region.arCL-AR5,241
Libertador General Bernardo O'Higginschile.region.liCL-LI3,598
Los Lagoschile.region.llCL-LL16,643
Los Ríoschile.region.lrCL-LR3,957
Magallanes y Antártica Chilenachile.region.maCL-MA120,439
Maulechile.region.mlCL-ML4,299
Región Metropolitana de Santiagochile.region.rmCL-RM3,733
Tarapacáchile.region.taCL-TA4,714
Valparaísochile.region.vsCL-VS4,454
Ñublechile.region.nbCL-NB3,566

Additional non ISO source units

These 20 entries preserve Natural Earth's source identity and classification. Use the listed source.* ID and exact key rather than assuming an ISO country code. Source classifications and boundaries retain the pinned snapshot; they do not imply Aner recognition or a current status determination.

Source map unitPack IDJoin keySource classification
Akrotiri Sovereign Base Areasource.wsbWSBDependency
Bajo Nuevo Bank (Petrel Is.)source.bjnBJNIndeterminate
Baykonur Cosmodromesource.kabKABLease
Bir Tawilsource.brtBRTIndeterminate
Brazilian Islandsource.briBRIIndeterminate
Cyprus No Mans Areasource.cnmCNMIndeterminate
Dhekelia Sovereign Base Areasource.esbESBDependency
Korean Demilitarized Zone (north)source.knzKNZOverlay
Korean Demilitarized Zone (south)source.knxKNXOverlay
Kosovosource.kosKOSDisputed
Northern Cyprussource.cynCYNSovereign country
Paracel Islandssource.pfaPFAGeo unit
Scarborough Reefsource.scrSCRIndeterminate
Serranilla Banksource.serSERIndeterminate
Siachen Glaciersource.kasKASIndeterminate
Somalilandsource.solSOLSovereign country
Southern Patagonian Ice Fieldsource.spiSPIIndeterminate
Spratly Islandssource.pgaPGAIndeterminate
UNDOFsource.syuSYUOverlay
US Naval Base Guantanamo Baysource.usgUSGLease

Existing administrative and overview packs

Existing named packs continue to work: world and usa overviews; south.america and europe bounded continental views; chile, argentina, bolivia, brazil, colombia, ecuador, guyana, paraguay, peru, suriname, uruguay, venezuela, mexico and canada first order administrative layers; and usa.<postal> for all 50 states plus DC. Each state pack contains separate county and place layers; loading one layer parses only that selected layer. The plotting guide documents joins and coverage.

Install usa.co for Boulder, usa.ca for the California city examples, or usa.ny, usa.hi and usa.tx for the matching city examples. These packs and national outlines remain optional and independent. Standalone GeoPosition point charts and numerical plots require no pack.

Aner documentation · Reference and guides