全球蓝色版切片服务 ​

1 服务介绍 ​

矢量切片是一类 Web API 接口服务，矢量切片文件采用 Google Protocol Buffers 进行编码。Google Protocol Buffers 是一种兼容多语言、多平台、易扩展的数据序列化格式。矢量切片文件的后缀应该为 pbf。例如，vector.pbf。矢量切片的 MIME 类型应该设置为 application/x-protobuf。

  • 获取切片集元数据
    获取指定矢量切片数据服务的切片集元数据。

  • 获取矢量切片
    根据矢量切片图层名称、切片级别、切片行列号、切片数据格式等参数获取矢量切片数据。

  • 获取地图样式
    获取指定矢量切片数据服务的地图样式，样式 ID 的对照表格。

  • 获取符号
    获取地图符号 JSON 数据/图片文件。

  • 获取字体
    根据字体名称、字体范围，获取字体文件。

2 使用说明 ​

  1. 根据切片集 ID 获取切片集 JSON。
  2. 根据样式 ID 获取样式 JSON，返回的 JSON 中包含了 PBF 文件，雪碧图，字体文件的 URL。

3 切片集元数据接口 ​

3.1 接口说明 ​

接口描述接口地址
接口地址http(s): //ip:port/api/v1/tilesets/:data_id
HTTP请求模式GET

3.2 返回结果示例 ​

{
    "center":[
        90,
        42.525564,
        1
    ],
    "bounds":[
        -180,
        -85.051129,
        180,
        85
    ],
    "vector_layers":[

    ],
    "tiles":[
        "http://172.16.101.13:8099/api/v1/tiles/11/{z}/{x}/{y}.pbf"
    ],
    "_id":"5d09f39df5bb9a0adce23716",
    "data_id":11,
    "name":"1_10_mercator",
    "zoom_min":0,
    "zoom_max":12,
    "format":"pbf",
    "scheme":"zxy",
    "version":"1.0.0",
    "tilejson":"2.1.0",
    "data":[

    ],
    "grids":[

    ],
    "tags":[

    ]
}

4 地图切片接口 ​

4.1 参数说明 ​

接口描述接口地址
接口地址http(s): //ip:port/api/v1/tiles/:data_id/: z/:x/:y.pbf
HTTP请求模式GET

4.2 参数说明 ​

参数名含义规则说明是否必填缺省值
z切片级别---必选
x切片行号---必选
y切片列号---必选

4.3 返回结果示例 ​

PBF文件

5 地图样式接口 ​

5.1 接口说明 ​

接口描述接口地址
接口地址http(s): //ip:port/api/v1/styles/:data_id
HTTP请求模式GET

5.2 返回结果示例 ​

{
    "_id":"60ac9be4b288a347adea2c98",
    "data_id":1,
    "name":"标准版",
    "zoom":2.9,
    "center":[
        104.22743681048,
        29.3326116512331
    ],
    "transition":{
        "duration":300,
        "delay":0
    },
    "layers":[

    ],
    "version":8,
    "glyphs":"http://172.16.101.13:8099/api/v1/fonts/{fontstack}/{range}",
    "sprite":"http://172.16.101.13:8099/api/v1/sprites/1/sprite",
    "sources":{

    },
    "metadata":{

    },
    "type":"tiles",
    "epsg":"EPSG:4490"
}

6 地图符号接口 ​

6.1 接口说明 ​

接口描述接口地址
接口地址（雪碧图）http(s): //ip:port/api/v1/sprites/:data_id/sprite.png
接口地址（响应描述文件）http(s): //ip:port/api/v1/sprites/:data_id/sprite.json
HTTP请求模式GET

6.2 返回结果示例 ​

雪碧图

7 地图字体接口 ​

7.1 接口说明 ​

接口描述接口地址
接口地址（雪碧图）http(s): //ip:port/api/v1/fonts/: fontstack/:range.pbf
HTTP请求模式GET

7.2 参数说明 ​

参数名含义规则说明是否必填缺省值
fontstack字体名称---必选
range字体范围---必选

7.3 返回结果示例 ​

字体文件。