检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 构造请求 认证鉴权 返回结果
本节介绍REST API请求的组成，并以调用IAM服务的获取用户Token来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。
Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。
MapDS服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
与其他服务的关系 表1 MapDS与其他云服务的关系 服务类别 服务名称 交互关系 CDN服务 内容分发网络（Content Delivery Network，CDN） 通过CDN加速，缩短用户查看地图的访问延迟，提高用户访问网站的响应速度与网站的可用性。 网络服务 VPC终端节点（VPC
Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI DELETE /v1/map/credentials/{clientid} 表1 路径参数 参数 是否必选 参数类型 描述 clientid 是 String 待删除的key的id。 请求参数 表2 请求Header参数
Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v1/map/tile/{z}/{x}/{y} 表1 路径参数 参数 是否必选 参数类型 描述 z 是 Integer 缩放级别，取值范围[0~20]。
Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v1/map/credentials 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token
使用限制 地图瓦片服务 凭证： 一个用户最多只能创建2个凭证。 由于CDN配置下发到各边缘节点需要时间，地图服务凭证生成后需要等待5分钟以上才能使用。 统计数据： 由于全球日志汇聚存在延迟时间，瓦片统计数据存在约6小时延迟。
通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1/map/sastoken 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token
Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1/map/credentials 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token
根据提示信息完成注册，详细操作请参见如何注册华为云管理控制台的用户？。 注册成功后，系统会自动跳转至您的个人信息界面。 参考实名认证完成个人或企业账号实名认证。 创建IAM用户 IAM用户由账号创建并管理，可以确保账号及资源的安全性，有关IAM的详细介绍请参见IAM用户。此处介绍如何创建一个具有DW
状态码 服务器向用户返回的状态码和提示信息如表1所示： 表1 状态码 状态码 说明 2xx 服务器成功返回用户请求的数据。 4xx 客户端发出的请求有错误，服务器没有进行新建或修改数据的操作。 5xx 服务器发生错误，用户将无法判断发出的请求是否成功。 父主题： 附录
单击界面右上角的“创建凭证”，输入描述信息之后单击“确定”，系统会自动分配一个凭证给用户。如图1示。 图1 创建凭证 删除凭证 在“凭证管理”页面凭证列表中，单击凭证操作列的“删除”可以执行凭证的删除操作。 图2 删除凭证 父主题： 地图瓦片服务
} 从控制台获取项目ID 从控制台获取项目ID的步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。 在“API凭证”页面的项目列表中查看项目ID。 图1 查看项目ID 父主题： 附录
在左侧导航栏选中“卫星遥感数据”，进入订单列表页面。 单击对应的订单前面的，查看订单详情，订单详情中的“数据下载链接”即为数据下载地址。 图4 获取下载地址 OBS支持通过API、SDK、OBS Browser+、obsutil方式复制对象。具体参考表2。 表2 复制对象 支持的使用方式 参考文档
API概览 凭证管理 表1 凭证管理接口 接口 说明 创建凭证 创建访问地图数据服务的凭证。 删除凭证 删除访问地图数据服务的凭证。 查询凭证 查询访问地图数据服务的凭证。 获取地图瓦片 表2 获取地图瓦片接口 接口 说明 获取地图瓦片 获取地图瓦片。
WGS84坐标系转换成EPSG:4527坐标系完成面积统计计算。 图1 选择区域 单击“下一步”，根据界面提示进行属性配置，配置信息表1所示。 表1 配置属性 参数名称 参数说明 购买类型 影像：数字正射影像图，带有公里格网、图廓（内、外）整饰和注记的平面图。 地形：数字高程模型，即对地面地形的数字化模拟。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
