路線圖圖塊

歐洲經濟區 (EEA) 開發人員

Roadmap Tile 總覽路線圖圖塊是根據向量地形資料和 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)，x 和 y 則是您要擷取的圖塊圖塊座標。

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

如要瞭解回應訊息標頭，請參閱「預先擷取、快取或儲存內容」。