Skip to content

charliemcgrady/overture-tiles

 
 

Repository files navigation

Overture Tiles

Create tilesets from Overture Maps data.

These tilesets display an "X-ray" visualization of Overture data, for inspecting the breadth of Overture data and attributes. They are not designed to be a production-ready cartographic basemap.

Each Overture theme has an associated PMTiles file.

View these tilesets in your browser:

  • addresses

  • base

  • buildings

  • divisions

  • places

  • transportation

  • S3: s3://overturemaps-tiles-us-west-2-beta/RELEASE/THEME.pmtiles

  • HTTP: https://overturemaps-tiles-us-west-2-beta.s3.amazonaws.com/RELEASE/THEME.pmtiles

  • THEME: one of addresses, base, buildings, divisions, places, transportation

  • RELEASE: The Overture release name, not including minor version. For example, theme buildings in data release 2024-07-22.0 will have tiles object name 2024-07-22/buildings.pmtiles.

How to Use

Accessing only the data you want

To create a new tileset for only part of the world, use the extract command of the pmtiles CLI.

To get all buildings tiles around Ghent, Belgium:

pmtiles extract https://overturemaps-tiles-us-west-2-beta.s3.amazonaws.com/2024-07-22/buildings.pmtiles ghent.pmtiles --bbox=3.660507,51.004250,3.784790,51.065996

Building Tilesets

On AWS

Included is a AWS CDK configuration for automating tileset creation using AWS Batch.

Other Environments

Requirements

Scripts

You can build the tilesets from raw data, modifying the profiles/ and scripts/.

  • Copy the Overture Parquet dataset to your local machine using these docs. If you want to only run on a small sample of data, you can use only the first .parquet file instead of all in the directory.

  • for the base, buildings and transportation themes, generate the tileset with java:

# --data indicates where your Overture data is (overture/theme=base/...)
java -cp planetiler.jar profiles/Base.java --data=overture

The above command outputs base.pmtiles in the data dir.

  • for other themes, run the theme script in themes/:
scripts/2024-07-22/places.sh overture places.pmtiles

This reads from Overture data in overture and writes places.pmtiles.

Releases

No releases published

Packages

No packages published

Languages

  • Shell 40.6%
  • Java 25.4%
  • HTML 20.4%
  • TypeScript 8.5%
  • Dockerfile 2.9%
  • JavaScript 2.2%