OpenGlobus

TypeScript/JavaScript 3D maps and geospatial data visualization engine library
GitHub
758
Created 11 years ago, last commit 15 days ago
20 contributors
4.81k commits
Stars added on GitHub, month by month
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
1
2
3
4
5
6
7
8
9
10
11
12
2024
Stars added on GitHub, per day, on average
Yesterday
=
Last week
+0.3
/day
Last month
+0.6
/day
npmPackage on NPM
Monthly downloads on NPM
1
2
3
4
5
6
7
8
9
10
11
12
2024
No dependencies
README

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