Compare commits
79 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
6e085af7cc | ||
|
|
345d96d5e6 | ||
|
|
f1c835c21d | ||
|
|
15ed6d74bf | ||
|
|
a3d8240aac | ||
|
|
098f057e55 | ||
|
|
18ba6f5059 | ||
|
|
820dbdd3dd | ||
|
|
acd7683f18 | ||
|
|
09859c10c1 | ||
|
|
f201deecdc | ||
|
|
b49521d2ed | ||
|
|
30c9bc8979 | ||
|
|
69340bbc83 | ||
|
|
ff9d5a8e5d | ||
|
|
23c2aa54d0 | ||
|
|
a8fd1b38b7 | ||
|
|
7c28bf2b21 | ||
|
|
f9f26f0d65 | ||
|
|
de60a0a076 | ||
|
|
90b9af3d95 | ||
|
|
78aea26318 | ||
|
|
292b1b6b44 | ||
|
|
de7f5f0366 | ||
|
|
161de17803 | ||
|
|
f9e5afbf49 | ||
|
|
513e2dac8f | ||
|
|
e428ab60f1 | ||
|
|
9d1a2bf995 | ||
|
|
bbda49589c | ||
|
|
a571d5f39b | ||
|
|
68d997a655 | ||
|
|
7d2f8ab062 | ||
|
|
4c2157842c | ||
|
|
25c87ccf23 | ||
|
|
97457a23f2 | ||
|
|
e9cad399c9 | ||
|
|
ee1cb21dfd | ||
|
|
f524f1465e | ||
|
|
1004f4cce1 | ||
|
|
b4d6490e00 | ||
|
|
3cf8ce9903 | ||
|
|
f21ee2691b | ||
|
|
845e31b3f2 | ||
|
|
c2a18d7329 | ||
|
|
d120b46966 | ||
|
|
afda5d00bc | ||
|
|
b3cb047d3d | ||
|
|
af47c9c23b | ||
|
|
2ab9d9e168 | ||
|
|
8a7f44d4c2 | ||
|
|
aa9a469bb4 | ||
|
|
53c1ef5786 | ||
|
|
8074cfb4c7 | ||
|
|
ffc72789ae | ||
|
|
4fc76251c3 | ||
|
|
b048990e14 | ||
|
|
b257855e38 | ||
|
|
fb758be730 | ||
|
|
7accdfa7da | ||
|
|
7efe22cf7f | ||
|
|
5a20bf4fac | ||
|
|
a0fbf7fb79 | ||
|
|
ed0af943da | ||
|
|
e4ce4877b6 | ||
|
|
a0a086e95a | ||
|
|
dbaca66b2c | ||
|
|
d465142275 | ||
|
|
7f06f09696 | ||
|
|
f5c5570fca | ||
|
|
cb10936a1d | ||
|
|
a43c96f6cc | ||
|
|
a310c130f3 | ||
|
|
14f406cc34 | ||
|
|
3c29cb0f65 | ||
|
|
d993c805fe | ||
|
|
6443ade489 | ||
|
|
eeb27ed481 | ||
|
|
15bc393aa8 |
4
.gitignore
vendored
@@ -1,3 +1,7 @@
|
|||||||
|
docs/_build
|
||||||
node_modules
|
node_modules
|
||||||
test_data
|
test_data
|
||||||
|
data
|
||||||
|
light
|
||||||
config.json
|
config.json
|
||||||
|
*.mbtiles
|
||||||
|
|||||||
@@ -15,7 +15,7 @@ before_install:
|
|||||||
- sudo apt-get install -qq xvfb
|
- sudo apt-get install -qq xvfb
|
||||||
install:
|
install:
|
||||||
- npm install
|
- npm install
|
||||||
- wget -O test_data.zip https://github.com/klokantech/tileserver-gl-data/archive/v0.0.3.zip
|
- wget -O test_data.zip https://github.com/klokantech/tileserver-gl-data/archive/v0.8.zip
|
||||||
- unzip -q test_data.zip -d tmp_test_data
|
- unzip -q test_data.zip -d tmp_test_data
|
||||||
- mkdir test_data
|
- mkdir test_data
|
||||||
- mv tmp_test_data/tileserver-gl-data-*/* -t test_data
|
- mv tmp_test_data/tileserver-gl-data-*/* -t test_data
|
||||||
|
|||||||
10
Dockerfile
@@ -3,13 +3,19 @@ MAINTAINER Petr Sloup <petr.sloup@klokantech.com>
|
|||||||
|
|
||||||
RUN apt-get -qq update \
|
RUN apt-get -qq update \
|
||||||
&& DEBIAN_FRONTEND=noninteractive apt-get -y install \
|
&& DEBIAN_FRONTEND=noninteractive apt-get -y install \
|
||||||
|
apt-transport-https \
|
||||||
curl \
|
curl \
|
||||||
|
unzip \
|
||||||
build-essential \
|
build-essential \
|
||||||
python \
|
python \
|
||||||
libcairo2-dev \
|
libcairo2-dev \
|
||||||
xvfb \
|
xvfb \
|
||||||
&& curl -sL https://deb.nodesource.com/setup_4.x | bash - \
|
&& echo "deb https://deb.nodesource.com/node_4.x jessie main" >> /etc/apt/sources.list.d/nodejs.list \
|
||||||
&& apt-get -y install nodejs \
|
&& echo "deb-src https://deb.nodesource.com/node_4.x jessie main" >> /etc/apt/sources.list.d/nodejs.list \
|
||||||
|
&& apt-get -qq update \
|
||||||
|
&& DEBIAN_FRONTEND=noninteractive apt-get -y --allow-unauthenticated install \
|
||||||
|
nodejs \
|
||||||
|
&& rm /etc/apt/sources.list.d/nodejs.list \
|
||||||
&& apt-get clean
|
&& apt-get clean
|
||||||
|
|
||||||
RUN mkdir -p /usr/src/app
|
RUN mkdir -p /usr/src/app
|
||||||
|
|||||||
6
PUBLISHING.md
Normal file
@@ -0,0 +1,6 @@
|
|||||||
|
# Publishing new version
|
||||||
|
|
||||||
|
- Update version in `package.json`
|
||||||
|
- `git tag vx.x.x`
|
||||||
|
- `git push --tags`
|
||||||
|
- `node publish.js` (publishes packages to npm)
|
||||||
75
README.md
@@ -1,59 +1,46 @@
|
|||||||
|

|
||||||
|
|
||||||
|
|
||||||
# TileServer GL
|
# TileServer GL
|
||||||
[](https://travis-ci.org/klokantech/tileserver-gl)
|
[](https://travis-ci.org/klokantech/tileserver-gl)
|
||||||
[](https://hub.docker.com/r/klokantech/tileserver-gl/)
|
[](https://hub.docker.com/r/klokantech/tileserver-gl/)
|
||||||
|
|
||||||
|
Vector and raster maps with GL styles. Server side rendering by Mapbox GL Native. Map tile server for Mapbox GL JS, Android, iOS, Leaflet, OpenLayers, GIS via WMTS, etc.
|
||||||
|
|
||||||
## Installation
|
## Get Started
|
||||||
|
|
||||||
### Docker
|
Install `tileserver-gl` with server-side raster rendering of vector tiles with npm
|
||||||
- `docker run -it -v $(pwd):/data -p 8080:80 klokantech/tileserver-gl`
|
|
||||||
|
|
||||||
### Without docker
|
```bash
|
||||||
- Make sure you have Node v4 or higher (`nvm install 4`)
|
npm install -g tileserver-gl
|
||||||
- `npm install`
|
```
|
||||||
- `node src/main.js`
|
|
||||||
|
|
||||||
## Sample data
|
Now download vector tiles from [OSM2VectorTiles](http://osm2vectortiles.org/downloads/).
|
||||||
Sample data can be downloaded at https://github.com/klokantech/tileserver-gl-data/archive/master.zip
|
|
||||||
|
|
||||||
#### Usage
|
```bash
|
||||||
- unpack somewhere and `cd` to the directory
|
curl -o zurich_switzerland.mbtiles https://osm2vectortiles-downloads.os.zhdk.cloud.switch.ch/v2.0/extracts/zurich_switzerland.mbtiles
|
||||||
- `docker run -it -v $(pwd):/data -p 8080:80 klokantech/tileserver-gl`
|
```
|
||||||
- (or `node path/to/repo/src/main.js`)
|
|
||||||
|
|
||||||
## Configuration
|
Start `tileserver-gl` with the downloaded vector tiles.
|
||||||
|
|
||||||
Create `config.json` file in the root directory.
|
```bash
|
||||||
The config file can contain definition of several paths where the tiles will be served.
|
tileserver-gl zurich_switzerland.mbtiles
|
||||||
|
```
|
||||||
|
|
||||||
### Example configuration file
|
Alternatively, you can use the `tileserver-gl-light` package instead, which is pure javascript (does not have any native dependencies) and can run anywhere, but does not contain rasterization on the server side made with MapBox GL Native.
|
||||||
See https://github.com/klokantech/tileserver-gl-data/blob/master/config.json
|
|
||||||
|
|
||||||
**Note**: To specify local mbtiles as source of the vector tiles inside the style, use urls with `mbtiles` protocol with path relative to the `cwd + options.paths.root + options.paths.mbtiles`. (For example `mbtiles://switzerland.mbtiles`)
|
## Using Docker
|
||||||
|
|
||||||
## Available URLs
|
An alternative to npm to start the packed software easier is to install [Docker](http://www.docker.com/) on your computer and then run in the directory with the downloaded MBTiles the command:
|
||||||
|
|
||||||
- If you visit the server on the configured port (default 8080) you should see your maps appearing in the browser.
|
```bash
|
||||||
- Style is served at `/styles/{id}.json` (+ array at `/styles.json`)
|
docker run -it -v $(pwd):/data -p 8080:80 klokantech/tileserver-gl
|
||||||
- Sprites at `/styles/{id}/sprite[@2x].{format}`
|
```
|
||||||
- Fonts at `/fonts/{fontstack}/{start}-{end}.pbf`
|
|
||||||
- Rendered tiles are at `/styles/{id}/rendered/{z}/{x}/{y}[@2x].{format}`
|
This will download and start a ready to use container on your computer and the maps are going to be available in webbrowser on localhost:8080.
|
||||||
- The optional `@2x` (or `@3x`) part can be used to render HiDPI (retina) tiles
|
|
||||||
- Available formats: `png`, `jpg` (`jpeg`), `webp`
|
On laptop you can use [Docker Kitematic](https://kitematic.com/) and search "tileserver-gl" and run it, then drop in the 'data' folder the MBTiles.
|
||||||
- TileJSON at `/styles/{id}/rendered.json`
|
|
||||||
- Static images are rendered at:
|
## Documentation
|
||||||
- `/styles/{id}/static/{lon},{lat},{zoom}[@{bearing}[,{pitch}]]/{width}x{height}[@2x].{format}` (center-based)
|
|
||||||
- `/styles/{id}/static/{minx},{miny},{maxx},{maxy}/{width}x{height}[@2x].{format}` (area-based)
|
You can read full documentation of this project at http://tileserver.readthedocs.io/.
|
||||||
- `/styles/{id}/static/auto/{width}x{height}[@2x].{format}` (autofit path -- see below)
|
|
||||||
- The static image endpoints additionally support following query parameters:
|
|
||||||
- `path` - comma-separated `lng,lat`, pipe-separated pairs
|
|
||||||
- e.g. `5.9,45.8|5.9,47.8|10.5,47.8|10.5,45.8|5.9,45.8`
|
|
||||||
- `latlng` - indicates the `path` coordinates are in `lat,lng` order rather than the usual `lng,lat`
|
|
||||||
- `fill` - color to use as the fill (e.g. `red`, `rgba(255,255,255,0.5)`, `#0000ff`)
|
|
||||||
- `stroke` - color of the path stroke
|
|
||||||
- `width` - width of the stroke
|
|
||||||
- `padding` - "percetange" padding for fitted endpoints (area-based and path autofit)
|
|
||||||
- value of `0.1` means "add 10% size to each side to make sure the area of interest is nicely visible"
|
|
||||||
- Source data at `/data/{mbtiles}/{z}/{x}/{y}.{format}`
|
|
||||||
- TileJSON at `/data/{mbtiles}.json`
|
|
||||||
- Array of all TileJSONs at `/index.json` (`/rendered.json`; `/data.json`)
|
|
||||||
|
|||||||
17
README_light.md
Normal file
@@ -0,0 +1,17 @@
|
|||||||
|
# TileServer GL light
|
||||||
|
[](https://travis-ci.org/klokantech/tileserver-gl)
|
||||||
|
[](https://hub.docker.com/r/klokantech/tileserver-gl/)
|
||||||
|
|
||||||
|
Vector maps with GL styles. Map tile server for Mapbox Android, iOS, GL JS, Leaflet, OpenLayers, etc. without server side rendering.
|
||||||
|
|
||||||
|
## Quickstart
|
||||||
|
Use `npm install -g tileserver-gl-light` to install the package from npm.
|
||||||
|
|
||||||
|
Then you can simply run `tileserver-gl-light zurich_switzerland.mbtiles` to start the server for the given mbtiles.
|
||||||
|
|
||||||
|
See also `tileserver-gl` which contains server side rendering.
|
||||||
|
|
||||||
|
Prepared vector tiles can be downloaded from [OSM2VectorTiles](http://osm2vectortiles.org/).
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
You can read full documentation of this project at http://tileserver.readthedocs.io/.
|
||||||
177
docs/Makefile
Normal file
@@ -0,0 +1,177 @@
|
|||||||
|
# Makefile for Sphinx documentation
|
||||||
|
#
|
||||||
|
|
||||||
|
# You can set these variables from the command line.
|
||||||
|
SPHINXOPTS =
|
||||||
|
SPHINXBUILD = sphinx-build
|
||||||
|
PAPER =
|
||||||
|
BUILDDIR = _build
|
||||||
|
|
||||||
|
# User-friendly check for sphinx-build
|
||||||
|
ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
|
||||||
|
$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
|
||||||
|
endif
|
||||||
|
|
||||||
|
# Internal variables.
|
||||||
|
PAPEROPT_a4 = -D latex_paper_size=a4
|
||||||
|
PAPEROPT_letter = -D latex_paper_size=letter
|
||||||
|
ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
|
||||||
|
# the i18n builder cannot share the environment and doctrees with the others
|
||||||
|
I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
|
||||||
|
|
||||||
|
.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
|
||||||
|
|
||||||
|
help:
|
||||||
|
@echo "Please use \`make <target>' where <target> is one of"
|
||||||
|
@echo " html to make standalone HTML files"
|
||||||
|
@echo " dirhtml to make HTML files named index.html in directories"
|
||||||
|
@echo " singlehtml to make a single large HTML file"
|
||||||
|
@echo " pickle to make pickle files"
|
||||||
|
@echo " json to make JSON files"
|
||||||
|
@echo " htmlhelp to make HTML files and a HTML help project"
|
||||||
|
@echo " qthelp to make HTML files and a qthelp project"
|
||||||
|
@echo " devhelp to make HTML files and a Devhelp project"
|
||||||
|
@echo " epub to make an epub"
|
||||||
|
@echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
|
||||||
|
@echo " latexpdf to make LaTeX files and run them through pdflatex"
|
||||||
|
@echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
|
||||||
|
@echo " text to make text files"
|
||||||
|
@echo " man to make manual pages"
|
||||||
|
@echo " texinfo to make Texinfo files"
|
||||||
|
@echo " info to make Texinfo files and run them through makeinfo"
|
||||||
|
@echo " gettext to make PO message catalogs"
|
||||||
|
@echo " changes to make an overview of all changed/added/deprecated items"
|
||||||
|
@echo " xml to make Docutils-native XML files"
|
||||||
|
@echo " pseudoxml to make pseudoxml-XML files for display purposes"
|
||||||
|
@echo " linkcheck to check all external links for integrity"
|
||||||
|
@echo " doctest to run all doctests embedded in the documentation (if enabled)"
|
||||||
|
|
||||||
|
clean:
|
||||||
|
rm -rf $(BUILDDIR)/*
|
||||||
|
|
||||||
|
html:
|
||||||
|
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
|
||||||
|
@echo
|
||||||
|
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
|
||||||
|
|
||||||
|
dirhtml:
|
||||||
|
$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
|
||||||
|
@echo
|
||||||
|
@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
|
||||||
|
|
||||||
|
singlehtml:
|
||||||
|
$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
|
||||||
|
@echo
|
||||||
|
@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
|
||||||
|
|
||||||
|
pickle:
|
||||||
|
$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
|
||||||
|
@echo
|
||||||
|
@echo "Build finished; now you can process the pickle files."
|
||||||
|
|
||||||
|
json:
|
||||||
|
$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
|
||||||
|
@echo
|
||||||
|
@echo "Build finished; now you can process the JSON files."
|
||||||
|
|
||||||
|
htmlhelp:
|
||||||
|
$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
|
||||||
|
@echo
|
||||||
|
@echo "Build finished; now you can run HTML Help Workshop with the" \
|
||||||
|
".hhp project file in $(BUILDDIR)/htmlhelp."
|
||||||
|
|
||||||
|
qthelp:
|
||||||
|
$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
|
||||||
|
@echo
|
||||||
|
@echo "Build finished; now you can run "qcollectiongenerator" with the" \
|
||||||
|
".qhcp project file in $(BUILDDIR)/qthelp, like this:"
|
||||||
|
@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/TileServerGL.qhcp"
|
||||||
|
@echo "To view the help file:"
|
||||||
|
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/TileServerGL.qhc"
|
||||||
|
|
||||||
|
devhelp:
|
||||||
|
$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
|
||||||
|
@echo
|
||||||
|
@echo "Build finished."
|
||||||
|
@echo "To view the help file:"
|
||||||
|
@echo "# mkdir -p $$HOME/.local/share/devhelp/TileServerGL"
|
||||||
|
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/TileServerGL"
|
||||||
|
@echo "# devhelp"
|
||||||
|
|
||||||
|
epub:
|
||||||
|
$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
|
||||||
|
@echo
|
||||||
|
@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
|
||||||
|
|
||||||
|
latex:
|
||||||
|
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
|
||||||
|
@echo
|
||||||
|
@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
|
||||||
|
@echo "Run \`make' in that directory to run these through (pdf)latex" \
|
||||||
|
"(use \`make latexpdf' here to do that automatically)."
|
||||||
|
|
||||||
|
latexpdf:
|
||||||
|
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
|
||||||
|
@echo "Running LaTeX files through pdflatex..."
|
||||||
|
$(MAKE) -C $(BUILDDIR)/latex all-pdf
|
||||||
|
@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
|
||||||
|
|
||||||
|
latexpdfja:
|
||||||
|
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
|
||||||
|
@echo "Running LaTeX files through platex and dvipdfmx..."
|
||||||
|
$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
|
||||||
|
@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
|
||||||
|
|
||||||
|
text:
|
||||||
|
$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
|
||||||
|
@echo
|
||||||
|
@echo "Build finished. The text files are in $(BUILDDIR)/text."
|
||||||
|
|
||||||
|
man:
|
||||||
|
$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
|
||||||
|
@echo
|
||||||
|
@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
|
||||||
|
|
||||||
|
texinfo:
|
||||||
|
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
|
||||||
|
@echo
|
||||||
|
@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
|
||||||
|
@echo "Run \`make' in that directory to run these through makeinfo" \
|
||||||
|
"(use \`make info' here to do that automatically)."
|
||||||
|
|
||||||
|
info:
|
||||||
|
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
|
||||||
|
@echo "Running Texinfo files through makeinfo..."
|
||||||
|
make -C $(BUILDDIR)/texinfo info
|
||||||
|
@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
|
||||||
|
|
||||||
|
gettext:
|
||||||
|
$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
|
||||||
|
@echo
|
||||||
|
@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
|
||||||
|
|
||||||
|
changes:
|
||||||
|
$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
|
||||||
|
@echo
|
||||||
|
@echo "The overview file is in $(BUILDDIR)/changes."
|
||||||
|
|
||||||
|
linkcheck:
|
||||||
|
$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
|
||||||
|
@echo
|
||||||
|
@echo "Link check complete; look for any errors in the above output " \
|
||||||
|
"or in $(BUILDDIR)/linkcheck/output.txt."
|
||||||
|
|
||||||
|
doctest:
|
||||||
|
$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
|
||||||
|
@echo "Testing of doctests in the sources finished, look at the " \
|
||||||
|
"results in $(BUILDDIR)/doctest/output.txt."
|
||||||
|
|
||||||
|
xml:
|
||||||
|
$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
|
||||||
|
@echo
|
||||||
|
@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
|
||||||
|
|
||||||
|
pseudoxml:
|
||||||
|
$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
|
||||||
|
@echo
|
||||||
|
@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
|
||||||
258
docs/conf.py
Normal file
@@ -0,0 +1,258 @@
|
|||||||
|
# -*- coding: utf-8 -*-
|
||||||
|
#
|
||||||
|
# TileServer GL documentation build configuration file, created by
|
||||||
|
# sphinx-quickstart on Thu Aug 4 23:48:49 2016.
|
||||||
|
#
|
||||||
|
# This file is execfile()d with the current directory set to its
|
||||||
|
# containing dir.
|
||||||
|
#
|
||||||
|
# Note that not all possible configuration values are present in this
|
||||||
|
# autogenerated file.
|
||||||
|
#
|
||||||
|
# All configuration values have a default; values that are commented out
|
||||||
|
# serve to show the default.
|
||||||
|
|
||||||
|
import sys
|
||||||
|
import os
|
||||||
|
|
||||||
|
# If extensions (or modules to document with autodoc) are in another directory,
|
||||||
|
# add these directories to sys.path here. If the directory is relative to the
|
||||||
|
# documentation root, use os.path.abspath to make it absolute, like shown here.
|
||||||
|
#sys.path.insert(0, os.path.abspath('.'))
|
||||||
|
|
||||||
|
# -- General configuration ------------------------------------------------
|
||||||
|
|
||||||
|
# If your documentation needs a minimal Sphinx version, state it here.
|
||||||
|
#needs_sphinx = '1.0'
|
||||||
|
|
||||||
|
# Add any Sphinx extension module names here, as strings. They can be
|
||||||
|
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
|
||||||
|
# ones.
|
||||||
|
extensions = []
|
||||||
|
|
||||||
|
# Add any paths that contain templates here, relative to this directory.
|
||||||
|
templates_path = ['_templates']
|
||||||
|
|
||||||
|
# The suffix of source filenames.
|
||||||
|
source_suffix = '.rst'
|
||||||
|
|
||||||
|
# The encoding of source files.
|
||||||
|
#source_encoding = 'utf-8-sig'
|
||||||
|
|
||||||
|
# The master toctree document.
|
||||||
|
master_doc = 'index'
|
||||||
|
|
||||||
|
# General information about the project.
|
||||||
|
project = u'TileServer GL'
|
||||||
|
copyright = u'2016, Klokan Technologies GmbH'
|
||||||
|
|
||||||
|
# The version info for the project you're documenting, acts as replacement for
|
||||||
|
# |version| and |release|, also used in various other places throughout the
|
||||||
|
# built documents.
|
||||||
|
#
|
||||||
|
# The short X.Y version.
|
||||||
|
version = '1'
|
||||||
|
# The full version, including alpha/beta/rc tags.
|
||||||
|
release = '1.0'
|
||||||
|
|
||||||
|
# The language for content autogenerated by Sphinx. Refer to documentation
|
||||||
|
# for a list of supported languages.
|
||||||
|
#language = None
|
||||||
|
|
||||||
|
# There are two options for replacing |today|: either, you set today to some
|
||||||
|
# non-false value, then it is used:
|
||||||
|
#today = ''
|
||||||
|
# Else, today_fmt is used as the format for a strftime call.
|
||||||
|
#today_fmt = '%B %d, %Y'
|
||||||
|
|
||||||
|
# List of patterns, relative to source directory, that match files and
|
||||||
|
# directories to ignore when looking for source files.
|
||||||
|
exclude_patterns = ['_build']
|
||||||
|
|
||||||
|
# The reST default role (used for this markup: `text`) to use for all
|
||||||
|
# documents.
|
||||||
|
#default_role = None
|
||||||
|
|
||||||
|
# If true, '()' will be appended to :func: etc. cross-reference text.
|
||||||
|
#add_function_parentheses = True
|
||||||
|
|
||||||
|
# If true, the current module name will be prepended to all description
|
||||||
|
# unit titles (such as .. function::).
|
||||||
|
#add_module_names = True
|
||||||
|
|
||||||
|
# If true, sectionauthor and moduleauthor directives will be shown in the
|
||||||
|
# output. They are ignored by default.
|
||||||
|
#show_authors = False
|
||||||
|
|
||||||
|
# The name of the Pygments (syntax highlighting) style to use.
|
||||||
|
pygments_style = 'sphinx'
|
||||||
|
|
||||||
|
# A list of ignored prefixes for module index sorting.
|
||||||
|
#modindex_common_prefix = []
|
||||||
|
|
||||||
|
# If true, keep warnings as "system message" paragraphs in the built documents.
|
||||||
|
#keep_warnings = False
|
||||||
|
|
||||||
|
|
||||||
|
# -- Options for HTML output ----------------------------------------------
|
||||||
|
|
||||||
|
# The theme to use for HTML and HTML Help pages. See the documentation for
|
||||||
|
# a list of builtin themes.
|
||||||
|
html_theme = 'default'
|
||||||
|
|
||||||
|
# Theme options are theme-specific and customize the look and feel of a theme
|
||||||
|
# further. For a list of options available for each theme, see the
|
||||||
|
# documentation.
|
||||||
|
#html_theme_options = {}
|
||||||
|
|
||||||
|
# Add any paths that contain custom themes here, relative to this directory.
|
||||||
|
#html_theme_path = []
|
||||||
|
|
||||||
|
# The name for this set of Sphinx documents. If None, it defaults to
|
||||||
|
# "<project> v<release> documentation".
|
||||||
|
#html_title = None
|
||||||
|
|
||||||
|
# A shorter title for the navigation bar. Default is the same as html_title.
|
||||||
|
#html_short_title = None
|
||||||
|
|
||||||
|
# The name of an image file (relative to this directory) to place at the top
|
||||||
|
# of the sidebar.
|
||||||
|
#html_logo = None
|
||||||
|
|
||||||
|
# The name of an image file (within the static path) to use as favicon of the
|
||||||
|
# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
|
||||||
|
# pixels large.
|
||||||
|
#html_favicon = None
|
||||||
|
|
||||||
|
# Add any paths that contain custom static files (such as style sheets) here,
|
||||||
|
# relative to this directory. They are copied after the builtin static files,
|
||||||
|
# so a file named "default.css" will overwrite the builtin "default.css".
|
||||||
|
html_static_path = ['_static']
|
||||||
|
|
||||||
|
# Add any extra paths that contain custom files (such as robots.txt or
|
||||||
|
# .htaccess) here, relative to this directory. These files are copied
|
||||||
|
# directly to the root of the documentation.
|
||||||
|
#html_extra_path = []
|
||||||
|
|
||||||
|
# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
|
||||||
|
# using the given strftime format.
|
||||||
|
#html_last_updated_fmt = '%b %d, %Y'
|
||||||
|
|
||||||
|
# If true, SmartyPants will be used to convert quotes and dashes to
|
||||||
|
# typographically correct entities.
|
||||||
|
#html_use_smartypants = True
|
||||||
|
|
||||||
|
# Custom sidebar templates, maps document names to template names.
|
||||||
|
#html_sidebars = {}
|
||||||
|
|
||||||
|
# Additional templates that should be rendered to pages, maps page names to
|
||||||
|
# template names.
|
||||||
|
#html_additional_pages = {}
|
||||||
|
|
||||||
|
# If false, no module index is generated.
|
||||||
|
#html_domain_indices = True
|
||||||
|
|
||||||
|
# If false, no index is generated.
|
||||||
|
#html_use_index = True
|
||||||
|
|
||||||
|
# If true, the index is split into individual pages for each letter.
|
||||||
|
#html_split_index = False
|
||||||
|
|
||||||
|
# If true, links to the reST sources are added to the pages.
|
||||||
|
#html_show_sourcelink = True
|
||||||
|
|
||||||
|
# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
|
||||||
|
#html_show_sphinx = True
|
||||||
|
|
||||||
|
# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
|
||||||
|
#html_show_copyright = True
|
||||||
|
|
||||||
|
# If true, an OpenSearch description file will be output, and all pages will
|
||||||
|
# contain a <link> tag referring to it. The value of this option must be the
|
||||||
|
# base URL from which the finished HTML is served.
|
||||||
|
#html_use_opensearch = ''
|
||||||
|
|
||||||
|
# This is the file name suffix for HTML files (e.g. ".xhtml").
|
||||||
|
#html_file_suffix = None
|
||||||
|
|
||||||
|
# Output file base name for HTML help builder.
|
||||||
|
htmlhelp_basename = 'TileServerGLdoc'
|
||||||
|
|
||||||
|
|
||||||
|
# -- Options for LaTeX output ---------------------------------------------
|
||||||
|
|
||||||
|
latex_elements = {
|
||||||
|
# The paper size ('letterpaper' or 'a4paper').
|
||||||
|
#'papersize': 'letterpaper',
|
||||||
|
|
||||||
|
# The font size ('10pt', '11pt' or '12pt').
|
||||||
|
#'pointsize': '10pt',
|
||||||
|
|
||||||
|
# Additional stuff for the LaTeX preamble.
|
||||||
|
#'preamble': '',
|
||||||
|
}
|
||||||
|
|
||||||
|
# Grouping the document tree into LaTeX files. List of tuples
|
||||||
|
# (source start file, target name, title,
|
||||||
|
# author, documentclass [howto, manual, or own class]).
|
||||||
|
latex_documents = [
|
||||||
|
('index', 'TileServerGL.tex', u'TileServer GL Documentation',
|
||||||
|
u'Klokan Technologies GmbH', 'manual'),
|
||||||
|
]
|
||||||
|
|
||||||
|
# The name of an image file (relative to this directory) to place at the top of
|
||||||
|
# the title page.
|
||||||
|
#latex_logo = None
|
||||||
|
|
||||||
|
# For "manual" documents, if this is true, then toplevel headings are parts,
|
||||||
|
# not chapters.
|
||||||
|
#latex_use_parts = False
|
||||||
|
|
||||||
|
# If true, show page references after internal links.
|
||||||
|
#latex_show_pagerefs = False
|
||||||
|
|
||||||
|
# If true, show URL addresses after external links.
|
||||||
|
#latex_show_urls = False
|
||||||
|
|
||||||
|
# Documents to append as an appendix to all manuals.
|
||||||
|
#latex_appendices = []
|
||||||
|
|
||||||
|
# If false, no module index is generated.
|
||||||
|
#latex_domain_indices = True
|
||||||
|
|
||||||
|
|
||||||
|
# -- Options for manual page output ---------------------------------------
|
||||||
|
|
||||||
|
# One entry per manual page. List of tuples
|
||||||
|
# (source start file, name, description, authors, manual section).
|
||||||
|
man_pages = [
|
||||||
|
('index', 'tileservergl', u'TileServer GL Documentation',
|
||||||
|
[u'Klokan Technologies GmbH'], 1)
|
||||||
|
]
|
||||||
|
|
||||||
|
# If true, show URL addresses after external links.
|
||||||
|
#man_show_urls = False
|
||||||
|
|
||||||
|
|
||||||
|
# -- Options for Texinfo output -------------------------------------------
|
||||||
|
|
||||||
|
# Grouping the document tree into Texinfo files. List of tuples
|
||||||
|
# (source start file, target name, title, author,
|
||||||
|
# dir menu entry, description, category)
|
||||||
|
texinfo_documents = [
|
||||||
|
('index', 'TileServerGL', u'TileServer GL Documentation',
|
||||||
|
u'Klokan Technologies GmbH', 'TileServerGL', 'One line description of project.',
|
||||||
|
'Miscellaneous'),
|
||||||
|
]
|
||||||
|
|
||||||
|
# Documents to append as an appendix to all manuals.
|
||||||
|
#texinfo_appendices = []
|
||||||
|
|
||||||
|
# If false, no module index is generated.
|
||||||
|
#texinfo_domain_indices = True
|
||||||
|
|
||||||
|
# How to display URL addresses: 'footnote', 'no', or 'inline'.
|
||||||
|
#texinfo_show_urls = 'footnote'
|
||||||
|
|
||||||
|
# If true, do not generate a @detailmenu in the "Top" node's menu.
|
||||||
|
#texinfo_no_detailmenu = False
|
||||||
121
docs/config.rst
Normal file
@@ -0,0 +1,121 @@
|
|||||||
|
==================
|
||||||
|
Configuration file
|
||||||
|
==================
|
||||||
|
|
||||||
|
The configuration file defines the behavior of the application. It's a regular JSON file.
|
||||||
|
|
||||||
|
Example::
|
||||||
|
|
||||||
|
{
|
||||||
|
"options": {
|
||||||
|
"paths": {
|
||||||
|
"root": "",
|
||||||
|
"fonts": "glyphs",
|
||||||
|
"sprites": "sprites",
|
||||||
|
"styles": "styles",
|
||||||
|
"mbtiles": ""
|
||||||
|
},
|
||||||
|
"domains": [
|
||||||
|
"localhost:8080",
|
||||||
|
"127.0.0.1:8080"
|
||||||
|
],
|
||||||
|
"formatQuality": {
|
||||||
|
"jpeg": 80,
|
||||||
|
"webp": 90,
|
||||||
|
"pngQuantization": false,
|
||||||
|
"png": 90
|
||||||
|
},
|
||||||
|
"maxSize": 2048
|
||||||
|
},
|
||||||
|
"styles": {
|
||||||
|
"basic": {
|
||||||
|
"style": "basic.json",
|
||||||
|
"tilejson": {
|
||||||
|
"type": "overlay",
|
||||||
|
"bounds": [8.44806, 47.32023, 8.62537, 47.43468]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"hybrid": {
|
||||||
|
"style": "satellite-hybrid.json",
|
||||||
|
"serve_rendered": false,
|
||||||
|
"tilejson": {
|
||||||
|
"format": "webp"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"data": {
|
||||||
|
"zurich-vector": {
|
||||||
|
"mbtiles": "zurich.mbtiles"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
``options``
|
||||||
|
===========
|
||||||
|
|
||||||
|
``paths``
|
||||||
|
---------
|
||||||
|
|
||||||
|
Defines where to look for the different types of input data.
|
||||||
|
|
||||||
|
The value of ``root`` is used as prefix for all data types.
|
||||||
|
|
||||||
|
``domains``
|
||||||
|
-----------
|
||||||
|
|
||||||
|
You can use this to optionally specify on what domains the rendered tiles are accessible. This can be used for basic load-balancing or to bypass browser's limit for the number of connections per domain.
|
||||||
|
|
||||||
|
``formatQuality``
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
Quality of the compression of individual image formats. [0-100]
|
||||||
|
|
||||||
|
The value for ``png`` is only used when ``pngQuantization`` is ``true``.
|
||||||
|
|
||||||
|
``maxSize``
|
||||||
|
-----------
|
||||||
|
|
||||||
|
Maximum image side length to be allowed to be rendered (including scale factor). Default is ``2048``.
|
||||||
|
|
||||||
|
``styles``
|
||||||
|
==========
|
||||||
|
|
||||||
|
Each item in this object defines one style (map). It can have the following options:
|
||||||
|
|
||||||
|
* ``style`` -- name of the style json file [required]
|
||||||
|
* ``serve_rendered`` -- whether to render the raster tiles for this style or not
|
||||||
|
* ``serve_data`` -- whether to allow acces to the original tiles, sprites and required glyphs
|
||||||
|
* ``tilejson`` -- properties to add to the TileJSON created for the raster data
|
||||||
|
|
||||||
|
* ``format`` and ``bounds`` can be especially useful
|
||||||
|
|
||||||
|
``data``
|
||||||
|
========
|
||||||
|
|
||||||
|
Each item specifies one data source which should be made accessible by the server. It has the following options:
|
||||||
|
|
||||||
|
* ``mbtiles`` -- name of the mbtiles file [required]
|
||||||
|
|
||||||
|
The mbtiles file does not need to be specified here unless you explicitly want to serve the raw data.
|
||||||
|
|
||||||
|
Referencing local mbtiles from style
|
||||||
|
====================================
|
||||||
|
|
||||||
|
You can link various data sources from the style JSON (for example even remote TileJSONs).
|
||||||
|
|
||||||
|
To specify that you want to use local mbtiles, use to following syntax: ``mbtiles://switzerland.mbtiles``.
|
||||||
|
The TileServer-GL will try to find the file ``switzerland.mbtiles`` in ``root`` + ``mbtiles`` path.
|
||||||
|
|
||||||
|
For example::
|
||||||
|
|
||||||
|
"sources": {
|
||||||
|
"source1": {
|
||||||
|
"url": "mbtiles://switzerland.mbtiles",
|
||||||
|
"type": "vector"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Alternatively, you can use ``mbtiles://{zurich-vector}`` to reference existing data object from the config.
|
||||||
|
In this case, the server will look into the ``config.json`` to determine what mbtiles file to use.
|
||||||
|
For the config above, this is equivalent to ``mbtiles://zurich.mbtiles``.
|
||||||
15
docs/deployment.rst
Normal file
@@ -0,0 +1,15 @@
|
|||||||
|
==========
|
||||||
|
Deployment
|
||||||
|
==========
|
||||||
|
|
||||||
|
Typically - you should use nginx/lighttpd/apache on the frontend - and the tileserver-gl server is hidden behind it in production deployment.
|
||||||
|
|
||||||
|
Caching
|
||||||
|
=======
|
||||||
|
|
||||||
|
There is a plenty of options you can use to create proper caching infrastructure: Varnish, CloudFlare, ...
|
||||||
|
|
||||||
|
Securing
|
||||||
|
========
|
||||||
|
|
||||||
|
Nginx can be used to add protection via https, password, referrer, IP address restriction, access keys, etc.
|
||||||
56
docs/endpoints.rst
Normal file
@@ -0,0 +1,56 @@
|
|||||||
|
===================
|
||||||
|
Available endpoints
|
||||||
|
===================
|
||||||
|
|
||||||
|
If you visit the server on the configured port (default 8080) you can see your maps appearing in the browser.
|
||||||
|
|
||||||
|
Styles
|
||||||
|
======
|
||||||
|
* Styles are served at ``/styles/{id}.json`` (+ array at ``/styles.json``)
|
||||||
|
|
||||||
|
* Sprites at ``/styles/{id}/sprite[@2x].{format}``
|
||||||
|
* Fonts at ``/fonts/{fontstack}/{start}-{end}.pbf``
|
||||||
|
|
||||||
|
Rendered tiles
|
||||||
|
==============
|
||||||
|
* Rendered tiles are served at ``/styles/{id}/rendered/{z}/{x}/{y}[@2x].{format}``
|
||||||
|
|
||||||
|
* The optional ``@2x`` (or ``@3x``, ``@4x``) part can be used to render HiDPI (retina) tiles
|
||||||
|
* Available formats: ``png``, ``jpg`` (``jpeg``), ``webp``
|
||||||
|
* TileJSON at ``/styles/{id}/rendered.json``
|
||||||
|
|
||||||
|
* The rendered tiles are not available in the ``tileserver-gl-light`` version.
|
||||||
|
|
||||||
|
Static images
|
||||||
|
=============
|
||||||
|
* Several endpoints:
|
||||||
|
|
||||||
|
* ``/styles/{id}/static/{lon},{lat},{zoom}[@{bearing}[,{pitch}]]/{width}x{height}[@2x].{format}`` (center-based)
|
||||||
|
* ``/styles/{id}/static/{minx},{miny},{maxx},{maxy}/{width}x{height}[@2x].{format}`` (area-based)
|
||||||
|
* ``/styles/{id}/static/auto/{width}x{height}[@2x].{format}`` (autofit path -- see below)
|
||||||
|
|
||||||
|
* All the static image endpoints additionally support following query parameters:
|
||||||
|
|
||||||
|
* ``path`` - comma-separated ``lng,lat``, pipe-separated pairs
|
||||||
|
|
||||||
|
* e.g. ``5.9,45.8|5.9,47.8|10.5,47.8|10.5,45.8|5.9,45.8``
|
||||||
|
|
||||||
|
* ``latlng`` - indicates the ``path`` coordinates are in ``lat,lng`` order rather than the usual ``lng,lat``
|
||||||
|
* ``fill`` - color to use as the fill (e.g. ``red``, ``rgba(255,255,255,0.5)``, ``#0000ff``)
|
||||||
|
* ``stroke`` - color of the path stroke
|
||||||
|
* ``width`` - width of the stroke
|
||||||
|
* ``padding`` - "percetange" padding for fitted endpoints (area-based and path autofit)
|
||||||
|
|
||||||
|
* value of ``0.1`` means "add 10% size to each side to make sure the area of interest is nicely visible"
|
||||||
|
|
||||||
|
* The static images are not available in the ``tileserver-gl-light`` version.
|
||||||
|
|
||||||
|
Source data
|
||||||
|
===========
|
||||||
|
* Source data are served at ``/data/{mbtiles}/{z}/{x}/{y}.{format}``
|
||||||
|
|
||||||
|
* TileJSON at ``/data/{mbtiles}.json``
|
||||||
|
|
||||||
|
TileJSON arrays
|
||||||
|
===============
|
||||||
|
Array of all TileJSONs is at ``/index.json`` (``/rendered.json``; ``/data.json``)
|
||||||
28
docs/index.rst
Normal file
@@ -0,0 +1,28 @@
|
|||||||
|
.. TileServer GL documentation master file, created by
|
||||||
|
sphinx-quickstart on Thu Aug 4 23:48:49 2016.
|
||||||
|
You can adapt this file completely to your liking, but it should at least
|
||||||
|
contain the root `toctree` directive.
|
||||||
|
|
||||||
|
Welcome to TileServer GL's documentation!
|
||||||
|
=========================================
|
||||||
|
|
||||||
|
Contents:
|
||||||
|
|
||||||
|
.. toctree::
|
||||||
|
:maxdepth: 2
|
||||||
|
|
||||||
|
installation
|
||||||
|
usage
|
||||||
|
config
|
||||||
|
deployment
|
||||||
|
endpoints
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Indices and tables
|
||||||
|
==================
|
||||||
|
|
||||||
|
* :ref:`genindex`
|
||||||
|
* :ref:`modindex`
|
||||||
|
* :ref:`search`
|
||||||
|
|
||||||
37
docs/installation.rst
Normal file
@@ -0,0 +1,37 @@
|
|||||||
|
============
|
||||||
|
Installation
|
||||||
|
============
|
||||||
|
|
||||||
|
Docker
|
||||||
|
======
|
||||||
|
|
||||||
|
When running docker image, no special installation is needed -- the docker will automatically download the image if not present.
|
||||||
|
|
||||||
|
Just run ``docker run -it -v $(pwd):/data -p 8080:80 klokantech/tileserver-gl``.
|
||||||
|
|
||||||
|
npm
|
||||||
|
===
|
||||||
|
|
||||||
|
Just run ``npm install -g tileserver-gl``.
|
||||||
|
|
||||||
|
``tileserver-gl-light`` on npm
|
||||||
|
==============================
|
||||||
|
|
||||||
|
Alternatively, you can use ``tileserver-gl-light`` package instead, which is pure javascript (does not have any native dependencies) and can run anywhere, but does not contain rasterization features.
|
||||||
|
|
||||||
|
|
||||||
|
From source
|
||||||
|
===========
|
||||||
|
|
||||||
|
Make sure you have Node v4 or higher (nvm install 4) and run::
|
||||||
|
|
||||||
|
npm install
|
||||||
|
node .
|
||||||
|
|
||||||
|
|
||||||
|
On OSX
|
||||||
|
======
|
||||||
|
|
||||||
|
Make sure to have ``pkg-config`` and ``cairo`` installed::
|
||||||
|
|
||||||
|
brew install pkg-config cairo
|
||||||
28
docs/usage.rst
Normal file
@@ -0,0 +1,28 @@
|
|||||||
|
=====
|
||||||
|
Usage
|
||||||
|
=====
|
||||||
|
|
||||||
|
Getting started
|
||||||
|
======
|
||||||
|
|
||||||
|
::
|
||||||
|
|
||||||
|
Usage: tileserver-gl [mbtiles] [options]
|
||||||
|
|
||||||
|
mbtiles MBTiles file (uses demo configuration);
|
||||||
|
ignored if the configuration file is also specified
|
||||||
|
|
||||||
|
Options:
|
||||||
|
-c, --config Configuration file [config.json]
|
||||||
|
-b, --bind Bind address
|
||||||
|
-p, --port Port [8080]
|
||||||
|
-V, --verbose More verbose output
|
||||||
|
-v, --version Version info
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Default styles and configuration
|
||||||
|
======
|
||||||
|
|
||||||
|
- If no configuration file is specified, the default styles (compatible with osm2vectortiles) are used.
|
||||||
|
- If no mbtiles file is specified (and is not found in the current working directory), an extract is downloaded directly from osm2vectortiles.
|
||||||
25
package.json
@@ -1,8 +1,9 @@
|
|||||||
{
|
{
|
||||||
"name": "tileserver-gl",
|
"name": "tileserver-gl",
|
||||||
"version": "0.6.0",
|
"version": "1.1.5",
|
||||||
"description": "Map tile server for JSON GL styles - serverside generated raster tiles",
|
"description": "Map tile server for JSON GL styles - vector and server side generated raster tiles",
|
||||||
"main": "src/main.js",
|
"main": "src/main.js",
|
||||||
|
"bin": "src/main.js",
|
||||||
"authors": [
|
"authors": [
|
||||||
"Petr Sloup <petr.sloup@klokantech.com>"
|
"Petr Sloup <petr.sloup@klokantech.com>"
|
||||||
],
|
],
|
||||||
@@ -15,24 +16,28 @@
|
|||||||
"test": "mocha test/**.js"
|
"test": "mocha test/**.js"
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"async": "1.5.2",
|
"async": "2.0.1",
|
||||||
"advanced-pool": "0.3.2",
|
"advanced-pool": "0.3.2",
|
||||||
"canvas": "1.4.0",
|
"base64url": "2.0.0",
|
||||||
|
"canvas": "1.5.0",
|
||||||
"clone": "1.0.2",
|
"clone": "1.0.2",
|
||||||
"color": "0.11.3",
|
"color": "0.11.3",
|
||||||
"cors": "2.7.1",
|
"cors": "2.8.1",
|
||||||
"express": "4.14.0",
|
"express": "4.14.0",
|
||||||
|
"glyph-pbf-composite": "0.0.2",
|
||||||
"handlebars": "4.0.5",
|
"handlebars": "4.0.5",
|
||||||
"mapbox-gl-native": "3.2.1",
|
"mapbox-gl-native": "3.3.3",
|
||||||
"mbtiles": "0.9.0",
|
"mbtiles": "0.9.0",
|
||||||
"morgan": "1.7.0",
|
"morgan": "1.7.0",
|
||||||
|
"node-pngquant-native": "1.0.4",
|
||||||
"nomnom": "1.8.1",
|
"nomnom": "1.8.1",
|
||||||
"request": "2.72.0",
|
"request": "2.75.0",
|
||||||
"sharp": "0.15.0",
|
"sharp": "0.16.0",
|
||||||
"sphericalmercator": "1.0.5"
|
"sphericalmercator": "1.0.5",
|
||||||
|
"tileserver-gl-styles": "0.3.0"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"should": "^9.0.0",
|
"should": "^10.0.0",
|
||||||
"mocha": "^2.5.0",
|
"mocha": "^2.5.0",
|
||||||
"supertest": "^1.2.0"
|
"supertest": "^1.2.0"
|
||||||
}
|
}
|
||||||
|
|||||||
|
Before Width: | Height: | Size: 1.1 KiB After Width: | Height: | Size: 5.3 KiB |
BIN
public/resources/fonts/OpenSans-Bold.ttf
Normal file
BIN
public/resources/fonts/OpenSans-Italic.ttf
Normal file
BIN
public/resources/fonts/OpenSans-Regular.ttf
Normal file
BIN
public/resources/images/header-map-1280px.png
Normal file
|
After Width: | Height: | Size: 171 KiB |
BIN
public/resources/images/header-map-1600px.png
Normal file
|
After Width: | Height: | Size: 250 KiB |
BIN
public/resources/images/header-map-2560px.png
Normal file
|
After Width: | Height: | Size: 530 KiB |
BIN
public/resources/images/header-map-640px.png
Normal file
|
After Width: | Height: | Size: 48 KiB |
BIN
public/resources/images/klokantech.png
Normal file
|
After Width: | Height: | Size: 2.6 KiB |
BIN
public/resources/images/logo.png
Normal file
|
After Width: | Height: | Size: 6.3 KiB |
BIN
public/resources/images/placeholder.png
Normal file
|
After Width: | Height: | Size: 2.0 KiB |
@@ -229,6 +229,13 @@
|
|||||||
border-bottom-right-radius: 0;
|
border-bottom-right-radius: 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
.mapboxgl-marker {
|
||||||
|
position: absolute;
|
||||||
|
top: 0;
|
||||||
|
left: 0;
|
||||||
|
will-change: transform;
|
||||||
|
}
|
||||||
|
|
||||||
.mapboxgl-crosshair,
|
.mapboxgl-crosshair,
|
||||||
.mapboxgl-crosshair .mapboxgl-interactive,
|
.mapboxgl-crosshair .mapboxgl-interactive,
|
||||||
.mapboxgl-crosshair .mapboxgl-interactive:active {
|
.mapboxgl-crosshair .mapboxgl-interactive:active {
|
||||||
|
|||||||
@@ -2,6 +2,7 @@
|
|||||||
<html>
|
<html>
|
||||||
<head>
|
<head>
|
||||||
<meta charset="UTF-8">
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||||
<title>{{name}} - TileServer GL</title>
|
<title>{{name}} - TileServer GL</title>
|
||||||
{{#is_vector}}
|
{{#is_vector}}
|
||||||
<link rel="stylesheet" type="text/css" href="/mapbox-gl.css{{&key_query}}" />
|
<link rel="stylesheet" type="text/css" href="/mapbox-gl.css{{&key_query}}" />
|
||||||
@@ -123,6 +124,10 @@
|
|||||||
<div id='map'></div>
|
<div id='map'></div>
|
||||||
<script>
|
<script>
|
||||||
var map = L.mapbox.map('map', '/data/{{id}}.json{{&key_query}}', { zoomControl: false });
|
var map = L.mapbox.map('map', '/data/{{id}}.json{{&key_query}}', { zoomControl: false });
|
||||||
|
map.eachLayer(function(layer) {
|
||||||
|
// do not add scale prefix even if retina display is detected
|
||||||
|
layer.scalePrefix = '.';
|
||||||
|
});
|
||||||
new L.Control.Zoom({ position: 'topright' }).addTo(map);
|
new L.Control.Zoom({ position: 'topright' }).addTo(map);
|
||||||
setTimeout(function() {
|
setTimeout(function() {
|
||||||
new L.Hash(map);
|
new L.Hash(map);
|
||||||
|
|||||||
@@ -2,6 +2,7 @@
|
|||||||
<html>
|
<html>
|
||||||
<head>
|
<head>
|
||||||
<meta charset="UTF-8">
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||||
<title>{{name}} - TileServer GL</title>
|
<title>{{name}} - TileServer GL</title>
|
||||||
<link rel="stylesheet" type="text/css" href="/mapbox-gl.css{{&key_query}}" />
|
<link rel="stylesheet" type="text/css" href="/mapbox-gl.css{{&key_query}}" />
|
||||||
<script src="/mapbox-gl.js{{&key_query}}"></script>
|
<script src="/mapbox-gl.js{{&key_query}}"></script>
|
||||||
|
|||||||
45
publish.js
Normal file
@@ -0,0 +1,45 @@
|
|||||||
|
#!/usr/bin/env node
|
||||||
|
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
/*
|
||||||
|
* This script creates `tileserver-gl-light` version
|
||||||
|
* (without native dependencies) and publishes
|
||||||
|
* `tileserver-gl` and `tileserver-gl-light` to npm.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/* CREATE tileserver-gl-light */
|
||||||
|
|
||||||
|
// SYNC THE `light` FOLDER
|
||||||
|
require('child_process').execSync('rsync -av --exclude="light" --exclude=".git" --exclude="node_modules" --delete . light', {
|
||||||
|
stdio: 'inherit'
|
||||||
|
});
|
||||||
|
|
||||||
|
// PATCH `package.json`
|
||||||
|
var fs = require('fs');
|
||||||
|
var packageJson = require('./package');
|
||||||
|
|
||||||
|
packageJson.name += '-light';
|
||||||
|
packageJson.description = 'Map tile server for JSON GL styles - serving vector tiles';
|
||||||
|
delete packageJson.dependencies['canvas'];
|
||||||
|
delete packageJson.dependencies['mapbox-gl-native'];
|
||||||
|
delete packageJson.dependencies['node-pngquant-native'];
|
||||||
|
delete packageJson.dependencies['sharp'];
|
||||||
|
|
||||||
|
delete packageJson.devDependencies;
|
||||||
|
|
||||||
|
var str = JSON.stringify(packageJson, undefined, 2);
|
||||||
|
fs.writeFileSync('light/package.json', str);
|
||||||
|
fs.renameSync('light/README_light.md', 'light/README.md');
|
||||||
|
|
||||||
|
/* PUBLISH */
|
||||||
|
|
||||||
|
// tileserver-gl
|
||||||
|
require('child_process').execSync('npm publish .', {
|
||||||
|
stdio: 'inherit'
|
||||||
|
});
|
||||||
|
|
||||||
|
// tileserver-gl-light
|
||||||
|
require('child_process').execSync('npm publish light', {
|
||||||
|
stdio: 'inherit'
|
||||||
|
});
|
||||||
3
run.sh
@@ -1,2 +1,3 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
xvfb-run -a -e /dev/stdout --server-args="-screen 0 1024x768x24" node /usr/src/app/src/main.js -p 80 -c /data/config.json
|
cd /data
|
||||||
|
xvfb-run -a -e /dev/stdout --server-args="-screen 0 1024x768x24" node /usr/src/app/ -p 80
|
||||||
|
|||||||
145
src/main.js
@@ -2,27 +2,166 @@
|
|||||||
|
|
||||||
'use strict';
|
'use strict';
|
||||||
|
|
||||||
|
var fs = require('fs'),
|
||||||
|
path = require('path'),
|
||||||
|
request = require('request');
|
||||||
|
|
||||||
|
var mbtiles = require('mbtiles');
|
||||||
|
|
||||||
|
var packageJson = require('../package');
|
||||||
|
|
||||||
var opts = require('nomnom')
|
var opts = require('nomnom')
|
||||||
|
.option('mbtiles', {
|
||||||
|
default: undefined,
|
||||||
|
help: 'MBTiles file (uses demo configuration);\n' +
|
||||||
|
'\t ignored if the configuration file is also specified',
|
||||||
|
position: 0
|
||||||
|
})
|
||||||
.option('config', {
|
.option('config', {
|
||||||
abbr: 'c',
|
abbr: 'c',
|
||||||
default: 'config.json',
|
default: 'config.json',
|
||||||
help: 'Configuration file'
|
help: 'Configuration file'
|
||||||
})
|
})
|
||||||
|
.option('bind', {
|
||||||
|
abbr: 'b',
|
||||||
|
default: undefined,
|
||||||
|
help: 'Bind address'
|
||||||
|
})
|
||||||
.option('port', {
|
.option('port', {
|
||||||
abbr: 'p',
|
abbr: 'p',
|
||||||
default: 8080,
|
default: 8080,
|
||||||
help: 'Port'
|
help: 'Port'
|
||||||
})
|
})
|
||||||
|
.option('verbose', {
|
||||||
|
abbr: 'V',
|
||||||
|
flag: true,
|
||||||
|
help: 'More verbose output'
|
||||||
|
})
|
||||||
.option('version', {
|
.option('version', {
|
||||||
abbr: 'v',
|
abbr: 'v',
|
||||||
flag: true,
|
flag: true,
|
||||||
help: 'Version info',
|
help: 'Version info',
|
||||||
callback: function() {
|
callback: function() {
|
||||||
return 'version ' + require('../package.json').version;
|
return packageJson.name + ' v' + packageJson.version;
|
||||||
}
|
}
|
||||||
}).parse();
|
}).parse();
|
||||||
|
|
||||||
return require('./server')({
|
|
||||||
config: opts.config,
|
console.log('Starting ' + packageJson.name + ' v' + packageJson.version);
|
||||||
|
|
||||||
|
var startServer = function(configPath, config) {
|
||||||
|
return require('./server')({
|
||||||
|
configPath: configPath,
|
||||||
|
config: config,
|
||||||
|
bind: opts.bind,
|
||||||
port: opts.port
|
port: opts.port
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
var startWithMBTiles = function(mbtilesFile) {
|
||||||
|
console.log('Automatically creating config file for ' + mbtilesFile);
|
||||||
|
|
||||||
|
mbtilesFile = path.resolve(process.cwd(), mbtilesFile);
|
||||||
|
|
||||||
|
var mbtilesStats = fs.statSync(mbtilesFile);
|
||||||
|
if (!mbtilesStats.isFile() || mbtilesStats.size === 0) {
|
||||||
|
console.log('ERROR: Not valid MBTiles file: ' + mbtilesFile);
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
|
var instance = new mbtiles(mbtilesFile, function(err) {
|
||||||
|
instance.getInfo(function(err, info) {
|
||||||
|
var bounds = info.bounds;
|
||||||
|
|
||||||
|
var styleDir = path.resolve(__dirname, "../node_modules/tileserver-gl-styles/");
|
||||||
|
|
||||||
|
var config = {
|
||||||
|
"options": {
|
||||||
|
"paths": {
|
||||||
|
"root": styleDir,
|
||||||
|
"fonts": "glyphs",
|
||||||
|
"sprites": "sprites",
|
||||||
|
"styles": "styles",
|
||||||
|
"mbtiles": path.dirname(mbtilesFile)
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"styles": {},
|
||||||
|
"data": {}
|
||||||
|
};
|
||||||
|
|
||||||
|
if (info.format == 'pbf' &&
|
||||||
|
info.name.toLowerCase().indexOf('osm2vectortiles') > -1) {
|
||||||
|
config['data']['osm2vectortiles'] = {
|
||||||
|
"mbtiles": path.basename(mbtilesFile)
|
||||||
|
};
|
||||||
|
|
||||||
|
var styles = fs.readdirSync(path.resolve(styleDir, 'styles'));
|
||||||
|
for (var i = 0; i < styles.length; i++) {
|
||||||
|
var styleFilename = styles[i];
|
||||||
|
if (styleFilename.endsWith('.json')) {
|
||||||
|
var styleObject = {
|
||||||
|
"style": path.basename(styleFilename),
|
||||||
|
"tilejson": {
|
||||||
|
"bounds": bounds
|
||||||
|
}
|
||||||
|
};
|
||||||
|
config['styles'][path.basename(styleFilename, '.json')] =
|
||||||
|
styleObject;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
console.log('WARN: MBTiles not in "osm2vectortiles" format. ' +
|
||||||
|
'Serving raw data only...');
|
||||||
|
config['data'][info.id || 'mbtiles'] = {
|
||||||
|
"mbtiles": path.basename(mbtilesFile)
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
if (opts.verbose) {
|
||||||
|
console.log(JSON.stringify(config, undefined, 2));
|
||||||
|
} else {
|
||||||
|
console.log('Run with --verbose to see the config file here.');
|
||||||
|
}
|
||||||
|
|
||||||
|
return startServer(null, config);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
fs.stat(path.resolve(opts.config), function(err, stats) {
|
||||||
|
if (err || !stats.isFile() || stats.size === 0) {
|
||||||
|
var mbtiles = opts.mbtiles;
|
||||||
|
if (!mbtiles) {
|
||||||
|
// try to find in the cwd
|
||||||
|
var files = fs.readdirSync(process.cwd());
|
||||||
|
for (var i=0; i < files.length; i++) {
|
||||||
|
var filename = files[i];
|
||||||
|
if (filename.endsWith('.mbtiles')) {
|
||||||
|
var mbTilesStats = fs.statSync(filename);
|
||||||
|
if (mbTilesStats.isFile() && mbTilesStats.size > 0) {
|
||||||
|
mbtiles = filename;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (mbtiles) {
|
||||||
|
console.log('No MBTiles specified, using ' + mbtiles);
|
||||||
|
return startWithMBTiles(mbtiles);
|
||||||
|
} else {
|
||||||
|
var url = 'https://github.com/klokantech/tileserver-gl-styles/releases/download/v0.3.0/zurich_switzerland.mbtiles';
|
||||||
|
var filename = 'zurich_switzerland.mbtiles';
|
||||||
|
var stream = fs.createWriteStream(filename);
|
||||||
|
console.log('Downloading sample data (' + filename + ') from ' + url);
|
||||||
|
stream.on('finish', function() {
|
||||||
|
return startWithMBTiles(filename);
|
||||||
|
});
|
||||||
|
return request.get(url).pipe(stream);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (mbtiles) {
|
||||||
|
return startWithMBTiles(mbtiles);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
console.log('Using specified config file from ' + opts.config);
|
||||||
|
return startServer(opts.config, null);
|
||||||
|
}
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
'use strict';
|
'use strict';
|
||||||
|
|
||||||
var crypto = require('crypto'),
|
var fs = require('fs'),
|
||||||
fs = require('fs'),
|
|
||||||
path = require('path');
|
path = require('path');
|
||||||
|
|
||||||
var clone = require('clone'),
|
var clone = require('clone'),
|
||||||
@@ -13,13 +12,17 @@ var utils = require('./utils');
|
|||||||
module.exports = function(options, repo, params, id) {
|
module.exports = function(options, repo, params, id) {
|
||||||
var app = express().disable('x-powered-by');
|
var app = express().disable('x-powered-by');
|
||||||
|
|
||||||
var mbtilesFile = path.join(options.paths.mbtiles, params.mbtiles);
|
var mbtilesFile = path.resolve(options.paths.mbtiles, params.mbtiles);
|
||||||
var tileJSON = {
|
var tileJSON = {
|
||||||
'tiles': params.domains || options.domains
|
'tiles': params.domains || options.domains
|
||||||
};
|
};
|
||||||
|
|
||||||
repo[id] = tileJSON;
|
repo[id] = tileJSON;
|
||||||
|
|
||||||
|
var mbtilesFileStats = fs.statSync(mbtilesFile);
|
||||||
|
if (!mbtilesFileStats.isFile() || mbtilesFileStats.size == 0) {
|
||||||
|
throw Error('Not valid MBTiles file: ' + mbtilesFile);
|
||||||
|
}
|
||||||
var source = new mbtiles(mbtilesFile, function(err) {
|
var source = new mbtiles(mbtilesFile, function(err) {
|
||||||
source.getInfo(function(err, info) {
|
source.getInfo(function(err, info) {
|
||||||
tileJSON['name'] = id;
|
tileJSON['name'] = id;
|
||||||
@@ -29,7 +32,7 @@ module.exports = function(options, repo, params, id) {
|
|||||||
|
|
||||||
tileJSON['tilejson'] = '2.0.0';
|
tileJSON['tilejson'] = '2.0.0';
|
||||||
tileJSON['basename'] = id;
|
tileJSON['basename'] = id;
|
||||||
tileJSON['filesize'] = fs.statSync(mbtilesFile)['size'];
|
tileJSON['filesize'] = mbtilesFileStats['size'];
|
||||||
delete tileJSON['scheme'];
|
delete tileJSON['scheme'];
|
||||||
|
|
||||||
Object.assign(tileJSON, params.tilejson || {});
|
Object.assign(tileJSON, params.tilejson || {});
|
||||||
@@ -59,12 +62,11 @@ module.exports = function(options, repo, params, id) {
|
|||||||
return res.status(500).send(err.message);
|
return res.status(500).send(err.message);
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
var md5 = crypto.createHash('md5').update(data).digest('base64');
|
|
||||||
headers['content-md5'] = md5;
|
|
||||||
if (tileJSON['format'] == 'pbf') {
|
if (tileJSON['format'] == 'pbf') {
|
||||||
headers['content-type'] = 'application/x-protobuf';
|
headers['Content-Type'] = 'application/x-protobuf';
|
||||||
headers['content-encoding'] = 'gzip';
|
headers['Content-Encoding'] = 'gzip';
|
||||||
}
|
}
|
||||||
|
delete headers['ETag']; // do not trust the tile ETag -- regenerate
|
||||||
res.set(headers);
|
res.set(headers);
|
||||||
|
|
||||||
if (data == null) {
|
if (data == null) {
|
||||||
|
|||||||
@@ -1,56 +1,29 @@
|
|||||||
'use strict';
|
'use strict';
|
||||||
|
|
||||||
var async = require('async'),
|
|
||||||
path = require('path'),
|
|
||||||
fs = require('fs');
|
|
||||||
|
|
||||||
var clone = require('clone'),
|
var clone = require('clone'),
|
||||||
express = require('express');
|
express = require('express');
|
||||||
|
|
||||||
|
var utils = require('./utils');
|
||||||
|
|
||||||
module.exports = function(options, allowedFonts) {
|
module.exports = function(options, allowedFonts) {
|
||||||
var app = express().disable('x-powered-by');
|
var app = express().disable('x-powered-by');
|
||||||
|
|
||||||
var fontPath = options.paths.fonts;
|
var lastModified = new Date().toUTCString();
|
||||||
|
|
||||||
var getFontPbf = function(name, range, callback) {
|
var fontPath = options.paths.fonts;
|
||||||
// if some of the files failed to load (does not exist or not allowed),
|
|
||||||
// return empty buffer so the other fonts can still work
|
|
||||||
if (allowedFonts[name]) {
|
|
||||||
var filename = path.join(fontPath, name, range + '.pbf');
|
|
||||||
return fs.readFile(filename, function(err, data) {
|
|
||||||
if (err) {
|
|
||||||
console.log('Font load error:', filename);
|
|
||||||
return callback(null, new Buffer([]));
|
|
||||||
} else {
|
|
||||||
return callback(null, data);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
} else {
|
|
||||||
return callback(null, new Buffer([]));
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
app.get('/:fontstack/:range([\\d]+-[\\d]+).pbf',
|
app.get('/:fontstack/:range([\\d]+-[\\d]+).pbf',
|
||||||
function(req, res, next) {
|
function(req, res, next) {
|
||||||
var fontstack = decodeURI(req.params.fontstack);
|
var fontstack = decodeURI(req.params.fontstack);
|
||||||
var range = req.params.range;
|
var range = req.params.range;
|
||||||
|
|
||||||
var fonts = fontstack.split(',');
|
return utils.getFontsPbf(allowedFonts, fontPath, fontstack, range,
|
||||||
|
function(err, concated) {
|
||||||
var queue = [];
|
if (err || concated.length === 0) {
|
||||||
fonts.forEach(function(font) {
|
|
||||||
queue.push(function(callback) {
|
|
||||||
getFontPbf(font, range, callback);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
return async.parallel(queue, function(err, results) {
|
|
||||||
var concated = Buffer.concat(results);
|
|
||||||
if (err || concated.length == 0) {
|
|
||||||
return res.status(400).send('');
|
return res.status(400).send('');
|
||||||
} else {
|
} else {
|
||||||
res.header('Content-type', 'application/x-protobuf');
|
res.header('Content-type', 'application/x-protobuf');
|
||||||
|
res.header('Last-Modified', lastModified);
|
||||||
return res.send(concated);
|
return res.send(concated);
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -2,7 +2,6 @@
|
|||||||
|
|
||||||
var async = require('async'),
|
var async = require('async'),
|
||||||
advancedPool = require('advanced-pool'),
|
advancedPool = require('advanced-pool'),
|
||||||
crypto = require('crypto'),
|
|
||||||
fs = require('fs'),
|
fs = require('fs'),
|
||||||
path = require('path'),
|
path = require('path'),
|
||||||
util = require('util'),
|
util = require('util'),
|
||||||
@@ -19,12 +18,13 @@ var Canvas = require('canvas'),
|
|||||||
mercator = new (require('sphericalmercator'))(),
|
mercator = new (require('sphericalmercator'))(),
|
||||||
mbgl = require('mapbox-gl-native'),
|
mbgl = require('mapbox-gl-native'),
|
||||||
mbtiles = require('mbtiles'),
|
mbtiles = require('mbtiles'),
|
||||||
|
pngquant = require('node-pngquant-native'),
|
||||||
request = require('request');
|
request = require('request');
|
||||||
|
|
||||||
var utils = require('./utils');
|
var utils = require('./utils');
|
||||||
|
|
||||||
var FLOAT_PATTERN = '[+-]?(?:\\d+|\\d+\.?\\d+)';
|
var FLOAT_PATTERN = '[+-]?(?:\\d+|\\d+\.?\\d+)';
|
||||||
var SCALE_PATTERN = '@[23]x';
|
var SCALE_PATTERN = '@[234]x';
|
||||||
|
|
||||||
var getScale = function(scale) {
|
var getScale = function(scale) {
|
||||||
return (scale || '@1x').slice(1, 2) | 0;
|
return (scale || '@1x').slice(1, 2) | 0;
|
||||||
@@ -36,9 +36,11 @@ mbgl.on('message', function(e) {
|
|||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
module.exports = function(options, repo, params, id) {
|
module.exports = function(options, repo, params, id, dataResolver) {
|
||||||
var app = express().disable('x-powered-by');
|
var app = express().disable('x-powered-by');
|
||||||
|
|
||||||
|
var lastModified = new Date().toUTCString();
|
||||||
|
|
||||||
var rootPath = options.paths.root;
|
var rootPath = options.paths.root;
|
||||||
|
|
||||||
var styleFile = params.style;
|
var styleFile = params.style;
|
||||||
@@ -55,12 +57,20 @@ module.exports = function(options, repo, params, id) {
|
|||||||
request: function(req, callback) {
|
request: function(req, callback) {
|
||||||
var protocol = req.url.split(':')[0];
|
var protocol = req.url.split(':')[0];
|
||||||
//console.log('Handling request:', req);
|
//console.log('Handling request:', req);
|
||||||
if (protocol == 'sprites' || protocol == 'fonts') {
|
if (protocol == 'sprites') {
|
||||||
var dir = options.paths[protocol];
|
var dir = options.paths[protocol];
|
||||||
var file = unescape(req.url).substring(protocol.length + 3);
|
var file = unescape(req.url).substring(protocol.length + 3);
|
||||||
fs.readFile(path.join(dir, file), function(err, data) {
|
fs.readFile(path.join(dir, file), function(err, data) {
|
||||||
callback(err, { data: data });
|
callback(err, { data: data });
|
||||||
});
|
});
|
||||||
|
} else if (protocol == 'fonts') {
|
||||||
|
var parts = req.url.split('/');
|
||||||
|
var fontstack = unescape(parts[2]);
|
||||||
|
var range = parts[3].split('.')[0];
|
||||||
|
utils.getFontsPbf(null, options.paths[protocol], fontstack, range,
|
||||||
|
function(err, concated) {
|
||||||
|
callback(err, {data: concated});
|
||||||
|
});
|
||||||
} else if (protocol == 'mbtiles') {
|
} else if (protocol == 'mbtiles') {
|
||||||
var parts = req.url.split('/');
|
var parts = req.url.split('/');
|
||||||
var source = map.sources[parts[2]];
|
var source = map.sources[parts[2]];
|
||||||
@@ -78,9 +88,6 @@ module.exports = function(options, repo, params, id) {
|
|||||||
if (headers['Last-Modified']) {
|
if (headers['Last-Modified']) {
|
||||||
response.modified = new Date(headers['Last-Modified']);
|
response.modified = new Date(headers['Last-Modified']);
|
||||||
}
|
}
|
||||||
if (headers['ETag']) {
|
|
||||||
response.etag = headers['ETag'];
|
|
||||||
}
|
|
||||||
|
|
||||||
if (format == 'pbf') {
|
if (format == 'pbf') {
|
||||||
response.data = zlib.unzipSync(data);
|
response.data = zlib.unzipSync(data);
|
||||||
@@ -161,14 +168,31 @@ module.exports = function(options, repo, params, id) {
|
|||||||
Object.keys(styleJSON.sources).forEach(function(name) {
|
Object.keys(styleJSON.sources).forEach(function(name) {
|
||||||
var source = styleJSON.sources[name];
|
var source = styleJSON.sources[name];
|
||||||
var url = source.url;
|
var url = source.url;
|
||||||
|
|
||||||
if (url.lastIndexOf('mbtiles:', 0) === 0) {
|
if (url.lastIndexOf('mbtiles:', 0) === 0) {
|
||||||
// found mbtiles source, replace with info from local file
|
// found mbtiles source, replace with info from local file
|
||||||
delete source.url;
|
delete source.url;
|
||||||
|
|
||||||
queue.push(function(callback) {
|
|
||||||
var mbtilesFile = url.substring('mbtiles://'.length);
|
var mbtilesFile = url.substring('mbtiles://'.length);
|
||||||
map.sources[name] = new mbtiles(
|
var fromData = mbtilesFile[0] == '{' &&
|
||||||
path.join(options.paths.mbtiles, mbtilesFile), function(err) {
|
mbtilesFile[mbtilesFile.length - 1] == '}';
|
||||||
|
|
||||||
|
if (fromData) {
|
||||||
|
mbtilesFile = dataResolver(
|
||||||
|
mbtilesFile.substr(1, mbtilesFile.length - 2));
|
||||||
|
if (!mbtilesFile) {
|
||||||
|
console.log('ERROR: data "' + mbtilesFile + '" not found!');
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
queue.push(function(callback) {
|
||||||
|
mbtilesFile = path.resolve(options.paths.mbtiles, mbtilesFile);
|
||||||
|
var mbtilesFileStats = fs.statSync(mbtilesFile);
|
||||||
|
if (!mbtilesFileStats.isFile() || mbtilesFileStats.size == 0) {
|
||||||
|
throw Error('Not valid MBTiles file: ' + mbtilesFile);
|
||||||
|
}
|
||||||
|
map.sources[name] = new mbtiles(mbtilesFile, function(err) {
|
||||||
map.sources[name].getInfo(function(err, info) {
|
map.sources[name].getInfo(function(err, info) {
|
||||||
var type = source.type;
|
var type = source.type;
|
||||||
Object.assign(source, info);
|
Object.assign(source, info);
|
||||||
@@ -178,6 +202,7 @@ module.exports = function(options, repo, params, id) {
|
|||||||
// meta url which will be detected when requested
|
// meta url which will be detected when requested
|
||||||
'mbtiles://' + name + '/{z}/{x}/{y}.' + (info.format || 'pbf')
|
'mbtiles://' + name + '/{z}/{x}/{y}.' + (info.format || 'pbf')
|
||||||
];
|
];
|
||||||
|
delete source.scheme;
|
||||||
if (source.format == 'pbf') {
|
if (source.format == 'pbf') {
|
||||||
map.sources[name].emptyTile = new Buffer(0);
|
map.sources[name].emptyTile = new Buffer(0);
|
||||||
} else {
|
} else {
|
||||||
@@ -215,6 +240,7 @@ module.exports = function(options, repo, params, id) {
|
|||||||
map.renderers[1] = createPool(1, 4, 16);
|
map.renderers[1] = createPool(1, 4, 16);
|
||||||
map.renderers[2] = createPool(2, 2, 8);
|
map.renderers[2] = createPool(2, 2, 8);
|
||||||
map.renderers[3] = createPool(3, 2, 4);
|
map.renderers[3] = createPool(3, 2, 4);
|
||||||
|
map.renderers[4] = createPool(4, 2, 4);
|
||||||
});
|
});
|
||||||
|
|
||||||
repo[id] = tileJSON;
|
repo[id] = tileJSON;
|
||||||
@@ -229,7 +255,7 @@ module.exports = function(options, repo, params, id) {
|
|||||||
return res.status(400).send('Invalid center');
|
return res.status(400).send('Invalid center');
|
||||||
}
|
}
|
||||||
if (Math.min(width, height) <= 0 ||
|
if (Math.min(width, height) <= 0 ||
|
||||||
Math.max(width, height) * scale > 2048) {
|
Math.max(width, height) * scale > (options.maxSize || 2048)) {
|
||||||
return res.status(400).send('Invalid size');
|
return res.status(400).send('Invalid size');
|
||||||
}
|
}
|
||||||
if (format == 'png' || format == 'webp') {
|
if (format == 'png' || format == 'webp') {
|
||||||
@@ -277,25 +303,33 @@ module.exports = function(options, repo, params, id) {
|
|||||||
|
|
||||||
image.toFormat(format);
|
image.toFormat(format);
|
||||||
|
|
||||||
var formatEncoding = (params.formatEncoding || {})[format] ||
|
var formatQuality = (params.formatQuality || {})[format] ||
|
||||||
(options.formatEncoding || {})[format];
|
(options.formatQuality || {})[format];
|
||||||
if (format == 'png') {
|
if (format == 'png') {
|
||||||
image.compressionLevel(formatEncoding || 6)
|
image.withoutAdaptiveFiltering();
|
||||||
.withoutAdaptiveFiltering();
|
|
||||||
} else if (format == 'jpeg') {
|
} else if (format == 'jpeg') {
|
||||||
image.quality(formatEncoding || 80);
|
image.quality(formatQuality || 80);
|
||||||
} else if (format == 'webp') {
|
} else if (format == 'webp') {
|
||||||
image.quality(formatEncoding || 90);
|
image.quality(formatQuality || 90);
|
||||||
}
|
}
|
||||||
image.toBuffer(function(err, buffer, info) {
|
image.toBuffer(function(err, buffer, info) {
|
||||||
if (!buffer) {
|
if (!buffer) {
|
||||||
return res.status(404).send('Not found');
|
return res.status(404).send('Not found');
|
||||||
}
|
}
|
||||||
|
|
||||||
var md5 = crypto.createHash('md5').update(buffer).digest('base64');
|
if (format == 'png') {
|
||||||
|
var usePngQuant =
|
||||||
|
(options.formatQuality || {}).pngQuantization === true;
|
||||||
|
if (usePngQuant) {
|
||||||
|
buffer = pngquant.compress(buffer, {
|
||||||
|
quality: [0, formatQuality || 90]
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
res.set({
|
res.set({
|
||||||
'content-md5': md5,
|
'Last-Modified': lastModified,
|
||||||
'content-type': 'image/' + format
|
'Content-Type': 'image/' + format
|
||||||
});
|
});
|
||||||
return res.status(200).send(buffer);
|
return res.status(200).send(buffer);
|
||||||
});
|
});
|
||||||
@@ -304,6 +338,13 @@ module.exports = function(options, repo, params, id) {
|
|||||||
};
|
};
|
||||||
|
|
||||||
app.get(tilePattern, function(req, res, next) {
|
app.get(tilePattern, function(req, res, next) {
|
||||||
|
var modifiedSince = req.get('if-modified-since'), cc = req.get('cache-control');
|
||||||
|
if (modifiedSince && (!cc || cc.indexOf('no-cache') == -1)) {
|
||||||
|
if (new Date(lastModified) <= new Date(modifiedSince)) {
|
||||||
|
return res.sendStatus(304);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
var z = req.params.z | 0,
|
var z = req.params.z | 0,
|
||||||
x = req.params.x | 0,
|
x = req.params.x | 0,
|
||||||
y = req.params.y | 0,
|
y = req.params.y | 0,
|
||||||
@@ -391,14 +432,15 @@ module.exports = function(options, repo, params, id) {
|
|||||||
|
|
||||||
var minCorner = mercator.px([bbox[0], bbox[3]], z),
|
var minCorner = mercator.px([bbox[0], bbox[3]], z),
|
||||||
maxCorner = mercator.px([bbox[2], bbox[1]], z);
|
maxCorner = mercator.px([bbox[2], bbox[1]], z);
|
||||||
while ((((maxCorner[0] - minCorner[0]) * (1 + 2 * padding) > w) ||
|
var w_ = w / (1 + 2 * padding);
|
||||||
((maxCorner[1] - minCorner[1]) * (1 + 2 * padding) > h)) && z > 0) {
|
var h_ = h / (1 + 2 * padding);
|
||||||
z--;
|
|
||||||
minCorner[0] /= 2;
|
z -= Math.max(
|
||||||
minCorner[1] /= 2;
|
Math.log((maxCorner[0] - minCorner[0]) / w_),
|
||||||
maxCorner[0] /= 2;
|
Math.log((maxCorner[1] - minCorner[1]) / h_)
|
||||||
maxCorner[1] /= 2;
|
) / Math.LN2;
|
||||||
}
|
|
||||||
|
z = Math.max(Math.log(Math.max(w, h) / 256) / Math.LN2, Math.min(25, z));
|
||||||
|
|
||||||
return z;
|
return z;
|
||||||
};
|
};
|
||||||
@@ -408,11 +450,12 @@ module.exports = function(options, repo, params, id) {
|
|||||||
':scale(' + SCALE_PATTERN + ')?\.:format([\\w]+)';
|
':scale(' + SCALE_PATTERN + ')?\.:format([\\w]+)';
|
||||||
|
|
||||||
var centerPattern =
|
var centerPattern =
|
||||||
util.format(':lon(%s),:lat(%s),:z(\\d+)(@:bearing(%s)(,:pitch(%s))?)?',
|
util.format(':lon(%s),:lat(%s),:z(%s)(@:bearing(%s)(,:pitch(%s))?)?',
|
||||||
FLOAT_PATTERN, FLOAT_PATTERN, FLOAT_PATTERN, FLOAT_PATTERN);
|
FLOAT_PATTERN, FLOAT_PATTERN, FLOAT_PATTERN,
|
||||||
|
FLOAT_PATTERN, FLOAT_PATTERN);
|
||||||
|
|
||||||
app.get(util.format(staticPattern, centerPattern), function(req, res, next) {
|
app.get(util.format(staticPattern, centerPattern), function(req, res, next) {
|
||||||
var z = req.params.z | 0,
|
var z = +req.params.z,
|
||||||
x = +req.params.lon,
|
x = +req.params.lon,
|
||||||
y = +req.params.lat,
|
y = +req.params.lat,
|
||||||
bearing = +(req.params.bearing || '0'),
|
bearing = +(req.params.bearing || '0'),
|
||||||
@@ -422,6 +465,10 @@ module.exports = function(options, repo, params, id) {
|
|||||||
scale = getScale(req.params.scale),
|
scale = getScale(req.params.scale),
|
||||||
format = req.params.format;
|
format = req.params.format;
|
||||||
|
|
||||||
|
if (z < 0) {
|
||||||
|
return res.status(404).send('Invalid zoom');
|
||||||
|
}
|
||||||
|
|
||||||
var path = extractPathFromQuery(req.query);
|
var path = extractPathFromQuery(req.query);
|
||||||
var overlay = renderOverlay(z, x, y, bearing, pitch, w, h, scale,
|
var overlay = renderOverlay(z, x, y, bearing, pitch, w, h, scale,
|
||||||
path, req.query);
|
path, req.query);
|
||||||
|
|||||||
@@ -17,8 +17,14 @@ module.exports = function(options, repo, params, id, reportTiles, reportFont) {
|
|||||||
var source = styleJSON.sources[name];
|
var source = styleJSON.sources[name];
|
||||||
var url = source.url;
|
var url = source.url;
|
||||||
if (url.lastIndexOf('mbtiles:', 0) === 0) {
|
if (url.lastIndexOf('mbtiles:', 0) === 0) {
|
||||||
var mbtiles = url.substring('mbtiles://'.length);
|
var mbtilesFile = url.substring('mbtiles://'.length);
|
||||||
var identifier = reportTiles(mbtiles);
|
var fromData = mbtilesFile[0] == '{' &&
|
||||||
|
mbtilesFile[mbtilesFile.length - 1] == '}';
|
||||||
|
|
||||||
|
if (fromData) {
|
||||||
|
mbtilesFile = mbtilesFile.substr(1, mbtilesFile.length - 2);
|
||||||
|
}
|
||||||
|
var identifier = reportTiles(mbtilesFile, fromData);
|
||||||
source.url = 'local://data/' + identifier + '.json';
|
source.url = 'local://data/' + identifier + '.json';
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -7,20 +7,30 @@ process.env.UV_THREADPOOL_SIZE =
|
|||||||
var fs = require('fs'),
|
var fs = require('fs'),
|
||||||
path = require('path');
|
path = require('path');
|
||||||
|
|
||||||
var clone = require('clone'),
|
var base64url = require('base64url'),
|
||||||
|
clone = require('clone'),
|
||||||
cors = require('cors'),
|
cors = require('cors'),
|
||||||
express = require('express'),
|
express = require('express'),
|
||||||
handlebars = require('handlebars'),
|
handlebars = require('handlebars'),
|
||||||
mercator = new (require('sphericalmercator'))(),
|
mercator = new (require('sphericalmercator'))(),
|
||||||
morgan = require('morgan');
|
morgan = require('morgan');
|
||||||
|
|
||||||
var serve_font = require('./serve_font'),
|
var packageJson = require('../package'),
|
||||||
serve_rendered = require('./serve_rendered'),
|
serve_font = require('./serve_font'),
|
||||||
|
serve_rendered = null,
|
||||||
serve_style = require('./serve_style'),
|
serve_style = require('./serve_style'),
|
||||||
serve_data = require('./serve_data'),
|
serve_data = require('./serve_data'),
|
||||||
utils = require('./utils');
|
utils = require('./utils');
|
||||||
|
|
||||||
|
var isLight = packageJson.name.slice(-6) == '-light';
|
||||||
|
if (!isLight) {
|
||||||
|
// do not require `serve_rendered` in the light package
|
||||||
|
serve_rendered = require('./serve_rendered');
|
||||||
|
}
|
||||||
|
|
||||||
module.exports = function(opts, callback) {
|
module.exports = function(opts, callback) {
|
||||||
|
console.log('Starting server');
|
||||||
|
|
||||||
var app = express().disable('x-powered-by'),
|
var app = express().disable('x-powered-by'),
|
||||||
serving = {
|
serving = {
|
||||||
styles: {},
|
styles: {},
|
||||||
@@ -41,9 +51,10 @@ module.exports = function(opts, callback) {
|
|||||||
app.use(morgan('dev'));
|
app.use(morgan('dev'));
|
||||||
}
|
}
|
||||||
|
|
||||||
var configPath = path.resolve(opts.config);
|
var config = opts.config || null;
|
||||||
|
var configPath = null;
|
||||||
var config;
|
if (opts.configPath) {
|
||||||
|
configPath = path.resolve(opts.configPath);
|
||||||
try {
|
try {
|
||||||
config = clone(require(configPath));
|
config = clone(require(configPath));
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
@@ -51,11 +62,18 @@ module.exports = function(opts, callback) {
|
|||||||
console.log(' See README.md for instructions and sample data.');
|
console.log(' See README.md for instructions and sample data.');
|
||||||
process.exit(1);
|
process.exit(1);
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
if (!config) {
|
||||||
|
console.log('ERROR: No config file not specified!');
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
|
|
||||||
var options = config.options || {};
|
var options = config.options || {};
|
||||||
var paths = options.paths || {};
|
var paths = options.paths || {};
|
||||||
options.paths = paths;
|
options.paths = paths;
|
||||||
paths.root = path.resolve(process.cwd(), paths.root || '');
|
paths.root = path.resolve(
|
||||||
|
configPath ? path.dirname(configPath) : process.cwd(),
|
||||||
|
paths.root || '');
|
||||||
paths.styles = path.resolve(paths.root, paths.styles || '');
|
paths.styles = path.resolve(paths.root, paths.styles || '');
|
||||||
paths.fonts = path.resolve(paths.root, paths.fonts || '');
|
paths.fonts = path.resolve(paths.root, paths.fonts || '');
|
||||||
paths.sprites = path.resolve(paths.root, paths.sprites || '');
|
paths.sprites = path.resolve(paths.root, paths.sprites || '');
|
||||||
@@ -74,15 +92,24 @@ module.exports = function(opts, callback) {
|
|||||||
|
|
||||||
if (item.serve_data !== false) {
|
if (item.serve_data !== false) {
|
||||||
app.use('/styles/', serve_style(options, serving.styles, item, id,
|
app.use('/styles/', serve_style(options, serving.styles, item, id,
|
||||||
function(mbtiles) {
|
function(mbtiles, fromData) {
|
||||||
var dataItemId;
|
var dataItemId;
|
||||||
Object.keys(data).forEach(function(id) {
|
Object.keys(data).forEach(function(id) {
|
||||||
|
if (fromData) {
|
||||||
|
if (id == mbtiles) {
|
||||||
|
dataItemId = id;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
if (data[id].mbtiles == mbtiles) {
|
if (data[id].mbtiles == mbtiles) {
|
||||||
dataItemId = id;
|
dataItemId = id;
|
||||||
}
|
}
|
||||||
|
}
|
||||||
});
|
});
|
||||||
if (dataItemId) { // mbtiles exist in the data config
|
if (dataItemId) { // mbtiles exist in the data config
|
||||||
return dataItemId;
|
return dataItemId;
|
||||||
|
} else if (fromData) {
|
||||||
|
console.log('ERROR: data "' + mbtiles + '" not found!');
|
||||||
|
process.exit(1);
|
||||||
} else {
|
} else {
|
||||||
var id = mbtiles.substr(0, mbtiles.lastIndexOf('.')) || mbtiles;
|
var id = mbtiles.substr(0, mbtiles.lastIndexOf('.')) || mbtiles;
|
||||||
while (data[id]) id += '_';
|
while (data[id]) id += '_';
|
||||||
@@ -96,8 +123,21 @@ module.exports = function(opts, callback) {
|
|||||||
}));
|
}));
|
||||||
}
|
}
|
||||||
if (item.serve_rendered !== false) {
|
if (item.serve_rendered !== false) {
|
||||||
|
if (serve_rendered) {
|
||||||
app.use('/styles/' + id + '/',
|
app.use('/styles/' + id + '/',
|
||||||
serve_rendered(options, serving.rendered, item, id));
|
serve_rendered(options, serving.rendered, item, id,
|
||||||
|
function(mbtiles) {
|
||||||
|
var mbtilesFile;
|
||||||
|
Object.keys(data).forEach(function(id) {
|
||||||
|
if (id == mbtiles) {
|
||||||
|
mbtilesFile = data[id].mbtiles;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
return mbtilesFile;
|
||||||
|
}));
|
||||||
|
} else {
|
||||||
|
item.serve_rendered = false;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
@@ -172,6 +212,8 @@ module.exports = function(opts, callback) {
|
|||||||
return res.status(404).send('Not found');
|
return res.status(404).send('Not found');
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
data['server_version'] = packageJson.name + ' v' + packageJson.version;
|
||||||
|
data['is_light'] = isLight;
|
||||||
data['key_query_part'] =
|
data['key_query_part'] =
|
||||||
req.query.key ? 'key=' + req.query.key + '&' : '';
|
req.query.key ? 'key=' + req.query.key + '&' : '';
|
||||||
data['key_query'] = req.query.key ? '?key=' + req.query.key : '';
|
data['key_query'] = req.query.key ? '?key=' + req.query.key : '';
|
||||||
@@ -201,10 +243,14 @@ module.exports = function(opts, callback) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
var query = req.query.key ? ('?key=' + req.query.key) : '';
|
var query = req.query.key ? ('?key=' + req.query.key) : '';
|
||||||
style.wmts_link = 'https://wmts.maptiler.com/' +
|
style.wmts_link = 'http://wmts.maptiler.com/' +
|
||||||
new Buffer(req.protocol + '://' + req.headers.host +
|
base64url('http://' + req.headers.host +
|
||||||
'/styles/' + id + '/rendered.json' + query).toString('base64') +
|
'/styles/' + id + '/rendered.json' + query) + '/wmts';
|
||||||
'/wmts';
|
|
||||||
|
var tiles = utils.getTileUrls(
|
||||||
|
req, style.serving_rendered.tiles,
|
||||||
|
'styles/' + id + '/rendered', style.serving_rendered.format);
|
||||||
|
style.xyz_link = tiles[0];
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
var data = clone(serving.data || {});
|
var data = clone(serving.data || {});
|
||||||
@@ -227,8 +273,12 @@ module.exports = function(opts, callback) {
|
|||||||
|
|
||||||
var query = req.query.key ? ('?key=' + req.query.key) : '';
|
var query = req.query.key ? ('?key=' + req.query.key) : '';
|
||||||
data_.wmts_link = 'http://wmts.maptiler.com/' +
|
data_.wmts_link = 'http://wmts.maptiler.com/' +
|
||||||
new Buffer('http://' + req.headers.host +
|
base64url('http://' + req.headers.host +
|
||||||
'/data/' + id + '.json' + query).toString('base64') + '/wmts';
|
'/data/' + id + '.json' + query) + '/wmts';
|
||||||
|
|
||||||
|
var tiles = utils.getTileUrls(
|
||||||
|
req, data_.tiles, 'data/' + id, data_.format);
|
||||||
|
data_.xyz_link = tiles[0];
|
||||||
}
|
}
|
||||||
if (data_.filesize) {
|
if (data_.filesize) {
|
||||||
var suffix = 'kB';
|
var suffix = 'kB';
|
||||||
@@ -280,7 +330,7 @@ module.exports = function(opts, callback) {
|
|||||||
return data;
|
return data;
|
||||||
});
|
});
|
||||||
|
|
||||||
var server = app.listen(process.env.PORT || opts.port, function() {
|
var server = app.listen(process.env.PORT || opts.port, process.env.BIND || opts.bind, function() {
|
||||||
console.log('Listening at http://%s:%d/',
|
console.log('Listening at http://%s:%d/',
|
||||||
this.address().address, this.address().port);
|
this.address().address, this.address().port);
|
||||||
|
|
||||||
|
|||||||
39
src/utils.js
@@ -1,5 +1,11 @@
|
|||||||
'use strict';
|
'use strict';
|
||||||
|
|
||||||
|
var async = require('async'),
|
||||||
|
path = require('path'),
|
||||||
|
fs = require('fs');
|
||||||
|
|
||||||
|
var glyphCompose = require('glyph-pbf-composite');
|
||||||
|
|
||||||
module.exports.getTileUrls = function(req, domains, path, format) {
|
module.exports.getTileUrls = function(req, domains, path, format) {
|
||||||
|
|
||||||
if (domains) {
|
if (domains) {
|
||||||
@@ -37,3 +43,36 @@ module.exports.fixTileJSONCenter = function(tileJSON) {
|
|||||||
];
|
];
|
||||||
}
|
}
|
||||||
};
|
};
|
||||||
|
|
||||||
|
module.exports.getFontsPbf = function(allowedFonts, fontPath, names, range, callback) {
|
||||||
|
var getFontPbf = function(name, range, callback) {
|
||||||
|
if (!allowedFonts || allowedFonts[name]) {
|
||||||
|
var filename = path.join(fontPath, name, range + '.pbf');
|
||||||
|
return fs.readFile(filename, function(err, data) {
|
||||||
|
if (err) {
|
||||||
|
return callback(new Error('Font load error: ' + name));
|
||||||
|
} else {
|
||||||
|
return callback(null, data);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
} else {
|
||||||
|
return callback(new Error('Font not allowed: ' + name));
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
var fonts = names.split(',');
|
||||||
|
var queue = [];
|
||||||
|
fonts.forEach(function(font) {
|
||||||
|
queue.push(function(callback) {
|
||||||
|
getFontPbf(font, range, callback);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
return async.parallel(queue, function(err, results) {
|
||||||
|
if (err) {
|
||||||
|
callback(err, new Buffer([]));
|
||||||
|
} else {
|
||||||
|
callback(err, glyphCompose.combine(results));
|
||||||
|
}
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|||||||
@@ -64,6 +64,6 @@ describe('Metadata', function() {
|
|||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
testTileJSON('/styles/test/rendered.json', 'test');
|
testTileJSON('/styles/bright/rendered.json', 'bright');
|
||||||
testTileJSON('/data/zurich-vector.json', 'zurich-vector');
|
testTileJSON('/data/zurich-vector.json', 'zurich-vector');
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ before(function() {
|
|||||||
console.log('global setup');
|
console.log('global setup');
|
||||||
process.chdir('test_data');
|
process.chdir('test_data');
|
||||||
var running = require('../src/server')({
|
var running = require('../src/server')({
|
||||||
config: 'config.json',
|
configPath: 'config.json',
|
||||||
port: 8888
|
port: 8888
|
||||||
});
|
});
|
||||||
global.app = running.app;
|
global.app = running.app;
|
||||||
|
|||||||
@@ -12,88 +12,91 @@ var testStatic = function(prefix, q, format, status, scale, type, query) {
|
|||||||
});
|
});
|
||||||
};
|
};
|
||||||
|
|
||||||
|
var prefix = 'bright';
|
||||||
|
|
||||||
describe('Static endpoints', function() {
|
describe('Static endpoints', function() {
|
||||||
describe('center-based', function() {
|
describe('center-based', function() {
|
||||||
describe('valid requests', function() {
|
describe('valid requests', function() {
|
||||||
describe('various formats', function() {
|
describe('various formats', function() {
|
||||||
testStatic('test', '0,0,0/256x256', 'png', 200, undefined, /image\/png/);
|
testStatic(prefix, '0,0,0/256x256', 'png', 200, undefined, /image\/png/);
|
||||||
testStatic('test', '0,0,0/256x256', 'jpg', 200, undefined, /image\/jpeg/);
|
testStatic(prefix, '0,0,0/256x256', 'jpg', 200, undefined, /image\/jpeg/);
|
||||||
testStatic('test', '0,0,0/256x256', 'jpeg', 200, undefined, /image\/jpeg/);
|
testStatic(prefix, '0,0,0/256x256', 'jpeg', 200, undefined, /image\/jpeg/);
|
||||||
testStatic('test', '0,0,0/256x256', 'webp', 200, undefined, /image\/webp/);
|
testStatic(prefix, '0,0,0/256x256', 'webp', 200, undefined, /image\/webp/);
|
||||||
});
|
});
|
||||||
|
|
||||||
describe('different parameters', function() {
|
describe('different parameters', function() {
|
||||||
testStatic('test', '0,0,0/300x300', 'png', 200, 2);
|
testStatic(prefix, '0,0,0/300x300', 'png', 200, 2);
|
||||||
testStatic('test', '0,0,0/300x300', 'png', 200, 3);
|
testStatic(prefix, '0,0,0/300x300', 'png', 200, 3);
|
||||||
|
|
||||||
testStatic('test', '80,40,20/600x300', 'png', 200, 3);
|
testStatic(prefix, '0,0,1.5/256x256', 'png', 200);
|
||||||
testStatic('test', '8.5,40.5,20/300x150', 'png', 200, 3);
|
|
||||||
testStatic('test', '-8.5,-40.5,20/300x150', 'png', 200, 3);
|
|
||||||
|
|
||||||
testStatic('test', '8,40,2@0,0/300x150', 'png', 200);
|
testStatic(prefix, '80,40,20/600x300', 'png', 200, 3);
|
||||||
testStatic('test', '8,40,2@180,45/300x150', 'png', 200, 2);
|
testStatic(prefix, '8.5,40.5,20/300x150', 'png', 200, 3);
|
||||||
testStatic('test', '8,40,2@10/300x150', 'png', 200, 3);
|
testStatic(prefix, '-8.5,-40.5,20/300x150', 'png', 200, 3);
|
||||||
testStatic('test', '8,40,2@10.3,20.4/300x300', 'png', 200);
|
|
||||||
testStatic('test', '0,0,2@390,120/300x300', 'png', 200);
|
testStatic(prefix, '8,40,2@0,0/300x150', 'png', 200);
|
||||||
|
testStatic(prefix, '8,40,2@180,45/300x150', 'png', 200, 2);
|
||||||
|
testStatic(prefix, '8,40,2@10/300x150', 'png', 200, 3);
|
||||||
|
testStatic(prefix, '8,40,2@10.3,20.4/300x300', 'png', 200);
|
||||||
|
testStatic(prefix, '0,0,2@390,120/300x300', 'png', 200);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
describe('invalid requests return 4xx', function() {
|
describe('invalid requests return 4xx', function() {
|
||||||
testStatic('test', '190,0,0/256x256', 'png', 400);
|
testStatic(prefix, '190,0,0/256x256', 'png', 400);
|
||||||
testStatic('test', '0,86,0/256x256', 'png', 400);
|
testStatic(prefix, '0,86,0/256x256', 'png', 400);
|
||||||
testStatic('test', '80,40,20/0x0', 'png', 400);
|
testStatic(prefix, '80,40,20/0x0', 'png', 400);
|
||||||
testStatic('test', '0,0,0/256x256', 'gif', 400);
|
testStatic(prefix, '0,0,0/256x256', 'gif', 400);
|
||||||
testStatic('test', '0,0,0/256x256', 'png', 404, 1);
|
testStatic(prefix, '0,0,0/256x256', 'png', 404, 1);
|
||||||
|
|
||||||
testStatic('test', '0,0,-1/256x256', 'png', 404);
|
testStatic(prefix, '0,0,-1/256x256', 'png', 404);
|
||||||
testStatic('test', '0,0,1.5/256x256', 'png', 404);
|
testStatic(prefix, '0,0,0/256.5x256.5', 'png', 404);
|
||||||
testStatic('test', '0,0,0/256.5x256.5', 'png', 404);
|
|
||||||
|
|
||||||
testStatic('test', '0,0,0,/256x256', 'png', 404);
|
testStatic(prefix, '0,0,0,/256x256', 'png', 404);
|
||||||
testStatic('test', '0,0,0,0,/256x256', 'png', 404);
|
testStatic(prefix, '0,0,0,0,/256x256', 'png', 404);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
describe('area-based', function() {
|
describe('area-based', function() {
|
||||||
describe('valid requests', function() {
|
describe('valid requests', function() {
|
||||||
describe('various formats', function() {
|
describe('various formats', function() {
|
||||||
testStatic('test', '-180,-80,180,80/10x10', 'png', 200, undefined, /image\/png/);
|
testStatic(prefix, '-180,-80,180,80/10x10', 'png', 200, undefined, /image\/png/);
|
||||||
testStatic('test', '-180,-80,180,80/10x10', 'jpg', 200, undefined, /image\/jpeg/);
|
testStatic(prefix, '-180,-80,180,80/10x10', 'jpg', 200, undefined, /image\/jpeg/);
|
||||||
testStatic('test', '-180,-80,180,80/10x10', 'jpeg', 200, undefined, /image\/jpeg/);
|
testStatic(prefix, '-180,-80,180,80/10x10', 'jpeg', 200, undefined, /image\/jpeg/);
|
||||||
testStatic('test', '-180,-80,180,80/10x10', 'webp', 200, undefined, /image\/webp/);
|
testStatic(prefix, '-180,-80,180,80/10x10', 'webp', 200, undefined, /image\/webp/);
|
||||||
});
|
});
|
||||||
|
|
||||||
describe('different parameters', function() {
|
describe('different parameters', function() {
|
||||||
testStatic('test', '-180,-90,180,90/20x20', 'png', 200, 2);
|
testStatic(prefix, '-180,-90,180,90/20x20', 'png', 200, 2);
|
||||||
testStatic('test', '0,0,1,1/200x200', 'png', 200, 3);
|
testStatic(prefix, '0,0,1,1/200x200', 'png', 200, 3);
|
||||||
|
|
||||||
testStatic('test', '-280,-80,0,80/280x160', 'png', 200);
|
testStatic(prefix, '-280,-80,0,80/280x160', 'png', 200);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
describe('invalid requests return 4xx', function() {
|
describe('invalid requests return 4xx', function() {
|
||||||
testStatic('test', '0,87,1,88/5x2', 'png', 400);
|
testStatic(prefix, '0,87,1,88/5x2', 'png', 400);
|
||||||
|
|
||||||
testStatic('test', '0,0,1,1/1x1', 'gif', 400);
|
testStatic(prefix, '0,0,1,1/1x1', 'gif', 400);
|
||||||
|
|
||||||
testStatic('test', '-180,-80,180,80/0.5x2.6', 'png', 404);
|
testStatic(prefix, '-180,-80,180,80/0.5x2.6', 'png', 404);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
describe('autofit path', function() {
|
describe('autofit path', function() {
|
||||||
describe('valid requests', function() {
|
describe('valid requests', function() {
|
||||||
testStatic('test', 'auto/256x256', 'png', 200, undefined, /image\/png/, '?path=10,10|20,20');
|
testStatic(prefix, 'auto/256x256', 'png', 200, undefined, /image\/png/, '?path=10,10|20,20');
|
||||||
|
|
||||||
describe('different parameters', function() {
|
describe('different parameters', function() {
|
||||||
testStatic('test', 'auto/20x20', 'png', 200, 2, /image\/png/, '?path=10,10|20,20');
|
testStatic(prefix, 'auto/20x20', 'png', 200, 2, /image\/png/, '?path=10,10|20,20');
|
||||||
testStatic('test', 'auto/200x200', 'png', 200, 3, /image\/png/, '?path=-10,-10|-20,-20');
|
testStatic(prefix, 'auto/200x200', 'png', 200, 3, /image\/png/, '?path=-10,-10|-20,-20');
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
describe('invalid requests return 4xx', function() {
|
describe('invalid requests return 4xx', function() {
|
||||||
testStatic('test', 'auto/256x256', 'png', 400);
|
testStatic(prefix, 'auto/256x256', 'png', 400);
|
||||||
testStatic('test', 'auto/256x256', 'png', 400, undefined, undefined, '?path=10,10');
|
testStatic(prefix, 'auto/256x256', 'png', 400, undefined, undefined, '?path=10,10');
|
||||||
testStatic('test', 'auto/2560x2560', 'png', 400, undefined, undefined, '?path=10,10|20,20');
|
testStatic(prefix, 'auto/2560x2560', 'png', 400, undefined, undefined, '?path=10,10|20,20');
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -8,13 +8,15 @@ var testIs = function(url, type, status) {
|
|||||||
});
|
});
|
||||||
};
|
};
|
||||||
|
|
||||||
|
var prefix = 'bright';
|
||||||
|
|
||||||
describe('Styles', function() {
|
describe('Styles', function() {
|
||||||
describe('/styles/test.json is valid style', function() {
|
describe('/styles/' + prefix + '.json is valid style', function() {
|
||||||
testIs('/styles/test.json', /application\/json/);
|
testIs('/styles/' + prefix + '.json', /application\/json/);
|
||||||
|
|
||||||
it('contains expected properties', function(done) {
|
it('contains expected properties', function(done) {
|
||||||
supertest(app)
|
supertest(app)
|
||||||
.get('/styles/test.json')
|
.get('/styles/' + prefix + '.json')
|
||||||
.expect(function(res) {
|
.expect(function(res) {
|
||||||
res.body.version.should.equal(8);
|
res.body.version.should.equal(8);
|
||||||
res.body.name.should.be.String();
|
res.body.name.should.be.String();
|
||||||
@@ -29,20 +31,20 @@ describe('Styles', function() {
|
|||||||
testIs('/styles/streets.json', /./, 404);
|
testIs('/styles/streets.json', /./, 404);
|
||||||
});
|
});
|
||||||
|
|
||||||
describe('/styles/test/sprite[@2x].{format}', function() {
|
describe('/styles/' + prefix + '/sprite[@2x].{format}', function() {
|
||||||
testIs('/styles/test/sprite.json', /application\/json/);
|
testIs('/styles/' + prefix + '/sprite.json', /application\/json/);
|
||||||
testIs('/styles/test/sprite@2x.json', /application\/json/);
|
testIs('/styles/' + prefix + '/sprite@2x.json', /application\/json/);
|
||||||
testIs('/styles/test/sprite.png', /image\/png/);
|
testIs('/styles/' + prefix + '/sprite.png', /image\/png/);
|
||||||
testIs('/styles/test/sprite@2x.png', /image\/png/);
|
testIs('/styles/' + prefix + '/sprite@2x.png', /image\/png/);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
describe('Fonts', function() {
|
describe('Fonts', function() {
|
||||||
testIs('/fonts/Open Sans Bold/0-255.pbf', /application\/x-protobuf/);
|
testIs('/fonts/Open Sans Bold/0-255.pbf', /application\/x-protobuf/);
|
||||||
testIs('/fonts/Open Sans Regular/65280-65533.pbf', /application\/x-protobuf/);
|
testIs('/fonts/Open Sans Regular/65280-65535.pbf', /application\/x-protobuf/);
|
||||||
testIs('/fonts/Open Sans Bold,Open Sans Regular/0-255.pbf',
|
testIs('/fonts/Open Sans Bold,Open Sans Regular/0-255.pbf',
|
||||||
/application\/x-protobuf/);
|
/application\/x-protobuf/);
|
||||||
testIs('/fonts/Nonsense,Open Sans Bold/0-255.pbf', /application\/x-protobuf/);
|
testIs('/fonts/Nonsense,Open Sans Bold/0-255.pbf', /./, 400);
|
||||||
|
|
||||||
testIs('/fonts/Nonsense/0-255.pbf', /./, 400);
|
testIs('/fonts/Nonsense/0-255.pbf', /./, 400);
|
||||||
testIs('/fonts/Nonsense1,Nonsense2/0-255.pbf', /./, 400);
|
testIs('/fonts/Nonsense1,Nonsense2/0-255.pbf', /./, 400);
|
||||||
|
|||||||
@@ -9,35 +9,38 @@ var testTile = function(prefix, z, x, y, format, status, scale, type) {
|
|||||||
});
|
});
|
||||||
};
|
};
|
||||||
|
|
||||||
|
var prefix = 'bright';
|
||||||
|
|
||||||
describe('Raster tiles', function() {
|
describe('Raster tiles', function() {
|
||||||
describe('valid requests', function() {
|
describe('valid requests', function() {
|
||||||
describe('various formats', function() {
|
describe('various formats', function() {
|
||||||
testTile('test', 0, 0, 0, 'png', 200, undefined, /image\/png/);
|
testTile(prefix, 0, 0, 0, 'png', 200, undefined, /image\/png/);
|
||||||
testTile('test', 0, 0, 0, 'jpg', 200, undefined, /image\/jpeg/);
|
testTile(prefix, 0, 0, 0, 'jpg', 200, undefined, /image\/jpeg/);
|
||||||
testTile('test', 0, 0, 0, 'jpeg', 200, undefined, /image\/jpeg/);
|
testTile(prefix, 0, 0, 0, 'jpeg', 200, undefined, /image\/jpeg/);
|
||||||
testTile('test', 0, 0, 0, 'webp', 200, undefined, /image\/webp/);
|
testTile(prefix, 0, 0, 0, 'webp', 200, undefined, /image\/webp/);
|
||||||
});
|
});
|
||||||
|
|
||||||
describe('different coordinates and scales', function() {
|
describe('different coordinates and scales', function() {
|
||||||
testTile('test', 1, 1, 1, 'png', 200);
|
testTile(prefix, 1, 1, 1, 'png', 200);
|
||||||
|
|
||||||
testTile('test', 0, 0, 0, 'png', 200, 2);
|
testTile(prefix, 0, 0, 0, 'png', 200, 2);
|
||||||
testTile('test', 0, 0, 0, 'png', 200, 3);
|
testTile(prefix, 0, 0, 0, 'png', 200, 3);
|
||||||
testTile('test', 2, 1, 1, 'png', 200, 3);
|
testTile(prefix, 2, 1, 1, 'png', 200, 3);
|
||||||
|
testTile(prefix, 0, 0, 0, 'png', 200, 4);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
describe('invalid requests return 4xx', function() {
|
describe('invalid requests return 4xx', function() {
|
||||||
testTile('non_existent', 0, 0, 0, 'png', 404);
|
testTile('non_existent', 0, 0, 0, 'png', 404);
|
||||||
testTile('test', -1, 0, 0, 'png', 404);
|
testTile(prefix, -1, 0, 0, 'png', 404);
|
||||||
testTile('test', 25, 0, 0, 'png', 404);
|
testTile(prefix, 25, 0, 0, 'png', 404);
|
||||||
testTile('test', 0, 1, 0, 'png', 404);
|
testTile(prefix, 0, 1, 0, 'png', 404);
|
||||||
testTile('test', 0, 0, 1, 'png', 404);
|
testTile(prefix, 0, 0, 1, 'png', 404);
|
||||||
testTile('test', 0, 0, 0, 'gif', 400);
|
testTile(prefix, 0, 0, 0, 'gif', 400);
|
||||||
testTile('test', 0, 0, 0, 'pbf', 400);
|
testTile(prefix, 0, 0, 0, 'pbf', 400);
|
||||||
|
|
||||||
testTile('test', 0, 0, 0, 'png', 404, 1);
|
testTile(prefix, 0, 0, 0, 'png', 404, 1);
|
||||||
testTile('test', 0, 0, 0, 'png', 404, 4);
|
testTile(prefix, 0, 0, 0, 'png', 404, 5);
|
||||||
|
|
||||||
//testTile('hybrid', 0, 0, 0, 'png', 404); //TODO: test this
|
//testTile('hybrid', 0, 0, 0, 'png', 404); //TODO: test this
|
||||||
});
|
});
|
||||||
|
|||||||