В этом руководстве объясняется, как создать и настроить персональный ключ API платформы Google Maps для функции полета на карте мира FPVSIM: создать новый автономный проект в Google Cloud, выполнить требования к учетной записи, включить API плиток Карт, сгенерировать и правильно ограничить ключ и, наконец, сохранить ключ в сцене карты мира FPVSIM. Это видео было записано в 2023 году. Интерфейс Google, платежные требования, квоты и требования к проверке могли измениться, поэтому вам следует ознакомиться с последними политиками, отображаемыми в вашей консоли.
Для чего нужна настройка
Сцена карты мира FPVSIM получает тайлы от Google Maps Platform. Процесс не скачивает одну готовую карту: FPVSIM по мере надобности загружает реальные места через ваш проект Google Cloud и API-ключ. Отдельный проект позволяет независимо от других облачных сервисов управлять расходом, правами, бюджетными уведомлениями и последующим отзывом доступа.
Нужны аккаунт для входа в Google Cloud Console, стабильная сеть и возможность выполнить текущую проверку аккаунта или настройку оплаты. В видео функция названа экспериментальной. Даже при похожем нынешнем интерфейсе тогдашний бесплатный объём или дневное число запросов не являются долгосрочным обещанием.
Создайте безопасные учётные данные Google Cloud
Войдите в консоль, создайте отдельный проект FPVSIM и завершите настройку аккаунта по текущим подсказкам. В библиотеке API найдите и включите Map Tiles API, затем на странице учётных данных создайте API-ключ. Сразу сохраните его в безопасном месте и не допускайте появления на скриншотах, в чатах, публичном репозитории или открытом видео.
Рекомендуется разрешить ключу только Map Tiles API и выбрать самые строгие ограничения приложения, совместимые с использованием FPVSIM. Также проверьте квоты и уведомления о бюджете или расходе. Демонстрационный ключ видео не общий: автор прямо собирался его удалить. Любой раскрытый ключ нужно отозвать и создать заново.
Добавьте ключ в FPVSIM и загрузите карту
Обновите FPVSIM до версии с поддержкой функции. В конце списка Quick Play откройте Google Earth — сцену карты мира. Вставьте ключ своего проекта в первое поле и сохраните: начнётся запрос тайлов. Если камера при первом входе окажется под землёй, как в видео, войдите заново или повторно загрузите сцену.
Детали появляются постепенно с сетевыми запросами; медленное соединение требует ожидания. В конце на примере Гавайев показана загрузка реальных мест для виртуального FPV-исследования. Это не гарантирует одинаковую точность всех районов: результат зависит от данных карты, сети, состояния API и доступной квоты.
Безопасность, стоимость и поиск неполадок
Если карта пуста или загружена частично, последовательно проверьте включение Map Tiles API, принадлежность ключа нужному проекту, соответствие ограничений запросам, состояние аккаунта и оплаты, остаток квоты и непрерывную загрузку тайлов сетью. Не снимайте все ограничения ключа из-за временно пустой сцены. Сначала найдите конкретную причину.
Раскрытый ключ сразу отзовите в Google Cloud Console: удаления текста с публичной страницы недостаточно. Создайте замену, снова ограничьте права и проверьте необычный расход проекта. Упомянутые квоты и слова «деньги не спишут» отражают только тогдашнюю демонстрацию. Перед использованием заново прочитайте актуальные цены и условия.
Этапы работы
- Войдите и создайте отдельный проект
Откройте ссылку Google Cloud из описания, войдите в свой аккаунт и создайте отдельный проект для карт FPVSIM.
- Завершите текущую настройку аккаунта
Выполните нынешние требования консоли по личности, аккаунту или оплате, предварительно проверив актуальные цены и условия.
- Создайте и сохраните свой API-ключ
На странице учётных данных создайте свой ключ, безопасно сохраните и подготовьте ограничения API и приложения. Не копируйте демонстрационный ключ видео.
- Включите Map Tiles API
В библиотеке найдите Map Tiles API и убедитесь, что он включён для только что созданного проекта.
- Проверьте ограничения и квоты
Ограничьте ключ необходимым API, проверьте нынешнюю квоту и настройте доступные уведомления о бюджете или расходе.
- Выберите карту мира в FPVSIM
После обновления FPVSIM откройте Quick Play и сцену Google Earth / карты мира.
- Вставьте ключ и дождитесь загрузки тайлов
Вставьте собственный ключ в поле сцены и сохраните. Если начальная камера под землёй, войдите повторно или перезагрузите сцену.
Часто задаваемые вопросы
Можно ли взять API-ключ, показанный в видео?
Нет. Это временные демонстрационные данные, которые автор обещал удалить после публикации. Создайте, ограничьте и обслуживайте собственный ключ в своём Google Cloud.
Обязательно ли Map Tiles API бесплатен?
Такой вывод нельзя делать по видео 2023 года. Цены, бесплатный объём, квоты и требования оплаты меняются. До включения проверьте актуальные условия в своей консоли.
Почему после сохранения ключа карта остаётся пустой?
Проверьте включение API, проект ключа, соответствие ограничений запросам, состояние аккаунта или оплаты, остаток квоты и сеть. Тайлы также могут загружаться постепенно в течение некоторого времени.
Что делать, если API-ключ случайно опубликован?
Сразу отзовите раскрытый ключ, создайте и ограничьте замену, а также проверьте неожиданные запросы в расходе проекта. Одно удаление текста ключа со страницы не делает прежний ключ недействительным.
Нужен ли отдельный проект Google Cloud для FPVSIM?
Рекомендуется. Отдельный проект упрощает ограничения API, контроль расхода, уведомления и отзыв доступа без влияния на другие сервисы.
Полная стенограмма временной шкалы
Стенограммы упорядочены по времени видео, что позволяет легко найти поясняющее содержание. Язык стенограммы: упрощенный китайский.
Всем привет, это QuoteRank. Быстро покажу, как получить бесплатный API-ключ Google Maps и использовать его для FPV в любой точке мира. Сейчас API экспериментальный, поэтому нужны эти шаги. Возможно, после полного выпуска они больше не понадобятся. Но если хотите попробовать заранее, как я, вот очень простой способ. Сначала…
…откройте ссылку, которую я оставлю в описании, и убедитесь, что вошли в Google. У меня ещё нет аккаунта Google Cloud, поэтому нужна базовая настройка. Здесь достаточно согласиться. Создаём первый проект, название не важно. Нажимаем создание и немного ждём. Теперь завершим настройку аккаунта.
Google попросит данные кредитной карты, но использует их только для проверки личности и фактически денег не спишет, так что сильно переживать не нужно. Выбираем личный аккаунт и вводим карту. Я сразу перейду к странице после её добавления.
Дальше нужно ответить на несколько вопросов. Поскольку нужен только API key, ответы не так важны. Я выберу варианты и отправлю. Здесь выдают API key: скопируем и сохраним где-нибудь. Тут можно ограничить API, но мы используем его только сами, поэтому это не так важно.
Теперь ищем Tile API и выбираем API тайлов карты — Map Tiles API. Проверьте, что он включён, нажмите Enabled. Затем скопируйте ранее полученный ключ в FPVSIM. Если не сохранили его, откройте Credentials…
…и показ ключа, чтобы скопировать отсюда. Не используйте мой API key: после публикации я его удалю. Google также ограничивает число запросов к API за день. Здесь видно 250000 запросов в сутки.
По моему опыту, 250000 хватает на час-два полёта, если не загружать непрерывно новые карты. На час-два вполне хватает, так что беспокоиться особо не стоит. Теперь копируем ключ в FPVSIM. Убедитесь в обновлении до последней версии. В Quick Play откройте последнюю карту Google Earth — появится новый экран…
…в первое поле вставьте скопированный ключ и сохраните. Видно, что карта загружается. Кажется, мы оказались ниже земли. Нажмите ещё раз, и камера поднимется над поверхностью. Теперь можно исследовать виртуальные Гавайи.
