如果無法將第三方轉譯產品納入解決方案,您可能必須自行建立 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"
}
}
您必須在文字行中匯總、排序及顯示這項資訊,通常會顯示在算繪作業的底部。這包括下列步驟:
從檢視畫面中的所有圖塊中擷取所有版權資訊。
如有多個版權來源,請以半形分號分隔。
依據發生次數排序資訊。
在畫面上顯示著作權來源,並依出現次數由多到少排序,類似 Google 地球 的做法。