https://github.com/sfomuseum/swifter-protomaps-example

Example iOS (and Mac Catalyst) application to demonstrate use of the sfomuseum/swifter-protomaps package.
https://github.com/sfomuseum/swifter-protomaps-example

protomaps swift

Last synced: 5 months ago
JSON representation

Example iOS (and Mac Catalyst) application to demonstrate use of the sfomuseum/swifter-protomaps package.

• Host: GitHub
• URL: https://github.com/sfomuseum/swifter-protomaps-example
• Owner: sfomuseum
• License: other
• Created: 2022-03-15T23:10:19.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2025-01-04T02:01:03.000Z (over 1 year ago)
• Last Synced: 2025-05-30T18:56:39.890Z (about 1 year ago)
• Topics: protomaps, swift
• Language: CSS
• Homepage:
• Size: 10.8 MB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# swifter-protomaps-example

![](docs/images/swifter-protomaps-example.png)

This is a simple iOS (and Mac Catalyst) application to demonstrate use of the [sfomuseum/swifter-protomaps](https://github.com/sfomuseum/swifter-protomaps) package.

It bundles a [Protomaps](https://github.com/protomaps/) tile database for the San Francisco International Airport (SFO, launches an instance of the [httpswifter/swifter](https://github.com/httpswift/swifter) HTTP server running on `localhost:9001` that will serve requests for those tiles and displays a single ViewController that loads a web application for displaying the tiles.

![](docs/images/swifter-protomaps-example-catalyst.png)

For a longer version detailing why we did this please see the [Serving map tiles to yourself using Protomaps and iOS](https://millsfield.sfomuseum.org/blog/2022/03/30/swifter-protomaps/) blog post.

## How does it work?

The [httpswifter/swifter](https://github.com/httpswift/swifter) HTTP server, and handlers for serving Protomaps tiles, is started in the applications `AppDelegate` code.

The web application is instantiated in the application's main `ViewController` code.

The web application itself is contain in the application's `www.bundle` package and makes requests for tiles to the local HTTP server.

## See also

* https://github.com/sfomuseum/swifter-protomaps

* https://github.com/httpswift/swifter

* https://github.com/protomaps/