Предпосылки
Поскольку этот продукт находится на экспериментальной стадии (до GA), следующие настройки отличаются от стандартной облачной настройки, описанной ниже.
Требуемые разрешения
API управления картами требует включения API управления картами и облачной стилизации карт для ваших проектов.
Вам необходимы следующие разрешения:
-
datasetStyleAssociations.list -
datasetStyleAssociations.create -
datasetStyleAssociations.delete
Эти разрешения по умолчанию включены в роли MapsAdmin.owner и MapsAdmin.editor .
Стили и наборы данных должны существовать в проекте.
У вас должны быть ресурсы стилизации облачных карт, в частности наборы данных и стили, связанные с вашим проектом.
В этом руководстве показано, как настроить проект Google Cloud перед использованием API платформы Google Карт. Возможно, вы уже выполнили некоторые из этих шагов на странице «Начало работы с платформой Google Карт» , но этот документ содержит дополнительные полезные инструкции по управлению вашими проектами.
Создать проект
Чтобы использовать платформу Google Карт, вам необходим проект по управлению сервисами, учетными данными, выставлением счетов, API и SDK.
Для каждого проекта требуется настройка выставления счетов , но плата будет взиматься только в том случае, если проект превысит квоту бесплатных услуг.
Чтобы создать облачный проект с включенным биллингом:
Консоль
Создайте новый проект Google Cloud в консоли Cloud:
Создать новый проектНа странице «Новый проект» заполните необходимую информацию:
Название проекта: примите имя по умолчанию или введите собственное имя.
Вы можете изменить название проекта в любое время. Подробнее см. в разделе «Идентификация проектов» .
Идентификатор проекта: примите значение по умолчанию или нажмите «ИЗМЕНИТЬ» , чтобы ввести индивидуальный идентификатор, который API Google будет использовать в качестве уникального идентификатора для вашего проекта.
После создания проекта изменить его идентификатор невозможно , поэтому выберите идентификатор, который вам будет удобно использовать на протяжении всего жизненного цикла проекта. Не включайте в идентификатор проекта конфиденциальную информацию.
Платежный аккаунт: выберите платёжный аккаунт для проекта. Если у вас нет платёжного аккаунта или есть только один платёжный аккаунт, эта опция не будет доступна.
Чтобы связать проект с платёжным аккаунтом, необходимо быть администратором платёжного аккаунта или менеджером по выставлению счетов проекта. Подробнее см. в документации по управлению доступом к платёжным аккаунтам .
Расположение: Если у вас есть организация, с которой вы хотите связать свой проект, нажмите «Обзор» и выберите ее; в противном случае выберите «Нет организации».
Дополнительные сведения см. в разделах Создание и управление папками и Связи между организациями, проектами и счетами выставления счетов .
Выберите Создать .
gcloud
gcloud projects create "PROJECT"
Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:
Включить биллинг
Для развертывания приложений необходимо включить биллинг. С вашего счёта не будет взиматься плата, если вы не превысите ежемесячную квоту . Если вашему приложению требуются ресурсы, превышающие ежемесячную квоту, с вас будет взиматься плата за дополнительное использование.
Если при создании облачного проекта у вас есть учетная запись для выставления счетов, то выставление счетов для этого проекта включается автоматически.
Чтобы включить биллинг в облачном проекте:
- В консоли Cloud перейдите на страницу «Оплата»:
Перейти на страницу выставления счетов - Выберите или создайте облачный проект.
- В зависимости от того, существует ли учетная запись для выставления счетов или связан ли выбранный облачный проект с учетной записью, на странице выставления счетов отображается одно из следующих значений:
- Если для выбранного облачного проекта уже включено выставление счетов, будут указаны сведения о платежной учетной записи.
- Если платежная учетная запись не существует, вам будет предложено создать ее и связать с выбранным облачным проектом.
- Если учётная запись существует, вам будет предложено включить её, если выбранный проект Cloud ещё не связан с учётной записью. Вы также можете нажать «Отмена» , а затем выбрать «Создать учётную запись» , чтобы создать и связать новую учётную запись.
После включения биллинга сумма, которую вы можете списать, не будет ограничена. Чтобы лучше контролировать расходы, вы можете создать бюджет и настроить оповещения . Подробнее см. в разделе «Биллинг» .
Включить API
Чтобы использовать платформу Google Карт, необходимо включить API или SDK, которые вы планируете использовать в своем проекте.
Консоль
Облачный SDK
gcloud services enable \ --project "PROJECT" \ "mapmanagement.googleapis.com"
Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:
Просмотреть включенные API
Консоль
Чтобы просмотреть включенные вами API или SDK, перейдите на страницу платформы Google Карт в консоли Cloud:
Перейти на страницу платформы Google Карт- Дополнительные API: эти API или SDK не включены.
- Если вы видите карточки для каждого API и сервиса карты, то ни один API или SDK не был включен.
gcloud
gcloud services list --project "PROJECT"
Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:
Закрытие проекта
Вы можете отключить биллинг и освободить все облачные ресурсы, которые используются в вашем облачном проекте, завершив этот проект:
Консоль
Перейти на страницу проектов:
Перейти на страницу проектовВыберите проект Cloud, который вы хотите закрыть, затем нажмите Удалить .
Дополнительную информацию об управлении облачными проектами см. в статье Cloud Resource Manager: создание, завершение работы и восстановление проектов .
gcloud
gcloud projects delete "PROJECT"
Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:
Что дальше?
После настройки проекта Google Cloud необходимо создать и защитить свой ключ API для использования API управления картами: