94 lines
2.1 KiB
Markdown
94 lines
2.1 KiB
Markdown
Windshaft-CartoDB
|
|
==================
|
|
|
|
This is the CartoDB map tiler. It extends Windshaft with some extra
|
|
functionality and custom filters for authentication
|
|
|
|
* reads dbname from subdomain and cartodb redis for pretty tile urls
|
|
* configures windshaft to publish cartodb_id as the interactivity layer
|
|
* gets the default geometry type from the cartodb redis store
|
|
* allows tiles to be styled individually
|
|
* provides a link to varnish high speed cache
|
|
* provides a infowindow endpoint for windshaft
|
|
* provides a map_metadata endpoint for windshaft
|
|
|
|
Install
|
|
-------
|
|
|
|
```
|
|
git clone
|
|
npm install
|
|
```
|
|
|
|
Note that the ```npm install``` step will populate the node_modules/
|
|
directory with modules, some of which being compiled on demand. If you
|
|
happen to have startup errors you may need to force rebuilding those
|
|
modules. At any time just wipe out the node_modules/ directory and run
|
|
```npm install``` again.
|
|
|
|
Configure
|
|
---------
|
|
|
|
Edit config/environments/<env>.js files
|
|
|
|
Look at lib/cartodb/server_options for more on config
|
|
|
|
Run
|
|
---
|
|
|
|
```
|
|
node app.js [development | production]
|
|
```
|
|
|
|
Note that caches are kept in redis. If you're not seeing what
|
|
you expect there may be out-of-sync records in there.
|
|
Take a look: http://redis.io/commands
|
|
|
|
|
|
URLs
|
|
----
|
|
|
|
**TILES**
|
|
|
|
[GET] subdomain.cartodb.com/tiles/:table_name/:z/:x/:y.[png|png8|grid.json]
|
|
|
|
Args:
|
|
|
|
* sql - plain SQL arguments
|
|
* interactivity - specify the column to use in UTFGrid
|
|
* cache_buster - if needed you can add a cachebuster to make sure you're
|
|
rendering new
|
|
* geom_type - override the cartodb default
|
|
* style - override the default map style with Carto
|
|
|
|
|
|
**STYLE**
|
|
|
|
[GET/POST] subdomain.cartodb.com/tiles/:table_name/style
|
|
|
|
Args:
|
|
|
|
* style - the style in CartoCSS you want to set
|
|
|
|
|
|
**INFOWINDOW**
|
|
|
|
[GET] subdomain.cartodb.com/tiles/:table_name/infowindow
|
|
|
|
Args:
|
|
|
|
* infowindow - returns contents of infowindow from CartoDB.
|
|
|
|
|
|
**MAP METADATA**
|
|
|
|
[GET] subdomain.cartodb.com/tiles/:table_name/map_metadata
|
|
|
|
Args:
|
|
|
|
* infowindow - returns contents of infowindow from CartoDB.
|
|
|
|
|
|
All GET requests are wrappable with JSONP using callback argument,
|
|
including the UTFGrid map tile call.
|