# Overture Maps

Elke maand een nieuwe wereldkaart in zes thema's: gebouwen, plaatsen (winkels, horeca, voorzieningen), wegen, adressen, grenzen en ondergrond. Samengevoegd uit OpenStreetMap en andere open bronnen; voor Nederland komen de adressen uit de BAG. Alles als GeoParquet in de cloud, zonder account.

- Uitgever: Overture Maps Foundation, OpenStreetMap
- Gebied: Wereld · Laagste detail: gebouw en adres
- Periode: alleen de laatste releases (60 dagen) · Ververst: maandelijks
- Toegang: Open · Licentie: ODbL (gebouwen, wegen, grenzen, ondergrond); CDLA Permissive 2.0 en andere (plaatsen, adressen)
- Koppelsleutels: GERS-id (vast id per object), coördinaten (WGS84)
- Status: ok (2026-09-23) · release 2026-09-23.1
- URL: https://overturemaps.org

## Wat kun je ermee?
- **Plaatsen per buurt tellen.** Haal de plaatsen voor een Nederlandse stad op en tel per buurt hoeveel cafés, supermarkten of huisartsen er zijn. Overture heeft wereldwijd 81,5 miljoen plaatsen (release 2026-09-23.1).
- **Over de grens kijken met één bestand.** Gebouwen in Nederland, België en Duitsland staan in één schema. Handig voor grensregio's als Limburg en Twente, waar elk land zijn eigen register heeft.
- **Vergelijk met de BAG.** Leg de Overture-gebouwen naast de panden uit de BAG. Waar mist Overture iets, en welke bron gebruikte het (OpenStreetMap, Microsoft, Google)?
- **Volg een object door de tijd.** Elk object heeft een vast GERS-id. Koppel je eigen data één keer aan die ids en vergelijk daarna per maand welke gebouwen of plaatsen erbij kwamen of verdwenen.

## Zo verwerk je het
1. **Zoek de nieuwste release.** De STAC-catalogus noemt de releases en welke de nieuwste is (veld latest). Op 15 oktober 2026 was dat 2026-09-23.1.
   `https://stac.overturemaps.org/catalog.json`
2. **Kies thema en type.** Per type een collectie met aantal rijen, kolommen en licentie, en één item per bestand met het gebied dat het dekt. Gebouwen: 2,53 miljard objecten in 512 bestanden.
   `https://stac.overturemaps.org/2026-09-23.1/buildings/building/collection.json`
3. **Download alleen jouw gebied.** Eén bestand is al gauw 600 MB. De Python-client van Overture haalt alleen een rechthoek op (voorbeeld uit de documentatie, hier met het centrum van Utrecht): pip install overturemaps, dan het commando hieronder.
   `overturemaps download --bbox=5.11,52.08,5.13,52.10 -f geojson --type=building -o utrecht_gebouwen.geojson`
4. **Of vraag met SQL.** DuckDB leest de GeoParquet-bestanden rechtstreeks van S3 (s3://overturemaps-us-west-2/release/<release>/theme=…/type=…/*) en filtert op de kolom bbox, zodat je niet alles binnenhaalt.
   `https://docs.overturemaps.org/getting-data/duckdb/`

## Interessante koppelingen
- Hoe compleet is een open wereldkaart in Nederland? → [pdok-bag](https://www.opendataindex.nl/bron/pdok-bag.md) via locatie (gebouwvorm) of adres. Koppel gebouwen op ligging en tel per gemeente hoeveel BAG-panden een Overture-tegenhanger hebben.
- Welke buurten hebben de meeste voorzieningen? → [pdok-wijkenbuurten](https://www.opendataindex.nl/bron/pdok-wijkenbuurten.md) via ligging binnen de buurtgrens. Tel de plaatsen per buurtvlak en deel door het aantal inwoners uit de buurtcijfers.

## Vergelijkbare bronnen
- [openstreetmap](https://www.opendataindex.nl/bron/openstreetmap.md): De bron van veel Overture-data, maar zonder vaste ids, schema of samenvoeging met andere bronnen.
- [pdok-bag](https://www.opendataindex.nl/bron/pdok-bag.md): Het officiële register van alle Nederlandse adressen en panden, met bouwjaar en gebruiksdoel. Alleen Nederland.

## Waar je op moet letten
- **Oude releases verdwijnen.** Overture houdt een release hoogstens 60 dagen (twee maandreleases) openbaar, vanwege de AVG. Bewaar zelf wat je gebruikt, met het releasenummer erbij.
- **Licentie verschilt per thema.** Gebouwen, wegen, grenzen en ondergrond vallen onder de ODbL (vermeld OpenStreetMap). Plaatsen komen van o.a. Meta, Microsoft en Foursquare onder CDLA Permissive 2.0 of Apache 2.0. Adressen hebben een licentie per land; de Nederlandse uit de BAG zijn CC0.
- **Grote bestanden.** Het bestand met gebouwen dat midden-Nederland dekt (5,2 tot 6,8° oost, 51,4 tot 52,6° noord) is 633 MB en heeft bijna 5 miljoen gebouwen, ook in Duitsland. Filter altijd op bbox voordat je downloadt.
- **Plaatsen zijn niet gecontroleerd.** Plaatsen komen van bedrijven als Meta, Microsoft en Foursquare. Elke plaats heeft een confidence-score voor de kans dat hij echt bestaat, en dubbelingen komen voor. Kies een minimumscore voordat je telt.

## API (Statische STAC-catalogus (1.1.0) + GeoParquet-bestanden op S3 en Azure; PMTiles-tegels)

- Basis: https://stac.overturemaps.org
- Toegang: Geen account of sleutel. S3 en Azure zijn openbaar en niet 'requester pays'. (getest)
- Formaten: json, geoparquet, pmtiles
- Omvang: 2533842612 gebouwen wereldwijd in release 2026-09-23.1 (512 bestanden); plaatsen 81,5 mln, adressen 474 mln, wegsegmenten 352 mln (getest)
- Filteren: Geen zoek-API: de STAC is statisch (geen /search, geen queryables). Kies het bestand via de bbox van de items, of filter in SQL (DuckDB) op de kolom bbox en op velden als class, subtype, country.; 

### Endpoints
- `GET /catalog.json`: Alle releases (child-links) en de nieuwste (latest; 16 okt 2026: 2026-09-23.1), plus het GERS-register (registry) op S3.
- `GET /{release}/catalog.json`: Eén release: schemaversie (2.0.0) en de zes thema's: addresses, base, buildings, divisions, places, transportation.
- `GET /{release}/{thema}/{type}/collection.json`: Eén type (building, building_part, place, address, segment, connector, division, division_area, division_boundary, land, land_use, land_cover, water, infrastructure, bathymetry): licentie, aantal rijen, kolommen, items.
- `GET /{release}/{thema}/{type}/{nnnnn}/{nnnnn}.json`: Item per bestand: bbox die het dekt, num_rows, en de assets aws en azure met adres en file:size.
- `GET s3://overturemaps-us-west-2/release/{release}/theme={thema}/type={type}/*.zstd.parquet`: De GeoParquet-bestanden zelf (ook via https://overturemaps-us-west-2.s3.us-west-2.amazonaws.com/… en Azure overturemapswestus2). Lees ze met DuckDB en filter op de kolom bbox.
- `GET https://tiles.overturemaps.org/{release}/{thema}.pmtiles`: Vectortegels per thema als PMTiles, te lezen met HTTP Range (buildings 180,7 GB, places 18,4 GB).

### Parameters
- `release`: Releasenummer JJJJ-MM-DD.n (2026-08-19.0, 2026-09-23.0, 2026-09-23.1 stonden online op 16 okt 2026). (getest)
- `theme / type`: Mappen in de S3-paden: theme=buildings/type=building enzovoort. (getest)
- `bbox (kolom)`: Elke rij heeft bbox.xmin/xmax/ymin/ymax: filter daarop in DuckDB zodat alleen de nodige delen worden gelezen (NL ongeveer 3,3–7,3° O, 50,7–53,6° N). (uit de beschrijving)

### Kolommen in de GeoParquet-bestanden (selectie, schema 2.0.0) (10)
`id` tekst, `geometry` WKB, `bbox` struct, `names` struct, `sources` lijst, `height` getal, `confidence` getal, `basic_category` tekst, `street, number, postcode` tekst, `version` getal

### Limieten en valkuilen
- Geen rate limit gedocumenteerd. De bestanden zijn groot: een gebouwenbestand is ~525 MB met ~4,9 mln rijen; lees met bbox-filter of HTTP Range in plaats van alles te downloaden. (getest)
- Releases blijven hoogstens 60 dagen staan (AVG). Een adres met een releasenummer werkt dus maar twee maanden; begin altijd bij latest in catalog.json. (ervaring)
- Een HEAD-verzoek op een PMTiles-bestand geeft HTTP 400; een Range-verzoek (bytes=0-126) werkt wel (206, met de totale grootte in Content-Range). (getest)
- De STAC-collecties van places en addresses zeggen alleen license 'other' met een link naar de attributiepagina; per bron verschilt de licentie (places o.a. CDLA Permissive 2.0, Apache 2.0; adressen per land). (getest)
- Items hebben een wereldwijde indeling: één gebouwenbestand dekt een grote strook (midden-Nederland ligt in een bestand dat ook Duitsland bevat). Kijk naar de item-bbox voordat je iets ophaalt. (ervaring)
- De S3-bucket is ook te bladeren: ?list-type=2&prefix=release/&delimiter=/ geeft de releasemappen. Geen robots.txt op stac.overturemaps.org en tiles.overturemaps.org (404). (getest)

### Voorbeeld
```
https://stac.overturemaps.org/catalog.json
```

## Zo haal je het op

### curl
```bash
curl "https://stac.overturemaps.org/2026-09-23.1/places/place/collection.json"
```

### python
```python
import requests

cat = requests.get("https://stac.overturemaps.org/catalog.json").json()
release = cat["latest"]
col = requests.get(f"https://stac.overturemaps.org/{release}/buildings/building/collection.json").json()
print(release, col["license"], col["table:row_count"], "gebouwen wereldwijd")
```


## Voorbeelden met echte cijfers (1)

Per voorbeeld de bevinding, de peildatum en de aanroep die precies deze cijfers ophaalt.

- **Objecten in de wereldkaart van Overture Maps per type: het meest gebouwen (2.534 miljoen objecten), dan adressen en knooppunten van het wegennet** (oktober 2026). Tabel 2026-10-21.0. [Voorbeeld](https://www.opendataindex.nl/voorbeeld/overture-objecten-per-type)
  - `https://stac.overturemaps.org/2026-10-21.0/buildings/building/collection.json`
