# 地图数据 MapDS

> 云上一站式获取高质量多源卫星遥感数据

## 产品介绍

- [图解地图数据](https://support.huaweicloud.com/productdesc-mapds/zh-cn_topic_0000001424732725.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [什么是地图数据](https://support.huaweicloud.com/productdesc-mapds/mapds_01_0002.md): 地图数据服务（Map Data Service，MapDS）是一款面向全行业的在线地图相关数据服务，用户可以通过API调用地图相关的数据服务，创建时空信息相关的应用。如图1所示，MapDS具有地图相关数据接入、数据处理和数据调用三大能力，并最终通过数据调用对外进行服务。数据接入用于在获取各类型地图原始数据后进行上云和导入。数据处理用于对各
- [产品优势](https://support.huaweicloud.com/productdesc-mapds/mapds_01_0003.md): 多方式开放数据接入接入方式多：专线/VPN、就近DES接入、OBS跨区域复制接入效率高：单数据中心每天100TB接入能力毫秒级时空数据调用高效检索：毫秒级网格数据检索、瓦片数据检索高效计算：毫秒级网格数据计算在线销售：云上进行数据付费调用，实现数据价值变现
- [应用场景](https://support.huaweicloud.com/productdesc-mapds/mapds_01_0004.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [使用限制](https://support.huaweicloud.com/productdesc-mapds/mapds_01_0005.md): 凭证：一个用户最多只能创建2个凭证。由于CDN配置下发到各边缘节点需要时间，地图服务凭证生成后需要等待5分钟以上才能使用。统计数据：由于全球日志汇聚存在延迟时间，瓦片统计数据存在约6小时延迟。
- [计费说明](https://support.huaweicloud.com/productdesc-mapds/mapds_01_0006.md): 华为云租户通过MapDS服务凭证访问地图瓦片服务时会根据API调用次数进行按需计费。地图瓦片服务服务：支持按需计费，每个计费周期（计费周期1小时）分别统计瓦片接口访问成功的次数，并根据成功次数*单价的方式计算出费用，然后从账户余额中扣除对应金额。卫星数据服务：根据购买数据的规格、面积评估费用，一次性购买交付。按需计费是根据每个计费项在对应
- [权限管理](https://support.huaweicloud.com/productdesc-mapds/mapds_01_0007.md): 用户需要使用凭证访问地图瓦片。IAM用户默认可以直接访问地图数据服务，无需授予任何IAM权限。
- [与其他服务的关系](https://support.huaweicloud.com/productdesc-mapds/mapds_01_0008.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [基本概念](https://support.huaweicloud.com/productdesc-mapds/mapds_01_0009.md): 凭证是识别用户身份的依据，您通过API访问地图瓦片服务时，需要使用凭证来通过系统的鉴权认证。MapDS控制台凭证操作方式参见管理凭证。请求获取地图瓦片时，需要在API的Query参数中携带凭证。请求示例GET https://mapds.myhuaweicloud.com/v1/map/tile/{z}/{x}/{y}?key={acce
- [修订记录](https://support.huaweicloud.com/productdesc-mapds/mapds_01_0010.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## 快速入门

- [准备工作](https://support.huaweicloud.com/qs-mapds/mapds_02_0001.md): 如果您已有一个华为云账户，请跳到下一个任务。如果您还没有华为云账户，请参考以下步骤创建。打开华为云官网https://www.huaweicloud.com/，单击“注册”。根据提示信息完成注册，详细操作请参见如何注册华为云管理控制台的用户？。注册成功后，系统会自动跳转至您的个人信息界面。注册成功后，系统会自动跳转至您的个人信息界面。参考
- [获取地图瓦片](https://support.huaweicloud.com/qs-mapds/mapds_02_0002.md): 当用户需要将地图数据显示在应用终端时，可以通过MapDS提供的地图瓦片服务来获取地图瓦片。获取方式如图1所示，用户先通过MapDS控制台创建凭证，然后携带凭证调用API获取地图瓦片。登录MapDS控制台。在左侧导航栏选中“凭证管理”，进入“凭证管理”页面。单击界面右上角的“创建凭证”，输入描述信息之后单击“确定”，系统会自动分配一个凭证给
- [修订记录](https://support.huaweicloud.com/qs-mapds/mapds_02_0003.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## 用户指南

- [简介](https://support.huaweicloud.com/usermanual-mapds/mapds_01_0013.md): 地图数据通常体量较大， 地图瓦片服务能够将地图数据在服务端根据比例尺寸预先分割成地图瓦片，通过缓存和CDN技术高效快速的实现地图数据在应用终端加载。请参见权限管理。请参见使用限制。
- [管理凭证](https://support.huaweicloud.com/usermanual-mapds/mapds_01_0014.md): 凭证是您通过开发工具API访问瓦片服务的身份认证，通过“凭证管理”页面您可以创建、删除、查看自己的凭证。一个用户最多只能创建2个凭证。如果凭证泄露，可能会导致身份冒用，建议您妥善保存并定期更换。在“凭证管理”页面凭证列表中，单击凭证操作列的“删除”可以执行凭证的删除操作。删除凭证
- [简介](https://support.huaweicloud.com/usermanual-mapds/mapds_01_0016.md): 卫星遥感数据服务将聚焦使能平台、联合行业生态伙伴，为客户提供卫星遥感数据在线购买、交付的，卫星遥感行业解决方案。卫星遥感数据服务具有覆盖能⼒强、性价⽐⾼、拍摄需求可定制、预拍服务灵活、交付时间短等特点，可以达到市域⽉度覆盖，省域季度覆盖，并拥有丰富的存档数据。
- [购买卫星遥感数据](https://support.huaweicloud.com/usermanual-mapds/mapds_01_0017.md): 本章节指导用户购买卫星遥感数据。在购买区域上用户可根据行政区域选择或者自定义SharpFile。自定义sharpFile场景说明：上传的shp文件要求文件包含4个文件，后缀分别为.shp，.shx，.dbf，.prj，缺一不可。自定义sharpFile场景，要求上传的shp文件是WGS84坐标系，MapDS把shp文件从WGS84坐标系转
- [获取卫星遥感数据](https://support.huaweicloud.com/usermanual-mapds/mapds_01_0018.md): 购买卫星遥感数据后，您需要将数据下载到本地或者保存到个人桶中才能使用。用户收到订单交付短信提醒。obsutil使用详情参见通过obsutil下载对象。
- [修订记录](https://support.huaweicloud.com/usermanual-mapds/mapds_04_0300.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## API参考

- [概述](https://support.huaweicloud.com/api-mapds/mapds_06_0002.md): 欢迎使用地图数据服务MapDS（Map Data Service）。地图数据服务提供地图数据相关的服务功能。您可以使用本文档提供的API对MapDS进行相关操作，如创建、查询、删除访问MapDS服务的凭证，获取地图瓦片等。支持的全部操作请参见API概览。在调用MapDS API之前，请确保已经充分了解MapDS相关概念，详细信息请参见产品
- [调用说明](https://support.huaweicloud.com/api-mapds/mapds_06_0003.md): MapDS服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。
- [终端节点](https://support.huaweicloud.com/api-mapds/mapds_06_0004.md): 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询服务的终端节点。MapDS是全局服务，数据全局一份，在全局项目中存储，MapDS所有的API都可以使用全局服务的Endpoint调用。全局国内：mapds-cn.myhuaweicloud.com
- [基本概念](https://support.huaweicloud.com/api-mapds/mapds_06_0005.md): 账号用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用用户进行日常管理工作。用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体
- [API概览](https://support.huaweicloud.com/api-mapds/mapds_06_0006.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [构造请求](https://support.huaweicloud.com/api-mapds/mapds_06_0010.md): 本节介绍REST API请求的组成，并以调用IAM服务的获取用户Token来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。请求URI由如下部分组成：{URI-s
- [认证鉴权](https://support.huaweicloud.com/api-mapds/mapds_06_0009.md): 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。Token认证：通过Token认证调用请求。AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。Token认证：通过Token认证调用请求。AK/SK认证：通过AK（
- [返回结果](https://support.huaweicloud.com/api-mapds/mapds_06_0012.md): 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。对于获取用户Token接口，如果调用后返回状态码为201，则表示请求成功。对应请求消息头，响应同样也有消息头，如Content-type。对于获取用户Token接口，返回如图1所
- [创建凭证](https://support.huaweicloud.com/api-mapds/CreateCredential.md): 该接口用于创建访问地图数据服务的凭证。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。POST /v1/map/credentials状态码： 200创建访问地图数据服务的凭证，并为凭证添加描述。状态码： 200成功。请参见错误码。
- [查询凭证](https://support.huaweicloud.com/api-mapds/ShowCredential.md): 该接口用于查询访问地图数据服务的凭证。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。GET /v1/map/credentials状态码： 200状态码： 200成功。请参见错误码。
- [删除凭证](https://support.huaweicloud.com/api-mapds/DeleteCedential.md): 该接口用于删除访问地图数据服务的凭证。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。DELETE /v1/map/credentials/{clientid}无无请参见错误码。
- [创建SAS Token](https://support.huaweicloud.com/api-mapds/CreateSasToken.md): 创建SAS token凭据，用于访问瓦片。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。POST /v1/map/sastoken状态码： 200创建用于访问地图瓦片的SAS token凭据，并设置令牌到期时间。状态码： 200成功请参见错
- [获取地图瓦片](https://support.huaweicloud.com/api-mapds/mapds_06_0022.md): 该接口用于获取地图瓦片。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。GET /v1/map/tile/{z}/{x}/{y}状态码： 200状态码： 202无请参见错误码。
- [状态码](https://support.huaweicloud.com/api-mapds/mapds_06_0024.md): 服务器向用户返回的状态码和提示信息如表1所示：
- [错误码](https://support.huaweicloud.com/api-mapds/ErrorCode.md): 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。
- [获取项目ID](https://support.huaweicloud.com/api-mapds/ims_03_0909.md): 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式：调用API获取项目ID从控制台获取项目ID项目ID可以通过调用查询指定条件下的项目列表API获取。获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从地区和
- [修订记录](https://support.huaweicloud.com/api-mapds/mapds_06_0029.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。