# Licenses & Attribution

This document summarises the licenses governing the data, code, and third-party
dependencies used across the Unearth AI platform. It is the canonical reference
for every dataset page, the mapping tool, and the data marketplace.

Last updated: 2026-04-27

---

## 1. Source Data Licenses

| Dataset | Primary source | License | Share-alike? | Commercial use |
|---|---|---|---|---|
| Co-living | OpenStreetMap | [ODbL 1.0](https://opendatacommons.org/licenses/odbl/) | Yes (on Derivative DBs) | ✅ |
| Coworking | OpenStreetMap | [ODbL 1.0](https://opendatacommons.org/licenses/odbl/) | Yes (on Derivative DBs) | ✅ |
| Self-storage | OpenStreetMap | [ODbL 1.0](https://opendatacommons.org/licenses/odbl/) | Yes (on Derivative DBs) | ✅ |
| Solar farm | OpenStreetMap | [ODbL 1.0](https://opendatacommons.org/licenses/odbl/) | Yes (on Derivative DBs) | ✅ |
| Data centers | OpenStreetMap + Unearth Data Intelligence | ODbL 1.0 + proprietary | Mixed | ✅ |
| EV charger | Open Charge Map + OpenStreetMap | [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) + ODbL 1.0 | Yes | ✅ |

### 1.1 OpenStreetMap (ODbL)

- License: [Open Database License 1.0](https://opendatacommons.org/licenses/odbl/)
- Required attribution: "© OpenStreetMap contributors"
- Attribution link: https://www.openstreetmap.org/copyright
- **Share-alike trigger:** if Unearth publishes a "Derivative Database"
  (a substantial extraction or transformation of OSM data), that database
  must also be licensed under ODbL.
- **Produced Works** (visualisations, reports, screenshots, individual
  records returned via API queries) only require attribution, not relicensing.

### 1.2 Open Charge Map (CC BY-SA 4.0)

- License: [Creative Commons Attribution-ShareAlike 4.0 International](https://creativecommons.org/licenses/by-sa/4.0/)
- Required attribution: "Open Charge Map contributors, CC BY-SA 4.0"
- Attribution link: https://openchargemap.org/
- **Share-alike trigger:** any redistributed dataset derived from OCM data
  must also be CC BY-SA 4.0.

### 1.3 Unearth AI Data Intelligence (proprietary)

Records sourced from Unearth's internal data intelligence pipeline (currently
seeded from `data_centers_global.csv`, ~9,599 facilities) are proprietary to
Unearth AI Inc. Subscribers receive a usage license per the Unearth Data
Marketplace Terms of Service.

---

## 2. Compliance Practices

### 2.1 Attribution placement

| Surface | How attribution appears |
|---|---|
| Dataset pages (`coliving/`, `coworking/`, etc.) | `<footer>` `.footer-bottom` block with linked source + license |
| Mapping tool (`mapping/`) | Leaflet basemap attribution control covers tiles + dataset overlays |
| CSV exports (mapping tool) | Comment-lines at end of file naming all sources + license URLs |
| API responses (planned) | `meta.source` + `meta.license` fields on every payload |

### 2.2 Share-alike posture

- **End-user data via API queries / individual lookups:** Produced Work — attribution only, no relicensing.
- **Bulk dataset downloads (Pro tier and up):** treated as Derivative Databases — distributed under ODbL or CC BY-SA as appropriate. Bulk download endpoints must include the corresponding `LICENSE.txt` file in the archive.
- **Internal Unearth analytics:** Produced Work, no special obligation.

### 2.3 Tiered export caps (mapping tool)

To minimise Derivative-Database exposure for free/cheap tiers, the mapping
tool enforces row caps:

| Plan | Cap | License posture |
|---|---|---|
| Free | 50 rows | Produced Work — attribution only |
| Starter | 1,000 rows | Produced Work — attribution only |
| Pro | 10,000 rows | Approaches Derivative DB threshold for some queries; CSV footer includes ODbL/CC BY-SA notice |
| Enterprise (planned) | Bulk download | Derivative DB — distributed under ODbL/CC BY-SA |

---

## 3. Things We Will Not Do

The following sources have been audited and rejected as data inputs because
their terms of service prohibit commercial use, scraping, or redistribution:

| Source | Issue |
|---|---|
| coliving.com | ToS explicitly prohibits scraping; full copyright on all listings; commercial use disallowed |
| Loopnet, CoStar, Crexi, etc. | Commercial real-estate aggregators — proprietary; require paid licensing |
| Yelp, TripAdvisor, Google Maps Places | ToS prohibits redistribution / derivative databases |

Replacement strategy for coliving: OSM-based fetcher (current, ~117 records)
plus operator partnerships and community submissions (planned).

---

## 4. Code License (this repository)

Code in this repository (HTML, CSS, JavaScript, build scripts, GitHub Actions
workflows) is © 2026 Unearth AI Inc. All rights reserved unless otherwise
noted. Third-party dependencies retain their own licenses; see `package.json`
files and CDN script tags for details.

Third-party libraries used at runtime:

| Library | License |
|---|---|
| [Leaflet](https://leafletjs.com/) | BSD-2-Clause |
| [Leaflet.markercluster](https://github.com/Leaflet/Leaflet.markercluster) | MIT |
| [PapaParse](https://www.papaparse.com/) | MIT |
| [CARTO basemap tiles](https://carto.com/attributions) | Attribution required (see Leaflet attribution control) |

---

## 5. Reporting Issues

If you believe data on the Unearth platform infringes a license you hold or
misattributes a source, email **legal@unearth-ai.com** with the dataset name,
record IDs, and a description of the issue. We will respond within 5 business
days and remove or correct the records as appropriate.