Jian Project TileMap API

HTTPS XYZ Web Mercator 令牌桶限流

底图瓦片代理，用法兼容 Fan Studio tilemap：标准 {z}/{x}/{y}，无需 .png 后缀。CORS 已开放。

基础地址：https://tilemap.sismotide.top/{source}/{z}/{x}/{y}

请求方式：GET，响应为图像（jpeg / png）。

鉴权：不需要访问令牌。防滥用见 频率限制。

说明：本页为瓦片说明；JSON 气象 GET 见 /get/；WebSocket 见 /api/。

请求地址

类型 地址
瓦片 https://tilemap.sismotide.top/{source}/{z}/{x}/{y}
健康检查 https://tilemap.sismotide.top/health

可用地图源

source 说明 状态 文档
arcwi ArcGIS 卫星影像 已启用 查看
arcwob ArcGIS 地形图 已启用 查看
arcwh ArcGIS 山影图 已启用 查看
petallight PetalMap 矢量图 亮 暂未就绪 查看
petaldark PetalMap 矢量图 暗 暂未就绪 查看

通用约定

  • 公开路径为标准 Web Mercator XYZ；ArcGIS 上游内部为 {z}/{y}/{x}，由服务自动转换。
  • 未知 source 返回 404；暂未就绪源返回 503；上游失败返回 502（不写空缓存）。
  • 成功响应带 Cache-Control: public, max-age=3600, stale-while-revalidate=86400。
  • 底图版权归上游机构；本服务面向学习研究用途，不得替代官方渠道。

频率限制

TileMap 不需要访问令牌。瓦片请求高频，采用按客户端真实 IP 的令牌桶（与 GET JSON「每秒 1 次」不同）。

默认限额

项目 规则
稳态 约 20 次/秒 / IP
突发 约 60 令牌突发
计入路径 /{source}/{z}/{x}/{y} 瓦片请求
不计频 / 文档页、/health 不计入

超限响应

超过限制时返回 HTTP 429，正文为 JSON：

请求过于频繁
{
  "error": "请求过于频繁，请稍后重试"
}

对接建议

  • 地图库应对已加载瓦片做本地 / CDN 缓存，避免重复拉同一块。
  • 收到 429 后应退避，勿瞬时连打。
  • 更多说明见 服务条款 与 隐私政策。

消息协议

全部为 HTTPS GET。业务瓦片响应为二进制图像；错误与健康检查为 JSON。

瓦片

image/jpeg 或 image/png

健康检查

/health → status + sources

错误

JSON：{"error":"..."}

健康检查示例

GET /health
{
  "status": "正常",
  "service": "tilemap",
  "sources": {
    "arcwi": true,
    "arcwob": true,
    "arcwh": true,
    "petallight": false,
    "petaldark": false
  }
}

ArcGIS 卫星影像

source：arcwi

状态：已启用

说明：Esri World Imagery

请求地址：https://tilemap.sismotide.top/arcwi/{z}/{x}/{y}

示例

https://tilemap.sismotide.top/arcwi/7/101/52

ArcGIS 卫星影像 示例瓦片

注意事项

  • 坐标为 Web Mercator XYZ，与 Leaflet / MapLibre / OpenLayers 默认一致。
  • 请合理缓存瓦片，遵守上游底图版权与使用条款。

ArcGIS 地形图

source：arcwob

状态：已启用

说明：Esri World Ocean Base（与 Fan Studio arcwob 对齐）

请求地址：https://tilemap.sismotide.top/arcwob/{z}/{x}/{y}

示例

https://tilemap.sismotide.top/arcwob/7/101/52

ArcGIS 地形图 示例瓦片

注意事项

  • 坐标为 Web Mercator XYZ，与 Leaflet / MapLibre / OpenLayers 默认一致。
  • 请合理缓存瓦片，遵守上游底图版权与使用条款。

ArcGIS 山影图

source：arcwh

状态：已启用

说明：Esri World Hillshade

请求地址：https://tilemap.sismotide.top/arcwh/{z}/{x}/{y}

示例

https://tilemap.sismotide.top/arcwh/7/101/52

ArcGIS 山影图 示例瓦片

注意事项

  • 坐标为 Web Mercator XYZ，与 Leaflet / MapLibre / OpenLayers 默认一致。
  • 请合理缓存瓦片，遵守上游底图版权与使用条款。

PetalMap 矢量图 亮

source：petallight

状态：暂未就绪

说明：上游对齐后启用

请求地址：https://tilemap.sismotide.top/petallight/{z}/{x}/{y}

示例

https://tilemap.sismotide.top/petallight/7/101/52

该源暂未对外出图；就绪后上述 URL 将返回图像。

注意事项

  • 坐标为 Web Mercator XYZ，与 Leaflet / MapLibre / OpenLayers 默认一致。
  • 请合理缓存瓦片，遵守上游底图版权与使用条款。

PetalMap 矢量图 暗

source：petaldark

状态：暂未就绪

说明：上游对齐后启用

请求地址：https://tilemap.sismotide.top/petaldark/{z}/{x}/{y}

示例

https://tilemap.sismotide.top/petaldark/7/101/52

该源暂未对外出图；就绪后上述 URL 将返回图像。

注意事项

  • 坐标为 Web Mercator XYZ，与 Leaflet / MapLibre / OpenLayers 默认一致。
  • 请合理缓存瓦片，遵守上游底图版权与使用条款。