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
健康检查示例
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

注意事项
- 坐标为 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

注意事项
- 坐标为 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

注意事项
- 坐标为 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

注意事项
- 坐标为 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

注意事项
- 坐标为 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

注意事项
- 坐标为 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

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