mirror of
https://github.com/maptiler/tileserver-gl.git
synced 2024-09-11 12:05:41 +03:00
Vector and raster maps with GL styles. Server side rendering by MapLibre GL Native. Map tile server for MapLibre GL JS, Android, iOS, Leaflet, OpenLayers, GIS via WMTS, etc.
dockergl-stylesmapbox-gl-jsmaplibre-gl-jsopenmaptilesraster-maptileservertileserver-glvector-tileswmts
public | ||
src | ||
test | ||
.dockerignore | ||
.gitignore | ||
.travis.yml | ||
Dockerfile | ||
LICENSE.md | ||
package.json | ||
README.md | ||
run.sh |
TileServer GL
Installation
Docker
docker run -it -v $(pwd):/data -p 8080:80 klokantech/tileserver-gl
Without docker
- Make sure you have Node v4 or higher (
nvm install 4
) npm install
node src/main.js
Sample data
Sample data can be downloaded at https://github.com/klokantech/tileserver-gl-data/archive/master.zip
Usage
- unpack somewhere and
cd
to the directory docker run -it -v $(pwd):/data -p 8080:80 klokantech/tileserver-gl
- (or
node path/to/repo/src/main.js
)
- (or
Configuration
Create config.json
file in the root directory.
The config file can contain definition of several paths where the tiles will be served.
Example configuration file
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
)
Available URLs
- If you visit the server on the configured port (default 8080) you should see your maps appearing in the browser.
- Style is served at
/styles/{id}.json
(+ array at/styles.json
)- Sprites at
/styles/{id}/sprite[@2x].{format}
- Fonts at
/fonts/{fontstack}/{start}-{end}.pbf
- Sprites at
- Rendered tiles are at
/styles/{id}/rendered/{z}/{x}/{y}[@2x].{format}
- The optional
@2x
(or@3x
) part can be used to render HiDPI (retina) tiles - Available formats:
png
,jpg
(jpeg
),webp
- TileJSON at
/styles/{id}/rendered.json
- The optional
- Static images are rendered at:
/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)- The static image endpoints additionally support following query parameters:
path
- comma-separatedlng,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
- e.g.
latlng
- indicates thepath
coordinates are inlat,lng
order rather than the usuallng,lat
fill
- color to use as the fill (e.g.red
,rgba(255,255,255,0.5)
,#0000ff
)stroke
- color of the path strokewidth
- width of the strokepadding
- "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"
- value of
- Source data at
/data/{mbtiles}/{z}/{x}/{y}.{format}
- TileJSON at
/data/{mbtiles}.json
- TileJSON at
- Array of all TileJSONs at
/index.json
(/rendered.json
;/data.json
)