Use Earthscale in Your Products

You can easily use Earthscale's tile servers from any common map rendering library that supports XYZ tiles.

These are URLs formatted using placeholders for WebMercator tile coordinates like {x}, {y}, {z}.

A common workflow is to:

• Add a dataset using the Earthscale web app

• Configure the visualization in the web app

• Export the tile server URL or download an example that uses your data

Steps

• Open the dataset details window by clicking on the triple dots icon on a dataset in the sidebar and selecting "View Details" in the menu:

• Click "Add to Application" on the right-hand side:

• In this dialog, you can either copy the tile server URL at the top, or select the framework that you use and download or copy an example file:

• And open the example in your browser:

Automate it

You can use the Python API to add datasets and get their tile server URLs. For visualization parameters, we recommend configuring them once in the Earthscale web UI, and then reusing the parameters from the tile server URL displayed in the dataset details. You can also edit visualizations directly through the API parameters, see the tile server URL specification.

Security

To ease integration into your products, our tile servers use per-user API keys for authentication. You can see your API key in the exported URLs, as they are passed as GET parameters. We can revoke access to API keys at any time. If you accidentally leaked an API key or have a need for more advanced authentication, just contact us on Slack or email, and we will handle it quickly.

You can also view your API key under the "API Settings" in the user menu. In that menu, you can also restrict which website domains can call the tile servers, so that only your applications can access them.