Требования
Поскольку этот продукт находится на стадии предварительной версии, следующие аспекты отличаются от стандартной настройки облака, описанной ниже.
Требуемые права доступа
Чтобы использовать Map Management API, необходимо включить его и облачные стили карт для ваших проектов. Для работы с этими двумя продуктами требуются одинаковые разрешения, которые по умолчанию включены в роли MapsAdmin.owner и MapsAdmin.editor.
В этом руководстве описано, как создать проект Google Cloud, чтобы начать работу с API платформы Google Карт. Часть этих инструкций также приводится на странице Начало работы с платформой Google Карт, но мы рекомендуем прочитать эту статью целиком, поскольку она поможет вам в управлении проектами.
Как создать проект
Чтобы управлять сервисами, учетными данными, оплатой, а также использовать API и SDK на платформе Google Карт, необходимо создать проект.
Для каждого проекта обязательно настроить оплату: она будет взиматься только в случае превышения квоты на бесплатное использование сервисов.
Чтобы создать проект Google Cloud с включенной оплатой, выполните следующие шаги:
Консоль
-
Создайте новый облачный проект Google Cloud в Cloud Console.
Создать проект -
Заполните обязательные поля на странице New Project (Новый проект).
-
Project name (Название проекта). Используйте название по умолчанию или введите собственное.
Вы можете изменить название проекта в любой момент. Подробная информация приведена в разделе об идентификации проектов.
-
Идентификатор проекта Используйте вариант по умолчанию или нажмите ИЗМЕНИТЬ, чтобы указать пользовательский идентификатор, который API Google будут использовать в качестве уникального идентификатора для вашего проекта.
Идентификатор проекта нельзя изменить после создания проекта. Поэтому важно сразу выбрать подходящий вариант, так как он будет связан с проектом на протяжении всего периода его действия. Идентификатор проекта не должен содержать конфиденциальную информацию.
-
Billing account (Платежный аккаунт). Выберите платежный аккаунт для проекта. Если у вас только один платежный аккаунт или его нет вообще, этот пункт не будет отображаться на странице.
Чтобы связать проект с платежным аккаунтом, требуется роль администратора платежного аккаунта или менеджера управления оплатой в проекте. Подробнее см. документацию по контролю доступа к платежным данным.
-
Location (Местоположение). Если вы хотите привязать к проекту организацию, нажмите Browse (Обзор). Вы также можете выбрать вариант No organization (Без организации).
Подробная информация приведена в разделах о создании папок и управлении ими и взаимосвязи между организациями, проектами и платежными аккаунтами.
-
Нажмите Создать.
gcloud
gcloud projects create "PROJECT"
Прочитайте статьи о Google Cloud SDK, установке Cloud SDK и следующих командах:
Включить оплату
Чтобы развернуть приложения, необходимо включить оплату. Она будет взиматься только в случае превышения месячной квоты. То есть вы будете платить только за дополнительные ресурсы, не покрываемые месячной квотой, если они понадобятся для работы вашего приложения.
Если у вас уже есть платежный аккаунт, он будет автоматически связан с созданным проектом.
Чтобы включить оплату для проекта Google Cloud, выполните следующие шаги:
- Откройте Cloud Console и перейдите на страницу Оплата.
- Выберите или создайте проект Google Cloud.
- Информация, которую вы увидите на странице "Оплата", зависит от того, есть ли у вас платежный аккаунт и связан ли он с выбранным проектом Google Cloud.
- Если для выбранного проекта Google Cloud уже включена оплата, на странице отображаются сведения о платежном аккаунте.
- Если у вас нет платежного аккаунта, вам будет предложено создать его и связать с проектом.
- Если у вас есть платежный аккаунт, но он не связан с проектом, вам будет предложено включить оплату. Вы также можете создать и связать с проектом новый платежный аккаунт. Для этого нажмите Cancel (Отмена) и выберите Create account (Создать аккаунт).
Учтите, что ограничений на сумму оплаты нет. Чтобы контролировать расходы, укажите бюджет и настройте оповещения о его превышении. Подробнее…
Как включить API
Для работы с платформой Google Карт вам потребуется включить API и SDK, которые будут использоваться в проекте.
Консоль
Cloud SDK
gcloud services enable \ --project "PROJECT" \ "mapmanagement.googleapis.com"
Прочитайте статьи о Google Cloud SDK, установке Cloud SDK и следующих командах:
Как посмотреть список включенных API
Консоль
Чтобы посмотреть список включенных API и SDK, перейдите на страницу Google Maps Platform (Платформа Google Карт) в Cloud Console.
Перейти на страницу "Платформа Google Карт"- Дополнительные API – это API и SDK, которые можно включить.
- Если вы видите карточки для API и сервисов Google Карт, это значит, что API и SDK не были включены.
gcloud
gcloud services list --project "PROJECT"
Прочитайте статьи о Google Cloud SDK, установке Cloud SDK и следующих командах:
Как удалить проект
Чтобы отключить оплату и ресурсы, используемые для проекта Google Cloud, необходимо удалить проект. Для этого выполните следующие действия:
Cloud Console
-
Перейдите на страницу Projects (Проекты).
Перейти на страницу "Проекты" Выберите проект Google Cloud, который вы хотите закрыть, и нажмите Delete (Удалить).
Подробная информация об управлении проектами Google Cloud доступна на странице Cloud Resource Manager: создание, удаление и восстановление проектов.
gcloud
gcloud projects delete "PROJECT"
Прочитайте статьи о Google Cloud SDK, установке Cloud SDK и следующих командах:
Дальнейшие действия
Настроив облачный проект Google Cloud, создайте и защитите ключ API, чтобы пользоваться Map Management API.