HomeMapGlobeStudioExploreDocsStatusContributeAboutGitHub

Contribute Data

OpenZenith thrives on community-contributed data. Here's how you can add your geospatial datasets, data layers, and tools to the platform. All data is reviewed before being integrated.

How To Contribute

1

Prepare Your Data

Format your geospatial data in a supported format. We accept GeoJSON, CSV, and other standard formats. Ensure coordinates use WGS84 (lat/lon).

2

Submit for Review

Upload your data or open a pull request with a proposal. Include documentation of the data source, update frequency, and coverage area.

3

Integration

Once approved, your data layer is added to Globe, the API, or the data explorer with full attribution.

4

Ongoing Updates

For live data sources, set up automated updates or periodic refreshes. We support polling, webhooks, and push-based ingestion.

Supported Formats

Upload Your Data

↑
Drop a file here or click to browse
GeoJSON, CSV, GPX, or plain text · Max 50 MB

Data Source Integration

We can ingest data from various real-time and static sources:

Static GeoJSON / CSV Files

Upload point, line, or polygon datasets. Ideal for place markers, boundaries, trails, and point clouds. Hosted on GitHub alongside the code or on your own CDN.

ArcGIS REST Services

We already proxy ArcGIS FeatureServer queries. If you have a public ArcGIS service, we can add it to the data explorer for interactive querying.

Overpass API / OSM

Any Overpass QL query can be saved as a preset. Suggest new quick-query templates for the Explore page.

Real-Time Feeds (WMS/WFS/WCS)

Weather data, satellite imagery, and other OGC-standard services can be added as live layers to Globe with configurable refresh intervals.

Custom Tile Services

Have a custom tile server? We can add XYZ tile sources, WMTS layers, or TMS endpoints as basemap or overlay options.

API Endpoints

If you have a REST API serving geospatial data, we can create a proxy endpoint (like /api/flights) to fetch and display it on Globe.

Contribute via Pull Request

The easiest way to contribute is via a GitHub pull request. Here's the process:

Fork the Repository

Click "Fork" on GitHub to create your copy.

Prepare Your Data

Place your data file in an appropriate location. For static datasets, the public/data/ directory works well. Include metadata (source, license, coverage).

Add a Route or Layer

Create a new API route in src/app/api/ or add your data as a layer in the Globe component. Include proper attribution.

Update Documentation

Add your endpoint to the OpenAPI spec in src/app/api/openapi.json/route.ts and update the docs page.

Open a Pull Request

Describe what your data is, where it comes from, and how often it updates. We'll review, test, and merge.

API Integration Points

For developers, here's how to integrate your data with OpenZenith:

// Add a new data source proxy (see src/app/api/proxy/ for examples)
// Route: /api/{your-dataset}
export async function GET(request) {
const url = `https://your-api.com/data`;
const res = await fetch(url);
const data = await res.json();
return NextResponse.json(data, {
headers: { "Access-Control-Allow-Origin": "*" },
});
// Add to Globe as a toggleable layer // See src/app/globe/page.tsx loadEarthquakes() for patterns

Submit a Proposal

Have a dataset you'd like to add? Want to discuss integration? Submit a proposal below and we'll get back to you.