路線圖圖塊

路線圖圖塊總覽道路地圖圖塊是以向量地形資料的圖片圖塊,採用 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 為選用參數,其值會指定圖塊圖片逆時針旋轉的次數。roadmap 圖塊支援 orientation,而且基本圖像使用 "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

如要進一步瞭解回應訊息標頭,請參閱預先擷取、快取或儲存內容