Skip to content

Latest commit

 

History

History
32 lines (19 loc) · 2.31 KB

README.md

File metadata and controls

32 lines (19 loc) · 2.31 KB

AWS Planetiler

A service for downloading planet.mbtiles with weekly some updates.

Overview

In the past, it was difficult to get up-to-date vector tiles from OpenStreetMap for self-hosting. While it was straightforward to download the raw planet.osm.pbf data e.g. from Geofabrik, converting the raw data to a vector tiles planet.mbtiles file was tedious. The processing with OpenMapTiles for example took several days and involved lots of database configuration.

Planetiler is a tool written by Mike Barry which is over 100x faster than the OpenMapTiles method, while still producing an output which is compliant with the OpenMapTiles schema. On a machine with 32 cores, 128 GB ram, and 600 GB SSD, planetiler can render the full planet in something like 2 hours.

AWS Planetiler is a service which converts planet.osm.pbf to planet.mbtiles once a week and stores the output in an S3 bucket s3://planetiler/planet.mbtiles. You can download the up-to-date planet.mbtiles from this bucket and use it for self-hosting. We pay the processing cost on an EC2 instance and the storage cost on the S3 bucket. You pay the download bandwidth, an approach called Requester Pays.

Assets

key last modified size
planet.mbtiles July 4, 2022, 13:26:08 (UTC+02:00) 74.1 GB
switzerland.mbtiles July 4, 2022, 11:27:24 (UTC+02:00) 307.2 MB

Download Instructions

  • Get an AWS account (required for Requester Pays)
  • Install the AWS CLI
  • Run aws s3api get-object --bucket planetiler --request-payer requester --key planet.mbtiles planet.mbtiles

This will download the full planet file. If you want to test with a smaller file first, you can download data for Switzerland only with --key switzerland.mbtiles.

Run Planetiler Yourself

Running Planetiler yourself is a lot of fun. You can get some info on how I automatically start an EC2 instance from a GitHub Actions Workflow and run Planetiler in it in WORKFLOW.md.