Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/terrastories/default-offline-map
Open-license map tiles for using offline with Terrastories.
https://github.com/terrastories/default-offline-map
terrastories
Last synced: about 1 month ago
JSON representation
Open-license map tiles for using offline with Terrastories.
- Host: GitHub
- URL: https://github.com/terrastories/default-offline-map
- Owner: Terrastories
- License: other
- Created: 2022-05-04T21:11:21.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-01-15T21:34:27.000Z (11 months ago)
- Last Synced: 2024-01-16T03:08:08.350Z (11 months ago)
- Topics: terrastories
- Language: Dockerfile
- Homepage:
- Size: 8.11 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Terrastories Default Offline Map
This repository provides open-license offline map tiles (from OpenMapTiles) and accompanying style, font glyphs, and sprites to use with Terrastories using [TileserverGL](https://github.com/maptiler/tileserver-gl) by MapTiler.
## Usage
Map data provided here is free to use.
### Docker
The Docker image contains the default Terrastories map pre-bundled for use.
1. Pull Docker image
```
docker pull terrastories/terrastories-map
```
2. And run Tileserver
```
docker run --rm -it -p 8080:8080 terrastories/terrastories-map
```
Access Tileserver and Terrastories Map at localhost:8080.
#### Compose
Use the image in a Compose service:
```
services:
tiles:
image: terrastories/terrastories-map:latest
pull_policy: always
ports:
- 8080:8080
```
Run `docker compose up`.
Access Tileserver and Terrastories Map at localhost:8080.
### Manual
To use these offline tiles,
1. Download these files and place them in the Terrastories `tileserver/data/` directory.
2. The mbtiles file is too large to host on this repository. Instead, download the `tiles.mbtiles` file [here](https://bit.ly/39EdYoQ) and then place it in the `mbtiles/` directory.
The structure of the repo is set up to be used with [Tileserver-GL](https://github.com/maptiler/tileserver-gl) which is what serves locally hosted map tiles in Terrastories, but you can use map tiles with any other tileserver that uses the Mapbox style specification.
Note: the `bin/setup` script in Terrastories will download and place these files for you if you specify that you are building for offline, and you have not provided your own style and tiles.