playcanvas / earthatile

Engine-agnostic runtime for 3D Tiles geospatial datasets

Earthatile - 3D Maps for your Apps 🌎

Earthatile is an engine-agnostic runtime for loading and navigating 3D Tiles geospatial datasets. Use it to create immersive 3D map experiences with Photorealistic 3D Tiles such as flight simulators, explainers, games and more.

Getting Started

Earthatile depends upon Google's Photorealistic 3D Tiles API. To access it, you need an API key. You can obtain a key by setting up a Google Cloud project with a billing account. You then need to enable the Map Tiles API. To learn more, see Setup in Cloud Console. Once you have your API key, you can:

Node.js

If you want to run Earthatile in Node, you simply need to add it as a dependency in your package.json:

npm install earthatile

PlayCanvas

Earthatile is supplied with an integration for PlayCanvas.

1. Ensure you have the Draco WASM module in your project (set Settings > Asset Tasks > Mesh Compression to Draco and import the module).
2. Copy dist/earthatile.js to the Asset Panel in the Editor.
3. Copy integrations/playcanvas/*.js to the Asset Panel in the Editor.
4. Create an Entity and add a Script Component.
5. Assign tileRenderer and geolocation scripts to the Script Component.
6. Add a Script Component to your Camera entity.
7. Assign the flyCamera script to the Script Component.
8. Launch the scene. 🚀

Alternatively, fork this project.