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

• Examples
• Wiki
• API documentation

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