创建空间服务API
通过将空间数据管理中的各类型空间数据发布成行业标准的空间服务API,以便后续调用,减少资源操作成本。本文介绍如何创建空间服务API。
前提条件
已创建应用,具体操作,请参见新建应用。
操作步骤
登录数据资源平台控制台。
在页面左上角,单击
图标,选择协同。
在顶部菜单栏,单击
图标,选择目标工作组,单击资产加工。
在左侧导航栏,单击
图标,选择API开发 > 空间服务API。
在API资源页面右上角,单击创建API 。
在创建API向导页面,开始新建API。
设置API基础信息:设置API的名称、所属应用、服务类型、API提供商URL、ContentType、请求方式、调用认证方式、坐标系、投影类型等后,单击下一步。
名称
说明
API名称
需创建API的名称,自定义。
所属应用
API的归属应用,自定义创建,支持在系统设置模块和创建API页面新增应用,关于新建应用,更多请参见新建应用。
服务类型
支持多种服务类型。
OGC WFS服务:地图服务、地理数据服务,符合OGC Web要素服务 (WFS) 规范。
OGC WMS服务:地图服务、影像服务,符合OGC Web地图服务 (WMS) 规范。
OGC WMTS服务:地图服务、影像服务,符合OGC Web地图切片服务 (WMTS)规范的服务。
SuperMap REST服务:超图地图服务,SuperMap工作空间数据。
ArcGIS REST服务:地图服务。
其他GIS服务:除以上这些服务外的GIS服务。
服务URL
联系对应提供商获取。
说明URL地址示例:http://example.com/login
ContentType
根据封装API的contentType类型选择对应值。
请求方式
根据封装的API选择对应的请求方式,支持POST和GET。
API Path
API调用时展示的固定路径,默认自动生成。
调用认证方式
简单身份认证和加密身份认证两种方式,更多信息,请参见认证方式说明。
简单身份认证:适用于工作组内、测试等场景下的API调用,工作组内调用时用API归属应用的AppCode调用。
加密身份认证:通过加密算法计算一个签名并放在请求的Header中即可调用API,具备更高的安全性,适用于API共享后,应用开发场景下API的调用。
标签
自定义,可选。
描述
针对该API增加的描述信息,自定义,必选。
空间数据元信息
坐标系
需创建API坐标系。
投影类型
支持墨卡托、高斯-克吕格、web-墨卡托、UTM、经纬度和其他。
覆盖范围
需创建API覆盖范围,包括全球,全国、省、市县和其他,可选。
坐标范围
需创建API坐标范围,包括左上角经纬度、右下角经纬度具体地理位置,可选。
服务提供者信息
服务提供者的信息。
API配置及测试:设置过滤器,单击开始测试,核对测试结果无误后,单击下一步。
说明过滤器是API数据适配器开关,设置信息模块展示隐藏,更多信息,请参见API结果过滤器。
配置流量控制:填写API最大调用次数,选择超时配置和是否开启缓存,单击保存。
在API资源列表,可查看新建的API。
相关操作
操作 | 说明 |
---|---|
编辑API | 在API资源列表中,单击目标API操作列的编辑,在API编辑向导页面,可对API进行编辑修改。 说明 编辑API参数配置中的云计算资源时,需要查看当前使用表中字段是否与编辑前使用表中的字段存在部分一致,如果一致可能导致编辑完成后,编辑内容不生效。 |
复制API | 在API资源列表操作列,选择更多 > 复制,在API资源列表中生成一个新的草稿API。单击复制API操作列的编辑,对复制的API进行编辑修改。 |
删除API | 在API资源列表操作列,选择更多 > 删除,在删除对话框中,单击确定。 说明 已上线的API不支持删除。 |
后续步骤
API创建完成后,需要对API进行上线操作,具体操作,请参见上线API。