承载协议	HTTPS GET
接口方向	开发者服务器 -> 华为地图服务器
接口URL	https://mapapi.cloud.huawei.com/mapApi/v1/mapService/getTile
数据格式	响应消息：Content-Type: image/png 说明 mapType属性传入SATELLITE时返回图片格式为image/webp。

请求参数

说明

Request Header中的 Authorization 和Query String中的 key 至少需要存在一个。

Request Header

展开

参数	是否必选	参数类型	描述
Content-Type	是	application/json	请求消息的数据格式。
Authorization	否	String	AT或者API Key，推荐用AT。说明 AT认证获取AT认证的方式请参见基于OAuth 2.0获取应用级AT, AT有效期是1个小时。使用AT认证时推荐新申请AT接入MapKit。 API KEY认证获取API KEY的方式请参见获取API密钥。使用API密钥时需要调用URLEncoder.encode("Your apiKey", "UTF-8")方法对API密钥进行encodeURI编码。例如，原始API密钥：ABC/DFG+ ，转换结果：ABC%2FDFG%2B。建议API密钥设置安全保护措施，具体请参见如何保护API密钥。

Query String

展开

参数	是否必选	参数类型	描述
key	否	String	鉴权密钥，申请参见获取API密钥。说明获取API KEY的方式请参见获取API密钥。使用API key时需要调用URLEncoder.encode("Your apiKey", "UTF-8")方法对API key进行encodeURI编码。例如：原始API key：ABC/DFG+ ，转换结果：ABC%2FDFG%2B。
x	是	Integer	X轴坐标。取值范围：[0, 1048576]。
y	是	Integer	Y轴坐标。取值范围：[0, 1048576]。
z	是	Integer	缩放级别。取值范围：大于等于0。
language	否	String	图片显示语种，语言编码支持ISO 639-2 Code和BCP47。推荐使用BCP47，取值范围参见支持的语言。
scale	否	int	清晰度比较尺，图片缩放比例。默认为1，可用值为1和2。
mapType	否	String	地图类型。默认值为ROADMAP。 ROADMAP：矢量地形 SATELLITE：卫星图

请求示例

收起
自动换行
深色代码主题
复制
GET
https://mapapi.cloud.huawei.com/mapApi/v1/mapService/getTile?x=5
&y=1
&z=3
&language=en
&scale=2
&key=API KEY

响应参数

状态码为200时：

Response Header

展开

参数	是否必选	参数类型	描述
Content-Type	是	image/png	响应消息的数据格式。

Response Body

展开

参数	参数类型	描述
Body	String	返回栅格瓦片字节流。

调用示例

AT认证

API KEY认证

收起
自动换行
深色代码主题
复制
 
public class GetTileService {
    OkHttpClient client = new OkHttpClient();

    Request request = new Request.Builder()
            .url("https://mapapi.cloud.huawei.com/mapApi/v1/mapService/getTile?x=5
&y=1
&z=3
&language=en
&scale=2
")
            .addHeader("Authorization", "Bearer " + AT)
            .get()
            .build();

    Response response = client.newCall(request).execute();
}

收起
自动换行
深色代码主题
复制
public class GetTileService {
    OkHttpClient client = new OkHttpClient();

    Request request = new Request.Builder()
            .url("https://mapapi.cloud.huawei.com/mapApi/v1/mapService/getTile?x=5
&y=1
&z=3
&language=en
&scale=2
&key=xxxx
")
            .get()
            .build();

    Response response = client.newCall(request).execute();
}

图1 获取栅格图

Maps Static API

Tile Service API

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问 AI 助手提问