TerraFab
Prerequisites
- Node.js 0.10.x or newer
Getting up and running
You need the graphics library Cairo installed. Cairo needs to be linked with freetype to work with node_canvas for some reason. A simple way to achieve this if you are using homebrew on OS X is to install Cairo without X11-bindings, like so:
$ brew install cairo --without-x
Then:
$ npm install
$ node server.jsThe web app should now be accessible at http://localhost:3000
Configuration
All configuration can be done under ./config/app.json. Have a look at the ./config/app.example.json.
In order to configure the accessToken and accessTokenSecret for Shapeways, you may obtain them by
calling the route /accesstoken in the app after you have configrued the consumerKey and
consumerKeySecret for your Shapeways application.
Model endpoints
/preview
Packages the model into an archive ready for export.
/download
Download the built model archive.
/cart
Lets the user buy the model at Shapeways through our configured Shapeways application.
It assumes the user already have visited the /preview route.
API endpoints
/dtm (GET)
Renders a UTM 33 terrain model for a given bound (box).
Params
box : A bounding box for the map given in UTM 33 coordinates given as 'NWx,NWy,SEx,SEy'.
outsize : The image dimensions in pixels given as 'X,Y'.
format (optional): Either 'png' or 'bin' (16bit binary in ENVI-format).
Example
/dtm?box=253723.176600653,6660500.4670516,267723.176600653,6646500.4670516&outsize=1000,1000
/map (GET)
Renders a UTM 33 map tile for a given bound (box).
Params
box : A bounding box for the map given in UTM 33 coordinates given as 'NWx,NWy,SEx,SEy'.
outsize : The image dimensions in pixels given as 'X,Y'.
Example
/map?box=253723.176600653,6660500.4670516,267723.176600653,6646500.4670516&outsize=1000,1000
Shapeways endpoints
/accesstoken (GET)
Let you login to Shapeways to get an access token for the your Shapeways application. Note: the end user will not be logging into this. It's a tool for obtaining an access token for the application (in order to post models to the Shapeways API).
There is also: /login and /callback which is taken care of by the oAuth bonanza.
Params
None
Example
/accesstoken