Skip to content
A Three.js-based framework written in Javascript/WebGL for visualizing 3D geospatial data
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github chore: move githubs templates in .github/ folder Oct 23, 2018
config chore: update npm packages. May 13, 2019
docs refactor(core): add style class. May 10, 2019
examples refactor(core): add style class. May 10, 2019
src refacto(view): simplify the whenReady section of the View May 13, 2019
test fix(test): test parse Style. May 13, 2019
utils/debug refactor(core): Extent to Es6 class Apr 1, 2019
.babelrc test: add unit test on gltfLoader and remove ThreeExtented from cover… Apr 10, 2019
.editorconfig .editorconfig: trailing whitespace can have special meaning in Markdown Feb 22, 2016
.eslintignore fix(3dtiles): enable draco loader for b3dm Apr 1, 2019
.eslintrc.js chore: remove eslint rule 'class methods use this'. Apr 10, 2019
.gitattributes Style: enable linebreak-style rule Jan 19, 2017
.gitignore chore: reorganize files and folders Nov 27, 2018
.travis.yml chore: support node 11.1.0 Nov 8, 2018
CODING.md chore(test): rename test/examples to test/functional Feb 7, 2019
CONTRIBUTING.md chore: update and rewrite contents in README and other .md files. Jan 28, 2019
CONTRIBUTORS.md fix(controls): fix ORBIT touch event making North down. Mar 20, 2019
LICENSE.md chore: update and rewrite contents in README and other .md files. Jan 28, 2019
README.md chore: update and rewrite contents in README and other .md files. Jan 28, 2019
appveyor.yml test: Add continuous integration on Windows through AppVeyor Jul 10, 2018
autodeploy.sh chore(docs): move from API_Doc to docs Dec 13, 2018
deploy_key.enc chore: migrate travis-ci.org to travis-ci.com Oct 31, 2018
index.html refactor(core): extend Atmosphere from GeometryLayer Feb 28, 2019
package-lock.json chore: update THREE to r104.0 May 13, 2019
package.json chore: update THREE to r104.0 May 13, 2019
webpack.config.js chore: remove useless require Dec 19, 2018

README.md

iTowns

iTowns

Coverage Status Build Status

What is it?

iTowns is a Three.js-based framework written in Javascript/WebGL for visualizing 3D geospatial data.

It can connect to WMS/WMTS/TMS servers including elevation data and load many different data formats (3dTiles, GeoJSON, Vector Tiles, GPX and much more). A complete list of features and supported data formats is available on the wiki.

iTowns screenshot

Documentation and examples

The official documentation is available here. It contains tutorials to help you start using iTowns, and an API reference. You can find more informations on its contribution here.

Official examples can be viewed here. Some examples available:

iTowns examples

How to use

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 write 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. Note that there isn't a lot of support for older version of iTowns, we highly recommand to use the last release everytime.

Contributing

If you are interested in contributing to iTowns, please read the CONTRIBUTING guide and the CODING guide.

iTowns has been redesigned from this early version.

Licence

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

See LICENSE.md for more information.

Support

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 and AtolCD, and has been maintained by Oslandia in the past. It has also received contributions from people listed here.

IGN AtolCD Oslandia

You can’t perform that action at this time.