使用自己的 3D 資訊方塊轉譯器

如果您無法在解決方案中納入第三方轉譯產品,您可能就必須建立自己的 3D 圖塊轉譯器。這個方法需要考量下列重要因素:

內容網址

提供擬真成像 3D 圖塊時,Map Tiles API 會傳回子項圖塊集的 URI。這些圖塊集 URI 不是一般網址,只包含路徑和參數元件。但不包含您的 API 金鑰。此為授權要求所需的金鑰。詳情請參閱 3D 資訊方塊規格

要求與回應

以下列舉幾個擬真成像 3D 圖塊要求和回應的範例。您可以使用 Chrome 開發人員工具進行檢查。

根資訊方塊要求範例:

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

資訊方塊回應 URI 範例:

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

轉譯器使用的資訊方塊要求網址範例:

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY
https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

建構後續的資訊方塊要求時,您應附加資訊方塊 URI 中顯示的任何參數和 API 金鑰。3D Tiles API 提供下列兩個參數:

session
3D 載入工作階段的內建 ID。是由 API 自動產生建構後續的資訊方塊要求時,轉譯器必須將這個 ID 附加至轉譯器。
key
您用來存取 3D 資訊方塊服務的 API 金鑰。您必須將其附加至所有後續的資訊方塊要求。

顯示出處

歸因是指已確認地圖圖塊來源,而且是使用這個 API 的必要條件,包括 Google 品牌標示 (標誌) 及資料出處。您可以在 Map Tiles API 政策頁面看到 Google 標誌。每個資訊方塊回應都會傳回資料作者資訊。您可以在回應主體的 JSON 的 asset.copyright 底下尋找。

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

您必須在一行文字 (通常位於轉譯底部) 上匯總、排序及顯示這項資訊。您需要完成下列步驟:

  1. 從所有檢視的圖塊中擷取所有著作權資訊。

  2. 請以半形分號分隔多個版權來源。

  3. 根據發生次數排序資訊。

  4. 在畫面中顯示版權來源 (從出現次數到最少的順序),與 Google 地球的做法類似。