Kartpiloten/MapPiloteGeopackageHelperv1.1.1
.NET 8.0.NET 9.0.NET 10.0
Library for interacting with Geopackages.
Get Started
$ dotnet add package MapPiloteGeopackageHelperReadme
MapPiloteGeopackageHelper
Modern .NET library for creating, reading, and bulk-loading GeoPackage (GPKG) data using SQLite and NetTopologySuite.
Quick Start - Modern Fluent API
// Create/open GeoPackage with fluent API
using var geoPackage = await GeoPackage.OpenAsync("data.gpkg", srid: 3006);
// Create layer with schema
var layer = await geoPackage.EnsureLayerAsync("cities", new Dictionary<string, string>
{
["name"] = "TEXT",
["population"] = "INTEGER",
["area_km2"] = "REAL"
});
// Bulk insert with progress
var progress = new Progress<BulkProgress>(p =>
Console.WriteLine($"Progress: {p.PercentComplete:F1}%"));
await layer.BulkInsertAsync(features,
new BulkInsertOptions(BatchSize: 1000, CreateSpatialIndex: true),
progress);
// Query with async streaming
await foreach (var city in layer.ReadFeaturesAsync(
new ReadOptions(WhereClause: "population > 100000", Limit: 10)))
{
Console.WriteLine($"City: {city.Attributes["name"]} - {city.Attributes["population"]} people");
}
// Count and delete operations
var count = await layer.CountAsync("population < 50000");
var deleted = await layer.DeleteAsync("population < 10000");
? Modern Features
| Feature | Description | Example |
|---|---|---|
| Async/Await | Proper async support with CancellationToken | await layer.BulkInsertAsync(...) |
| Fluent API | Chain operations naturally | GeoPackage.OpenAsync().EnsureLayerAsync() |
| Progress Reporting | Track long-running operations | IProgress<BulkProgress> |
| Options Objects | Clean configuration, no parameter soup | BulkInsertOptions(BatchSize: 1000) |
| Streaming | IAsyncEnumerable for large datasets | await foreach (var item in ...) |
| Rich Queries | WHERE, LIMIT, ORDER BY support | ReadOptions(WhereClause: "pop > 1000") |