Utilizzare il proprio rendering del riquadro 3D

Sviluppatori dello Spazio economico europeo (SEE)

Se non riesci a incorporare un prodotto di rendering di terze parti nella tua soluzione, potresti dover creare il tuo renderer 3D Tiles. Questo approccio richiede di considerare i seguenti fattori importanti:

URL dei contenuti

Quando fornisce riquadri 3D fotorealistici, l'API Map Tiles restituisce gli URI per i set di riquadri secondari. Questi URI dei set di riquadri non sono URL normali. Includono solo il componente del percorso e dei parametri. Non contengono la chiave API, necessaria per autorizzare la richiesta. Per saperne di più, consulta la specifica 3D Tiles.

Richieste e risposte

Ecco alcuni esempi di richieste e risposte di riquadri 3D fotorealistici. Puoi esaminarli utilizzando gli Strumenti per sviluppatori di Chrome.

Esempio di richiesta di tileset principale:

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

URI di risposta del tileset di esempio:

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

URL di richiesta 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

Quando crei le richieste di tile successive, devi allegare tutti i parametri visualizzati nell'URI del tileset, insieme alla tua chiave API. L'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 allegato dal renderer durante la creazione delle successive richieste di riquadri.
key
La chiave API che hai utilizzato per accedere al servizio 3D Tiles. Devi allegarlo a tutte le richieste di tile successive.

Attribuzioni display

L'attribuzione indica la fonte dei tile di mappa ed è un requisito per l'utilizzo di questa API. Include l'attribuzione del brand Google (logo) e l'attribuzione dei dati. Il logo Google è disponibile nella pagina delle policy dell'API Map Tiles. Le informazioni sull'attribuzione dei dati vengono restituite in ogni risposta del riquadro. Cerca l'errore nel riquadro glTF, in 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. Ciò comporta i seguenti passaggi:

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

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

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

  4. Mostra le fonti del copyright sullo schermo, ordinate dalla più frequente alla meno frequente, in modo simile a come fa Google Earth.