Esta página foi traduzida pela API Cloud Translation.

Guia de faturamento da Plataforma Google Maps e Mobilidade

Antes de implementar um novo projeto do Google Maps na produção, verifique se a configuração está correta para pagar o valor certo pelos produtos que você está usando. Neste documento, abordamos aspectos para garantir que você tenha (i) transparência de faturamento, para que o uso possa ser verificado antes que uma fatura seja gerada, e (ii) a configuração correta do projeto, para garantir que você possa usar nossos produtos.

Embora esse seja um processo relativamente simples, os parceiros do Maps podem trabalhar com você para garantir que seus projetos sejam transferidos corretamente.

Conceitos

Nesta seção, queremos garantir que você entenda as informações básicas sobre o faturamento do Google Maps e as diferentes configurações que podem existir. Não há certo ou errado em muitas situações. Depende do tipo de resultado que você quer alcançar.

Neste documento, falamos muito sobre seu projeto do Google Cloud. Isso acontece porque os produtos do Google Maps estão disponíveis por ela. Isso significa que a configuração abordada neste documento é feita no seu projeto do Google Cloud.

Contas de faturamento

Atualmente, todas as empresas que usam os produtos do Google Maps têm um projeto do Google Cloud associado a elas. Este projeto precisa ter uma conta de faturamento configurada. A conta de faturamento é responsável por acumular todo o uso do Google Maps e criar uma fatura mensal com base nesse uso.

Para a Mobilidade, uma conta de faturamento especial é provisionada. Essa conta de faturamento é destinada apenas a casos de uso relacionados à mobilidade, como compartilhamento de carona, entrega e logística.

Uma única conta de faturamento pode ser usada por vários projetos do Google Cloud ou apenas um.

Um projeto único que aponta para a mesma conta de faturamento:

Caso de uso específico (por exemplo, casos de uso de mobilidade)
Faturas separadas
O desconto é feito no volume com base neste único projeto

Vários projetos que apontam para a mesma conta de faturamento:

Mesmo caso de uso
Aproveite os níveis de desconto ao agregar o uso
Fatura única

Para mais informações sobre contas de faturamento e outras informações relevantes, consulte este link.

Como mencionado acima, uma única conta de faturamento pode apontar para vários projetos. Se você tiver mais de um projeto, identifique quais deles vão usar nossos serviços de mobilidade e direcione-os a uma conta de faturamento de mobilidade. Os projetos que não têm um caso de uso de mobilidade associado devem continuar apontando para a conta de faturamento da Plataforma Google Maps que você está usando atualmente. Para ter uma conta de faturamento de mobilidade, é necessário assinar um contrato de mobilidade com o Google ou com um parceiro. Confira abaixo como uma conta de faturamento se encaixa no esquema completo e as diferentes configurações possíveis:

Possíveis configurações da conta de faturamento — **Possíveis configurações de conta de faturamento**

Recursos do Cloud, conta de faturamento e geração de faturas

Em relação aos preços, na Plataforma Google Maps, há diferentes níveis de descontos disponíveis com os parceiros do Maps ou diretamente com o Google em alguns cenários. Esses níveis são baseados no volume, então você paga menos quanto mais usar nossos produtos. Os descontos são aplicados a cada SKU individualmente. Nosso sistema de faturamento identifica seus projetos com base na credencial que você usou para chamar nossos produtos. Ela pode ser uma chave de API ou uma conta de serviço para algumas APIs de mobilidade:

Chaves de API

As APIs da Plataforma Google Maps são autenticadas usando uma chave de API. O Google identifica a conta de faturamento do projeto do Google Cloud correspondente com base nessa chave de API, onde o consumo vai acontecer.

Exemplo de solicitação para a API Geocoding:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJeRpOeF67j4AR9ydy_PIzPuM&key=YOUR_API_KEY

JWT

Algumas APIs exigem um ID de projeto do Google Cloud no URL e usam um JWT para autenticação. Portanto, é importante garantir que os sistemas certos usem o método de autenticação correto para que o faturamento ocorra corretamente.

Exemplo de solicitação para a API Fleet Engine:

curl -X GET \ https://fleetengine.googleapis.com/v1/providers/project_id/deliveryVehicles/vehicle-1234 \
  -H 'authorization: Bearer eyJ0eXAiOi...' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -d '{
    "lastLocation": {
        "location": {
            "latitude": 37.432,
            "longitude": -122.094
        },
        "updateTime": "2022-11-13T17:55:00Z"
    }
}'

Custos

Na Plataforma Google Maps, os custos são calculados com base no volume de solicitações de API. Para os serviços de mobilidade, cobramos com base no volume de transações de mobilidade faturáveis, que são viagens ou tarefas concluídas (envios, não coletas). Isso é definido antes da assinatura do contrato. Se você trabalha com transporte por aplicativo ou entrega de comida, concluir uma viagem ou entrega é sua métrica de sucesso, que é mapeada para uma Viagem. As tarefas são usadas para empresas de logística e varejistas que precisam entregar encomendas.

Sabemos que os clientes de mobilidade também usam os produtos da Plataforma Google Maps na execução de viagens e entregas. Portanto, se você estiver usando uma conta de faturamento de mobilidade, poderá chamar a Plataforma Google Maps sem custo financeiro, desde que os limites predefinidos sejam respeitados no mesmo caso de uso de mobilidade.

Por exemplo, se você é uma empresa de entrega de comida, pode chamar a API Geocoding dez vezes para cada viagem concluída. Para saber mais sobre esses limites, consulte Limites de uso na documentação de mobilidade. Qualquer mudança nos limites máximos exige uma alteração no seu contrato. Por isso, converse com o representante do Google ou do parceiro para discutir suas necessidades específicas.

No fim do mês, uma fatura será gerada com base (i) no número de viagens ou tarefas bem-sucedidas informadas no sistema e (ii) em qualquer volume de chamadas de API da Plataforma Google Maps além dos limites preestabelecidos (excessos). Nossos limites estão alinhados ao que consideramos necessário no mercado.

Sugerimos que você leia com atenção a documentação oficial de faturamento de mobilidade, disponível neste link.

Testes e avaliação

Os clientes podem realizar um pequeno piloto (prova de conceito, avaliação) de serviços de mobilidade em uma conta de faturamento da Plataforma Google Maps por um período limitado antes da assinatura do contrato. Se você quiser realizar um piloto, fale com seu parceiro do Maps ou com o Google.

Durante a fase piloto, como mencionado, não há uma conta de faturamento de mobilidade disponível porque o contrato ainda não foi assinado. Isso significa que, sempre que os produtos da Plataforma Google Maps forem usados, eles serão cobrados, mas os produtos específicos de mobilidade não serão. Em outras palavras, isso significa que, durante a fase piloto, o faturamento não é baseado em tarefas ou viagens. Como consequência, os limites de uso não se aplicam a essa fase.

Quando o piloto for lançado oficialmente para produção, ele precisará ser pago conforme o contrato.

Para resumir:

Fase piloto / de desenvolvimento: você só vai pagar pelas APIs do Google Maps que estão disponíveis publicamente. As APIs e os SDKs que não estão disponíveis publicamente não vão gerar cobranças até que uma conta de faturamento de mobilidade seja usada no projeto. O Google oferece US $200 em créditos para as APIs da Plataforma Google Maps a qualquer nova conta de faturamento criada. Isso deve ser suficiente para um ambiente controlado durante o período de avaliação.
Fase de produção: você é cobrado por viagens ou tarefas. Os custos associados à Plataforma Google Maps só vão ser gerados se o uso exceder os limites de uso do contrato. Nesse caso, você vai pagar pelo excesso. O uso excedente é cobrado conforme definido aqui.

Como migrar para uma conta de faturamento de mobilidade

Ao migrar para a produção, normalmente é necessário criar outros projetos do Google Cloud para representar os diferentes ambientes, como garantia de qualidade e produção. Antes disso, você provavelmente tinha apenas um ambiente, o de desenvolvimento.

Requisitos

Uma pessoa que pode:

Gerenciar contas de faturamento no Google Cloud. Geralmente, isso é feito pelo administrador da conta de faturamento ou pelo proprietário do projeto.
Acesso ao novo ID da conta de faturamento que veio como parte da carta de boas-vindas gerada após a assinatura do contrato.
Acesso ao projeto do Google Cloud correspondente ao ambiente de produção em que as viagens ou tarefas serão informadas.

Siga as etapas abaixo para configurar novos projetos e o faturamento deles.

Nova configuração do projeto

Criação de projetos

[Você] Crie um novo projeto do GCP no console do Google Cloud para cada novo ambiente. Por exemplo, produção, fase de testes e garantia de qualidade.
[Equipe do Google ou do parceiro] Adicione novos projetos a uma lista de permissões para ter acesso aos produtos de mobilidade. Trabalhe com seu representante de vendas do Google ou parceiro e forneça o ID do projeto criado na etapa anterior.
[Você] Atualize os Contatos essenciais nos seus projetos. Essa etapa é muito importante para garantir que as equipes de suporte do Google possam entrar em contato com as pessoas certas para o projeto, se necessário.

Configuração do projeto

Conclua as etapas a seguir no console do Google Cloud para o projeto criado nas etapas anteriores:

[Você] Cria contas de serviço, incluindo a associação de papéis corretos do IAM (Identity and Access Management) de mobilidade (com base na viagem e com base na tarefa).
- como foi feito no ambiente de desenvolvimento ou com uma segregação de acesso mais estruturada, se necessário. Consulte esta seção.
[Você] Cria chaves de API, como foi feito no ambiente de desenvolvimento ou com uma segregação de acesso mais estruturada (por exemplo, por produto, domínio etc.), se necessário.
[Você] Ativa APIs como "Local Rides and Deliveries" e outras APIs da Plataforma Google Maps necessárias (por exemplo, Geocoding, Autocomplete, Address Validation).
[You] Quota: se você precisar de aumentos de QPM (consultas por minuto) para determinadas APIs, abra um tíquete de suporte. Confira como fazer isso aqui. É necessário adicionar uma justificativa comercial informando por que o aumento é necessário. Confira as cotas predefinidas aqui.
[Você] Se você tiver sistemas desenvolvidos que usavam credenciais do ambiente de desenvolvimento, verifique se esses sistemas podem apontar para as novas credenciais criadas para os novos projetos. Isso inclui apontar sistemas de back-end e front-end para as novas credenciais, como chaves de API, contas de serviço e garantir que os IDs de projeto corretos sejam usados em cada ambiente.

Configuração de faturamento

Aqui, presumimos que você já tenha assinado um contrato diretamente com o Google (quando aplicável) ou por meio de um parceiro. Esse é um pré-requisito para receber a conta de faturamento de mobilidade na carta de boas-vindas, que será usada nas próximas etapas.

[Você] Verifica se um ID da conta de faturamento de mobilidade foi recebido como parte da Carta de boas-vindas enviada pelo Google por e-mail após a assinatura e execução do contrato. Importante: a carta de boas-vindas é enviada aos contatos técnicos e financeiros indicados no formulário de pedido do seu contrato. Trabalhe com sua equipe de projeto para entender quem pode ter recebido e peça para a pessoa fornecer o ID da conta de faturamento, que é uma série de caracteres e números separados por hífen.
[Você] Trabalhar com o Google ou o parceiro para garantir que uma validação de faturamento seja realizada. Isso significa que seus sistemas já estão informando corretamente as viagens ou tarefas ao Google. Mais detalhes na próxima seção.
[Você] Aponte seus projetos do Google Cloud para a nova conta de faturamento usando o console do Cloud. Consulte a seção Configuração da conta de faturamento mais adiante neste documento.

Confira mais detalhes sobre o faturamento em geral neste link e neste link.

Validação de faturamento

A validação de faturamento é importante para garantir que você seja cobrado corretamente. Às vezes, as empresas implementam APIs incorretamente, o que resulta em mais cobranças ou subnotificações.

A validação de faturamento consiste nas seguintes etapas:

Verificação se as solicitações para as APIs da Plataforma Google Maps têm um tripId (ou taskId) no cabeçalho da solicitação. Confira mais detalhes aqui.
Verifique se as viagens (ou tarefas) estão sendo informadas corretamente. Isso depende do pacote de mobilidade usado:
- Mobility Starter e Optimize ou Accelerate (com base na viagem): é necessária a integração com a API ReportBillableEvent. Isso significa que sempre que uma viagem for concluída, será necessário fazer uma solicitação para essa API. Para validar se isso está acontecendo corretamente, siga as etapas descritas aqui.
- Aceleração de mobilidade (baseada em tarefas): o faturamento não precisa ser acionado por uma chamada de API. Isso acontece automaticamente quando o resultado de uma tarefa é definido como "SUCESSO" em uma tarefa de entrega. Portanto, é muito importante definir o resultado da tarefa como FALHOU ou SUCESSO. Engenheiros de atendimento ao cliente (parceiros ou Google) vão trabalhar com você para verificar se a implementação foi feita corretamente. No Cloud Logging, é possível verificar se as tarefas estão sendo atualizadas corretamente executando a seguinte consulta do Cloud Logging:
```
resource.type="fleetengine.googleapis.com/DeliveryFleet"
jsonPayload.@type="type.googleapis.com/maps.fleetengine.delivery.log.v1.UpdateTaskLog"
jsonPayload.request.task.taskOutcome="TASK_OUTCOME_LOG_SUCCEEDED"
```
Se as entradas forem exibidas, significa que seus sistemas de back-end estão definindo corretamente as tarefas como SUCESSO.

Observação: é importante verificar se a contagem de viagens ou tarefas concluídas corresponde ao número de chamadas informadas. Às vezes, os eventos de faturamento são informados, mas não correspondem à quantidade total de viagens ou tarefas que foram realmente concluídas na vida real (subnotificação).

Status de integridade da integração

Uma migração bem-sucedida para a produção não deve apenas garantir que o faturamento esteja funcionando corretamente, mas também que as APIs não estejam falhando na execução. No caso dos serviços de mobilidade, é importante verificar se a integração com o Fleet Engine (API Local Rides and Deliveries) foi implementada corretamente.

Para fazer isso, abra o Cloud Logging e use a seguinte consulta:

jsonPayload.errorResponse.code:*

Isso vai listar todas as entradas de registro com problemas. Por exemplo:

**Como consultar erros usando o Cloud Logging**

Esses problemas podem ser exportados para outros produtos do Cloud, como o BigQuery. É possível configurar métricas e alertas com base na consulta do Cloud Logging:

Criação de métricas a partir da consulta do Cloud Logging — **Criação de métricas a partir de consultas do Cloud Logging**

Como esses são produtos do Google Cloud, pode haver custos adicionais. Você pode conversar com seu parceiro ou representante do Google para esclarecer dúvidas.

Configuração da conta de faturamento

Se todos os seus sistemas agora estiverem informando corretamente as viagens ou tarefas e não houver erros de integração, é hora de apontar seus projetos para a conta de faturamento que você recebeu como parte da carta de boas-vindas e que foi abordada nas seções anteriores deste documento.

Observação: se você estiver trabalhando com um parceiro do Maps, ele poderá ajudar você neste momento e você não precisará seguir as etapas abaixo sozinho. Se você estiver trabalhando diretamente com o Google, o que pode acontecer em algumas regiões, siga estas etapas:

Para fazer isso, siga estas etapas:

Abra o console do Google Cloud (https://console.cloud.google.com).
Selecione o novo projeto que será usado na produção.
Acesse a seção "Faturamento" do projeto. Um atalho pode ser acessar este link: https://console.cloud.google.com/billing
Faturamento > Clique em "Gerenciar contas de faturamento":

Seu projeto pode ser diferente do mostrado acima.
Em "Faturamento", clique no ícone de três pontos ao lado do projeto de produção criado e escolha "Mudar conta de faturamento":
Faturamento > Conta de faturamento: escolha o código da conta de faturamento que você recebeu na carta de boas-vindas na lista suspensa. Em seguida, clique em "DEFINIR CONTA":
O projeto será vinculado à nova conta de faturamento:

Importante: a partir de agora, todas as viagens ou tarefas informadas neste projeto vão ser faturadas conforme explicado anteriormente. Se a validação de faturamento ainda não tiver acontecido, não vincule a conta de faturamento.
Depois que o novo método de faturamento for adicionado, acesse "Visão geral > Visão geral do pagamento" e "Configurações de pagamento" para confirmar se as informações estão corretas. Para mais informações sobre como atualizar o faturamento e o pagamento, consulte este link. Se tiver problemas relacionados ao faturamento, abra um caso de suporte de faturamento ou converse com seu representante do Google ou parceiro.

Relatórios de faturamento

Os relatórios de faturamento ajudam a entender os custos associados à conta de faturamento vinculada ao projeto.

Observação: se você estiver trabalhando com um parceiro do Maps, colabore com ele para garantir que as informações de faturamento relevantes sejam fornecidas.

Abra a conta de faturamento vinculada ao projeto e selecione "Relatórios". Em seguida, use o seguinte conjunto de filtros:

Filtros do relatório de faturamento — **Filtros de relatório de faturamento**

Aqui, a principal configuração a ser considerada é o filtro Agrupar por por SKU, que mostra informações detalhadas sobre viagens e tarefas, bem como outras APIs, se usadas, incluindo se houve ou não superfaturamento, conforme explicado anteriormente:

As informações do relatório são atualizadas diariamente. Se for necessário ter informações intradiárias, as consultas do Cloud Logging podem ser usadas para saber quantos eventos faturáveis ocorreram durante o dia. Consulte as seções anteriores para saber mais.

Plano de ampliação

Um ponto importante a mencionar é o plano de aceleração. É comum que nem todo o tráfego seja migrado para o projeto de mobilidade, dependendo da natureza da sua empresa. Por exemplo, algumas empresas levam um tempo para lançar a nova solução em todas as filiais, franquias, lojas, escritórios etc., o que significa que parte do tráfego vai usar os sistemas antigos e parte vai ser direcionada para o novo projeto.

Além disso, em muitos casos, nem todo tráfego pertence a um caso de uso de mobilidade, como é o caso de localizadores de lojas, retirada na calçada e outras soluções internas. Elas precisam apontar para uma conta de faturamento da Plataforma Google Maps, já que o tráfego precisa ser mantido separado da conta de faturamento de mobilidade.

É importante que você cumpra a Política de implementação:

Modelo com base em viagem: "A solução de viagens e entregas sob demanda é destinada a serviços comerciais sob demanda e de entrega. Esses serviços geralmente incluem (a) consumidores que enviam solicitações de uma viagem para um determinado destino (ou entrega de um item específico) e (b) motoristas que são correspondidos a solicitações e dirigem um veículo para concluir os serviços".
Modelo baseado em tarefas: "A solução da Last Mile Fleet da Plataforma Google Maps é destinada a serviços comerciais de entrega e coleta. Esses serviços geralmente incluem (a) uma frota de veículos de entrega que são de propriedade ou contratados pelo cliente, (b) entregas com base em uma rota pré-planejada, (c) uma rede de centros de distribuição com equipes operacionais que dão suporte à execução da entrega e (d) consumidores que rastreiam e recebem os envios."

Portanto, você precisa entender quais dos seus sistemas devem apontar para a conta de faturamento da Plataforma Google Maps e quais devem apontar para a conta de faturamento de mobilidade. É comum ter vários projetos, cada um apontando para a conta de faturamento correta.

Por exemplo, considere que cada viagem / tarefa inclui 10 solicitações de geocodificação hoje, de acordo com os limites de uso. Se a migração levar alguns meses e você começar a informar 100 mil viagens / tarefas no primeiro mês, poderá chamar a API Geocoding 1 milhão de vezes. No entanto, se a empresa solicitar 5 milhões de geocodificações, essa diferença (4 milhões) poderá ser informada como excesso. Há duas opções possíveis:

Você aumenta a quantidade de viagens / tarefas que está informando para nós (acelera o plano de aceleração), então limites mais altos se aplicam. Nesse caso, você precisa informar 500 mil viagens / tarefas por mês.
Você negocia limites mais altos durante as negociações do contrato, conforme explicado anteriormente.
Você direciona as solicitações da API Geocoding para uma API da Plataforma Google Maps para se beneficiar de níveis de desconto mais altos e pagar menos do que os excedentes.

Sabemos que a estimativa de custo pode ser complexa, dependendo do tamanho e da complexidade da sua empresa e dos casos de uso. Por isso, trabalhe com seu parceiro ou com o Google para determinar a melhor maneira de se preparar para o lançamento da produção usando seus projetos atuais.

Em resumo, para criar um plano de aceleração adequado, as seguintes etapas são necessárias: 1. Identifique quais casos de uso estão relacionados à mobilidade e quais não estão, de acordo com a política de implementação. 2. Identifique quais APIs da Plataforma Google Maps são usadas hoje para os casos de uso relevantes e os volumes deles. 3. Identifique se as APIs da Plataforma Google Maps ainda serão necessárias depois que a solução de mobilidade for implementada. Por exemplo, o cálculo do tempo estimado de chegada acontece automaticamente no Fleet Engine. Talvez não seja mais necessário calcular com a API Directions. 4. Identifique quanto tempo vai levar para migrar totalmente os casos de uso de mobilidade para a nova plataforma de mobilidade. 5. Verifique se os limites de uso são suficientes para seus casos de uso. 6. Identifique o ponto de inflexão em que todas as solicitações da Plataforma Google Maps podem ser dobradas para a conta de faturamento de mobilidade para casos de uso de mobilidade.

Conclusão

Em conclusão, configurar corretamente a conta de faturamento é essencial para a previsibilidade e a transparência dos preços. Ao usar nossa tecnologia de mobilidade que incorpora os melhores serviços de localização, as empresas podem ter certeza de que os processos de faturamento são precisos e eficientes. Isso não apenas ajuda a reduzir custos, mas também fornece os dados e insights necessários para tomar decisões comerciais mais informadas. Além disso, a transparência oferecida por esse sistema permite que as empresas tenham um entendimento claro das despesas, o que leva a uma melhor gestão do orçamento.

Próximas ações

Configure sua conta de faturamento no console do GCP.
Confira mais detalhes sobre o faturamento em geral em
- Documentação comercial dos serviços de mobilidade
- Ativar, desativar ou alterar o faturamento de um projeto bookmark_border.