OpenStreetMap US Tileservice

March 31, 2026 ยท View on GitHub

This repository contains the source code for the OpenStreetMap US Tileservice.

Overview

This repo contains several loosely related components:

  • cloudflare/ - Cloudflare Worker code that serves tile requests at tiles.openstreetmap.us
  • feeds/ - CF Worker that maintains per-tileset Atom feeds, triggered by R2 upload events
  • logger/ - CF Tail Worker to send logs from the tile serving worker to a Loki log aggregation server
  • renderer/ - Planetiler configs and other scripts for creating vector tiles from OSM data
  • terrain/ - Scripts for generating hillshade raster tiles and contour vector tiles from DEM data
  • website/ - tiles.openstreetmap.us static website
  • static/ - tile.ourmap.us static website

Quick Start

For most users, the easiest way to use OpenStreetMap US tiles is through our hosted service at https://tiles.openstreetmap.us/. See the website documentation for usage examples and API documentation. All usage must comply with our usage policy.

Self-Hosting Options

Custom Server (AWS)

Anyone can access the OSM US-generated tilesets without restrictions by setting up their own custom server using our requester-pays S3 bucket.

Running Your Own Stack

Alternately, you can use the components in this repository to generate and serve your own tiles.

  1. Use the renderer scripts to generate PMTiles from OSM data
  2. Deploy your own copy of the Cloudflare Worker code, or adapt it for another edge computing platform like AWS Lambda.

See individual directory READMEs for detailed setup instructions.

License

The code in this repository is dedicated to the public domain via the CC0 license. You may use it for any purpose, without restriction. See LICENSE for details.