Добавьте ключ API Google Maps для World Flight

Симулятор FPVSIMКарты9:42
Смотреть на YouTube

Создайте и добавьте ключ Google Maps API, чтобы разблокировать реальные местоположения в FPVSIM World Flight.

Что рассматривается в этом руководстве

Это руководство соединяет личный проект платформы Google Maps со сценой мирового полета FPVSIM. Вы создаете специальный облачный проект, включаете API плиток карт, создаете ограниченные учетные данные, сохраняете эти учетные данные в FPVSIM, а затем загружаете реальное местоположение для виртуального полета с FPV.

Никогда не копируйте ключ, показанный в старом видео, снимке экрана, комментарии или общедоступном репозитории. Создайте свои собственные ограниченные учетные данные. Демонстрационный ключ был временным, и любой общедоступный ключ должен быть отозван и заменен.

Прежде чем начать

  • учетная запись Google с доступом к Google Cloud Console.
  • Разрешение на создание проекта, настройку платформы Maps и выполнение всех текущих требований по выставлению счетов и проверке учетной записи.
  • Доступ к FPVSIM и стабильное подключение к Интернету для потоковой передачи фрагментов карты.
  • Пришло время просмотреть текущие цены, квоты и условия Google; консоль и политики могли измениться с момента этой записи в 2023 году.

безопасно создайте учетные данные

  1. Создайте выделенный облачный проект.

    Войдите в Google Cloud Console и создайте проект специально для фрагментов карты FPVSIM. Специальный проект упрощает управление использованием, ограничениями и отзывом.

  2. Завершите настройку текущей учетной записи.

    Следуйте текущим инструкциям Google по настройке учетной записи и выставления счетов. Не полагайтесь на историческое описание бесплатного использования или квот в видео; проверьте условия, показанные в вашей консоли.

  3. Включить API плиток карт

    Откройте библиотеку API, найдите Maps Tiles API, выберите его и включите для нового проекта.

  4. Создайте ключ API.

    откройте учетные данные и создайте новый ключ API. Считайте значение секретным, даже если интеграция на основе браузера может передать его от клиента.

  5. Ограничить ключ

    Ограничьте ключ Maps Tiles API и примените самое узкое ограничение приложения, которое подходит для вашего варианта использования FPVSIM. Разрешайте только необходимые источники или приложения и не используйте повторно ключ для несвязанных проектов.

  6. Добавьте контроль затрат

    просмотрите квоты и настройте оповещения о бюджете или использовании, если это возможно. Перепроверяйте эти элементы управления каждый раз, когда Google меняет цены или ограничения платформы Карт.

Загрузить локацию мира в FPVSIM.

  1. Откройте мир полетов

    Запустите FPVSIM, выберите «Быстрое воспроизведение» и откройте сцену на основе Google Earth или Google Maps, показанную в конце списка сцен.

  2. Введите свой ключ

    Вставьте вновь созданные учетные данные в поле ключа API и сохраните их. Не вставляйте ключ, скопированный из этого или любого другого общедоступного руководства.

  3. Подождите, пока плитки загрузятся.

    Сцена начинает запрашивать фрагменты карты после сохранения учетных данных. Если камера запускается под поверхностью, перезагрузите или повторно войдите в сцену, как показано.

  4. Выбери локацию и лети.

    Перейдите к месту, которое хотите исследовать, и начните полет. Детализация плитки может появляться постепенно, особенно при более медленном соединении.

Советы по безопасности и устранению неполадок

  • Если ключ когда-либо будет раскрыт, отзовите его в Google Cloud Console и создайте замену вместо того, чтобы позже пытаться скрыть старое значение.
  • Пустой или частично загруженный мир может означать, что API отключен, ограничения не соответствуют запросу, квота исчерпана, выставление счетов неактивно или сеть работает медленно.
  • Просматривайте использование проекта после сеанса, чтобы неожиданные запросы были видны заранее.
  • Сохраняйте скриншоты и сообщения поддержки без полного значения учетных данных.

Отредактированная расшифровка

В этой расшифровке удаляются все значения учетных данных и обновляются формулировки безопасности, сохраняя при этом порядок действий, продемонстрированный в руководстве. Ярлыки Google Cloud, требования к выставлению счетов и квоты могли измениться с момента записи.

00:04–00:33

В этом видео показано, как получить ключ Google Maps API и использовать его для полетов в реальных местах внутри FPVSIM. На момент записи функция плитки карты была экспериментальной и требовала от пользователей предоставления собственных учетных данных.

00:34–01:14

Войдите в Google Cloud Console, завершите первоначальную настройку учетной записи и создайте первый проект. Создание проекта может занять некоторое время. Продолжайте использовать подсказки учетной записи, требуемые Google.

01:14–02:28

После настройки консоль предоставляет доступ к учетным данным. Создайте и скопируйте свой собственный ключ API, а затем защитите его с соответствующими ограничениями. В видеоролике ненадолго был показан демонстрационный ключ, но этот ключ предназначен для отключения и не подлежит повторному использованию.

02:47–03:11

Найдите в библиотеке API Maps Tiles API и включите его для проекта. Если вы не скопировали ключ ранее, им можно управлять на странице «Учетные данные».

03:11–04:18

В записи рассматривается доступная на тот момент квота и описывается эта функция как экспериментальная. Цены и ограничения являются внешними политиками, поэтому проверьте текущую консоль Google Cloud, а не опирайтесь на исторические цифры в видео.

04:18–05:13

Откройте FPVSIM, выберите «Быстрое воспроизведение» и выберите сцену Google Earth. Вставьте свой собственный ключ в поле ключа API и сохраните его. Фрагменты карты начнут загружаться. Если первоначальный вид находится под землей, войдите в сцену еще раз.

05:13–08:55

Демонстрация пролетает над Вайкики и направляется к Даймонд-Хед на Гавайях. Скорость загрузки плитки зависит от подключения к Интернету, но сцена позволяет виртуально исследовать выбранную область на большом расстоянии.

08:56–09:26

используйте учетные данные из собственного проекта, отслеживайте их использование и не используйте ключи, показанные в видео. Учебное пособие завершается вопросами о настройке.

Часто задаваемые вопросы

Могу ли я использовать ключ API, показанный в исходном видео?

Нет. Это были временные демонстрационные полномочия, и их планировалось деактивировать. Создайте и ограничьте ключ в своем собственном проекте Google Cloud.

гарантированно ли бесплатный API Maps Tiles API?

Из записи 2023 года не следует делать никаких гарантий. Прежде чем включать ее, ознакомьтесь с текущими ценами, квотами, требованиями к выставлению счетов и условиями платформы Google Maps в своей консоли.

Как мне ограничить учетные данные?

Ограничьте его API-интерфейсом Maps Tiles и используйте самое узкое ограничение совместимого приложения, например только источники или приложения, необходимые для вашего рабочего процесса FPVSIM. Держите проект посвященным этому использованию.

Почему плитки мира пусты или работают медленно?

Убедитесь, что API плиток Карт включен, ограничения ключей соответствуют запросу, выставление счетов и квота активны, и ваше соединение может осуществлять потоковую передачу плиток. При более медленных соединениях детали могут заполняться постепенно.

Что мне делать, если я случайно опубликую свой ключ?

немедленно отзовите открытый ключ в Google Cloud Console, создайте замену, примените ограничения и проверьте использование на предмет непредвиденных запросов.

Русский