道路圖圖塊是依據向量地形資料的圖片圖塊,可透過 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 度方向 |
---|---|
![]() |
![]() |
資訊方塊要求範例
請參考以下範例,要求包含整個世界的單一資訊方塊。在本例中,縮放等級為 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
如需回應訊息標頭的相關資訊,請參閱預先擷取、快取或儲存內容。