Como criar uma pista personalizada no FPVSIM
Crie uma pista de corrida FPV do zero com as ferramentas de criação de pistas do FPVSIM.
Crie e adicione uma chave da API do Google Maps para acessar locais reais no World Flight do FPVSIM.
O que este tutorial ensina
Este tutorial conecta um projeto pessoal do Google Maps Platform à cena de voo pelo mundo do FPVSIM. Você cria um projeto de nuvem exclusivo para essa finalidade, ativa a Map Tiles API, cria uma credencial com restrições, salva essa credencial no FPVSIM e carrega um local real para voar virtualmente em FPV.
Nunca copie a chave exibida em um vídeo antigo, captura de tela, comentário ou repositório público. Crie sua própria credencial com restrições. A chave da demonstração era temporária, e qualquer chave exposta publicamente deve ser revogada e substituída.
Antes de começar
- Uma conta do Google com acesso ao Google Cloud Console.
- Permissão para criar um projeto, configurar o Maps Platform e cumprir os requisitos atuais de faturamento ou verificação de conta.
- Acesso ao FPVSIM e uma conexão estável com a internet para carregar os blocos do mapa.
- Tempo para consultar os preços, as cotas e os termos atuais do Google: o console e as políticas podem ter mudado desde esta gravação de 2023.
Crie a credencial com segurança
Crie um projeto de nuvem exclusivo
Entre no Google Cloud Console e crie um projeto específico para os blocos de mapa do FPVSIM. Um projeto exclusivo facilita o gerenciamento de uso, restrições e revogação.
Conclua a configuração atual da conta
Siga as instruções atuais do Google para configurar a conta e o faturamento. Não se baseie na descrição histórica do vídeo sobre uso gratuito ou cotas; confira os termos exibidos no seu console.
Ative a Map Tiles API
Abra a biblioteca de APIs, procure Map Tiles API, selecione-a e ative-a para o novo projeto.
Crie uma chave de API
Abra Credentials e crie uma nova chave de API. Trate esse valor como segredo, mesmo que uma integração no navegador possa transmiti-lo a partir do cliente.
Aplique restrições à chave
Limite a chave à Map Tiles API e aplique a restrição de aplicativo mais rigorosa que funcione para o seu uso do FPVSIM. Permita apenas as origens ou os aplicativos necessários e não reutilize a chave em projetos sem relação com esse uso.
Configure controles de custo
Confira as cotas e configure alertas de orçamento ou de uso, quando disponíveis. Revise esses controles sempre que o Google alterar os preços ou os limites do Maps Platform.
Carregue um local do mundo no FPVSIM
Abra a cena de voo pelo mundo
Inicie o FPVSIM, escolha Quick Play e abra a cena baseada no Google Earth ou no Google Maps que aparece no final da lista de cenas.
Insira sua própria chave
Cole a credencial recém-criada no campo da chave de API e salve. Não cole uma chave copiada deste ou de qualquer outro tutorial público.
Aguarde o carregamento dos blocos do mapa
Depois que a credencial é salva, a cena começa a solicitar os blocos do mapa. Se a câmera iniciar abaixo da superfície, recarregue a cena ou entre nela novamente, como mostrado.
Escolha um local e voe
Navegue até o local que deseja explorar e comece a voar. Os detalhes dos blocos podem aparecer aos poucos, principalmente em conexões mais lentas.
Dicas de segurança e solução de problemas
- Se uma chave for exposta, revogue-a no Google Cloud Console e crie outra, em vez de tentar ocultar o valor antigo depois.
- Um mundo em branco ou parcialmente carregado pode indicar que a API está desativada, que as restrições não correspondem à solicitação, que a cota foi esgotada, que o faturamento está inativo ou que a rede está lenta.
- Confira o uso do projeto após cada sessão para identificar solicitações inesperadas logo no início.
- Não inclua o valor completo da credencial em capturas de tela ou mensagens de suporte.
Transcrição revisada
Esta transcrição omite todos os valores de credenciais e atualiza as orientações de segurança, preservando o fluxo demonstrado no tutorial. Os rótulos do Google Cloud, os requisitos de faturamento e as cotas podem ter mudado desde a gravação.
00:04–00:33
Este vídeo mostra como obter uma chave da API do Google Maps e usá-la para voar por locais reais no FPVSIM. Na época da gravação, o recurso de blocos de mapa era experimental e exigia que cada usuário fornecesse sua própria credencial.
00:34–01:14
Entre no Google Cloud Console, conclua a configuração inicial da conta e crie seu primeiro projeto. A criação do projeto pode levar alguns instantes. Continue seguindo as solicitações de conta exigidas pelo Google.
01:14–02:28
Depois da configuração, o console oferece acesso às credenciais. Crie e copie sua própria chave de API e proteja-a com as restrições adequadas. O vídeo exibiu brevemente uma chave de demonstração, mas ela seria desativada e não deve ser reutilizada.
02:47–03:11
Procure Map Tiles API na biblioteca de APIs e ative-a para o projeto. Se não copiou a chave antes, você pode gerenciá-la na página Credentials.
03:11–04:18
A gravação examina a cota disponível na época e descreve o recurso como experimental. Os preços e os limites dependem de políticas externas. Confira o Google Cloud Console atual, sem se basear nos números históricos do vídeo.
04:18–05:13
Abra o FPVSIM, escolha Quick Play e selecione a cena Google Earth. Cole sua própria chave no campo da chave de API e salve. Os blocos do mapa começarão a carregar. Se a visualização inicial estiver abaixo do solo, entre na cena novamente.
05:13–08:55
A demonstração sobrevoa Waikiki em direção a Diamond Head, no Havaí. A velocidade de carregamento dos blocos depende da conexão com a internet, mas a cena permite explorar virtualmente a área escolhida em longas distâncias.
08:56–09:26
Use uma credencial do seu próprio projeto, acompanhe o uso e não utilize nenhuma chave exposta no vídeo. O tutorial termina convidando os espectadores a fazer perguntas sobre a configuração.
Perguntas frequentes
Posso usar a chave de API que aparece no vídeo original?
Não. Ela era uma credencial temporária de demonstração, com desativação prevista. Crie uma chave no seu próprio projeto do Google Cloud e aplique restrições a ela.
Há garantia de que a Map Tiles API é gratuita?
A gravação de 2023 não oferece essa garantia. Antes de ativar o recurso, confira no seu console os preços, as cotas, os requisitos de faturamento e os termos atuais do Google Maps Platform.
Quais restrições devo aplicar à credencial?
Restrinja-a à Map Tiles API e use a restrição de aplicativo mais rigorosa que seja compatível, permitindo, por exemplo, apenas as origens ou os aplicativos necessários ao seu uso do FPVSIM. Mantenha o projeto exclusivo para essa finalidade.
Por que os blocos do mundo ficam em branco ou demoram a carregar?
Confirme se a Map Tiles API está ativada, se as restrições da chave correspondem à solicitação, se o faturamento está ativo e há cota disponível, e se sua conexão consegue carregar os blocos. Em conexões mais lentas, os detalhes podem aparecer aos poucos.
O que devo fazer se publicar minha chave por engano?
Revogue imediatamente a chave exposta no Google Cloud Console, crie outra, aplique restrições e confira o uso em busca de solicitações inesperadas.
