Añadir una clave de API de Google Maps para volar por el mundo

Simulador FPVSIMMapas9:42
Ver en YouTube

Crea y añade una clave de API de Google Maps para acceder a lugares reales en el modo World Flight de FPVSIM.

Qué aprenderás en este tutorial

Este tutorial conecta un proyecto personal de Google Maps Platform con el escenario de vuelo por el mundo de FPVSIM. Crearás un proyecto de nube dedicado, activarás Map Tiles API, generarás una clave restringida, la guardarás en FPVSIM y cargarás un lugar real para volar en FPV de forma virtual.

Nunca copies una clave que aparezca en un vídeo antiguo, una captura, un comentario o un repositorio público. Crea tu propia clave restringida. La clave de la demostración era temporal y cualquier clave expuesta públicamente debe revocarse y sustituirse.

Antes de empezar

  • Una cuenta de Google con acceso a Google Cloud Console.
  • Permiso para crear un proyecto, configurar Maps Platform y cumplir los requisitos actuales de facturación o verificación de cuenta.
  • Acceso a FPVSIM y una conexión a Internet estable para cargar las teselas del mapa en streaming.
  • Tiempo para revisar los precios, las cuotas y las condiciones actuales de Google: la consola y las políticas pueden haber cambiado desde esta grabación de 2023.

Crear la clave de forma segura

  1. Crear un proyecto de nube dedicado

    Inicia sesión en Google Cloud Console y crea un proyecto específico para las teselas de mapas de FPVSIM. Un proyecto dedicado facilita la gestión del uso, las restricciones y la revocación.

  2. Completar la configuración actual de la cuenta

    Sigue las indicaciones actuales de Google para configurar la cuenta y la facturación. No te bases en la descripción histórica de uso gratuito o cuotas del vídeo: comprueba las condiciones que aparecen en tu consola.

  3. Activar Map Tiles API

    Abre la biblioteca de API, busca Map Tiles API, selecciónala y actívala para el proyecto nuevo.

  4. Crear una clave de API

    Abre la sección de credenciales y crea una clave de API. Trátala como un secreto, aunque una integración en el navegador pueda transmitirla desde el cliente.

  5. Restringir la clave

    Limita la clave a Map Tiles API y aplica la restricción de aplicación más estricta que sea compatible con tu uso de FPVSIM. Permite solo los orígenes o las aplicaciones necesarios y no reutilices la clave en proyectos ajenos.

  6. Añadir controles de costes

    Revisa las cuotas y configura alertas de presupuesto o de uso cuando estén disponibles. Vuelve a comprobar estos controles cada vez que Google cambie los precios o los límites de Maps Platform.

Cargar un lugar del mundo en FPVSIM

  1. Abrir el escenario de vuelo por el mundo

    Inicia FPVSIM, elige « Quick Play » y abre el escenario de Google Earth o basado en Google Maps que aparece al final de la lista de escenarios.

  2. Introducir tu propia clave

    Pega la clave que acabas de crear en el campo de clave de API y guárdala. No pegues una clave copiada de este tutorial ni de ningún otro tutorial público.

  3. Esperar a que se carguen las teselas

    El escenario empieza a solicitar las teselas del mapa una vez guardada la clave. Si la cámara aparece bajo la superficie, recarga o vuelve a entrar en el escenario, como muestra la demostración.

  4. Elegir un lugar y volar

    Desplázate al lugar que quieras explorar y empieza a volar. Los detalles de las teselas pueden aparecer de forma progresiva, especialmente con una conexión lenta.

Consejos de seguridad y solución de problemas

  • Si una clave queda expuesta, revócala en Google Cloud Console y crea otra, en lugar de intentar ocultar el valor antiguo después.
  • Un mundo vacío o parcialmente cargado puede indicar que la API está desactivada, que las restricciones no coinciden con la solicitud, que se ha agotado la cuota, que la facturación está inactiva o que la red es lenta.
  • Revisa el uso del proyecto después de cada sesión para detectar pronto solicitudes inesperadas.
  • No incluyas el valor completo de la clave en capturas de pantalla ni en mensajes de asistencia.

Transcripción editada

Esta transcripción elimina todos los valores de las claves y actualiza la redacción de seguridad sin alterar el procedimiento mostrado. Las etiquetas de Google Cloud, los requisitos de facturación y las cuotas pueden haber cambiado desde la grabación.

00:04–00:33

Este vídeo explica cómo obtener una clave de API de Google Maps y utilizarla para volar en lugares reales dentro de FPVSIM. En el momento de la grabación, la función de teselas de mapas era experimental y requería que cada usuario aportara su propia clave.

00:34–01:14

Inicia sesión en Google Cloud Console, completa la configuración inicial de la cuenta y crea un primer proyecto. La creación puede tardar un poco. Continúa con los pasos de cuenta que solicite Google.

01:14–02:28

Después de la configuración, la consola da acceso a las credenciales. Crea y copia tu propia clave de API y protégela con las restricciones adecuadas. El vídeo mostró brevemente una clave de demostración, pero estaba previsto desactivarla y no debe reutilizarse.

02:47–03:11

Busca Map Tiles API en la biblioteca de API y actívala para el proyecto. Si no copiaste la clave antes, puedes gestionarla desde la página de credenciales.

03:11–04:18

La grabación repasa la cuota disponible en aquel momento y describe la función como experimental. Los precios y los límites son políticas externas: consulta la Google Cloud Console actual en lugar de basarte en las cifras históricas del vídeo.

04:18–05:13

Abre FPVSIM, elige « Quick Play » y selecciona el escenario de Google Earth. Pega tu propia clave en el campo de clave de API y guárdala. Las teselas empezarán a cargarse. Si la vista inicial está bajo el suelo, vuelve a entrar en el escenario.

05:13–08:55

La demostración sobrevuela Waikiki y se dirige hacia Diamond Head, en Hawaii. La velocidad de carga de las teselas depende de la conexión a Internet, pero el escenario permite explorar virtualmente la zona elegida a larga distancia.

08:56–09:26

Utiliza una clave de tu propio proyecto, supervisa su uso y no emplees ninguna clave expuesta en el vídeo. El tutorial termina invitando a plantear preguntas sobre la configuración.

Preguntas frecuentes

¿Puedo utilizar la clave de API visible en el vídeo original?

No. Era una clave temporal de demostración cuya desactivación estaba prevista. Crea y restringe una clave en tu propio proyecto de Google Cloud.

¿Está garantizado que Map Tiles API sea gratis?

No debe deducirse ninguna garantía de la grabación de 2023. Antes de activar la API, revisa en tu propia consola los precios, las cuotas, los requisitos de facturación y las condiciones actuales de Google Maps Platform.

¿Cómo debo restringir la clave?

Limítala a Map Tiles API y utiliza la restricción de aplicación compatible más estricta, por ejemplo solo los orígenes o las aplicaciones necesarios para tu uso de FPVSIM. Mantén el proyecto dedicado a ese uso.

¿Por qué las teselas del mundo están vacías o tardan en cargar?

Comprueba que Map Tiles API esté activada, que las restricciones de la clave coincidan con la solicitud, que la facturación y la cuota estén activas y que tu conexión pueda cargar las teselas. En conexiones lentas, los detalles pueden aparecer poco a poco.

¿Qué debo hacer si publico mi clave por accidente?

Revoca de inmediato la clave expuesta en Google Cloud Console, crea otra, aplícale restricciones y revisa el uso para detectar solicitudes inesperadas.

Español