Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 0 additions & 19 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,25 +2,6 @@
version: 2
updates:

# Maintain NPM dependencies for overture-tiles-cdk
- package-ecosystem: "npm"
directory: "/overture-tiles-cdk"
schedule:
interval: "weekly"
open-pull-requests-limit: 5
labels:
- "bot"
commit-message:
prefix: "[CHORE](deps)"
include: "scope"
groups:
aws:
patterns:
- "aws*"
- "@aws-cdk*"
cooldown:
default-days: 7

# Maintain GitHub Actions dependencies
- package-ecosystem: "github-actions"
directory: "/"
Expand Down
3 changes: 1 addition & 2 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
*.pmtiles
*.parquet
data
*.jar
overture-tiles-cdk/cdk.context.json
*.jar
17 changes: 4 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,11 @@
Create tilesets from [Overture Maps](http://overturemaps.org) data.

## Overview
This project provides tools to create vector tilesets in PMTiles format from Overture Maps data using Planetiler. It includes AWS CDK constructs for deploying the necessary infrastructure to generate and host the tilesets.
This project provides tools to create vector tilesets in PMTiles format from Overture Maps data using Planetiler.

> **Note**: Currently focused on AWS infrastructure (S3 & Batch), though the core processing runs in Docker containers
A reusable Terraform/OpenTofu module to create tilesets on AWS is available at [OvertureMaps/terraform-aws-overture-tiles](https://github.com/OvertureMaps/terraform-aws-overture-tiles).

## Project Structure
The repository is organized into the following main components:
- **Infrastructure**: AWS CDK constructs to deploy the processing and hosting infrastructure.
- **Profiles**: Planetiler profiles to define how to process Overture Maps data into vector tiles for all six themes.
For detailed deployment instructions, see the [Overture Tiles documentation](https://docs.overturemaps.org/examples/overture-tiles/).

## Architecture
The tile generation pipeline follows a three-stage process:
Expand All @@ -37,16 +34,10 @@ The Docker container accepts the following environment variables:
| `SKIP_UPLOAD` | No | Set to `true` to skip S3 upload (useful for local testing) |

## Profiles
All six themes (`base`, `transportation`, `buildings`, `addresses`, `places`, and `divisions`) are processed using Planetiler profiles. See [profiles/](profiles/) for details.
All six themes (`addresses`, `base`, `buildings`, `divisions`, `places`, `transportation`) are processed using Planetiler profiles. See [profiles/](profiles/) for details.

Currently, profiles are fixed within the Docker image. There are plans to support custom profiles in the future.

## Deploying to AWS
The CDK stack creates AWS Batch infrastructure for processing tiles at scale. Configure your S3 bucket and AWS account in [overture-tiles-cdk/bin/overture-tiles-cdk.ts](overture-tiles-cdk/bin/overture-tiles-cdk.ts), then deploy with standard CDK commands or use the [justfile](justfile) recipes.

For detailed deployment instructions, see the [Overture Tiles documentation](https://docs.overturemaps.org/examples/overture-tiles/).


## Development

### Prerequisites
Expand Down
24 changes: 0 additions & 24 deletions justfile
Original file line number Diff line number Diff line change
@@ -1,35 +1,11 @@
#!/usr/bin/env just --justfile

cdk_dir := 'overture-tiles-cdk'
latest_release := `curl -s https://stac.overturemaps.org | jq -r '.latest'`
overture_bucket := 's3://overturemaps-us-west-2'

@_default:
{{ just_executable() }} --list

# Bootstrap the CDK environment
[group('setup')]
bootstrap-cdk:
cd {{ cdk_dir }} && npm install && npm run build

# Deploy the CDK stack
[group('setup')]
deploy-cdk bucket_name account region create_bucket='false':
cd {{ cdk_dir }} && npm run cdk deploy -- \
-c bucketName={{ bucket_name }} \
-c account={{ account }} \
-c region={{ region }} \
-c createBucket={{ create_bucket }}

# Destroy the CDK stack
[group('setup')]
destroy-cdk account region bucket_name='' delete_bucket='false':
cd {{ cdk_dir }} && npm run cdk destroy -- \
-c bucketName={{ bucket_name }} \
-c account={{ account }} \
-c region={{ region }} \
-c deleteBucket={{ delete_bucket }}

# Run a local test of the Docker container with the city of San Francisco. It skips uploading the generated PMTiles
[arg('theme', pattern='base|transportation|buildings|addresses|places|divisions')]
[group('test')]
Expand Down
7 changes: 0 additions & 7 deletions overture-tiles-cdk/.gitignore

This file was deleted.

6 changes: 0 additions & 6 deletions overture-tiles-cdk/.npmignore

This file was deleted.

14 changes: 0 additions & 14 deletions overture-tiles-cdk/README.md

This file was deleted.

30 changes: 0 additions & 30 deletions overture-tiles-cdk/bin/overture-tiles-cdk.ts

This file was deleted.

72 changes: 0 additions & 72 deletions overture-tiles-cdk/cdk.json

This file was deleted.

Loading
Loading