Como configurar no Console do Google Cloud

Neste guia, mostramos como configurar seu projeto do Google Cloud antes de usar as APIs da Plataforma Google Maps. Talvez você tenha concluído algumas destas etapas na página Primeiros passos com a Plataforma Google Maps, mas este guia dá mais instruções úteis para gerenciar seus projetos.

Como criar um projeto

Se quiser usar a Plataforma Google Maps, você precisa ter um projeto para gerenciar serviços, credenciais, faturamento, APIs e SDKs.

A configuração de faturamento é exigida em todos os projetos, mas você só receberá uma cobrança se um projeto exceder a cota gratuita.

Para criar um projeto do Cloud com o faturamento ativado, faça o seguinte:

Console

  1. Crie um projeto do Google Cloud no Console do Cloud:

    Criar novo projeto
  2. Na página Novo projeto, preencha as informações necessárias:

    • Nome do projeto: aceite o padrão ou insira um nome personalizado.

      Você pode mudar o nome do projeto a qualquer momento. Para mais informações, consulte Identificar projetos.

    • ID do projeto: aceite o padrão ou clique em EDITAR para inserir um ID personalizado que as APIs do Google usam como identificador exclusivo do seu projeto.

      Depois de criar o projeto, não será possível mudar o ID. Portanto, escolha um ID que você poderá usar durante todo o projeto. Não inclua informações sensíveis no ID do projeto.

    • Conta de faturamento: selecione uma conta de faturamento para o projeto. Se não tiver criado uma conta de faturamento ou só tiver uma conta desse tipo, você não verá essa opção.

      Você precisa ser administrador da conta de faturamento ou gerente de faturamento do projeto para associá-lo a uma conta desse tipo. Para mais informações, consulte a documentação de controle de acesso do faturamento.

    • Local: se você quiser vincular um projeto a uma organização, clique em Procurar e selecione-a. Caso contrário, escolha "Sem organização".

      Para mais informações, consulte Como criar e gerenciar pastas e Relações entre organizações, projetos e contas de faturamento.

  3. Clique em Criar.

gcloud

gcloud projects create "PROJECT"

Leia mais sobre o SDK do Google Cloud, a instalação do SDK do Cloud e os seguintes comandos:

Ativar o faturamento

Para implantar seus apps, ative o faturamento. Sua conta não receberá cobranças se você permanecer na cota gratuita. Se o aplicativo precisar de recursos que excedam a cota gratuita, cobraremos você pelo uso adicional.

Se você tiver uma conta de faturamento ao criar um projeto do Cloud, o faturamento dele será ativado automaticamente.

Para ativar o faturamento de um projeto do Cloud, faça o seguinte:

  1. No Console do Cloud, acesse a página "Faturamento":

    Acessar a página "Faturamento"

  2. Selecione ou crie um projeto do Cloud.

  3. Se existir uma conta de faturamento ou se o projeto do Cloud selecionado estiver associado a uma conta, a página "Faturamento" exibirá uma destas opções:

    • Caso o faturamento já esteja ativado para o projeto do Cloud selecionado, os detalhes sobre a conta de faturamento serão listados.

    • Se não houver uma conta de faturamento, pediremos para você criar uma e associá-la ao projeto do Cloud selecionado.

    • Caso exista uma conta de faturamento, você precisará ativar o faturamento se o projeto do Cloud selecionado ainda não estiver associado a uma conta de faturamento. Se preferir, clique em Cancelar e, depois, em Criar conta para criar e associar uma nova conta de faturamento.

Após a ativação do faturamento, não haverá um valor-limite para as cobranças. Para ter mais controle sobre seus custos, crie um orçamento e defina alertas. Veja mais informações em Faturamento.

Ativar APIs

Para utilizar a Plataforma Google Maps, ative as APIs ou os SDKs que você planeja usar com seu projeto.

Console

Ativar o SDK do Maps para Android

SDK do Cloud

gcloud services enable \
    --project "PROJECT" \
    "maps-android-backend.googleapis.com"

Leia mais sobre o SDK do Google Cloud, a instalação do SDK do Cloud e os seguintes comandos:

Ver as APIs ativadas

Console

Para ver as APIs ou os SDKs que você ativou, acesse a página da Plataforma Google Maps no Console do Cloud:

Acessar a página da Plataforma Google Maps
  • Outras APIs: esses SDKs ou APIs não estão ativados.
  • Se você vê cards para cada API e serviço do Maps, nenhum SDK ou API foi ativado.

gcloud

gcloud services list --project "PROJECT"

Leia mais sobre o SDK do Google Cloud, a instalação do SDK do Cloud e os seguintes comandos:

Gerenciar o faturamento

  1. Selecione um projeto no Console do Cloud:

    Acessar a página "Faturamento"

  2. Realize as seguintes tarefas de gerenciamento:

    • Confira uma visão geral da conta de faturamento, faça pagamentos e adicione administradores dessa conta na página Visão geral. Recomendamos ter vários proprietários de projetos e administradores de faturamento, para que sempre haja alguém com essas funções disponíveis na sua equipe.
    • Crie orçamentos e alertas na página Orçamentos e alertas.
    • Veja seu histórico de transações e faça o download das faturas na página Transações.
    • Exporte seus dados de faturamento da página Exportação de faturamento.
    • Configure sua conta para pagamentos e seus contatos na página Configurações de pagamento.
    • Defina a forma de pagamento na página Forma de pagamento.

Para mais informações sobre faturamento, consulte Faturamento da Plataforma Google Maps.

Como criar orçamentos e definir alertas

Para evitar surpresas na sua fatura e monitorar todas as cobranças do Cloud em um só lugar, crie um orçamento para o projeto do Cloud. Com um orçamento, é possível definir alertas que enviarão e-mails aos administradores de faturamento quando as cobranças excederem um determinado valor.

Console

Para criar um orçamento e definir alertas em um projeto do Cloud, faça o seguinte:

  • No Console do Cloud, acesse a página "Faturamento":

    Acessar a página "Faturamento"
  • Clique em Orçamentos e alertas e em Criar orçamento se quiser definir um orçamento para o projeto do Cloud.
  • Estipule o orçamento na seção Definir orçamento e especifique as porcentagens que acionarão o envio de alertas por e-mail na seção Definir alertas de orçamento.
  • Clique em Concluir se quiser definir o orçamento e ativar alertas para seu projeto do Cloud. Caso você tenha vários projetos do Cloud, defina os orçamentos e os alertas em cada um deles.

gcloud

Ativar a API necessária para criar um orçamento de faturamento

gcloud services enable \
    --project "PROJECT" \
    billingbudgets.googleapis.com

Defina um orçamento para enviar um alerta quando você atingir 50% de gasto real e novamente ao alcançar 75% do gasto estimado.

gcloud billing budgets create \
    --project "PROJECT" \
    --billing-account="BILLING_ACCOUNT" \
    --display-name="BUDGET_NAME" \
    --budget-amount=AMOUNTUSD \
    --threshold-rule=percent=0.5 \
    --threshold-rule=percent=0.75,basis=forecasted-spend

Leia mais sobre o SDK do Google Cloud, a instalação do SDK do Cloud e os seguintes comandos:

Encerrar um projeto

Para desativar o faturamento e liberar todos os recursos do Cloud que estão sendo usados no projeto do Cloud, encerre esse projeto:

Console

  1. Acesse a página "Projetos":

    Acessar a página "Projetos"
  2. Selecione o projeto do Cloud que você quer encerrar e clique em Excluir.

Para mais informações sobre como gerenciar os projetos do Cloud, consulte Cloud Resource Manager: como criar, encerrar e restaurar projetos.

gcloud

gcloud projects delete "PROJECT"

Leia mais sobre o SDK do Google Cloud, a instalação do SDK do Cloud e os seguintes comandos:

Próxima etapa

Depois de configurar o projeto do Google Cloud, crie e proteja a chave de API para usar o SDK do Maps para Android:

Como usar chaves de API