Skip to main content
MapBundle package icon

MapBundle

v1.1.0Latest Stable
net10.0net8.0net9.0

Core runtime for MapBundle. Loads bundled map data (borders, cities, waterways) that ships as FlatGeobuf in the MapBundle.World and MapBundle.[Region] packages. Data is derived from OpenStreetMap (© OpenStreetMap contributors, ODbL).

Published
Sep 24, 2026
25d ago
Total Downloads
35.7K
35,656

Install

dotnet add package MapBundle --version 1.1.0
ProductVersions
.NET
net10.0net8.0net9.0

README

MapBundle

Bundled, offline map data for .NET apps — borders, cities, waterways and base layers — shipped as FlatGeobuf inside NuGet packages. Data is derived from OpenStreetMap under the ODbL; cities, rivers and lakes come from Natural Earth (public domain).

Packages

Package Contents
MapBundle Core runtime. Loads the bundled .fgb layers. No data of its own.
MapBundle.World The whole world (every continent merged).
MapBundle.[Region] A single continent or country (for example MapBundle.Europe or MapBundle.Monaco).

Install the core package plus the area required:

dotnet add package MapBundle.Monaco

A data package copies its FlatGeobuf files into a maps/<Region> folder beside the app at build time, and the MapBundle core reads them from there. Layers can instead be converted to another format and/or rendered to an image at build time.

Usage

var map = Maps.Open().Load("Monaco");

var borders = map.Borders;        // country polygons
var cities = map.Cities;          // populated places
var states = map.StatesProvinces; // admin-1 polygons
var rivers = map.Rivers;          // rivers
// also: map.Lakes, map.Coastline, map.Land, map.Ocean

snippet source | anchor

Layers are read on demand and returned as GeoConvert FeatureCollections (coordinates are WGS84 longitude/latitude).

Layers

🗺️ Borders · 🏛️ StatesProvinces · 🏙️ Cities · 〰️ Rivers · 💧 Lakes · 🏖️ Coastline · 🟩 Land · 🌊 Ocean

A layer is omitted from a package when the source has nothing for that region (for example Ocean and Coastline for landlocked countries). Roads, railways, buildings, land use and terrain are intentionally excluded.

More

Full documentation, the complete per-region package list, data sources and licensing details are on the project page:

https://github.com/Papyrine/MapBundle

License

The MapBundle core library is MIT. The data packages are licensed under the ODbL: the boundary layers (via country-levels) and the land/ocean/coastline layers (via osmdata) are © OpenStreetMap contributors; cities, rivers and lakes are made with Natural Earth (public domain).

Changes from Previous Version

No structural changes between v1.0.1 and v1.1.0.

Adoption Assessment

Assess this package against its supported frameworks, license, maintenance signals and dependency graph before making it a project standard.

No SPDX license expression is published. Review the license text and your organisation's policy before redistribution.Compatibility metadata lists 3 target frameworks; confirm the exact target used by your application.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.