polygon-city / polygon-city-cli

Converts a CityGML file into GeoJSON footprint indexes and 3D models (obj & collada)
6 stars 1 forks source link

Polygon City CLI

Converts a CityGML file into GeoJSON footprint indexes and 3D models (obj & collada)

Requirements

  1. npm and Node v5 (https://nodejs.org/dist/v5.2.0/node-v5.2.0.pkg)
  2. Redis (http://redis.io/download#installation)
  3. A Mapzen Elevation Service key (https://mapzen.com/developers)

Installation

$ npm install polygon-city-cli@latest -g

Usage

Processing a new CityGML file:

$ polygon-city -c <epsg_code> -E <mapzen_elevation_key> -o /path/to/obj/output/directory /path/to/cityGml/file.xml

Resuming previous unfinished jobs:

$ polygon-city resume

Step-by-step example

  1. Run npm install polygon-city-cli -g
  2. Start a local Redis server (using port 6379)
  3. Download some CityGML data from Linz, Austria
  4. Take note of the EPSG code used for the Linz dataset (EPSG:31255)
  5. Run the command line tool:
$ polygon-city -c 31255 -E "your_mapzen_elevation_key" -o /path/to/obj/output/directory /path/to/cityGml/file.xml