检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 MapDS.10000003 会话无效。 会话无效。 检查参数是否合法。 400 MapDS.10100002 参数为空。 参数为空。
状态码 服务器向用户返回的状态码和提示信息如表1所示： 表1 状态码 状态码 说明 2xx 服务器成功返回用户请求的数据。 4xx 客户端发出的请求有错误，服务器没有进行新建或修改数据的操作。 5xx 服务器发生错误，用户将无法判断发出的请求是否成功。 父主题： 附录
返回结果 状态码 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应
管理凭证 操作场景 凭证是您通过开发工具API访问瓦片服务的身份认证，通过“凭证管理”页面您可以创建、删除、查看自己的凭证。 一个用户最多只能创建2个凭证。 如果凭证泄露，可能会导致身份冒用，建议您妥善保存并定期更换。 创建凭证 登录MapDS控制台。 在左侧导航栏选中“凭证管理”，进入“凭证管理”页面。
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET ht
创建凭证 功能介绍 该接口用于创建访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1/map/credentials 请求参数
API概览 凭证管理 表1 凭证管理接口 接口 说明 创建凭证 创建访问地图数据服务的凭证。 删除凭证 删除访问地图数据服务的凭证。 查询凭证 查询访问地图数据服务的凭证。 获取地图瓦片 表2 获取地图瓦片接口 接口 说明 获取地图瓦片 获取地图瓦片。
获取卫星遥感数据 操作场景 购买卫星遥感数据后，您需要将数据下载到本地或者保存到个人桶中才能使用。 表1 获取数据 数据保存方式 操作指导 下载到本地 通过OBS Browser+下载数据 通过obsutil下载数据 复制数据到指定桶 复制数据到指定桶 前提条件 用户收到订单交付短信提醒。
获取地图瓦片 功能介绍 该接口用于获取地图瓦片。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v1/map/tile/{z}/{x}/{y} 表1 路径参数
查询凭证 功能介绍 该接口用于查询访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v1/map/credentials 请求参数 表1
创建SAS Token 功能介绍 创建SAS token凭据，用于访问瓦片。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1/map/sastoken
删除凭证 功能介绍 该接口用于删除访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI DELETE /v1/map/credentials/{clientid}
购买卫星遥感数据 操作场景 本章节指导用户购买卫星遥感数据。 操作步骤 登录MapDS控制台。 在左侧导航栏选中“卫星遥感数据”，进入订单列表页面。 单击右上角“购买卫星遥感数据”，进入购买页面。 根据界面提示选择购买区域。 在购买区域上用户可根据“行政区域选择”或者“自定义SharpFile”。
计费说明 计费项 华为云租户通过MapDS服务凭证访问地图瓦片服务时会根据API调用次数进行按需计费。 表1 地图瓦片服务计费项 计费项 计费方式 计费模式 API请求次数 按千次为单位对调用成功的API次数计费。 说明： 调用成功表示用户获取到了目标瓦片图，对于未获取到目标瓦片图的调用次数不计费。
应用场景 表1 应用场景 应用场景 所需数据服务 导航底图 卫星遥感影像栅格图 移动出行 卫星遥感影像栅格图、矢量栅格数据、地址数据等 行业一张图 卫星遥感影像栅格图、矢量栅格数据、行业GIS相关数据、地址数据等 森林防火 卫星遥感影像栅格图、气象数据、河湖数据、地址数据等 河湖四乱
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的获取用户Token来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证调用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。
与其他服务的关系 表1 MapDS与其他云服务的关系 服务类别 服务名称 交互关系 CDN服务 内容分发网络（Content Delivery Network，CDN） 通过CDN加速，缩短用户查看地图的访问延迟，提高用户访问网站的响应速度与网站的可用性。 网络服务 VPC终端节点（VPC
简介 卫星遥感数据服务将聚焦使能平台、联合行业生态伙伴，为客户提供卫星遥感数据在线购买、交付的，卫星遥感行业解决方案。 产品优势 卫星遥感数据服务具有覆盖能⼒强、性价⽐⾼、拍摄需求可定制、预拍服务灵活、交付时间短等特点，可以达到市域⽉度覆盖，省域季度覆盖，并拥有丰富的存档数据。 应用场景
准备工作 注册华为云并实名认证 如果您已有一个华为云账户，请跳到下一个任务。如果您还没有华为云账户，请参考以下步骤创建。 打开华为云官网https://www.huaweicloud.com/，单击“注册”。 根据提示信息完成注册，详细操作请参见如何注册华为云管理控制台的用户？。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
