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 em produção, convém garantir verifique se sua configuração está correta para que você pague o valor certo pelos produtos que você está usando. Neste documento, abordamos os aspectos para garantir que você (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, vamos falar muito sobre seu projeto do Google Cloud. Isso ocorre porque os produtos do Google Maps estão disponíveis por meio dele. 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. Esse 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 Mobilidade, é provisionada uma conta de faturamento especial. Esta conta de faturamento só pode ser usada com casos de uso relacionados à mobilidade, como serviços de transporte por aplicativo, entrega e logística.

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

Projeto único apontando para a mesma conta de faturamento:

Caso de uso específico (ou seja, 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 agrupando 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 usarão nossos serviços de mobilidade e encaminhe-os para 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. Para criar uma conta de faturamento de mobilidade, o negócio de mobilidade precisa ser assinado 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 uma 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 garantir 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. Nos serviços de mobilidade, cobramos com base no volume de transações de mobilidade faturáveis, ou seja, viagens ou tarefas concluídas (envios, e não retiradas). Isso é definido antes de assinar o contrato. Se você tem uma empresa de transporte por aplicativo ou entrega de comida, concluir uma viagem ou entrega é sua métrica de sucesso. Ela é mapeada para uma viagem. As tarefas são usadas para empresas de logística e varejistas que precisam entregar encomendas com sucesso.

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ê usa uma conta de faturamento para dispositivos móveis, pode 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ê tem uma empresa de entrega de comida, é possível 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 sobre faturamento para dispositivos móveis.

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 vão ser cobrados, mas não os produtos específicos de mobilidade. Em outras palavras, isso significa que, durante a fase piloto, o faturamento não é baseado em Tarefas ou Viagem e, por isso, os limites de uso não se aplicam durante 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 geram 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 manter 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ó serão gerados se o uso exceder os limites ("limites") 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 outras contas projetos do Cloud para representar seus diferentes ambientes, como controle de qualidade (garantia de qualidade) e produção. Antes disso, você provavelmente tem apenas um ambiente único: 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 ID da nova conta de faturamento que acompanha a mensagem 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.

Configuração do novo 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 no Google ou Partner e forneça o ID do projeto criado na etapa anterior.
[Você] Atualizar Contatos essenciais nos seus projetos. Essa etapa é muito importante para garantir que o Suporte do Google as equipes podem alcançar 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ê] Criar contas de serviço, incluindo a associação da mobilidade correta Identificar e de gerenciamento de acesso (IAM) (trip baseavam e tarefa base)
- como foi feito no ambiente de desenvolvimento ou em um sistema segregação de acesso, se necessário (consulte esta seção).
[Você] Cria chaves de API - como foi feita no ambiente de desenvolvimento ou com uma segregação de acesso mais estruturada (por produto, domínio etc.) se necessário.
[Você] Ativar APIs como "Local Rides and Deliveries" e outros recursos do Google Maps APIs da plataforma necessárias (ou seja, Geocoding, Autocomplete, Address Validation).
[You] Quota: if you need QPM (queries per minutes) uplifts for certain APIs, open a ticket to support. Confira como fazer isso aqui. Adicione uma justificativa comercial informando por que o aumento é necessário. As cotas predefinidas são exibidas aqui.
[Você] Se você tem sistemas desenvolvidos usando credenciais do ambiente de desenvolvimento, certifique-se de que esses sistemas sejam capazes de apontar para as novas credenciais que foram criadas para os novos projetos criados. 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 do Mobility na carta de boas-vindas, que será usada nas próximas etapas.

[Você] Verifique se o ID de uma conta de faturamento para dispositivos móveis 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 contrato. Trabalhe com sua equipe de projeto para entender quem pode ter recebido e peça a essa pessoa que informe 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 do faturamento é importante para garantir que a cobrança seja feita 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 em viagem): a integração com a API ReportBillableEvent é obrigatória. Ou seja, sempre que uma viagem é concluída, é preciso 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. Os engenheiros de clientes (parceiros ou Google) trabalharão 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 ao 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. Quando se trata de 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. Para mais esclarecimentos, converse com seu parceiro ou representante do Google.

Configuração da conta de faturamento

Se todos os seus sistemas estiverem informando as viagens ou tarefas corretamente e não houver erros de integração, indique os projetos para a conta de faturamento recebida 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.
Vá para a seção Faturamento desse 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 que está acima.
Em Faturamento > Clique no ícone de três pontos . ao lado do projeto de produção que foi criado e escolha "Alterar 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 desse momento, todas as viagens ou tarefas informadas neste projeto serão cobradas conforme explicado anteriormente. Se a validação de faturamento ainda não aconteceu, 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 os pagamentos, consulte este link. Para quaisquer problemas relacionados ao faturamento, abra um caso de suporte de faturamento ou fale com seu parceiro ou representante do Google.

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:

Aqui, a principal configuração a ter em mente é o filtro Agrupar por por SKU, que mostrará informações detalhadas sobre viagens e tarefas, bem como outras APIs, se usadas, incluindo se houve excedentes ou não, como explicado anteriormente:

As informações do relatório são atualizadas diariamente. Se forem necessárias informações intradiárias, use as consultas do Cloud Logging para conferir quantos eventos faturáveis aconteceram durante o dia. Consulte as seções anteriores para saber mais.

Plano de ampliação

Um ponto importante a ser mencionado é seu plano de ampliação. É comum que nem todo o tráfego seja migrado para o projeto de mobilidade, dependendo da natureza do seu negócio. 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 obedecer à 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 de viagens e entregas. 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 pertencem ou são 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 das entregas e (d) consumidores que rastreiam e recebem remessas.”

Portanto, você deve entender quais 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 conforme 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á relatando para nós (acelerar o plano de ampliação). Portanto, há limites mais altos. Nesse caso, você precisa informar 500 mil viagens / tarefas por mês.
Você negocia limites maiores durante as negociações do contrato, conforme explicado antes.
Você aponta 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 o excedente.

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 após a implementação da solução de mobilidade. Por exemplo, o cálculo do HEC é feito automaticamente no Fleet Engine. Talvez você não precise mais fazer esse cálculo com a API Directions. 4. Identifique quanto tempo levará para migrar totalmente os casos de uso de mobilidade para a nova plataforma de mobilidade da sua parte. 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 da categoria, as empresas podem ter a certeza de que seus 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 uma compreensão clara de suas despesas, o que resulta em uma melhor gestão do orçamento.

Próximas ações

Configure sua conta de faturamento no Console do GCP.
Mais detalhes sobre o faturamento em geral podem ser encontrados em
- Documentação comercial dos serviços de mobilidade
- Ativar, desativar ou alterar o faturamento de um projeto bookmark_border.