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