https://github.com/openglobus/openglobus
TypeScript/JavaScript 3D maps and geospatial data visualization engine library
https://github.com/openglobus/openglobus
3d 3dmap earth geospatial gis globe javascript lidar map maps openglobus terrain terrain-rendering webgl webgl2
Last synced: 27 days ago
JSON representation
TypeScript/JavaScript 3D maps and geospatial data visualization engine library
- Host: GitHub
- URL: https://github.com/openglobus/openglobus
- Owner: openglobus
- License: mit
- Created: 2013-08-16T06:28:26.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2026-01-16T21:36:17.000Z (5 months ago)
- Last Synced: 2026-01-17T01:52:44.494Z (5 months ago)
- Topics: 3d, 3dmap, earth, geospatial, gis, globe, javascript, lidar, map, maps, openglobus, terrain, terrain-rendering, webgl, webgl2
- Language: TypeScript
- Homepage: https://www.openglobus.org
- Size: 169 MB
- Stars: 865
- Watchers: 25
- Forks: 121
- Open Issues: 62
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/@openglobus/og)
# OpenGlobus
[openglobus](https://www.openglobus.org/) 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's main goal is to make 3D map features fast, good-looking, user-friendly, and easy to implement in any
related project.
## Getting Started
### Installation
```sh
npm install @openglobus/og
```
### Fast initialization
Create your first OpenGlobus application with the [create-openglobus](https://www.npmjs.com/package/create-openglobus) template. It supports JS, TS, React, and more.
Run:
```sh
npx create-openglobus
```
## React Integration
The OpenGlobus React module is available in the [openglobus-react](https://github.com/openglobus/openglobus-react) package.
```sh
npm i @openglobus/openglobus-react
```
## Documentation and Examples
- [Examples](https://sandbox.openglobus.org)
- [Wiki](https://github.com/openglobus/openglobus/wiki)
- [API documentation](https://openglobus.github.io/docs/)
## Get Started Contributing
### Development
1. Clone the repository.
2. Run in the repository folder:
```sh
npm install
```
### Build Library
Run
```sh
npm run build
```
This generates files in `lib/`:
- og.es.js
- og.es.js.map
- og.css
- ./res/...
### Run examples
First, it starts by watching sources and building into ./lib folder es module:
```sh
npm run dev
```
Second, run a local server. Then open `http://127.0.0.1:3000`:
```sh
npm run serve
```
or
```sh
npm run dev_serve
```
Third, try an example from the sandbox:
```sh
http://127.0.0.1:3000/sandbox/osm/osm.html
```
### Other scripts
`npm run docs` - build [api documentation](https://openglobus.github.io/docs/) into `docs/`
`npm run serve` - run local web server for develop and watch examples
`npm run lint` - run code linter
`npm run format` - format code and docs with Prettier
`npm run format:check` - check formatting with Prettier (non-modifying)
`npm run test` - run tests
`npm run dts` - generate TypeScript declarations
## Contributor Resources
- [Contributing guide](CONTRIBUTING.md)
- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Security policy](SECURITY.md)
- [Style guide](STYLEGUIDE.md)
- [Changelog](CHANGELOG.md)
- [Open an issue](https://github.com/openglobus/openglobus/issues/new/choose)
- [Start a discussion](https://github.com/openglobus/openglobus/discussions)
- [Open a pull request](https://github.com/openglobus/openglobus/compare)
## Support the Project
There are many ways to contribute back to the project:
- Help us test new and existing features and report [bugs](https://github.com/openglobus/openglobus/issues)
- Help answer questions on the community [forum](https://github.com/openglobus/openglobus/discussions)
and [chat](https://gitter.im/openglobus/og)
- ⭐️ us on GitHub
- Spread the word about openglobus on [social media](https://twitter.com/openglobus)
- Become a contributor
- [Support with money](https://opencollective.com/openglobusjs)
## License
### Apache-2.0