检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
修订记录 发布日期 修订记录 2022-03-30 第一次正式发布。
修订记录 发布日期 修订记录 2022-04-30 第一次正式发布。
状态码 服务器向用户返回的状态码和提示信息如表1所示: 表1 状态码 状态码 说明 2xx 服务器成功返回用户请求的数据。 4xx 客户端发出的请求有错误,服务器没有进行新建或修改数据的操作。 5xx 服务器发生错误,用户将无法判断发出的请求是否成功。 父主题: 附录
准备工作 注册华为云并实名认证 如果您已有一个华为云账户,请跳到下一个任务。如果您还没有华为云账户,请参考以下步骤创建。 打开华为云官网https://www.huaweicloud.com/,单击“注册”。 根据提示信息完成注册,详细操作请参见如何注册华为云管理控制台的用户?。
基本概念 凭证 凭证是识别用户身份的依据,您通过API访问地图瓦片服务时,需要使用凭证来通过系统的鉴权认证。 MapDS控制台凭证操作方式参见管理凭证。 请求获取地图瓦片时,需要在API的Query参数中携带凭证。 请求示例 1 GET https://mapds.myhuaweicloud
修订记录 发布日期 修订记录 2022-10-30 第二次正式发布。 本次变更说明如下: 新增卫星遥感数据服务。 2022-04-30 第一次正式发布。
创建凭证 功能介绍 该接口用于创建访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/map/credentials 请求参数
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 MapDS.10000003 会话无效。 会话无效。 检查参数是否合法。 400 MapDS.10100002 参数为空。 参数为空。
查询凭证 功能介绍 该接口用于查询访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v1/map/credentials 请求参数 表1
如何调用API 构造请求 认证鉴权 返回结果
地图瓦片服务 简介 管理凭证
获取项目ID 操作场景 在调用接口的时候,部分URL中需要填入项目ID,所以需要获取到项目ID。有如下两种获取方式: 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET ht
删除凭证 功能介绍 该接口用于删除访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI DELETE /v1/map/credentials/{clientid}
获取地图瓦片 获取地图瓦片
获取地图瓦片 操作场景 当用户需要将地图数据显示在应用终端时,可以通过MapDS提供的地图瓦片服务来获取地图瓦片。获取方式如图1所示,用户先通过MapDS控制台创建凭证,然后携带凭证调用API获取地图瓦片。 图1 获取地图瓦片 操作步骤 创建凭证。 登录MapDS控制台。 在左侧
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证调用请求。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比Token认证要高。
管理凭证 操作场景 凭证是您通过开发工具API访问瓦片服务的身份认证,通过“凭证管理”页面您可以创建、删除、查看自己的凭证。 一个用户最多只能创建2个凭证。 如果凭证泄露,可能会导致身份冒用,建议您妥善保存并定期更换。 创建凭证 登录MapDS控制台。 在左侧导航栏选中“凭证管理”,进入“凭证管理”页面。
与其他服务的关系 表1 MapDS与其他云服务的关系 服务类别 服务名称 交互关系 CDN服务 内容分发网络(Content Delivery Network,CDN) 通过CDN加速,缩短用户查看地图的访问延迟,提高用户访问网站的响应速度与网站的可用性。 网络服务 VPC终端节点(VPC
调用说明 MapDS服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
构造请求 本节介绍REST API请求的组成,并以调用IAM服务的获取用户Token来说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com/videos/102987。