Utilizzare il proprio rendering del riquadro 3D

Sviluppatori dello Spazio economico europeo (SEE)

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

URL dei contenuti

Quando si forniscono tile 3D fotorealistici, l'API Map Tiles restituisce gli URI per i tileset figlio. Questi URI tileset non sono URL normali. Includono solo il percorso e i parametri. Non contengono la tua chiave API, necessaria per autorizzare la tua richiesta. Per ulteriori informazioni, consultare le Specifiche delle tessere 3D.

Richieste e risposte

Ecco alcuni esempi di richieste e risposte relative a piastrelle 3D fotorealistiche. È possibile ispezionarli utilizzando gli Strumenti per sviluppatori di Chrome.

Esempio di richiesta di tileset radice:

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

Esempio di URI di risposta del tileset:

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

Esempi di URL di richiesta tile utilizzati dai motori di rendering:

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 si creano le richieste di tile successive, è necessario allegare tutti i parametri che compaiono nell'URI del tileset, insieme alla 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 costruzione delle successive richieste di tile.
key
La chiave API che hai utilizzato per accedere al servizio 3D Tiles. È necessario allegarlo a tutte le richieste di tile successive.

Visualizza attribuzioni

L'attribuzione implica il riconoscimento della fonte dei riquadri della mappa ed è un requisito per l'utilizzo di questa API; ciò include l'attribuzione del marchio Google (logo) e l'attribuzione dei dati. Il logo Google è disponibile nella pagina Norme dell'API Map Tiles. Le informazioni sull'attribuzione dei dati vengono restituite in ogni risposta del riquadro. Cercalo nel riquadro glTF, 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. Ciò comporta i seguenti passaggi:

  1. Estrai tutte le informazioni sul copyright da tutte le tessere visualizzate.

  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 dal maggior numero di occorrenze al minore, in modo simile a Google Earth.