Utilizzare il proprio rendering del riquadro 3D

Se non riesci a incorporare un prodotto di rendering di terze parti nel tuo potrebbe essere necessario creare un renderer personalizzato per i riquadri 3D. Questo di valutazione richiede di considerare i seguenti fattori importanti:

URL dei contenuti

Durante la pubblicazione di riquadri 3D fotorealistici, l'API Map Tiles restituisce gli URI per set di riquadri per bambini. Questi URI del set di riquadri non sono URL normali. Includono solo il componente del percorso e dei parametri. Non contengono la tua chiave API, che è necessarie per autorizzare la richiesta. Per ulteriori informazioni, consulta Specifiche per i riquadri 3D.

Richieste e risposte

Ecco alcuni esempi di richieste e risposte per i riquadri 3D fotorealistici. Tu con gli Strumenti per sviluppatori di Chrome.

Esempio di richiesta del set di riquadri radice:

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

URI di risposta del set di riquadri di esempio:

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

URL di richieste di riquadri di esempio utilizzati dai renderer:

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

Devi collegare tutti i parametri che appaiono nell'URI del set di riquadri, insieme la chiave API, quando crei le successive richieste di riquadro. API 3D Tiles fornisce i seguenti due parametri:

session
Un identificatore integrato per una sessione di caricamento 3D. Viene generato automaticamente dall'API. Deve essere collegato dal renderer durante la creazione del richieste di riquadri.
key
La chiave API che hai utilizzato per accedere al servizio 3D Tiles. Devi collegarlo a tutte le richieste di riquadri successive.

Attribuzioni display

L'attribuzione indica che riconosce l'origine dei riquadri delle mappe ed è un requisito per Utilizzo di questa API, inclusa l'attribuzione del brand Google (logo), nonché l'attribuzione dei dati. Il logo Google è disponibile per te nella Pagina delle norme dell'API Map Tiles. Dati le informazioni sull'attribuzione vengono restituite in ogni risposta del riquadro. Cercalo nel corpo della risposta, nel JSON sotto asset.copyright.

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

Devi aggregare, ordinare e visualizzare queste informazioni su una riga di testo, di solito nella parte inferiore del rendering. Questa operazione comporta i seguenti passaggi:

  1. Estrai tutte le informazioni sul copyright da tutti i riquadri nella visualizzazione.

  2. Separa più fonti di copyright con un punto e virgola.

  3. Ordina le informazioni in base al numero di occorrenze.

  4. Mostra sullo schermo le fonti del copyright, ordinate dalla maggior parte delle occorrenze in modo simile al modo in cui Google Earth ce l'ha fatta.