检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Service）。地图数据服务提供地图数据相关的服务功能。 您可以使用本文档提供的API对MapDS进行相关操作，如创建、查询、删除访问MapDS服务的凭证，获取地图瓦片等。支持的全部操作请参见API概览。 在调用MapDS API之前，请确保已经充分了解MapDS相关概念，详细信息请参见产品介绍。
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 MapDS.10000003 会话无效。 会话无效。 检查参数是否合法。 400 MapDS.10100002 参数为空。 参数为空。
查询凭证 功能介绍 该接口用于查询访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v1/map/credentials 请求参数 表1
创建凭证 功能介绍 该接口用于创建访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1/map/credentials 请求参数
调用说明 MapDS服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
删除凭证 功能介绍 该接口用于删除访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI DELETE /v1/map/credentials/{clientid}
状态码 服务器向用户返回的状态码和提示信息如表1所示： 表1 状态码 状态码 说明 2xx 服务器成功返回用户请求的数据。 4xx 客户端发出的请求有错误，服务器没有进行新建或修改数据的操作。 5xx 服务器发生错误，用户将无法判断发出的请求是否成功。 父主题： 附录
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https:
用于为用户生成令牌的密钥 取值为primary或者secondary 每个用户只有2个apikey，primary的原则就是对比apiKey时间最早的那个。 如果只有一个apikey，primary和secondary都指同一个apiKey expiry 是 String 令牌到期UTC时间，格式如
由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块
终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询服务的终端节点。 MapDS是全局服务，数据全局一份，在全局项目中存储，MapDS所有的API都可以使用全局服务的Endpoint调用。 全局国内：mapds-cn.myhuaweicloud
计费说明 计费项 华为云租户通过MapDS服务凭证访问地图瓦片服务时会根据API调用次数进行按需计费。 表1 地图瓦片服务计费项 计费项 计费方式 计费模式 API请求次数 按千次为单位对调用成功的API次数计费。 说明： 调用成功表示用户获取到了目标瓦片图，对于未获取到目标瓦片图的调用次数不计费。
本文介绍了地图数据各特性版本的功能发布和对应的文档动态，欢迎体验。 序号 功能名称 功能描述 阶段 相关文档 1 地图数据全新公测上线 地图数据服务（Map Data Service，MapDS）是一款面向全行业的在线地图相关数据服务，用户可以通过API调用地图相关的数据服务，创建时空信息相关的应用。
准备工作 注册华为云并实名认证 如果您已有一个华为云账户，请跳到下一个任务。如果您还没有华为云账户，请参考以下步骤创建。 打开华为云官网https://www.huaweicloud.com/，单击“注册”。 根据提示信息完成注册，详细操作请参见如何注册华为云管理控制台的用户？。
图4 获取下载地址 OBS支持通过API、SDK、OBS Browser+、obsutil方式复制对象。具体参考表2。 表2 复制对象 支持的使用方式 参考文档 SDK OBS支持多种语言SDK，请从SDK概述页面选择进入对应的开发指南查阅。 API 复制对象 OBS Browser+
基本概念 凭证 凭证是识别用户身份的依据，您通过API访问地图瓦片服务时，需要使用凭证来通过系统的鉴权认证。 MapDS控制台凭证操作方式参见管理凭证。 请求获取地图瓦片时，需要在API的Query参数中携带凭证。 请求示例 1 GET https://mapds.myhuaweicloud
单击界面右上角的“创建凭证”，输入描述信息之后单击“确定”，系统会自动分配一个凭证给用户。如图2所示。 图2 创建凭证 携带凭证调用API获取地图瓦片，详情参见地图数据API参考。 请求示例 1 GET https://mapds.myhuaweicloud.com/v1/map/tile/{z}/{x}/{y}
什么是地图数据 地图数据服务（Map Data Service，MapDS）是一款面向全行业的在线地图相关数据服务，用户可以通过API调用地图相关的数据服务，创建时空信息相关的应用。如图1所示，MapDS具有地图相关数据接入、数据处理和数据调用三大能力，并最终通过数据调用对外进行服务。
管理凭证 操作场景 凭证是您通过开发工具API访问瓦片服务的身份认证，通过“凭证管理”页面您可以创建、删除、查看自己的凭证。 一个用户最多只能创建2个凭证。 如果凭证泄露，可能会导致身份冒用，建议您妥善保存并定期更换。 创建凭证 登录MapDS控制台。 在左侧导航栏选中“凭证管理”，进入“凭证管理”页面。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
