Jian Project TileMap API

HTTPS XYZ Web Mercator 令牌桶限流

底图瓦片代理:标准 {z}/{x}/{y},无需 .png 后缀。CORS 已开放。

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

备站基础地址:https://tilemap.jianproject.cloud/{source}/{z}/{x}/{y}(与主站同源列表与路径约定一致,可作热备 / 分流)

请求方式:GET,响应为图像(jpeg / png)。

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

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

请求地址

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

可用地图源

source 说明 状态 文档
arcwi ArcGIS 卫星影像 已启用 查看
arcwob ArcGIS 海洋底图 已启用 查看
arcwh ArcGIS 山影图 已启用 查看
arcterr ArcGIS 地形底图 已启用 查看
arcphys ArcGIS 自然地形 已启用 查看
arcshade ArcGIS 彩色晕渲 已启用 查看
arctrans ArcGIS 交通路网 已启用 查看

通用约定

  • 公开路径为标准 Web Mercator XYZ;部分底图源坐标系不同,由服务自动转换。
  • 未知 source 返回 404;暂未就绪返回 503;取图失败返回 502。
  • 成功响应带 Cache-Control: public, max-age=3600, stale-while-revalidate=86400。
  • 底图版权归上游机构。当前仅提供 Esri 影像/地形/路网类(无政区/国境标注)。带外国政区名或麦克马洪线画法的街道底图已下架。本服务面向学习研究用途,不得替代官方渠道。

频率限制

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,
    "arcterr": true,
    "arcphys": true,
    "arcshade": true,
    "arctrans": true
  }
}

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 默认一致。
  • 备站将主站主机名换为 tilemap.jianproject.cloud 即可,路径与 source 不变。
  • 请合理缓存瓦片,遵守上游底图版权与使用条款。

ArcGIS 海洋底图

source:arcwob

状态:已启用

说明:Esri World Ocean Base

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

示例

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

ArcGIS 海洋底图 示例瓦片

注意事项

  • 坐标为 Web Mercator XYZ,与 Leaflet / MapLibre / OpenLayers 默认一致。
  • 备站将主站主机名换为 tilemap.jianproject.cloud 即可,路径与 source 不变。
  • 请合理缓存瓦片,遵守上游底图版权与使用条款。

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 默认一致。
  • 备站将主站主机名换为 tilemap.jianproject.cloud 即可,路径与 source 不变。
  • 请合理缓存瓦片,遵守上游底图版权与使用条款。

ArcGIS 地形底图

source:arcterr

状态:已启用

说明:Esri World Terrain Base

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

示例

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

ArcGIS 地形底图 示例瓦片

注意事项

  • 坐标为 Web Mercator XYZ,与 Leaflet / MapLibre / OpenLayers 默认一致。
  • 备站将主站主机名换为 tilemap.jianproject.cloud 即可,路径与 source 不变。
  • 请合理缓存瓦片,遵守上游底图版权与使用条款。

ArcGIS 自然地形

source:arcphys

状态:已启用

说明:Esri World Physical Map

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

示例

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

ArcGIS 自然地形 示例瓦片

注意事项

  • 坐标为 Web Mercator XYZ,与 Leaflet / MapLibre / OpenLayers 默认一致。
  • 备站将主站主机名换为 tilemap.jianproject.cloud 即可,路径与 source 不变。
  • 请合理缓存瓦片,遵守上游底图版权与使用条款。

ArcGIS 彩色晕渲

source:arcshade

状态:已启用

说明:Esri World Shaded Relief

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

示例

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

ArcGIS 彩色晕渲 示例瓦片

注意事项

  • 坐标为 Web Mercator XYZ,与 Leaflet / MapLibre / OpenLayers 默认一致。
  • 备站将主站主机名换为 tilemap.jianproject.cloud 即可,路径与 source 不变。
  • 请合理缓存瓦片,遵守上游底图版权与使用条款。

ArcGIS 交通路网

source:arctrans

状态:已启用

说明:Esri World Transportation(半透明路网,宜叠在影像上)

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

示例

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

ArcGIS 交通路网 示例瓦片

注意事项

  • 坐标为 Web Mercator XYZ,与 Leaflet / MapLibre / OpenLayers 默认一致。
  • 备站将主站主机名换为 tilemap.jianproject.cloud 即可,路径与 source 不变。
  • 请合理缓存瓦片,遵守上游底图版权与使用条款。