星图云开放平台-以卫星遥感为核心的空天信息服务开放平台

历史影像查询（按城市）

更新时间：2025-03-26 16:29:56

接口说明

Datacloud历史影像查询（按城市）API是通过 HTTPS 协议访问远程服务的接口，根据城市名称查询指定城市的历史影像数据。

调用方式

使用 API 前，需要先注册账号并完成用户认证，查看开发指南

服务地址	https://api.open.geovisearth.com/v2/history/years/city
请求方式	GET 方法
接口鉴权	服务密钥授权，您需要申请 token，将 token 作为必填参数拼接在服务地址中一起请求
调用限制	服务调用量的限制请点击这里查阅

请求参数

参数名	含义	规则数据	是否必填	缺省值
cityname	城市名的拼音，暂时仅支持省会、直辖	string	是	/

返回参数

参数名	含义	规则数据
year	影像年份，示例：2017	String
format	地图瓦片的图片格式，示例：webp	String
bounds	影像的范围，示例： [116.937488, 31.505384, 117.74664, 32.306936]	Array
tiles	历史影像的请求地址	Array

调用示例

请求示例

https://api.open.geovisearth.com/v2/history/years/city?token=您的token&cityname=hefei

返回示例

{
    "hefei": [
        {
            "tiles": [
                "https://api.open.geovisearth.com/v2/getStreamReq/plus/v1/time-series/cities/hefei/hefei_2017/tiles/{z}/{x}/{y}.webp?token=be6db9a4e38fc66641e10c370ebe842fe15304eb411a43417f76652af7e4cafe"
            ],
            "scheme": "xyz",
            "year": "2017",
            "format": "webp",
            "bounds": [
                116.937488,
                31.505384,
                117.74664,
                32.306936
            ],
            "type": "overlay",
            "isIntersect": true
        },
        {
            "tiles": [
                "https://api.open.geovisearth.com/v2/getStreamReq/plus/v1/time-series/cities/hefei/hefei_2018/tiles/{z}/{x}/{y}.webp?token=be6db9a4e38fc66641e10c370ebe842fe15304eb411a43417f76652af7e4cafe"
            ],
            "scheme": "xyz",
            "year": "2018",
            "format": "webp",
            "bounds": [
                116.88184,
                31.617984,
                117.636208,
                32.294304
            ],
            "type": "overlay",
            "isIntersect": true
        },
        {
            "tiles": [
                "https://api.open.geovisearth.com/v2/getStreamReq/plus/v1/time-series/cities/hefei/hefei_2019/tiles/{z}/{x}/{y}.webp?token=be6db9a4e38fc66641e10c370ebe842fe15304eb411a43417f76652af7e4cafe"
            ],
            "scheme": "xyz",
            "year": "2019",
            "format": "webp",
            "bounds": [
                116.853224,
                31.467664,
                117.68816,
                32.25132
            ],
            "type": "overlay",
            "isIntersect": true
        },
        {
            "tiles": [
                "https://api.open.geovisearth.com/v2/getStreamReq/plus/v1/time-series/cities/hefei/hefei_2020/tiles/{z}/{x}/{y}.webp?token=be6db9a4e38fc66641e10c370ebe842fe15304eb411a43417f76652af7e4cafe"
            ],
            "scheme": "xyz",
            "year": "2020",
            "format": "webp",
            "bounds": [
                116.933856,
                31.612208,
                117.603096,
                32.286728
            ],
            "type": "overlay",
            "isIntersect": true
        },
        {
            "tiles": [
                "https://api.open.geovisearth.com/v2/getStreamReq/plus/v1/time-series/cities/hefei/hefei_2021/tiles/{z}/{x}/{y}.webp?token=be6db9a4e38fc66641e10c370ebe842fe15304eb411a43417f76652af7e4cafe"
            ],
            "scheme": "xyz",
            "year": "2021",
            "format": "webp",
            "bounds": [
                117.082721,
                31.668084,
                117.464116,
                32.044479
            ],
            "type": "overlay",
            "isIntersect": true
        },
        {
            "tiles": [
                "https://api.open.geovisearth.com/v2/getStreamReq/plus/v1/time-series/cities/hefei/hefei_2022/tiles/{z}/{x}/{y}.webp?token=be6db9a4e38fc66641e10c370ebe842fe15304eb411a43417f76652af7e4cafe"
            ],
            "scheme": "xyz",
            "year": "2022",
            "format": "webp",
            "bounds": [
                116.853278,
                31.467902,
                117.746698,
                32.306875
            ],
            "type": "overlay",
            "isIntersect": true
        }
    ]
}

{
    "hefei": [
        {
            "year": "2019",
            "format": "webp",
            "type": "overlay",
            "bounds": [
                116.853224,
                31.467664,
                117.68816,
                32.25132
            ],
            "scheme": "xyz",
            "tiles": [
                "https://api.open.geovisearth.com/v2/getStreamReq/plus/v1/time-series/cities/hefei/hefei_2019/tiles/{z}/{x}/{y}.webp"
            ],
            "isIntersect": true
        },
        {
            "year": "2017",
            "format": "webp",
            "type": "overlay",
            "bounds": [
                116.937488,
                31.505384,
                117.74664,
                32.306936
            ],
            "scheme": "xyz",
            "tiles": [
                "https://api.open.geovisearth.com/v2/getStreamReq/plus/v1/time-series/cities/hefei/hefei_2017/tiles/{z}/{x}/{y}.webp"
            ],
            "isIntersect": false
        },
        {
            "year": "2018",
            "format": "webp",
            "type": "overlay",
            "bounds": [
                116.88184,
                31.617984,
                117.636208,
                32.294304
            ],
            "scheme": "xyz",
            "tiles": [
                "https://api.open.geovisearth.com/v2/getStreamReq/plus/v1/time-series/cities/hefei/hefei_2018/tiles/{z}/{x}/{y}.webp"
            ],
            "isIntersect": false
        },
        {
            "year": "2020",
            "format": "webp",
            "type": "overlay",
            "bounds": [
                116.933856,
                31.612208,
                117.603096,
                32.286728
            ],
            "scheme": "xyz",
            "tiles": [
                "https://api.open.geovisearth.com/v2/getStreamReq/plus/v1/time-series/cities/hefei/hefei_2020/tiles/{z}/{x}/{y}.webp"
            ],
            "isIntersect": false
        }
    ]
}