Go to file

Raul Ochoa 63ba75f703 Merge pull request #274 from CartoDB/url_rewrite allow urls like /u/:user/		2015-03-20 12:21:41 +01:00
assets	Adds default image placeholder for http renderer to use as fallback	2015-02-09 15:08:36 +01:00
config/environments	Adds example configuration to accept user param in /tiles/layergroup	2015-03-20 00:34:30 +01:00
docs	Switching to HTTPS	2015-03-16 12:26:28 +01:00
lib/cartodb	Adds user param to params whitelist and uses localhost user for tests	2015-03-20 00:30:56 +01:00
scripts	Adds script/tool to go from lzma base64 encoded string to mapconfig	2015-03-11 15:16:24 +01:00
test	Adds user param to params whitelist and uses localhost user for tests	2015-03-20 00:30:56 +01:00
tools	Remove flush_cache tool as it doesn't make sense anymore	2015-02-09 19:04:38 +01:00
.gitignore	Ignore npm-debug.log	2015-02-26 12:05:17 +01:00
.jshintrc	Fix Max cyclomatic complexity value	2015-03-16 00:36:38 +01:00
.travis.yml	apt-get update before apt-get install	2015-02-09 18:39:24 +01:00
app.js	Closes fd for log files on `kill -HUP`. Fixes #230	2014-12-02 15:05:28 +01:00
configure	Have ./configure tolerate unknown options	2014-10-08 10:10:58 +02:00
HOWTO_RELEASE	Update release document	2014-04-09 09:14:20 +02:00
LICENSE	Switch to 3-clause BSD license	2014-03-20 10:20:51 +01:00
Makefile	jshint to be tested by default	2015-03-16 00:38:29 +01:00
NEWS.md	Stubs next version	2015-03-11 17:15:44 +01:00
npm-shrinkwrap.json	Stubs next version	2015-03-11 17:15:44 +01:00
package.json	jshint to be tested by default	2015-03-16 00:38:29 +01:00
README.md	Specific dependencies for building node-canvas	2015-03-11 14:25:36 +01:00
run_tests.sh	Set default PostgreSQL application name to "cartodb_tiler"	2014-05-07 16:19:22 +02:00

README.md

Windshaft-CartoDB

This is the CartoDB Maps API 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 (DEPRECATED)
provides a map_metadata endpoint for windshaft (DEPRECATED)
provides a template maps API

Requirements

Core
- Node.js >=0.8
- npm >=1.2.1
- PostgreSQL >8.3.x, PostGIS >1.5.x
- Redis >2.4.0 (http://www.redis.io)
- Mapnik 2.0.1, 2.0.2, 2.1.0, 2.2.0, 2.3.0. See Installing Mapnik.
- Windshaft: check Windshaft dependencies and installation notes
- libcairo2-dev, libpango1.0-dev, libjpeg8-dev and libgif-dev for server side canvas support
For cache control (optional)
- CartoDB-SQL-API 1.0.0+
- CartoDB 0.9.5+ (for CDB_QueryTables)
- Varnish (http://www.varnish-cache.org)
For running the testsuite
- ImageMagick (http://www.imagemagick.org)

Configure

Create the config/environments/.js files (there are .example files to start from). You can optionally use the ./configure script for this, see ./configure --help to see available options.

Look at lib/cartodb/server_options.js for more on config

Build/install

To fetch and build all node-based dependencies, run:

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.

Run

node app.js <env>

Where is the name of a configuration file under config/environments/.

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

Documentation

The docs directory contains different documentation resources, from higher level to more detailed ones: The Maps API defined the endpoints and their expected parameters and outputs.

Examples

CartoDB's Map Gallery showcases several examples of visualisations built on top of this.