地图图块只是将世界划分为一个索引网格。借助该功能,您可以在多个地图比例下高效、动态地访问和利用地图数据。借助 Map Tiles API,您可以访问多个专题地理数据集,包括 Google 精选的:
基于矢量地形数据和 Google 制图样式的路线图图片图块。
由卫星和机载相机拍摄的正射影像,可提供地球的俯视(天底)图像。
山体阴影等高线图。
2D 地图图块均已进行地理配准并相互对齐。系统会根据视口的地理范围和缩放级别来选择这些地图项。缩放级别范围为 0(查看整个世界)到 22(查看街道和街区)。
地图主题
您可以获取以下地图主题的地图图块。
| 地图主题 | 说明 |
|---|---|
| 路线图 | 道路、建筑物、地图注点和行政边界 |
| 卫星 | 从太空拍摄的摄影图像 |
| 地形 | 显示植被等自然特征的等高线地图 |
如需从 Map Tiles API 请求地图图块,您必须先请求会话令牌。会话令牌会跟踪地图和视口的当前状态。设置会话令牌时,您必须将 mapType 值设置为与所需地图主题匹配的值。然后,您必须在向 Map Tiles API 发出的每个请求中包含会话令牌。
视口信息请求
视口定义了框定世界场景的框的大小。视口信息请求会返回有关构成当前视口的地图图块的详细信息。您请求视口信息的原因是为了确保避免请求不存在的缩放级别的图像。
例如,大多数城市都有缩放级别为 22 的图像,但海洋没有,因为最终只会显示没有特征的蓝色方块。
视口请求是采用以下形式的 HTTPS GET 请求。
curl "https://tile.googleapis.com/tile/v1/viewport?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &zoom=zoom &north=north &south=south &east=east &west=west"
该请求包含以下字段:
zoom- 视口的缩放级别。
north、south、east、west- 视口中最北、最南、最东和最西的点,以度为单位。南北必须在 (-90,90) 范围内,东西必须在 (-180, 180) 范围内。如需表示跨越 180 度经线的边界,west 可以是正数(例如 170),east 可以是负数(例如 -170)。所有参数都是必需的。
视口信息响应
视口响应会告知您哪些区域有图像,以及这些图像的缩放级别。视口信息响应采用以下形式。
{
"copyright": "Map data ©2023",
"maxZoomRects": [
{
"maxZoom": 19,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
{
"maxZoom": 9,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
{
"maxZoom": 14,
"north": 84.375,
"south": -84.375,
"east": 180,
"west": -180
}, ...
]
}
响应正文包含以下字段。
copyright- 包含一个提供方说明字符串,当您显示路线图和卫星图块时,必须在地图上显示该字符串。如需了解详情,请参阅 Map Tiles API 政策。
maxZoomRect- 包含与当前视口重叠的边界矩形数组。还包含每个矩形内可用的最大缩放级别。
图块坐标函数
大多数编程语言都提供了工具(简单函数),可将纬度/经度对转换为特定缩放级别下的图块坐标。
请考虑以下 JavaScript 代码示例,该示例首先从 latLng 转换为点,然后从点转换为图块坐标。
var TILE_SIZE = 256;
function fromLatLngToPoint(latLng) {
var mercator = -Math.log(Math.tan((0.25 + latLng.lat() / 360) * Math.PI));
return {
x: TILE_SIZE * (latLng.lng() / 360 + 0.5),
y: TILE_SIZE / 2 * (1 + mercator / Math.PI)
};
}
function fromLatLngToTileCoord(latLng, zoom) {
var point = fromLatLngToPoint(latLng);
var scale = Math.pow(2, zoom);
return {
x: Math.floor(point.x * scale / TILE_SIZE),
y: Math.floor(point.y * scale / TILE_SIZE),
z: zoom
};
}