https://github.com/bryceco/gomap
OpenStreetMap editor for iPhone/iPad
https://github.com/bryceco/gomap
editor ios macos mapping openstreetmap swift
Last synced: 17 days ago
JSON representation
OpenStreetMap editor for iPhone/iPad
- Host: GitHub
- URL: https://github.com/bryceco/gomap
- Owner: bryceco
- License: isc
- Created: 2013-01-26T04:30:28.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2025-03-31T20:25:44.000Z (25 days ago)
- Last Synced: 2025-04-06T11:34:40.521Z (19 days ago)
- Topics: editor, ios, macos, mapping, openstreetmap, swift
- Language: Swift
- Homepage:
- Size: 93.1 MB
- Stars: 349
- Watchers: 17
- Forks: 43
- Open Issues: 82
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Go Map!!
Go Map!! is an iPhone/iPad editor for adding cartographic information to [OpenStreetMap][1].
[![Download on the App Store badge][2]][3]
[Tutorial/help][8] on the OpenStreetMap Wiki.
## Join our TestFlight beta!
Do you want to help testing pre-releases of Go Map!!?
[Become a TestFlight tester][4] today! 🚀
## Source code structure
* iOS - App-specific UI code
* CustomViews - A collection of UIViews and CALayers primarily used by MapView
* Direction - The view controller for measuring direction
* Height - The view controller for measuring height
* OpeningHours - Support for recognizing hours via camera
* PhotoShare - App extension so we appear in the system Share menu
* POI - View Controllers for tagging objects
* Quests - Quest VCs and related code
* Upload - View controller for uploading changesets
* Shared - General purpose code (drawing code, OSM data structures, etc)
* Database - A SQLite3 database storing downloaded OSM data
* EditorLayer - The low-level graphical display for drawing nodes/ways
* MapMarkers - Markers for Quests, Notes, etc.
* OSMModels - Code for managing and storing OSM objects (nodes, ways, etc.)
* PresetsDatabase - Code for processing iD presets
* Tiles - Aerial imagery processing and display
* Images - Images used for application elements (buttons, etc)
* POI-Icons - Icons used for map elements (POIs, etc)
* presets - The presets database copied from the iD editor
* xliff - Translation files
## Application architecture
## External assets
A number of assets used in the app come from other repositories, and should be periodically updated. Because updating these items can be a lengthy process it is performed manually rather than at build time:
- iD presets database (https://github.com/openstreetmap/id-tagging-schema)
- iD presets icons (https://github.com/ideditor/temaki, https://github.com/mapbox/maki)
- Name Suggestion Index (https://github.com/osmlab/name-suggestion-index)
- NSI brand imagery (pulled from Facebook/Twitter/Wikipedia)
- StreetComplete quest filters (https://github.com/streetcomplete/StreetComplete)
- Weblate translations (https://hosted.weblate.org/projects/go-map/app)
### Updating external assets
```sh
cd src
(cd presets && ./update.sh) # fetches latest presets.json, etc. files and NSI
(cd presets && ./getBrandIcons.py) # downloads images from various websites and converts them to PNG as necessary
(cd presets && ./uploadBrandIcons.sh) # uploads imagery to gomaposm.com where they can be downloaded on demand at runtime (password required)
(cd POI-Icons && ./update.sh) # fetches Maki/Temaki icons
(cd xliff && ./update.sh) # downloads latest translations from Weblate (API token required). The output is very noisy and can be ignored
```
## Formatting
In order to have a consistent code style, please make sure to install
[SwiftFormat][6] and run it on a regular basis. Consider setting up a `pre-commit`
Git hook, as described [here][7].
## Assets
The Go Map!! app icon was created by [@Binnette][5].
[1]: https://www.openstreetmap.org
[2]: download-on-the-app-store.png
[3]: https://itunes.apple.com/app/id592990211
[4]: https://testflight.apple.com/join/T96F9wYq
[5]: https://github.com/Binnette
[6]: https://github.com/nicklockwood/SwiftFormat
[7]: https://github.com/nicklockwood/SwiftFormat#git-pre-commit-hook
[8]: https://wiki.openstreetmap.org/w/index.php?title=Go_Map!!
## Presets and translation
Go Map!! is using iD presets, so you can improve translations [by improving translations of iD presets](https://github.com/openstreetmap/id-tagging-schema).