PMTiles/serverless/aws/README.md

PMTiles on Lambda

Generates a Lambda function for deploying PMTiles on Lambda behind Lambda Function URLs or API Gateway. (CloudFront is recommended as a cache in front.)

How To Use

git clone https://github.com/protomaps/PMTiles
cd serverless/aws
python create_lambda_function.py

Upload the resulting lambda_function.zip using the Lambda console.

Configure these Lambda environment variables:

• BUCKET: the S3 bucket name.
• PMTILES_PATH: optional, define how a tileset name is translated into an S3 key. Default {name}.pmtiles
  • Example path setting for objects in a directory: my_folder/{name}/file.pmtiles
• TILE_PATH: optional, define the URL route of the tiles API. Default /{name}/{z}/{x}/{y}.pbf

Test Event

API Gateway V2 / Lambda Function URLs:

{
  "rawPath": "/my-tileset-name/0/0/0.pbf"
}

Monitoring

Lambda@Edge

Lambda@Edge's multi-region features have little benefit when fetching data from S3 in a single region, and Lambda@Edge doesn't support environment variables or responses over 1 MB. For globally distributed caching, use CloudFront in combination with Lambda Function URLs.