使用自己的 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 自動產生。在建構後續圖塊要求時,必須由轉譯器附加。
key
您用來存取 3D Tiles 服務的 API 金鑰。您必須將其附加至所有後續的資訊方塊要求。

顯示出處資訊

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

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

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

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

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

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

  4. 在畫面上顯示著作權來源,並依出現次數由多到少排序,類似 Google 地球 的做法。