Pure Maps: Difference between revisions
m Add installation instructions |
Added how to do MapBox API keys |
||
Line 22: | Line 22: | ||
[https://gitlab.com/postmarketOS/pmaports/-/merge_requests/593#note_335530177 Find a suitable provider] and register a free (developer) API key if necessary. Then configure Pure Maps in postmarketOS to use it. | [https://gitlab.com/postmarketOS/pmaports/-/merge_requests/593#note_335530177 Find a suitable provider] and register a free (developer) API key if necessary. Then configure Pure Maps in postmarketOS to use it. | ||
''(If somebody went through the process, please describe how to configure Pure Maps here.)'' | == Mapbox API == | ||
Register an acocunt on Mapbox | |||
Go to the account and copy the "Default public token" to the Mapbox API Key. | |||
Note that though they have a free tier, they may charge for over usage: https://www.mapbox.com/pricing/ | |||
''(If somebody went through the process for other API keys, please describe how to configure Pure Maps here.)'' | |||
== See also == | == See also == |
Revision as of 03:25, 9 November 2020
Pure Maps displays vector and raster maps, places, routes, and provides navigation instructions.
Installation
Pure Maps is available from postmarketOS' repository, and can as such be installed via:
# apk add pure-maps
Data providers
The displayed map data is fetched from a provider, which is usually converting data from OSM into a format suitable for map clients such as Pure Maps. As of writing, there is no default data provider configured when installing Pure Maps in postmarketOS. You must configure a provider to make the app useful.
Offline
The most privacy friendly way of using this application will be with the offline provider OSM Scout Server. See pmaports#575 for an effort to package it in postmarketOS. In an early test it was noted, that running Pure Maps with OSM Scout Server requires a rather high amount of RAM with 2 GB, but maybe this can be optimized.
Online
When using an online provider, Pure Maps must send queries for tiles, search, and routing to the map provider. Make sure that this is what you want, and that you are fine with the privacy implications.
Find a suitable provider and register a free (developer) API key if necessary. Then configure Pure Maps in postmarketOS to use it.
Mapbox API
Register an acocunt on Mapbox Go to the account and copy the "Default public token" to the Mapbox API Key. Note that though they have a free tier, they may charge for over usage: https://www.mapbox.com/pricing/
(If somebody went through the process for other API keys, please describe how to configure Pure Maps here.)
See also
- pmaports!593 initial merge request (with an interesting discussion with the lead developer about vendor lock-in)