/openglobus

TypeScript/JavaScript 3D maps and geospatial data visualization engine library

Primary LanguageTypeScriptMIT LicenseMIT

NPM PACKAGE BUILD

Openglobus

English | 简体中文 | Portuguese-BR

Openglobus is a typescript/javascript library designed to display interactive 3D maps and other geospatial data at a scale from planet to bee.

It supports various high-resolution terrain providers, imagery layers, renders thousands of 3D objects, provides geometry measurement tools, and more. It uses the WebGL technology, open-source and completely free.

Openglobus main goal is to make 3D map features fast, good-looking, user-friendly and easy to implement in any related project.

Getting Start

Installation

npm install @openglobus/og

Fast initialization

Create your first openglobus application with create-openglobus template. It support js, ts + react, etc.

Run:

npx create-openglobus

React integration

Openglobus React module is available with openglobus-react package.

npm i @openglobus/openglobus-react

Documentation and Examples

Get Started to contribute

Development

  1. Clone repository.
  2. Run in the repo folder:
npm install

Build Library

Run

npm run build

Then, it will generate 5 files at lib/@openglobus/:

  • og.umd.js
  • og.umd.js.map
  • og.esm.js
  • og.esm.js.map
  • og.css
  • ./res/...

Run examples

First, it starts by watching sources and building into ./lib folder esm module:

npm run dev

Second, runs local server, then you can browse 127.0.0.1:8080:

npm run serve

Third, try an example from the sandbox:

 http://127.0.0.1:8080/sandbox/osm/osm.html

Other scripts

npm run docs - build api documentation into /api folder

npm run serve - run local web server for develop and watch examples

npm run lint - run code linter

npm run test - run tests

tsc - run typescript parser

Support the Project

There are many ways to contribute back to the project:

  • Help us test new and existing features and report bugs
  • Help answer questions on the community forum and chat
  • ⭐️ us on GitHub
  • Spread the word about openglobus on social media
  • Become a contributor
  • Support with money

License

MIT