Utilizzare il proprio rendering del riquadro 3D

Se non sei in grado di incorporare un prodotto di rendering di terze parti nella tua soluzione, potrebbe essere necessario creare un tuo rendering per i riquadri 3D. Questo approccio richiede di prendere in considerazione i seguenti fattori importanti:

URL dei contenuti

Quando vengono pubblicati riquadri 3D fotorealistici, l'API Map Tiles restituisce gli URI per i set di riquadri per bambini. Questi URI del set di riquadri non sono URL normali, ma solo il componente del percorso e dei parametri. Non contengono la chiave API, necessaria per autorizzare la richiesta. Per ulteriori informazioni, consulta la Specifica dei riquadri 3D.

Richieste e risposte

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

Esempio di richiesta del set di riquadri principale:

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

URI di risposta al set di riquadri di esempio:

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

Esempi di URL di richieste di riquadri 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 riquadro successive, devi collegare tutti i parametri visualizzati nell'URI del set di riquadri, insieme alla chiave API. L'API 3D Tiles fornisce i due parametri seguenti:

session
Un identificatore integrato per una sessione di caricamento 3D. Viene generato automaticamente dall'API. Deve essere associato dal renderer durante la creazione delle successive richieste di riquadro.
key
La chiave API che hai utilizzato per accedere al servizio Tile 3D. da associare a tutte le successive richieste di riquadro.

Attribuzioni display

L'attribuzione significa riconoscere l'origine dei riquadri della mappa ed è un requisito per l'utilizzo di questa API, che include l'attribuzione del brand Google (logo) e l'attribuzione dei dati. Il logo Google è disponibile nella pagina Norme relative all'API Map Tiles. Le informazioni sull'attribuzione dei dati vengono restituite in ogni risposta del riquadro. Cercalo nel corpo della risposta, nel codice JSON 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. L'operazione prevede 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 di copyright sullo schermo, ordinate dalla maggior parte delle occorrenze al minor numero di occorrenze, in modo simile a Google Earth.