KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

geopackage-ios

★ 59 Open GitHub ↗

GeoPackage iOS Library

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GeoPackage iOS

### Maintenance Mode

GeoPackage is in maintenance mode only, and users should expect no further major updates.

### GeoPackage iOS Lib ####

The [GeoPackage Libraries](http://ngageoint.github.io/GeoPackage/) were developed at the [National Geospatial-Intelligence Agency (NGA)](http://www.nga.mil/) in collaboration with [BIT Systems](https://www.caci.com/bit-systems/). The government has "unlimited rights" and is releasing this software to increase the impact of government investments by providing developers with the opportunity to take things in new directions. The software use, modification, and distribution rights are stipulated within the [MIT license](http://choosealicense.com/licenses/mit/).

### Pull Requests ###
If you'd like to contribute to this project, please make a pull request. We'll review the pull request and discuss the changes. All pull request contributions to this project will be released under the MIT license.

Software source code previously released under an open source license and then modified by NGA staff is considered a "joint work" (see 17 USC § 101); it is partially copyrighted, partially public domain, and as a whole is protected by the copyrights of the non-government authors and must be released according to the terms of the original open source license.

### About ###

[GeoPackage iOS](http://ngageoint.github.io/geopackage-ios/) is a [GeoPackage Library](http://ngageoint.github.io/GeoPackage/) Objective-C SDK implementation of the Open Geospatial Consortium [GeoPackage](http://www.geopackage.org/) [spec](http://www.geopackage.org/spec/).  It is listed as an [OGC GeoPackage Implementation](http://www.geopackage.org/#implementations_nga) by the National Geospatial-Intelligence Agency.

The GeoPackage SDK provides the ability to manage GeoPackage files providing read, write, import, export, share, and open support. Open GeoPackage files provide read and write access to features and tiles. Feature support includes Well-Known Binary and iOS Map shape translations. Tile generation supports creation by URL or features. Tile providers supporting GeoPackage format, standard tile API, and feature tile generation.

### Usage ###

View the latest [Appledoc](http://ngageoint.github.io/geopackage-ios/docs/api/).

#### Example Apps ####

The following projects demonstrate usage of geopackage-ios in a host app.

##### GeoPackage MapCache #####

The [GeoPackage MapCache](https://github.com/ngageoint/geopackage-mapcache-ios) app provides an extensive standalone example on how to use the SDK.

##### MAGE #####

The [Mobile Awareness GEOINT Environment (MAGE)](https://github.com/ngageoint/mage-ios) app provides mobile situational awareness capabilities. It [uses the SDK](https://github.com/ngageoint/mage-ios/search?q=GeoPackage&type=Code) to provide GeoPackage functionality.

#### Objective-C Example ####
```objectivec

// NSString *geoPackageFile = ...;
// MKMapView *mapView = ...;

// Get a manager
GPKGGeoPackageManager *manager = [GPKGGeoPackageFactory manager];

// Available databases
NSArray *databases = [manager databases];

// Import database
BOOL imported = [manager importGeoPackageFromPath:geoPackageFile];

// Open database
GPKGGeoPackage *geoPackage = [manager open:[databases objectAtIndex:0]];

// GeoPackage Table DAOs
GPKGSpatialReferenceSystemDao *srsDao = [geoPackage spatialReferenceSystemDao];
GPKGContentsDao *contentsDao =  [geoPackage contentsDao];
GPKGGeometryColumnsDao *geometryColumnsDao = [geoPackage geometryColumnsDao];
GPKGTileMatrixSetDao *tileMatrixSetDao = [geoPackage tileMatrixSetDao];
GPKGTileMatrixDao *tileMatrixDao = [geoPackage tileMatrixDao];
GPKGSchemaExtension *schemaExtension = [[GPKGSchemaExtension alloc] initWithGeoPackage:geoPackage];
GPKGDataColumnsDao *dataColumnsDao = [schemaExtension dataColumnsDao];
GPKGDataColumnConstraintsDao *dataColumnConstraintsDao = [schemaExtension dataColumnConstraintsDao];
GPKGMetadataExtension *metadataExtension = [[GPKGMetadataExtension alloc] initWithGeoPackage:geoPackage];
GPKGMetadataDao *metadataDao = [metadataExtension metadataDao];
GPKGMetadataReferenceDao *metadataReferenceDao = [metadataExtension metadataReferenceDao];
GPKGExtensionsDao *extensionsDao = [geoPackage extensionsDao];

// Feature and tile tables
NSArray<NSString *> *features = [geoPackage featureTables];
NSArray<NSString *> *tiles = [geoPackage tileTables];

// Query Features
NSString *featureTable = [features objectAtIndex:0];
GPKGFeatureDao *featureDao = [geoPackage featureDaoWithTableName:featureTable];
GPKGMapShapeConverter *converter = [[GPKGMapShapeConverter alloc] initWithProjection:featureDao.projection];
GPKGRowResultSet *featureResults = [featureDao results:[featureDao queryForAll]];
@try {
    for (GPKGFeatureRow *featureRow in featureResults) {
        GPKGGeometryData *geometryData = [featureRow geometry];
        if (geometryData != nil && !geometryData.empty) {
            SFGeometry *geometry = geometryData.geometry;
            GPKGMapShape *shape = [converter toShapeWithGeometry:geometry];
            GPKGMapShape *mapShape = [GPKGMapShapeConverter addMapShape:shape toMapView:mapView];
            // ...
            // Track the map shape to remove it at a later time
            [mapShape removeFromMapView:mapView];
        }
    }
} @finally {
    [converter destroy];
    [featureResults close];
}

// Query Tiles
NSString *tileTable = [tiles objectAtIndex:0];
GPKGTileDao *tileDao = [geoPackage tileDaoWithTableName:tileTable];
GPKGRowResultSet *tileResults = [tileDao results:[tileDao queryForAll]];
@try {
    for (GPKGTileRow *tileRow in tileResults) {
        NSData *tileData = [tileRow tileData];
        UIImage *tileImage = [tileRow tileDataImage];
        // ...
    }
} @finally {
    [tileResults close];
}

// Retrieve Tiles by XYZ
NSObject<GPKGTileRetriever> *retriever = [[GPKGGeoPackageTileRetriever alloc] initWithTileDao:tileDao];
GPKGGeoPackageTile *geoPackageTile = [retriever tileWithX:2 andY:2 andZoom:2];
if (geoPackageTile != nil) {
    NSData *tileData = geoPackageTile.data;
    UIImage *tileImage = [GPKGImageConverter toImage:tileData];
    // ...
}

// Retrieve Tiles by Bounding Box
GPKGTileCreator *tileCreator = [[GPKGTileCreator alloc] initWithTileDao:tileDao andProjection:[PROJProjectionFactory projectionWithEpsgInt:PROJ_EPSG_WORLD_GEODETIC_SYSTEM]];
GPKGGeoPackageTile *geoPackageTile2 = [tileCreator tileWithBoundingBox:[[GPKGBoundingBox alloc] initWithMinLongitudeDouble:-90.0 andMinLatitudeDouble:0.0 andMaxLongitudeDouble:0.0 andMaxLatitudeDouble:66.513260]];
if (geoPackageTile2 != nil) {
    NSData *tileData = geoPackageTile2.data;
    UIImage *tileImage = [GPKGImageConverter toImage:tileData];
    // ...
}

// Tile Overlay (GeoPackage or Standard API)
MKTileOverlay *tileOverlay = [GPKGOverlayFactory tileOverlayWithTileDao:tileDao];
tileOverlay.canReplaceMapContent = false;
[mapView addOverlay:tileOverlay];

GPKGBoundingBox *boundingBox = [GPKGBoundingBox worldWebMercator];
PROJProjection *projection = [PROJProjectionFactory projectionWithEpsgInt:PROJ_EPSG_WEB_MERCATOR];

// Index Features
GPKGFeatureIndexManager *indexer = [[GPKGFeatureIndexManager alloc] initWithGeoPackage:geoPackage andFeatureDao:featureDao andGeodesic:NO];
[indexer setIndexLocation:GPKG_FIT_RTREE];
int indexedCount = [indexer index];

// Query Indexed Features in paginated chunks
GPKGFeatureIndexResults *indexResults = [indexer queryForChunkWithBoundingBox:boundingBox inProjection:projection andLimit:50];
GPKGRowPaginatedResults *paginatedResults = [indexer paginate:indexResults];
@try {
    for (GPKGFeatureRow *featureRow in paginatedResults) {
        GPKGGeometryData *geometryData = [featureRow geometry];
        if (geometryData != nil && !geometryData.empty) {
            SFGeometry *geometry = geometryData.geometry;
            // ...
        }
    }
} @finally {
    [paginatedResults close];
}

// Feature Tile Overlay (dynamically draw tiles from features)
GPKGFeatureTiles *featureTiles = [[GPKGFeatureTiles alloc] initWithFeatureDao:featureDao andGeodesic:NO];
[featureTiles setMaxFeaturesPerTile:[NSNumber numberWithInt:1000]];
GPKGNumberFeaturesTile *numberFeaturesTile = [[GPKGNumberFeaturesTile alloc] init];
[featureTiles setMaxFeaturesTileDraw:numberFeaturesTile];
[featureTiles setIndexManager:indexer];
GPKGFeatureOverlay *featureOverlay = [[GPKGFeatureOverlay alloc] initWithFeatureTiles:featureTiles];
[featureOverlay setMinZoom:[NSNumber numberWithInt:[featureDao zoomLevel]]];
[mapView addOverlay:featureOverlay];

// Feature Overlay Query (query the features represented by tiles)
GPKGFeatureOverlayQuery *featureOverlayQuery = [[GPKGFeatureOverlayQuery alloc] initWithBoundedOverlay:featureOverlay andFeatureTiles:featureTiles];
[featureOverlayQuery calculateStylePixelBounds];
GPKGBoundingBox *featureBounds = [featureDao boundingBox];
indexResults = [featureOverlayQuery queryFeaturesWithBoundingBox:featureBounds];
@try {
    for (GPKGFeatureRow *featureRow in indexResults) {
        SFGeometry *geometry = [featureRow geometryValue];
        if (geometry != nil) {
            // ...
        }
    }
} @finally {
    [indexResults close];
}

// URL Tile Generator (generate tiles from a URL)
GPKGTileGenerator *urlTileGenerator = [[GPKGUrlTileGenerator alloc] initWithGeoPackage:geoPackage andTableName:@"url_tile_table" andTileUrl:@"http://url/{z}/{x}/{y}.png" andMinZoom:0 andMaxZoom:0 andBoundingBox:boundingBox andProjection:projection];
int urlTileCount = [urlTileGenerator generateTiles];

// Feature Tile Generator (generate tiles from features)
GPKGTileGenerator *featureTileGenerator = [[GPKGFeatureTileGenerator alloc] initWithGeoPackage:geoPackage andTableName:[NSString stringWithFormat:@"tiles_%@", featureTable] andFeatureTiles:featureTiles andMinZoom:1 andMaxZoom:2 andBoundingBox:boundingBox andProjection:projection];
int featureTileCount = [featureTileGenerator generateTiles];

// Remove and close map overlays
[mapView removeOverlay:tileOverlay];
[mapView removeOverlay:featureOverlay];
[featureTiles close];

// Close database when done
[geoPackage close];

// Close manager when done
[manager close];

```

#### Swift Example ####

To use from Swift, import the module:

import GeoPackage
 
```swift

// let geoPackageFile: String = ...
// let mapView: MKMapView = ...

// Get a manager
let manager: GPKGGeoPackageManager = GPKGGeoPackageFactory.manager()

// Available databases
let databases: NSArray = manager.databases() as NSArray

// Import database
let imported: Bool = manager.importGeoPackage(fromPath: geoPackageFile)

// Open database
let geoPackage: GPKGGeoPackage = manager.open(databases.object(at: 0) as? String)

// GeoPackage Table DAOs
let srsDao: GPKGSpatialReferenceSystemDao = geoPackage.spatialReferenceSystemDao()
let contentsDao: GPKGContentsDao = geoPackage.contentsDao()
let geometryColumnsDao: GPKGGeometryColumnsDao = geoPackage.geometryColumnsDao()
let tileMatrixSetDao: GPKGTileMatrixSetDao = geoPackage.tileMatrixSetDao()
let tileMatrixDao: GPKGTileMatrixDao = geoPackage.tileMatrixDao()
let schemaExtension : GPKGSchemaExtension = GPKGSchemaExtension.init(geoPackage: geoPackage)
let dataColumnsDao: GPKGDataColumnsDao = schemaExtension.dataColumnsDao()
let dataColumnConstraintsDao: GPKGDataColumnConstraintsDao = schemaExtension.dataColumnConstraintsDao()
let metadataExtension : GPKGMetadataExtension = GPKGMetadataExtension.init(geoPackage: geoPackage)
let metadataDao: GPKGMetadataDao = metadataExtension.metadataDao()
let metadataReferenceDao: GPKGMetadataReferenceDao = metadataExtension.metadataReferenceDao()
let extensionsDao: GPKGExtensionsDao = geoPackage.extensionsDao()

// Feature and tile tables
let features: NSArray = geoPackage.featureTables() as NSArray
let tiles: NSArray = geoPackage.tileTables() as NSArray

// Query Features
let featureTable: String = features.object(at: 0) as! String
let featureDao: GPKGFeatureDao = geoPackage.featureDao(withTableName: featureTable)
let converter: GPKGMapShapeConverter = GPKGMapShapeConverter(projection: featureDao.projection)
let featureResults: GPKGResultSet = featureDao.queryForAll()
do {
    defer{converter.destroy()}
    defer{featureResults.close()}
    while (featureResults.moveToNext()) {
        let featureRow: GPKGFeatureRow = featureDao.featureRow(featureResults)
        let geometryData: GPKGGeometryData! = featureRow.geometry()
        if (geometryData != nil && !geometryData.empty) {
            let geometry: SFGeometry = geometryData.geometry
            let shape: GPKGMapShape = converter.toShape(with: geometry)
            let mapShape = GPKGMapShapeConverter.add(shape, to: mapView)
            // ...
            // Track the map shape to remove it at a later time
            mapShape?.remove(from: mapView)
        }
    }
}

// Query Tiles
let tileTable: String = tiles.object(at: 0) as! String
let tileDao: GPKGTileDao = geoPackage.tileDao(withTableName: tileTable)
let tileResults: GPKGResultSet = tileDao.queryForAll()
do {
    defer{tileResults.close()}
    while (tileResults.moveToNext()) {
        let tileRow: GPKGTileRow = tileDao.tileRow(tileResults)
        let tileData: Data = tileRow.tileData()
        let tileImage: UIImage = tileRow.tileDataImage()
        // ...
    }
}

// Retrieve Tiles by XYZ
let retriever = GPKGGeoPackageTileRetriever()
let geoPackageTile: GPKGGeoPackageTile! = retriever.tileWith(x: 2, andY: 2, andZoom: 2)
if (geoPackageTile != nil) {
    let tileData: Data = geoPackageTile.data
    let tileImage: UIImage = GPKGImageConverter.toImage(tileData)
    // ...
}

// Retrieve Tiles by Bounding Box
let tileCreator: GPKGTileCreator = GPKGTileCreator(tileDao: tileDao, andProjection: PROJProjectionFactory.projection(withEpsgInt: PROJ_EPSG_WORLD_GEODETIC_SYSTEM))
let geoPackageTile2: GPKGGeoPackageTile! = tileCreator.tile(with: GPKGBoundingBox(minLongitudeDouble: -90.0, andMinLatitudeDouble: 0.0, andMaxLongitudeDouble: 0.0, andMaxLatitudeDouble: 66.513260))
if (geoPackageTile2 != nil) {
    let tileData: Data = geoPackageTile2.data
    let tileImage: UIImage = GPKGImageConverter.toImage(tileData)
    // ...
}

// Tile Overlay (GeoPackage or Standard API)
let tileOverlay: MKTileOverlay = GPKGOverlayFactory.tileOverlay(with: tileDao)
tileOverlay.canReplaceMapContent = false
mapView.addOverlay(tileOverlay)

let boundingBox: GPKGBoundingBox = GPKGBoundingBox.worldWebMercator()
let projection: PROJProjection = PROJProjectionFactory.projection(withEpsgInt: PROJ_EPSG_WEB_MERCATOR)

// Index Features
let indexer: GPKGFeatureIndexManager = GPKGFeatureIndexManager(geoPackage: geoPackage, andFeatureDao: featureDao)
indexer.indexLocation = GPKG_FIT_RTREE
let indexedCount = indexer.index()

// Query Indexed Features in paginated chunks
var indexResults: GPKGFeatureIndexResults = indexer.queryForChunk(with: boundingBox, in: projection, andLimit: 50)
let paginatedResults: GPKGRowPaginatedResults = indexer.paginate(indexResults)
do {
    defer{paginatedResults.close()}
    while (paginatedResults.moveToNext()) {
        let featureRow: GPKGFeatureRow = paginatedResults.userRow() as! GPKGFeatureRow
        let geometryData: GPKGGeometryData! = featureRow.geometry()
        if (geometryData != nil && !geometryData.empty) {
            let geometry: SFGeometry = geometryData.geometry
            // ...
        }
    }
}

// Feature Tile Overlay (dynamically draw tiles from features)
let featureTiles: GPKGFeatureTiles = GPKGFeatureTiles(featureDao: featureDao)
featureTiles.maxFeaturesPerTile = 1000
let numberFeaturesTile: GPKGNumberFeaturesTile = GPKGNumberFeaturesTile()
featureTiles.maxFeaturesTileDraw = numberFeaturesTile
featureTiles.indexManager = indexer
let featureOverlay: GPKGFeatureOverlay! = GPKGFeatureOverlay(featureTiles: featureTiles)
featureOverlay.minZoom = NSNumber(value:featureDao.zoomLevel())
mapView.addOverlay(featureOverlay!)

// Feature Overlay Query (query the features represented by tiles)
let featureOverlayQuery: GPKGFeatureOverlayQuery = GPKGFeatureOverlayQuery(boundedOverlay: featureOverlay, andFeatureTiles: featureTiles)
featureOverlayQuery.calculateStylePixelBounds()
let featureBounds: GPKGBoundingBox = featureDao.boundingBox()
indexResults = featureOverlayQuery.queryFeatures(with: featureBounds)
do {
    defer{indexResults.close()}
    while (indexResults.moveToNext()) {
        let featureRow: GPKGFeatureRow = indexResults.featureRow()
        let geometry: SFGeometry! = featureRow.geometryValue()
        if (geometry != nil) {
            // ...
        }
    }
}

// URL Tile Generator (generate tiles from a URL)
let urlTileGenerator: GPKGTileGenerator = GPKGUrlTileGenerator(geoPackage: geoPackage, andTableName: "url_tile_table", andTileUrl: "http://url/{z}/{x}/{y}.png", andMinZoom: 1, andMaxZoom: 2, andBoundingBox:boundingBox, andProjection:projection)
let urlTileCount: Int32 = urlTileGenerator.generateTiles()

// Feature Tile Generator (generate tiles from features)
let featureTileGenerator: GPKGTileGenerator = GPKGFeatureTileGenerator(geoPackage: geoPackage, andTableName: featureTable + "_tiles", andFeatureTiles: featureTiles, andMinZoom: 1, andMaxZoom: 2, andBoundingBox:boundingBox, andProjection:projection)
let featureTileCount: Int32 = featureTileGenerator.generateTiles()

// Remove and close map overlays
mapView.removeOverlay(tileOverlay)
mapView.removeOverlay(featureOverlay)
featureTiles.close()

// Close database when done
geoPackage.close()

// Close manager when done
manager.close()

```

### Build ###

[![Build](https://github.com/ngageoint/geopackage-ios/workflows/Build/badge.svg)](https://github.com/ngageoint/geopackage-ios/actions/workflows/build.yml)

Build and Test (Uses UIKit, so we build with xcodebuild instead of SPM).

./build.sh

You can build and test if you open the Package.swift in Xcode.

### Include Library ###

Use this library via SPM in your Package.swift:

dependencies: [
        .package(url: "https://github.com/ngageoint/geopackage-ios.git", branch: "release/9.0.0"),
    ]
    
Or as a tagged release:

dependencies: [
        .package(url: "https://github.com/ngageoint/geopackage-ios.git", from: "9.0.0"),
    ]

Reference it in your Package.swift target:

.target(
        name: "MyApp",
        dependencies: [
            .product(name: "GeoPackage", package: "geopackage-ios"),
        ],
    ),

### Remote Dependencies ###

* [Simple Features WKB](https://github.com/ngageoint/simple-features-wkb-ios) (The MIT License (MIT)) - Simple Features Well Known Binary Lib
* [Simple Features WKT](https://github.com/ngageoint/simple-features-wkt-ios) (The MIT License (MIT)) - Simple Features Well Known Text Lib
* [Simple Features Projection](https://github.com/ngageoint/simple-features-proj-ios) (The MIT License (MIT)) - Simple Features Projection Lib
* [OGC API Features JSON](https://github.com/ngageoint/ogc-api-features-json-ios) (The MIT License (MIT)) - OGC API Features JSON Lib
* [Color](https://github.com/ngageoint/color-ios) (The MIT License (MIT)) - Color Lib
* [TIFF](https://github.com/ngageoint/tiff-ios) (The MIT License (MIT)) - Tagged Image File Format Lib

geopackage-ios

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README