Skip to content

Latest commit

 

History

History
90 lines (61 loc) · 3.21 KB

README.md

File metadata and controls

90 lines (61 loc) · 3.21 KB
Raw

GRANDFATHERED

Foundational point of departure for DeltaVerse 3.D We recommend using Cesium instead (code sample).

WebGL Earth 2.0

Open-source virtual planet web application running in any web browser with support for WebGL HTML5 standard. Mobile devices such as iPhone, iPad or Android based mobile phones are going to be supported too. It is a free software and a community driven project.

There is an extremely easy to use JavaScript API - fully mimicking LeafletJS.

Usage

JavaScript API

WebGL Earth in version 2.0 is adapting the popular LeafletJS API. So if you are familiar with Leaflet you can easily start to use WebGL Earth, things like markers, popups, centering and flying to a place on given latitude and longitude are possible. The code from Leaflet can be also mixed with WE - you can pass L.LatLng and L.LatLngBounds, etc.

A simple Hello World:

<!DOCTYPE HTML>
<html>
  <head>
    <script src="http://www.webglearth.com/v2/api.js"></script>
    <script>
      function initialize() {
        var earth = new WE.map('earth_div');
        WE.tileLayer('http://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png').addTo(earth);
      }
    </script>
  </head>
  <body onload="initialize()">
    <div id="earth_div" style="width:600px;height:400px;"></div>
  </body>
</html>



Original version of WebGL Earth had also it's own easy API which is preserved for back compatibility.
It is documented at http://www.webglearth.org/api todo use the timemachine

The supported Leaflet API methods are not yet documented -- the best source of the information are currently the API examples (`src/api-l.html`, `src/api.html`, `src/polygon.html`) and the API symbol exports itselves (`src/api.js` and `src/api-l.js`).

### Online hosted API

The project API is available from Google CDN and can be linked and called directly from your web application as `http://www.webglearth.com/v2/api.js`. Examples mentioned above are demonstrating this form of use.

Embedding of a globe in your own web is then extremely easy.

### From custom server or even offline

Capable of local and external hosting for dAPP editing while offline. With custom rendered map tiles (made with http://www.maptiler.com/) the project can be used on intranets, in restricted environments or even offline. The API should be accessed via HTTP protocol (possibly via localhost).


## Development and building

* Clone the code from GitHub, including the submodules (cesium).
* Use `make cesium` to build the required component.

### Running the app
* Run `make serve` to start the plovr server (port 9810)
* Open any of `src/*.html`

### Build the app
* Run `make build` to produce `deploy/*_nocesium.js`
* Combine the sources together to produce a single JavaScript file:

/**

CESIUM_BASE_URL = '.'; {content of cesium/Build/Cesium/Cesium.js} {content of deploy/api_nocesium.js}


## Supported by

- Klokan Technologies GmbH
- Analytical Graphics, Inc.
- Tween Globe Ltd
- Miizee.com