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