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 accattivanti e interattivi.

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

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

  • Promuovere narrazioni basate sulla posizione: la possibilità di incorporare PDI (punti di interesse) con descrizioni dettagliate consente di creare esperienze basate sulla narrazione che istruiscono 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.

Per iniziare

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 base e i dati 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 visivamente accattivante degli ambienti urbani.
  • API Places: l'app può identificare e visualizzare informazioni dettagliate sui punti d'interesse (PDI) all'interno dell'area esplorata, arricchendo l'esperienza utente con conoscenze locali.
  • Autocomplete 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 terreno.

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

  • Impostare il punto di vista iniziale in modo che si concentri 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 queste funzionalità sono incluse (panoramica, zoom, rotazione).

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

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 ogni app in modo più approfondito:

App per amministratori

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

  • Ricerca della località: utilizza la barra di ricerca con completamento automatico integrata di Google Maps Platform 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 mostrare.

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

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

App demo

Questa è l'applicazione finale rivolta agli utenti che carica la configurazione che hai creato 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 utilizzando l'app per amministratori, 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 a quella località.

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

  5. La rotazione automatica è attiva, consentendo alla videocamera 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 abilitate:

  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 container Docker in qualsiasi ambiente container come GKE o GAE. La demo in hosting utilizza la seguente architettura:

immagine

  • In questa architettura, il codice si trova in un progetto GitHub.
  • Cloud Build recupera il codice a ogni push nel ramo principale e attiva un'operazione di build.
  • Come parte della build, inserisce la chiave API e crea un'immagine che viene poi archiviata in Artifact Registry.
  • Infine, esegue il deployment dell'immagine stabile più recente da Artifact Registry a Cloud Run.
  • Abbiamo anche alcuni controlli di integrità e monitoraggi 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 3D Tiles

La soluzione 3D Area Explorer utilizza l'API 3D Tiles per migliorare l'esperienza visiva con i dati geospaziali. Per i dettagli sui prezzi relativi all'API 3D Tiles, consulta Prezzi dell'API 3D Tiles di Google Maps Platform.

Google Maps Platform - API Places

L'API Places viene utilizzata per i dati basati sulla posizione, aggiungendo informazioni dettagliate all'esperienza di 3D Area Explorer. Per comprendere i costi associati all'API Google Places, visita Google Maps Platform - Prezzi dell'API Places.

Google Maps Platform - API Autocomplete

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

CesiumJS

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

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

Consulta sempre le pagine ufficiali dei prezzi per informazioni più accurate e aggiornate sui costi di utilizzo di Google Maps Platform e CesiumJS. Assicurati di rispettare i termini e le 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 Explorer area 3D.

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 sbalorditiva.

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