路线图图块

欧洲经济区 (EEA) 开发者

“路线图”功能块概览路线图图块是基于矢量地形数据 和 Google 制图样式的图像图块。其中包括道路、建筑物、地图注点 和政治边界。

获取路线图图块

获取会话令牌后,您就可以开始发出路线图图块请求。由于会话令牌适用于整个会话,因此您无需在图块请求中指定地图选项。

以下代码示例演示了路线图图块的典型会话令牌请求。

curl -X POST -d '{
  "mapType": "roadmap",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

您可以通过发出 HTTPS GET 请求来获取路线图图块,如以下示例所示。

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&orientation=0_or_90_or_180_or_270"

在此 HTTPS GET 请求中,z 是缩放级别 (范围为 0 到 22),xy 是您要检索的图块的 图块坐标

orientation 参数是可选的。其值指定图块图像的逆时针旋转度数。orientationroadmap 图块支持,并且还受卫星和 地形请求支持,这些请求使用 "overlay": true 移除了基础图像,并设置了 layerTypes。有效的 orientation 值包括 0(默认值)、90、180 和 270。

如果您包含 orientation 值,则图块坐标网格不会旋转。例如,如果您将 orientation 设置为 90,则 x 坐标仍会定义图块的从左到右位置,在这种情况下,该位置在地图上是从北到南。

零度屏幕方向 90 度屏幕方向
零度屏幕方向 90 度屏幕方向

图块请求示例

请考虑以下示例,该示例请求包含整个世界的单个图块。在此示例中,缩放级别为 0,x 和 y 坐标为 0, 0。

curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

在此示例中,服务器没有响应消息。相反,图块会下载到本地文件,并显示以下统计信息。

一个图块中的整个世界

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8335  100  8335    0     0  51471      0 --:--:-- --:--:-- --:--:-- 54835

如需了解响应消息标头,请参阅 预取、缓存或存储内容