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

如果無法將第三方轉譯產品納入解決方案,您可能必須自行建立 3D 平鋪轉譯器。採用這種做法時,請務必考量下列重要因素:

內容網址

提供擬真 3D 圖塊時,Map Tiles API 會傳回子圖塊集的 URI。這些圖塊集 URI 並非一般網址,只包含路徑和參數元件。這些要求不含 API 金鑰,而您必須提供 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 圖塊中尋找 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 地球 的做法。