Home Reference Source Repository

iTowns V2

What is it?

iTowns is a web framework written in Javascript/WebGL for visualisation of 3D geographic data allowing precise measurements in 3D. Its first purpose was the visualisation of street view images and terrestrial lidar point cloud. It has then been extended to handle more data types.

The V2 of iTowns Open Source is a refactoring of iTowns V1

This version includes a globe visualization mode.

iTowns screenshot

How to use Itowns in your project

You can use it through npm (the preferred way) or download a bundle from our github release page.

With NPM

In your project:

npm install --save itowns

This package contains the ES5-compatible sources of Itowns.

If you're using a module bundler (like wepback), you can directly require('itowns') in your code.

Alternatively, we provide a bundle you can directly include in your html files that exposes itowns in window:

<script src="node_modules/itowns/dist/itowns.js"></script>

/!\ Please note that this bundle also contains the dependencies.

From a release bundle

See our release page (coming soon).

Supported data types

API documentation and demo

You can find an API documentation here [http://www.itowns-project.org/itowns2/API_Doc/]

If you want to play with a demonstration, please see [http://www.itowns-project.org/itowns2/]

In Progress

Latest changes can be found in CHANGES.md


iTowns V2 is dual-licenced under Cecill-B V1.0 and MIT. Incorporated libraries are published under their original licences.

See LICENSE.md for more information.


iTowns has received contributions from people listed in CONTRIBUTORS.md. If you are interested in contributing to iTowns, please read CONTRIBUTING.md.


iTowns is an original work from French IGN, MATIS research laboratory. It has been funded through various research programs involving the French National Research Agency, Cap Digital, UPMC, Mines ParisTec, CNRS, LCPC.

iTowns is currently maintained by IGN ( http://www.ign.fr ) and Oslandia ( http://www.oslandia.com )

IGN Logo Oslandia Logo