Iniziare a utilizzare Esplorare aree in 3D

immagine

Panoramica

La soluzione 3D Area Explorer ti offre un modo completamente nuovo di 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 interattivi e accattivanti.

3D Area Explorer è progettato per servire a più scopi:

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

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

  • Ispirare lo sviluppo utilizzando le funzionalità 3D di Google Maps: dimostra il potenziale dei dati di mappatura 3D di Google per la creazione di mappe immersive e interattive.

Guida introduttiva:

Attiva

Tecnologie chiave

Questa soluzione è basata su due tecnologie chiave:

API Google Maps Platform:

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

  • Riquadri 3D fotorealistici di Google Maps: i modelli 3D ad alta risoluzione di edifici e rilievi forniscono una rappresentazione realistica e visivamente coinvolgente degli ambienti urbani.
  • API Places: l'app può identificare e visualizzare informazioni dettagliate sui punti di interesse (PDI) all'interno dell'area esplorata, arricchendo l'esperienza utente con la conoscenza locale.
  • 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 rilievi.

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 per concentrarsi sul quartiere specificato al caricamento dell'app.
  • Implementazione di movimenti dinamici della videocamera, come le animazioni di orbita automatizzate per l'esplorazione.
  • Gestione delle interazioni dell'utente con il globo se sono incluse queste funzionalità (panoramica, zoom, rotazione).

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

Componenti chiave

L'applicazione è suddivisa in due app diverse:

  • App per amministratori
  • App demo

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

immagine

Sarebbe utile esaminare ulteriormente ogni app:

App per amministratori

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

  • Ricerca località : utilizza la barra di ricerca di completamento automatico di Google Maps Platform integrata per trovare l'area che vuoi mostrare. Una volta selezionata una località, la videocamera si sposterà senza problemi in quell'area.

  • 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, punti di riferimento) che vuoi mettere in evidenza.

Utilizza questa app per personalizzare l'esperienza per gli utenti finali.

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

App demo

Questa è l'applicazione finale rivolta agli utenti che carica la configurazione creata nell'app per amministratori. In questo ambiente 3D immersivo, gli utenti potranno esplorare le aree selezionate e scoprire i luoghi che hai messo in evidenza.

Dopo aver personalizzato l'aspetto e il comportamento utilizzando l'app per amministratori, puoi scaricare la configurazione ed eseguire l'applicazione personalizzata dal codice sorgente.

Esperienza utente

immagine

Di seguito sono riportate 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 i luoghi nelle vicinanze (ad es. musei, parchi, ristoranti).

  3. Quando selezionano un luogo, gli utenti possono visualizzare informazioni dettagliate o narrazioni correlate a quella località.

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

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

Prerequisiti

  1. Chiave API di Google Maps: avrai bisogno 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 include 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 container Docker in qualsiasi ambiente container, ad esempio GKE o GAE. La demo ospitata utilizza la seguente architettura:

immagine

  • In questa architettura, il codice risiede in un progetto GitHub.
  • Cloud Build recupera il codice in qualsiasi push a main e attiva un'operazione di build.
  • Nell'ambito della build, inserisce la chiave API e crea un'immagine che viene poi archiviata in Artifact Registry.
  • Infine, esegue il deployment dell'ultima immagine stabile da Artifact Registry a Cloud Run.
  • Abbiamo anche alcuni controlli di integrità e monitoraggio in esecuzione per verificare l'integrità delle app di cui è stato eseguito il deployment.

Dati di fatturazione

La soluzione 3D Area Explorer utilizza i servizi di Google Maps Platform per offrire un'esperienza immersiva e dinamica. Alcune API potrebbero comportare addebiti. Ecco una panoramica delle API e dei link ai prezzi.

Google Maps Platform - API Riquadri 3D:

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

Google Maps Platform - API Places:

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

Google Maps Platform - API Autocomplete:

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

CesiumJS:

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

È fondamentale esaminare i dettagli sui prezzi di ogni API, poiché gli addebiti vengono determinati individualmente in base all'utilizzo. Tieni presente che Google Maps Platform offre un livello senza costi con una determinata 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 condizioni descritti da questi servizi per gestire e comprendere in modo efficace le spese associate.

Conclusione

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

Sfruttando i riquadri 3D fotorealistici di Google e l'API Places, consente l'esplorazione virtuale dei quartieri, la scoperta di punti di interesse e l'apprendimento della storia locale.

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

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