Creare un circuito personalizzato in FPVSIM
Crea da zero un circuito da gara FPV con gli strumenti di creazione dei circuiti di FPVSIM.
Crea e aggiungi una chiave API di Google Maps per accedere a luoghi reali in World Flight di FPVSIM.
Cosa imparerai in questo tutorial
Questo tutorial collega un progetto personale di Google Maps Platform alla scena di volo sul mondo di FPVSIM. Crei un progetto cloud dedicato, abiliti Map Tiles API, crei una credenziale con restrizioni, la salvi in FPVSIM e carichi un luogo reale per il volo FPV virtuale.
Non copiare mai una chiave mostrata in un vecchio video, in uno screenshot, in un commento o in un repository pubblico. Crea una tua credenziale con restrizioni. La chiave della dimostrazione era temporanea e qualsiasi chiave esposta pubblicamente deve essere revocata e sostituita.
Prima di iniziare
- Un account Google con accesso a Google Cloud Console.
- L'autorizzazione a creare un progetto, configurare Maps Platform e soddisfare gli attuali requisiti di fatturazione o verifica dell'account.
- Accesso a FPVSIM e una connessione Internet stabile per caricare i tasselli della mappa.
- Il tempo necessario a consultare prezzi, quote e condizioni attuali di Google: la console e le regole potrebbero essere cambiate dalla registrazione del 2023.
Creare la credenziale in modo sicuro
Creare un progetto cloud dedicato
Accedi a Google Cloud Console e crea un progetto dedicato ai tasselli delle mappe di FPVSIM. Un progetto separato facilita la gestione dell'utilizzo, delle restrizioni e della revoca.
Completare la configurazione dell'account richiesta oggi
Segui le istruzioni attuali di Google per configurare l'account e la fatturazione. Non basarti sulle vecchie indicazioni del video relative all'uso gratuito o alle quote: verifica le condizioni mostrate nella tua console.
Abilitare Map Tiles API
Apri la libreria delle API, cerca Map Tiles API, selezionala e abilitala per il nuovo progetto.
Creare una chiave API
Apri Credentials e crea una nuova chiave API. Tratta il valore come un segreto, anche se un'integrazione nel browser potrebbe trasmetterlo dal client.
Applicare restrizioni alla chiave
Limita la chiave a Map Tiles API e applica la restrizione per applicazioni più rigorosa compatibile con il tuo utilizzo di FPVSIM. Consenti soltanto le origini o le applicazioni necessarie e non riutilizzare la chiave per progetti non correlati.
Configurare i controlli sui costi
Controlla le quote e configura avvisi sul budget o sull'utilizzo, quando disponibili. Ricontrolla queste impostazioni ogni volta che Google modifica i prezzi o i limiti di Maps Platform.
Caricare un luogo del mondo in FPVSIM
Aprire la scena di volo sul mondo
Avvia FPVSIM, scegli Quick Play e apri la scena basata su Google Earth o Google Maps mostrata in fondo all'elenco delle scene.
Inserire la propria chiave
Incolla la credenziale appena creata nel campo della chiave API e salva. Non incollare una chiave copiata da questo o da altri tutorial pubblici.
Attendere il caricamento dei tasselli
Dopo il salvataggio della credenziale, la scena inizia a richiedere i tasselli della mappa. Se la telecamera parte sotto la superficie, ricarica la scena o rientraci come mostrato.
Scegliere un luogo e volare
Raggiungi il luogo che vuoi esplorare e inizia a volare. I dettagli dei tasselli possono comparire progressivamente, soprattutto con una connessione lenta.
Consigli sulla sicurezza e sulla risoluzione dei problemi
- Se una chiave viene esposta, revocala in Google Cloud Console e creane una nuova, anziché cercare di nascondere il vecchio valore in seguito.
- Un mondo vuoto o caricato solo in parte può indicare che l'API è disabilitata, che le restrizioni non corrispondono alla richiesta, che la quota è esaurita, che la fatturazione non è attiva oppure che la rete è lenta.
- Controlla l'utilizzo del progetto dopo una sessione per individuare subito eventuali richieste inattese.
- Non includere il valore completo della credenziale negli screenshot o nei messaggi di assistenza.
Trascrizione revisionata
Questa trascrizione rimuove tutti i valori delle credenziali e aggiorna le indicazioni sulla sicurezza, mantenendo la procedura mostrata nel tutorial. Le etichette di Google Cloud, i requisiti di fatturazione e le quote potrebbero essere cambiati dalla registrazione.
00:04–00:33
Questo video mostra come ottenere una chiave API di Google Maps e usarla per volare in luoghi reali all'interno di FPVSIM. Al momento della registrazione, la funzione dei tasselli delle mappe era sperimentale e richiedeva agli utenti di fornire una propria credenziale.
00:34–01:14
Accedi a Google Cloud Console, completa la configurazione iniziale dell'account e crea un primo progetto. La creazione può richiedere qualche istante. Prosegui seguendo le richieste di Google relative all'account.
01:14–02:28
Dopo la configurazione, la console consente di accedere alle credenziali. Crea e copia la tua chiave API, poi proteggila con restrizioni appropriate. Nel video è stata mostrata brevemente una chiave dimostrativa, ma era destinata a essere disattivata e non deve essere riutilizzata.
02:47–03:11
Cerca Map Tiles API nella libreria delle API e abilitala per il progetto. Se non hai copiato la chiave in precedenza, puoi gestirla dalla pagina Credentials.
03:11–04:18
La registrazione esamina la quota disponibile all'epoca e descrive la funzione come sperimentale. Prezzi e limiti dipendono da politiche esterne: consulta quindi la versione attuale di Google Cloud Console senza basarti sui valori storici del video.
04:18–05:13
Apri FPVSIM, scegli Quick Play e seleziona la scena Google Earth. Incolla la tua chiave nel campo della chiave API e salva. I tasselli della mappa iniziano a caricarsi. Se la vista iniziale è sotto il terreno, entra di nuovo nella scena.
05:13–08:55
La dimostrazione sorvola Waikiki e prosegue verso Diamond Head, alle Hawaii. La velocità di caricamento dei tasselli dipende dalla connessione Internet, ma la scena permette di esplorare virtualmente su lunghe distanze l'area selezionata.
08:56–09:26
Usa una credenziale del tuo progetto, monitorane l'utilizzo e non usare alcuna chiave esposta nel video. Il tutorial si conclude invitando a porre domande sulla configurazione.
Domande frequenti
Posso usare la chiave API visibile nel video originale?
No. Era una credenziale dimostrativa temporanea di cui era prevista la disattivazione. Crea una chiave nel tuo progetto Google Cloud e applicale delle restrizioni.
È garantito che Map Tiles API sia gratuita?
La registrazione del 2023 non va interpretata come una garanzia. Prima di abilitare il servizio, consulta nella tua console i prezzi, le quote, i requisiti di fatturazione e le condizioni attuali di Google Maps Platform.
Quali restrizioni devo applicare alla credenziale?
Limitala a Map Tiles API e usa la restrizione per applicazioni più rigorosa compatibile, ad esempio consentendo soltanto le origini o le applicazioni necessarie al tuo utilizzo di FPVSIM. Mantieni il progetto dedicato a questo scopo.
Perché i tasselli del mondo restano vuoti o si caricano lentamente?
Verifica che Map Tiles API sia abilitata, che le restrizioni della chiave corrispondano alla richiesta, che la fatturazione sia attiva e la quota disponibile, e che la connessione riesca a caricare i tasselli. Con connessioni lente i dettagli possono comparire gradualmente.
Cosa devo fare se pubblico la chiave per errore?
Revoca immediatamente la chiave esposta in Google Cloud Console, creane una nuova, applica le restrizioni e controlla l'utilizzo per individuare richieste inattese.
