PMTiles 开源项目教程

PMTiles 开源项目教程

PMTilesCloud-optimized + compressed single-file tile archives for vector and raster maps项目地址:https://gitcode.com/gh_mirrors/pm/PMTiles

项目介绍

PMTiles 是一个用于矢量和栅格地图的云优化压缩单文件瓦片存档格式。PMTiles 存档可以托管在如 S3 这样的商品存储平台上，实现低成本、零维护的地图应用，这些应用是“无服务器”的，即无需自定义瓦片后端或第三方提供商。PMTiles 项目由 protomaps 维护，旨在提供一个高效、便捷的地图数据存储和分发解决方案。

项目快速启动

安装 PMTiles 工具

首先，从 go-pmtiles/Releases 下载适用于您系统的 pmtiles 二进制文件。

创建 PMTiles 存档

使用以下命令将 .mbtiles 文件转换为 .pmtiles 文件：

pmtiles convert INPUT.mbtiles OUTPUT.pmtiles

上传 PMTiles 存档

将生成的 .pmtiles 文件上传到 S3 存储桶：

pmtiles upload OUTPUT.pmtiles s3://my-bucket region=us-west-2

确保设置 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY 环境变量。

应用案例和最佳实践

创建 PMTiles 存档示例

以下是一个从美国人口普查局邮政编码区域 shapefile 创建 PMTiles 存档的示例：

# 使用 GDAL/OGR 将 SHP 转换为 GeoJSON
ogr2ogr -t_srs EPSG:4326 cb_2018_us_zcta510_500k.json cb_2018_us_zcta510_500k.shp

# 创建一个名为 "zcta" 的矢量瓦片层
tippecanoe -zg --projection=EPSG:4326 -o cb_2018_us_zcta510_500k_nolimit.pmtiles -l zcta cb_2018_us_zcta510_500k.json

上传到存储

使用 PMTiles 命令行工具上传本地 PMTiles 文件到云存储：

pmtiles upload LOCAL.pmtiles "s3://BUCKET_NAME endpoint=https://example.com&region=region" REMOTE.pmtiles

典型生态项目

使用 PMTiles 的 JavaScript 库

PMTiles 提供了在 Leaflet 或 MapLibre GL JS 中使用的 JavaScript 库。请参考 js/README.md 和 js/examples 获取详细用法。

使用 PMTiles 的 OpenLayers

PMTiles 也支持在 OpenLayers 中使用。请参考 openlayers/README.md 获取详细用法。

使用 PMTiles 的 Python 库

PMTiles 提供了 Python 库，用于在 Python 环境中使用 PMTiles。请参考 python/bin 获取详细用法。

通过这些生态项目，PMTiles 可以无缝集成到各种地图应用中，提供高效、便捷的地图数据存储和分发解决方案。

PMTilesCloud-optimized + compressed single-file tile archives for vector and raster maps项目地址:https://gitcode.com/gh_mirrors/pm/PMTiles