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

多媒體歸因

歸因是指確認地圖圖塊的來源,也是使用這個 API 的必要條件,包括 Google 品牌歸因 (標誌) 和資料歸因。您可以在「Map Tiles API Policy」(地圖圖塊 API 政策) 頁面使用 Google 標誌。每個資訊方塊回應都會傳回資料歸因資訊。請在回應主體 (位於 asset.copyright 下方的 JSON) 中尋找。

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

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

  1. 從檢視畫面中的所有圖塊中擷取所有版權資訊。

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

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

  4. 在螢幕上顯示版權來源,依照出現次數由多到最少依序顯示,就像 Google 地球是這樣。