Utilizzare il proprio rendering del riquadro 3D

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

URL dei contenuti

Quando pubblica i riquadri 3D fotorealistici, l'API Map Tiles restituisce gli URI per i set di riquadri secondari. Questi URI dei set di tessere non sono URL regolari. Includono solo il componente del percorso e dei parametri. Non contengono la tua chiave API, obbligatoria per autorizzare la richiesta. Per ulteriori informazioni, consulta la Specifica dei riquadri 3D.

Richieste e risposte

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

Richiesta di set di riquadri radice di esempio:

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

URI di risposta del set di tessere 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 riquadri successive, devi allegare tutti i parametri visualizzati nell'URI del set di riquadri, 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 richieste di elementi successivi.
key
La chiave API utilizzata per accedere al servizio 3D Tiles. Devi allegarlo a tutte le richieste di riquadri successive.

Attribuzioni display

L'attribuzione significa riconoscere la fonte dei riquadri della mappa ed è un requisito per l'utilizzo di questa API, inclusa l'attribuzione del brand 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. Cercala 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 in una riga di testo, solitamente nella parte inferiore del rendering. Questo comporta i seguenti passaggi:

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

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

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

  4. Mostrare sullo schermo le fonti del copyright, ordinate dalla maggior parte delle occorrenze alla meno, in modo simile a come avviene su Google Earth.