检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 构造请求 认证鉴权 返回结果
地图瓦片服务 简介 管理凭证
周期（计费周期1小时）分别统计瓦片接口访问成功的次数，并根据成功次数*单价的方式计算出费用，然后从账户余额中扣除对应金额。 卫星数据服务：根据购买数据的规格、面积评估费用，一次性购买交付。 欠费 按需计费是根据每个计费项在对应的计费周期进行扣费的，若余额不足，则无法对上一个计费周期进行扣费，从而导致服务欠费。
产品优势 多方式开放数据接入 接入方式多：专线/VPN、就近DES接入、OBS跨区域复制 接入效率高：单数据中心每天100TB接入能力 毫秒级时空数据调用 高效检索：毫秒级网格数据检索、瓦片数据检索 高效计算：毫秒级网格数据计算 在线销售：云上进行数据付费调用，实现数据价值变现
一个用户最多只能创建2个凭证。 由于CDN配置下发到各边缘节点需要时间，地图服务凭证生成后需要等待5分钟以上才能使用。 统计数据： 由于全球日志汇聚存在延迟时间，瓦片统计数据存在约6小时延迟。
权限管理 用户需要使用凭证访问地图瓦片。 IAM用户默认可以直接访问地图数据服务，无需授予任何IAM权限。
创建凭证 功能介绍 该接口用于创建访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1/map/credentials 请求参数
本文介绍了地图数据各特性版本的功能发布和对应的文档动态，欢迎体验。 序号 功能名称 功能描述 阶段 相关文档 1 地图数据全新公测上线 地图数据服务（Map Data Service，MapDS）是一款面向全行业的在线地图相关数据服务，用户可以通过API调用地图相关的数据服务，创建时空信息相关的应用。
简介 地图数据通常体量较大， 地图瓦片服务能够将地图数据在服务端根据比例尺寸预先分割成地图瓦片，通过缓存和CDN技术高效快速的实现地图数据在应用终端加载。 权限说明 请参见权限管理。 约束与限制 请参见使用限制。 使用方式 支持的使用方式 支持的操作 控制台 管理凭证 父主题： 地图瓦片服务
删除凭证 功能介绍 该接口用于删除访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI DELETE /v1/map/credentials/{clientid}
查询凭证 功能介绍 该接口用于查询访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v1/map/credentials 请求参数 表1
获取地图瓦片 操作场景 当用户需要将地图数据显示在应用终端时，可以通过MapDS提供的地图瓦片服务来获取地图瓦片。获取方式如图1所示，用户先通过MapDS控制台创建凭证，然后携带凭证调用API获取地图瓦片。 图1 获取地图瓦片 操作步骤 创建凭证。 登录MapDS控制台。 在左侧
服务器向用户返回的状态码和提示信息如表1所示： 表1 状态码 状态码 说明 2xx 服务器成功返回用户请求的数据。 4xx 客户端发出的请求有错误，服务器没有进行新建或修改数据的操作。 5xx 服务器发生错误，用户将无法判断发出的请求是否成功。 父主题： 附录
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET ht
准备工作 注册华为云并实名认证 如果您已有一个华为云账户，请跳到下一个任务。如果您还没有华为云账户，请参考以下步骤创建。 打开华为云官网https://www.huaweicloud.com/，单击“注册”。 根据提示信息完成注册，详细操作请参见如何注册华为云管理控制台的用户？。
基本概念 凭证 凭证是识别用户身份的依据，您通过API访问地图瓦片服务时，需要使用凭证来通过系统的鉴权认证。 MapDS控制台凭证操作方式参见管理凭证。 请求获取地图瓦片时，需要在API的Query参数中携带凭证。 请求示例 1 GET https://mapds.myhuaweicloud
终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询服务的终端节点。 MapDS是全局服务，数据全局一份，在全局项目中存储，MapDS所有的API都可以使用全局服务的Endpoint调用。 全局国内：mapds-cn.myhuaweicloud
管理凭证 操作场景 凭证是您通过开发工具API访问瓦片服务的身份认证，通过“凭证管理”页面您可以创建、删除、查看自己的凭证。 一个用户最多只能创建2个凭证。 如果凭证泄露，可能会导致身份冒用，建议您妥善保存并定期更换。 创建凭证 登录MapDS控制台。 在左侧导航栏选中“凭证管理”，进入“凭证管理”页面。
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证调用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 MapDS.10000003 会话无效。 会话无效。 检查参数是否合法。 400 MapDS.10100002 参数为空。 参数为空。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
