https://github.com/technologiestiftung/qtrees-vectortiles

Vector Tiles Generator
https://github.com/technologiestiftung/qtrees-vectortiles

Last synced: 30 days ago
JSON representation

Vector Tiles Generator

• Host: GitHub
• URL: https://github.com/technologiestiftung/qtrees-vectortiles
• Owner: technologiestiftung
• License: mit
• Created: 2022-07-01T14:01:57.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-11-22T18:27:26.000Z (about 1 month ago)
• Last Synced: 2024-11-22T19:31:28.861Z (about 1 month ago)
• Language: HCL
• Size: 1.5 MB
• Stars: 3
• Watchers: 4
• Forks: 1
• Open Issues: 18
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
![](https://img.shields.io/badge/Built%20with%20%E2%9D%A4%EF%B8%8F-at%20Technologiestiftung%20Berlin-blue)

[![All Contributors](https://img.shields.io/badge/all_contributors-1-orange.svg?style=flat-square)](#contributors-)

> Note: This project is part of the [Baumblick](https://github.com/technologiestiftung/baumblick-frontend) application, which is in demo mode since 2024-07-01. The tileserver implemented in this repository is therefore shut down.

# QTrees Vector Tiles Generator

This project is a pipeline to generate vector tiles based on a PGSQL Database. It uses gdal, tippecanoe and mbtileserver to generate and serve vector tiles. It is a part of the QTrees.ai project.

The pipeline consist of three parts. The

1. The base image [Dockerfile.base](./Dockerfile.base) installs all the dependencies and tools needed to generate the vector tiles and serve them

2. The generator.sh step in a GitHub Action [generate.yml](./.github/workflows/generate.yml) generates the vector tiles and pushes them to a S3 bucket (uses the base image)

3. The tileserver hosted on render.com. [Dockerfile.server](./Dockerfile.server) builds a docker image that downloads the generated .pbf from AWS S3 and serves the vector tiles (uses the base image)

## Prerequisites

- Docker

- Postgres DB (also included in docker-compose.override.yml)

- render.com Account

- AWS S3 Bucket

## Usage and Development

Local development is hard when trying to build ci pipelines. Happens mostly in the cloud on GitHub Actions. You could try [nektos/act](https://github.com/nektos/act) to run this locally.

```bash

cd path/to/repo

docker compose up -d

```

## Tests

Currently the tests only check if the images can be built and if the `mbtileserver` can be started.

```bash

cd path/to/repo

docker-compose up -f docker-compose.yml -f docker-compose.test.yml

```

## Credits

  

    

      Made by 

        


        


        

      

    

    

      A project by 

        


        


        

      

    

    

      Supported by 

        


        


        

      

    

  

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

  

    
Fabian Morón Zirfas
💻 🎨 🤔 🚇 ⚠️

    
juan-carlos-tsb
💻 🎨 👀 🤔

  

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!