如果無法在解決方案中加入第三方算繪產品,您可能必須建立自己的 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"
}
}
您必須在一行文字 (通常位於轉譯底部) 中匯總、排序及顯示這項資訊。步驟如下:
從檢視畫面中的所有圖塊中擷取所有版權資訊。
請以半形分號區隔多個版權來源。
根據發生次數排序資訊。
在螢幕上顯示版權來源,依照出現次數由多到最少依序顯示,就像 Google 地球是這樣。