检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
应用场景 表1 应用场景 应用场景 所需数据服务 导航底图 卫星遥感影像栅格图 移动出行 卫星遥感影像栅格图、矢量栅格数据、地址数据等 行业一张图 卫星遥感影像栅格图、矢量栅格数据、行业GIS相关数据、地址数据等 森林防火 卫星遥感影像栅格图、气象数据、河湖数据、地址数据等 河湖四乱
创建凭证 功能介绍 该接口用于创建访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/map/credentials 请求参数
状态码 服务器向用户返回的状态码和提示信息如表1所示: 表1 状态码 状态码 说明 2xx 服务器成功返回用户请求的数据。 4xx 客户端发出的请求有错误,服务器没有进行新建或修改数据的操作。 5xx 服务器发生错误,用户将无法判断发出的请求是否成功。 父主题: 附录
准备工作 注册华为云并实名认证 如果您已有一个华为云账户,请跳到下一个任务。如果您还没有华为云账户,请参考以下步骤创建。 打开华为云官网https://www.huaweicloud.com/,单击“注册”。 根据提示信息完成注册,详细操作请参见如何注册华为云管理控制台的用户?。
基本概念 凭证 凭证是识别用户身份的依据,您通过API访问地图瓦片服务时,需要使用凭证来通过系统的鉴权认证。 MapDS控制台凭证操作方式参见管理凭证。 请求获取地图瓦片时,需要在API的Query参数中携带凭证。 请求示例 1 GET https://mapds.myhuaweicloud.com
修订记录 发布日期 修订记录 2022-10-30 第二次正式发布。 本次变更说明如下: 新增卫星遥感数据服务。 2022-04-30 第一次正式发布。
获取项目ID 操作场景 在调用接口的时候,部分URL中需要填入项目ID,所以需要获取到项目ID。有如下两种获取方式: 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 MapDS.10000003 会话无效。 会话无效。 检查参数是否合法。 400 MapDS.10100002 参数为空。 参数为空。
查询凭证 功能介绍 该接口用于查询访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v1/map/credentials 请求参数 表
如何调用API 构造请求 认证鉴权 返回结果
地图瓦片服务 简介 管理凭证
删除凭证 功能介绍 该接口用于删除访问地图数据服务的凭证。 调试 您可以在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终端节点
调用说明 MapDS服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
构造请求 本节介绍REST API请求的组成,并以调用IAM服务的获取用户Token来说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com
返回结果 状态码 请求发送以后,您会收到响应,其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头