检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 凭证管理 表1 凭证管理接口 接口 说明 创建凭证 创建访问地图数据服务的凭证。 删除凭证 删除访问地图数据服务的凭证。 查询凭证 查询访问地图数据服务的凭证。 获取地图瓦片 表2 获取地图瓦片接口 接口 说明 获取地图瓦片 获取地图瓦片。
如何调用API 构造请求 认证鉴权 返回结果
什么是地图数据 地图数据服务(Map Data Service,MapDS)是一款面向全行业的在线地图相关数据服务,用户可以通过API调用地图相关的数据服务,创建时空信息相关的应用。如图1所示,MapDS具有地图相关数据接入、数据处理和数据调用三大能力,并最终通过数据调用对外进行服务。
获取地图瓦片 功能介绍 该接口用于获取地图瓦片。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v1/map/tile/{z}/{x}/{y} 表1 路径参数
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于获取用户Token接口,您可以从接口的请求部分看到所需的请求参数及参数说
完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 对于获取用户Token接口,返回如图1所示的消息头,其中“x-subject-tok
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token,即调用获取用户Token接口时,请求body中auth.scope的取值需要选择project,如下所示。
图瓦片服务时会根据API调用次数进行按需计费。 计费说明 计费说明 04 使用 地图瓦片服务能够将地图数据在服务端根据比例尺寸预先分割成瓦片,通过缓存和CDN技术高效快速的实现地图数据在应用终端加载。 地图瓦片服务 简介 管理凭证 05 API 您可以使用API获取地图瓦片。 地图瓦片服务
附录 状态码 错误码 获取项目ID
凭证管理 创建凭证 查询凭证 删除凭证 创建SAS Token
删除凭证 功能介绍 该接口用于删除访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI DELETE /v1/map/credentials/{clientid}
获取地图瓦片 获取地图瓦片
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 MapDS.10000003 会话无效。 会话无效。 检查参数是否合法。 400 MapDS.10100002 参数为空。 参数为空。
使用前必读 概述 调用说明 终端节点 基本概念
修订记录 发布日期 修订记录 2022-03-30 第一次正式发布。
查询凭证 功能介绍 该接口用于查询访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v1/map/credentials 请求参数 表1
Service)。地图数据服务提供地图数据相关的服务功能。 您可以使用本文档提供的API对MapDS进行相关操作,如创建、查询、删除访问MapDS服务的凭证,获取地图瓦片等。支持的全部操作请参见API概览。 在调用MapDS API之前,请确保已经充分了解MapDS相关概念,详细信息请参见产品介绍。
调用说明 MapDS服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
创建凭证 功能介绍 该接口用于创建访问地图数据服务的凭证。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/map/credentials 请求参数
状态码 服务器向用户返回的状态码和提示信息如表1所示: 表1 状态码 状态码 说明 2xx 服务器成功返回用户请求的数据。 4xx 客户端发出的请求有错误,服务器没有进行新建或修改数据的操作。 5xx 服务器发生错误,用户将无法判断发出的请求是否成功。 父主题: 附录