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 di riquadri 3D. Questo approccio richiede di considerare i seguenti fattori importanti:

URL dei contenuti

Quando vengono pubblicati i riquadri 3D fotorealistici, l'API Map Tiles restituisce gli URI per i tileset secondari. Questi URI dei tileset non sono URL normali. Includono solo il componente del percorso e dei parametri. Non contengono la chiave API, necessaria per autorizzare la richiesta. Per ulteriori informazioni, consulta le specifiche 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 esempio per il tileset radice:

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 dei 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 che appaiono nell'URI del tileset, insieme alla chiave API. L'API Riquadri 3D fornisce i seguenti due parametri:

session
Un identificatore integrato per una sessione di caricamento 3D. Viene generato automaticamente dall'API. Il renderer deve allegarlo quando crea le richieste di riquadri successive.
key
La chiave API che hai utilizzato per accedere al servizio Riquadri 3D. Devi allegarla a tutte le richieste di riquadri successive.

Visualizzare le attribuzioni

L'attribuzione indica il riconoscimento dell'origine dei riquadri 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 Norme dell'API Map Tiles. Le informazioni sull'attribuzione dei dati vengono restituite in ogni risposta del riquadro. Cerca queste informazioni 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, in genere nella parte inferiore del rendering. Questa operazione prevede i seguenti passaggi:

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

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

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

  4. Visualizza le origini del copyright sullo schermo, ordinate dalla più frequente alla meno frequente, in modo simile a Google Earth