https://github.com/Artsdatabanken/tiny-tileserver

A minimal http server with mbtiles (SQLite) raster and vector tiles support.
https://github.com/Artsdatabanken/tiny-tileserver

jpg mbtiles pbf png protobuf raster-tiles vector-tiles

Last synced: 4 months ago
JSON representation

A minimal http server with mbtiles (SQLite) raster and vector tiles support.

• Host: GitHub
• URL: https://github.com/Artsdatabanken/tiny-tileserver
• Owner: Artsdatabanken
• Created: 2018-09-14T10:43:20.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2023-02-11T15:37:54.000Z (over 2 years ago)
• Last Synced: 2024-10-28T04:24:22.844Z (9 months ago)
• Topics: jpg, mbtiles, pbf, png, protobuf, raster-tiles, vector-tiles
• Language: JavaScript
• Homepage: https://data.artsdatabanken.no/
• Size: 27.5 MB
• Stars: 18
• Watchers: 7
• Forks: 6
• Open Issues: 14
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# tiny-tileserver

[![Build Status](https://travis-ci.org/Artsdatabanken/tiny-tileserver.svg?branch=master)](https://travis-ci.org/Artsdatabanken/tiny-tileserver)

[![Coverage Status](https://coveralls.io/repos/github/Artsdatabanken/tiny-tileserver/badge.svg?branch=master)](https://coveralls.io/github/Artsdatabanken/tiny-tileserver?branch=master)

[![Open Source Love](https://badges.frapsoft.com/os/v2/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)

[![MIT Licence](https://badges.frapsoft.com/os/mit/mit.svg?v=103)](https://opensource.org/licenses/mit-license.php)

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md#pull-requests)

[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)

[![Screenshot](doc/screenshot.png "ratatouille screenshot")](https://maps.artsdatabanken.no)

Demo: [tiny-tileserver](https://maps.artsdatabanken.no)

tiny-tileserver is a minimal raster and vector tile server. It supports .mbtiles containing rasters of .png, .jpg and vector tiles in .pbf protobuf format.

## Features

- Supports thousands of tile sets

- Vector tiles (MBTiles)

  - Serve protobuf .pbf vector tiles

  - Compressed (deflate, gzip) or uncompressed tiles

  - Can convert to .geosjon

  - Return semi-raw protobuf as json (integer coordinates)

- Raster tiles (MBTiles)

  - Serve png or jpg raster tiles

- Static files

  - Can serve any other file statically

## Installation

Put one or more .mbtiles inside the data subfolder.

Execute:

```

yarn

yarn start

```

Navigate to http://localhost:8000/ to display a summary of the tile sets.

Tiles can be pulled using an url of this form: http://localhost:8000/{name}/{zoom}/{x}/{y}

## Configuration

Tiny-tileserver has command-line options:

```

Usage: node tiny-tileserver.js [options] [rootDirectory]

rootDirectory    Data directory containing .mbtiles

Options:

   -p PORT --port PORT       Set the HTTP port [8000]

A root directory is required.

```

## Images

The following images are built for each tiny-tileserver release, using the Node.js base image.

- Latest: https://hub.docker.com/r/artsdatabanken/tiny-tileserver/

### Docker image

To use prebuilt docker image, navigate to a folder containing .mbtile file(s) and run

```

docker run -v ${pwd}:/data -p 8000:8000 artsdatabanken/tiny-tileserver

```