2D 資訊方塊總覽

藍圖範例地圖圖塊只是將世界劃分為已建立索引的格線。Search Ads 360 可讓您以多種方式,以動態的方式存取及使用地圖資料,方法如下:Map Tiles API 提供多個主題地理區域資料集,包括 Google 收錄的:

  • 使用 Google 的製圖樣式建立向量地形資料的地圖圖塊。

  • 衛星鏡頭和空拍攝影機拍攝的正反射攝影鏡頭,可將地球圖像從上方 (天底) 拍攝出來。

  • Hillshade 等距地圖。

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
可視區域的縮放等級。
northsoutheastwest
可視區域的最上北、南、東和西點,以度為單位表示。北部和南都必須落在範圍 (-90,90) 內,東部和西部都必須在範圍 (-180、180)。如要表示跨越時間表的邊界,西方可以是正數 (例如 170),東方可以是負數 (例如 -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
  };
}