The Local Geohistory Project aims to educate users and disseminate information concerning the geographic history and structure of political subdivisions and local government. This repository contains a process to create a PMTiles archive based on the Daylight map distribution for use as a base map layer, which takes about two hours to run.
To start the process, the create-instance.sh shell script creates a compute-optimized instance in AWS capable of processing the large OpenStreetMap and related datasets. Inside this instance, the process-tile.sh shell script handles the steps from processing to uploading of the final archive.
The datasets are prepared for tiling using Osmconvert and the Osmium Tool, including clipping Microsoft Building Footprints to the area delimited by Simplified10.poly, filtering Administrative boundaries to only national and the highest subnational boundaries, renumbering IDs to avoid conflicts, reformatting, and merging the disparate datasets into one planet file for tiling.
Planetiler is then used to create two intermediate MBTiles archives: one with the entire planet through zoom level 10, and another clipped to the previously delimited geographic area for higher zoom levels. These MBTiles archives are then combined into another intermediate MBTiles archive using tilelive-copy. The go-pmtiles utility then converts the tileset to the final PMTiles archive, which is then uploaded to a bucket compatible with AWS S3 (including Cloudflare R2).
When processing is complete, the instance is terminated in order to limit processing costs. However, it is recommended to verify that termination was successful via AWS's web console to avoid unanticipated charges.
These instructions were created using Ubuntu; however, URLs to software instructions are provided to facilitate installations on other operating systems.
In order to create an instance, an AWS account is required. Certain resources may need to be created in EC2 and S3 prior to running the process. More information about AWS is available at:
Several components must be installed to build the application. On Ubuntu, run the following code via Terminal:
sudo apt-get install awscli gitMore detailed installation instructions for AWS Command Line Interface (AWS CLI) are available at:
https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html
More detailed installation instructions for Git are available at:
Navigate to the folder where the process code will be downloaded, then run the following command using a program such as Git BASH or Terminal:
git clone https://github.com/localgeohistoryproject/tile-creation.git tile-creationThis will create a subfolder named tile-creation, which contains the process code.
Within the newly-created tile-creation folder, the root folder contains a Sample.env file that can be used to create the necessary .env file for the process, which is where information like credentials is stored.
First, copy the Sample.env, and name the copy .env (with nothing before the period). Then, populate the values labeled ***, following the directions in the file.
Once configurations are finalized, the create-instance.sh shell script can be executed in Terminal, as the below example illustrates:
./create-instance.shThe Simplified10.poly and Simplified25.poly files are used to clip certain datasets to roughly within 0.1 or 0.25 degrees, respectively, of the Local Geohistory Project coverage area. This allows the tile archive to omit higher zoom levels and associated data for geographic areas outside of the required scope.
For more information on how to format these files for projects with other geographic scopes, see Osmosis's documentation on the Polygon Filter File Format.
This repository does not include the code required to serve the tiles. See the Protomaps documentation for more information.
For an example of how served tiles can be incorporated into a web application, see the Application repository.