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:

Use with AI Assistants

Earthscale provides a "Use Map in AI" feature that generates instructions for AI assistants to work with your map data. This feature:

• Generates a structured prompt with metadata about all datasets currently loaded in your map

• Includes tile server URLs and point query endpoints for each dataset

• Provides dimension information for raster datasets (e.g., time series data)

• Formats everything with clear instructions for the AI to use the Earthscale API

Steps

1. Click the Use Map in AI (sparkle) button in the map interface

2. Copy the generated prompt snippet

3. Paste it into your AI assistant (ChatGPT, Claude, etc.)

4. The AI can then:

• Generate code to visualize your data in frameworks like Leaflet, Folium, or MapLibre

• Create point queries to fetch pixel values at specific coordinates

• Handle multi-dimensional data by selecting appropriate dimension indices

• Respect zoom level constraints for optimal tile loading

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.