Guida introduttiva a 3D Area Explorer

immagine

Panoramica

La soluzione Esplora aree 3D ti offre un modo completamente nuovo per scoprire e vivere le località. Questa soluzione sfrutta le funzionalità dei riquadri 3D fotorealistici di Google Maps Platform e dell'API Places per creare ambienti 3D coinvolgenti e interattivi.

3D Area Explorer è progettato per diversi scopi:

  • Migliora l'esplorazione dell'area: gli utenti possono esplorare i quartieri virtualmente con un elevato grado di dettaglio visivo, ottenendo informazioni su elementi e punti di riferimento locali.

  • Promuovi narrazioni basate sulla posizione: la possibilità di incorporare PDI (punti d'interesse) con descrizioni dettagliate consente di creare esperienze basate su narrazioni che educano e informano gli utenti su località specifiche.

  • Stimola lo sviluppo utilizzando le funzionalità 3D di Google Maps: mostra il potenziale dei dati di mappatura 3D di Google per creare mappe immersive e interattive

Guida introduttiva:

Attiva

Tecnologie chiave

Questa soluzione è realizzata utilizzando due tecnologie chiave:

API Google Maps Platform:

Utilizziamo diverse API di Google Maps Platform per ottenere la mappa di base e i dati necessari per creare questa esperienza:

  • Riquadri 3D fotorealistici di Google Maps: i modelli 3D ad alta risoluzione di edifici e terreni forniscono una rappresentazione realistica e coinvolgente degli ambienti urbani.
  • API Places: l'app può identificare e mostrare informazioni dettagliate sui punti di interesse (PDI) all'interno dell'area esplorata, arricchendo l'esperienza utente con conoscenze locali.
  • Il completamento automatico aiuta gli utenti a cercare località o aree di interesse specifiche.

CesiumJS

CesiumJS è responsabile del rendering e della visualizzazione del globo 3D ad alta risoluzione. Gestisce il caricamento e la visualizzazione dei riquadri 3D fotorealistici di Google, che forniscono un modello mesh 3D di edifici e terreni.

Gestione della videocamera:CesiumJS fornisce gli strumenti per controllare la posizione, l'orientamento e il movimento della videocamera. È incluso quanto segue:

  • Impostazione del punto di vista iniziale in modo che si concentri sul quartiere specificato al caricamento dell'app.
  • Implementazione di movimenti dinamici della fotocamera, come le animazioni di orbita automatica per l'esplorazione.
  • Gestire le interazioni dell'utente con il globo se sono incluse queste funzionalità (panoramica, zoom, rotazione).

Scopri come i riquadri 3D fotorealistici possono funzionare con un visualizzatore di riquadri 3D.

Componenti principali

L'applicazione è suddivisa in due app diverse, ovvero:

  • App Amministrazione
  • App demo

Questo diagramma fornisce una panoramica delle differenze e della correlazione tra le due applicazioni:

immagine

Ti consigliamo di esaminare ulteriormente ogni app:

App Amministrazione

Questa applicazione fornisce un'interfaccia utente intuitiva che ti consente di personalizzare l'esperienza 3D:

  • Ricerca località :utilizza la barra di ricerca integrata con il completamento automatico di Google Maps Platform per trovare l'area che vuoi mettere in evidenza. Una volta selezionata la località, la videocamera si sposterà in quella zona senza problemi.

  • Videocamera: regola la velocità di movimento della videocamera e il tipo di orbita per creare l'esperienza di visualizzazione selezionata.

  • Luoghi (PDI): definisci la densità, il raggio di ricerca e i tipi di punti di interesse (ad es. ristoranti, bar, monumenti) che vuoi mettere in evidenza.

Utilizza questa app per personalizzare l'esperienza per i tuoi utenti finali.

È disponibile una descrizione dettagliata di tutte le personalizzazioni Personalizzazioni di 3D Area Explorer.

App demo

Si tratta dell'applicazione finale rivolta agli utenti che carica la configurazione creata nell'app Amministrazione. In questo ambiente 3D immersivo, gli utenti potranno esplorare le aree selezionate e scoprire i luoghi che hai evidenziato.

Dopo aver personalizzato l'aspetto utilizzando l'app Amministrazione, puoi scaricare la configurazione ed eseguire l'applicazione personalizzata dal codice sorgente.

Esperienza utente

immagine

Ecco alcune delle funzionalità principali dell'applicazione:

  1. Gli utenti possono esplorare in modo interattivo un'area in 3D, inclusi edifici, punti di riferimento e rilievi.
  2. Gli utenti possono cercare e scoprire luoghi nelle vicinanze (ad es. musei, parchi, ristoranti).
  3. Dopo aver selezionato un luogo, gli utenti possono visualizzare informazioni dettagliate o narrazioni relative alla località.

  4. Gli sviluppatori possono personalizzare la propria esperienza di esplorazione tramite impostazioni e controlli (se utilizzano l'app Amministrazione).

  5. La rotazione automatica è attivata, consentendo alla fotocamera di ruotare automaticamente attorno al centro dell'area selezionata.

Prerequisiti

  1. Chiave API di Google Maps: devi disporre di una chiave API valida con le seguenti API attivate:

  2. Server web: puoi pubblicare l'applicazione da:

    • Un server web locale (ad es. utilizzando Node.js, http-server)
    • Un servizio di hosting web statico (l'applicazione è dotata di un Dockerfile)

Puoi trovare una descrizione dettagliata delle opzioni di deployment nella sezione readme del progetto GitHub.

Deployment

Puoi eseguire il deployment dell'app come applicazione Node o come contenitore Docker in qualsiasi ambiente contenitore come GKE o GAE. La demo ospitata utilizza la seguente architettura:

immagine

  • In questa architettura, il codice si trova in un progetto GitHub.
  • Cloud Build recupera il codice su qualsiasi push in main e attiva un'operazione di compilazione.
  • Nell'ambito della compilazione, inietta la chiave API e crea un'immagine che viene poi memorizzata nel registry degli elementi.
  • Infine, esegue il deployment dell'immagine stabile più recente da Artifact Registry a Cloud Run.
  • Eseguiamo anche alcuni controlli di integrità e monitoraggio per verificare l'integrità delle app di cui è stato eseguito il deployment.

Dati di fatturazione

La soluzione 3D Area Explorer utilizza i servizi Google Maps Platform per offrire un'esperienza dinamica e immersiva. Per alcune API potrebbero essere applicati costi. Ecco una panoramica delle API e i link ai prezzi.

Google Maps Platform - API 3D Tiles:

La soluzione di storytelling utilizza l'API 3D Tiles per migliorare l'esperienza visiva con i dati geospaziali. Per informazioni dettagliate sui prezzi relativi all'API 3D Tiles, consulta la pagina Google Maps Platform - Prezzi dell'API 3D Tiles.

Google Maps Platform - API Places:

L'API Places viene utilizzata per i dati basati sulla posizione, aggiungendo informazioni dettagliate all'esperienza di storytelling. Per informazioni sui costi associati all'API Google Maps,visita la pagina Google Maps Platform - Prezzi dell'API Places.

Google Maps Platform - API Autocomplete:

La funzionalità di completamento automatico migliora l'interazione dell'utente. Per informazioni dettagliate sui prezzi relativi all'API Autocompletamento di Google Maps, visita la pagina Google Maps Platform - Prezzi di completamento automatico di Places.

CesiumJS:

CesiumJS viene utilizzato per la visualizzazione del globo 3D. Sebbene CesiumJS sia open source, funzionalità o servizi aggiuntivi potrebbero avere costi associati. Consulta la documentazione di CesiumJS per eventuali offerte premium.

È fondamentale esaminare i dettagli dei prezzi per ogni rispettiva API, poiché gli addebiti vengono determinati singolarmente in base all'utilizzo. Tieni presente che Google Maps Platform offre un livello senza costi con una certa quantità di utilizzo senza costi e che le specifiche dei prezzi possono variare in base a fattori quali il numero di richieste e la regione di utilizzo.

Fai sempre riferimento alle pagine dei prezzi ufficiali per informazioni più accurate e aggiornate sui costi di utilizzo di Google Maps Platform e CesiumJS. Assicurati di rispettare i termini e le condizioni previsti da questi servizi per gestire e comprendere efficacemente le eventuali spese associate.

Conclusione

Questo documento fornisce una panoramica delle funzionalità, dei componenti, dell'esperienza utente e dei requisiti tecnici di Esploratore di aree 3D.

Sfruttando i riquadri 3D fotorealistici di Google e l'API Places, consente di esplorare virtualmente i quartieri, scoprire punti di interesse e conoscere la storia locale.

Che si tratti di mostrare un'area, migliorare l'esplorazione o promuovere la narrazione digitale, 3D Area Explorer offre una piattaforma visivamente eccezionale.

Prova la demo e personalizzala utilizzando l'app Amministrazione per creare un'esperienza 3D coinvolgente e informativa.