gleo

GLeo

A JS library for WebGL-powered geographic maps.

Gleo is a library for displaying geographical maps (and map-like things on cartesian planes), leveraging WebGL1 via the Glii abstraction library. It aims to cover the use cases of Leaflet, OpenLayers or MapboxGL/MaplibreGL, but since it's a one-man project, it's not quite there yet.

I want to see it working!

Go to https://ivansanchez.gitlab.io/gleo/ , then.

Trying out

1. Clone the repo
2. Run a git submodule init plus git submodule update

• This pulls the glii and arrugator dependencies from their git repos

1. Spin up a local webserver
2. Browse the demos in /browser-demos

No bundling needed! Gleo leverages the magic of ES6 modules.

Documentation

Running npm install then npm run docs will build the API documentation and the graphviz UML diagram.

Legalese

Gleo itself is licensed under a GPL license. See the LICENSE.md file for details.

Gleo depends on some javascript libraries, which are bundled under src/3rd-party:

• shelf-pack by Bryan Housel, ISC licensed.
• css-color-parser by Dean McNamee, MIT licensed.
• earcut by Vladimir Agafonkin, ISC licensed.
• glmatrix by Brandon Jones, Catto Petter, et al, MIT licensed.
• point-geometry by Tom McWright, et al, ISC licensed.
• rbush-knn by Vladimir Agafonkin, ISC licensed, plus dependencies:
  • rbush by Vladimir Agafonkin, MIT licensed.
  • tinyqueue by Vladimir Agafonkin, ISC licensed.
  • quickselect by Vladimir Agafonkin, ISC licensed.
• vector-tile-js by Vladimir Agafonkin, John Firebaugh, Tom McWright, et al, BSD-3 licensed, plus dependencies:
  • pbf by Vladimir Agafonkin, BSD-3 licensed.
  • ieee754 by Feross Aboukhadijeh, BSD-3 licensed.

As well, Gleo uses some geographical data, assets and non-required javascript libraries in the demos:

• proj4js
• Natural Earth
• geoboundaries
• OpenStreetMap data in several forms
• Leaflet.ExtraMarkers spritesheet
• geographiclib