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, é importante verificar se a configuração está correta para pagar o valor certo pelos produtos usados. Neste documento, abordamos aspectos para garantir que você tenha (i) transparência no faturamento (para que o uso possa ser verificado antes da geração de uma fatura) 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 migrados 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 disponíveis. Não há certo ou errado em muitas situações, depende do tipo de resultado que você está tentando 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 meio dele. Isso significa que a configuração abordada neste documento é feita no seu projeto do Google Cloud.

Contas de faturamento

Toda empresa que usa produtos do Google Maps atualmente tem um projeto do Google Cloud associado a ela. 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 todo mês com base nesse uso.

Para Mobilidade, uma conta de faturamento especial é provisionada. Ela deve ser usada apenas com casos de uso relacionados a mobilidade, como transporte por aplicativo, entrega e logística.

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

Projeto único que aponta para a mesma conta de faturamento:

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

Vários projetos apontando para a mesma conta de faturamento:

Mesmo caso de uso
Aproveitar os níveis de desconto agregando o uso
Fatura única

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

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

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

Recursos de nuvem, conta de faturamento e geração de faturas

Por falar em preços, na Plataforma Google Maps há diferentes níveis de descontos, disponíveis por parceiros do Maps ou diretamente com o Google em alguns cenários. Esses níveis são baseados em volume, assim você paga menos quanto mais usa 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 com uma chave de API. O Google identifica a conta de faturamento do projeto do Google Cloud correspondente com base nessa chave de API, em que 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 autenticar. Portanto, é importante que os sistemas certos usem o método de autenticação correto para garantir que o faturamento ocorra corretamente.

Exemplo de uma 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, fazemos a cobrança com base no volume de transações de mobilidade faturáveis, que são viagens ou tarefas concluídas com sucesso (envios, não retiradas). Isso é definido antes da assinatura do contrato. Se você tem uma empresa de transporte por aplicativo compartilhado ou entrega de comida, a conclusão de 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 pacotes com sucesso.

Sabemos que os clientes de mobilidade também usam os produtos da Plataforma Google Maps para fazer viagens e entregas. Portanto, se você estiver usando uma conta de faturamento para mobilidade, poderá ligar para a Plataforma Google Maps sem custos financeiros, 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, para cada viagem bem-sucedida, é possível chamar a API Geocoding dez vezes. Para saber mais sobre esses limites, consulte a seção sobre limites de uso na documentação sobre mobilidade. Como qualquer mudança nos limites exige uma alteração no seu contrato, converse com seu 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 concluídas informadas no sistema e (ii) em qualquer volume de chamadas de API da Plataforma Google Maps que ultrapassem os limites preestabelecidos ("sobreuso"). Nossos limites estão alinhados ao que temos visto no mercado conforme necessário.

Sugerimos que você leia atentamente a documentação de faturamento oficial para mobilidade, disponível aqui.

Pilotos e avaliação

Antes de assinar um contrato, 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. Se você quiser realizar um piloto, fale com seu parceiro do Maps ou seu correspondente do Google.

Durante a fase piloto, como mencionado, não há contas de faturamento de mobilidade disponíveis 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 para dispositivos móveis nã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.

Depois que o piloto for lançado oficialmente para produção, ele precisa ser pago conforme o contrato.

Para resumir:

Fase piloto / desenvolvimento: você é cobrado apenas pelas APIs do Google Maps que estão disponíveis publicamente. APIs e SDKs não disponíveis publicamente não vão gerar cobranças até que uma conta de faturamento de mobilidade seja usada no projeto. Lembre-se de que 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ê recebe cobranças por viagens ou tarefas. Os custos associados à Plataforma Google Maps só serão cobrados se o uso exceder os limites ("limites") do contrato. Nesse caso, você vai pagar pelos excedentes. Os excedentes são cobrados conforme definido aqui.

Como migrar para uma conta de faturamento de mobilidade

Ao migrar para produção, você normalmente precisa criar alguns outros projetos do Google Cloud Platform (GCP) para representar seus diferentes ambientes, como controle de qualidade (controle de qualidade) e produção. Antes disso, provavelmente você tinha apenas um ambiente, o de desenvolvimento.

Requisitos

Uma pessoa ao seu lado 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, enviado como parte da 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.

Mostramos abaixo as etapas necessárias para a configuração de um novo projeto e como configurar o faturamento nesses novos projetos.

Configuração de novo projeto

Criação de projetos

[Você] Criar um ou mais projetos do GCP para os novos ambientes (por exemplo, produção, controle de qualidade etc.). Isso é feito no console do Google Cloud. Acesse este link.
[Parceiro ou equipe do Google] Este projeto precisa estar na lista de permissões para ter acesso aos produtos de mobilidade. Para fazer isso, trabalhe com seu representante de vendas no Google ou parceiro para fazer isso por você. Informe o ID do projeto que foi criado na etapa anterior.
[Você] Atualize os contatos essenciais dos seus projetos. Isso é muito importante para garantir que as equipes de suporte do Google tenham contato com as pessoas certas.

Configuração do projeto

Siga as etapas abaixo no console do Google Cloud do projeto criado nas etapas anteriores:

[Você] Criação de contas de serviço, incluindo associação de papéis corretos do Mobility Identity & Access Management (IAM) (baseado em viagem e com base em tarefas), 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ção de 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ção de APIs, como "Local Rides and Deliveries" e outras APIs da Plataforma Google Maps necessárias (por exemplo, Geocoding, Autocomplete e Address Validation).
[You] Cota: se você precisar de aumentos de QPS (consultas por segundo) para determinadas APIs, abra um tíquete para o suporte. Veja como fazer isso aqui. Adicione uma justificativa comercial explicando por que o aumento é necessário. Veja as cotas predefinidas aqui.
[Você] Se você tiver sistemas desenvolvidos usando credenciais do ambiente de desenvolvimento, verifique se esses sistemas são capazes de apontar para as novas credenciais que foram criadas para os novos projetos criados. Isso inclui direcionar os 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 respectivo.

Configuração de faturamento

Neste caso, presumimos que você já tenha assinado um contrato com o Google diretamente (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 da conta de faturamento do Google Mobile foi recebido na Carta de boas-vindas, enviada pelo Google por e-mail após a assinatura e a execução do contrato. Importante: a carta de boas-vindas é enviada aos contatos técnicos e financeiros indicados no formulário do pedido do contrato. Trabalhe com sua equipe de projeto para entender quem pode ter recebido e peça para essa pessoa informar o ID da conta de faturamento, que é uma série de caracteres e números separados por hífen.
[Você] Trabalhe com o Google ou um parceiro para garantir que uma validação de faturamento seja realizada. Isso significa que seus sistemas já estão informando as viagens ou tarefas corretamente para o Google. Mais detalhes na próxima seção.
[Você] Direcione 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 neste documento.

Para mais detalhes sobre o faturamento em geral, acesse este link e este link.

Validação de faturamento

A validação do faturamento é importante para garantir que você receba cobranças corretamente. Às vezes, as empresas implementam APIs de forma incorreta, gerando mais cobranças ou subnotificações nos relatórios.

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

Como verificar se as solicitações às APIs da Plataforma Google Maps têm um tripId (ou taskId) no cabeçalho da solicitação. Confira mais detalhes neste link.
Verificar se as viagens (ou tarefas) estão sendo informadas corretamente. Isso depende do pacote de mobilidade que está sendo usado:
- Mobility Starter e Optimize ou Accelerate (Trip-Com base): é necessário fazer a integração com a API ReportBillableEvent. Isso significa que, sempre que uma viagem é concluída, é 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 (com base 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 SUCCEEDED em uma tarefa de entrega. Portanto, é muito importante definir corretamente o resultado da tarefa como FALHA ou CONCLUÍDA. Engenheiros de clientes (parceiros ou Google) vão trabalhar com você para verificar se a implementação foi feita corretamente. Com o 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, isso significa que os sistemas de back-end estão definindo corretamente as tarefas como SUCCEEDED.

Observação: é importante verificar se a contagem de viagens ou tarefas concluídas com sucesso corresponde ao número de chamadas informadas. Às vezes, vemos eventos de faturamento sendo relatados, mas eles não correspondem à quantidade total de viagens ou tarefas que foram realmente concluídas na vida real (subrelatórios).

Status de integridade da integração

Uma migração para a produção precisa não apenas garantir que o faturamento funcione corretamente, mas que as APIs não apresentem falhas 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:

Consultar erros usando o Cloud Logging — **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étrica com base na consulta do Cloud Logging — **Criação de métricas pela consulta do Cloud Logging**

Como esses são produtos do Google Cloud, pode haver custos adicionais. Entre em contato com seu parceiro ou representante do Google para ter mais esclarecimentos.

Configuração da conta de faturamento

Se todos os seus sistemas estiverem informando as viagens ou tarefas e não houver erros de integração, indique seus projetos para a conta de faturamento que você recebeu na carta de boas-vindas e que já foi abordada em seções anteriores deste documento.

Observação: se você estiver trabalhando com um parceiro do Maps, ele poderá ajudar você nesse momento. Não é necessário seguir as etapas abaixo sozinho. Se você estiver trabalhando diretamente com o Google, o que pode acontecer em algumas regiões, siga as próximas 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" desse projeto. Um atalho pode 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 de um projeto de produção que foi criado e escolha "Mudar conta de faturamento":
Faturamento > em Conta de faturamento, escolha o código da conta de faturamento que você recebeu na carta de boas-vindas na lista suspensa. Depois, 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 faturadas, conforme explicado anteriormente. Se a validação de faturamento ainda não tiver ocorrido, 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, acesse este link.
Se você tiver problemas relacionados ao faturamento, abra um caso de suporte de billing 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, trabalhe com ele para fornecer as informações de faturamento relevantes.

Abra a conta de faturamento vinculada do projeto e selecione "Relatórios". Em seguida, você pode usar o seguinte conjunto de filtros:

A configuração principal a ter em mente é o filtro Agrupar por por SKU, que mostra informações detalhadas sobre viagens e tarefas, além de outras APIs, se usadas, incluindo se há excedentes ou não, conforme explicado anteriormente:

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

Plano de otimização

Um ponto importante a ser mencionado é seu plano de otimizaçã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 implementar a nova solução em todas as filiais, franquias, lojas, escritórios etc. Isso significa que parte do tráfego usará os sistemas antigos e parte do tráfego irá para o novo projeto.

Além disso, em muitos casos, nem todo o tráfego pertence a um caso de uso de mobilidade, como os localizadores de lojas, drive-thru e outras soluções internas. Eles devem apontar para uma conta de faturamento da Plataforma Google Maps, porque o tráfego precisa ser mantido separado dessa conta.

É importante obedecer à política de implementação:

Modelo com base em viagem: "A solução de viagens e entregas sob demanda destina-se ao uso em serviços de entrega e transporte comercial sob demanda. Esses serviços geralmente incluem (a) consumidores que enviam solicitações de viagem para um determinado destino (ou entrega de um item específico) e (b) motoristas que atendem às solicitações e que dirigem um veículo para concluir os serviços.”
Modelo com base em tarefas - “A solução Last Mile Fleet da Plataforma Google Maps destina-se ao uso em serviços comerciais de entrega de last mile e de primeira milha. Esses serviços normalmente incluem (a) uma frota de Veículos de entrega que são de propriedade ou contratados pelo Cliente, (b) entregas com base em um trajeto pré-planejado, (c) uma rede de centros de distribuição com equipes operacionais que auxiliam na execução da entrega e (d) consumidores que rastreiam e recebem remessas.”

Portanto, é importante entender quais sistemas devem apontar para a conta de faturamento da Plataforma Google Maps e quais devem apontar para a conta de faturamento do mobilidade. É comum ter vários projetos, e cada um deles apontando para a conta de faturamento correta.

Como 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, é possível chamar a API Geocoding 1 milhão de vezes. No entanto, se sua empresa 5M Geocoding solicitar essa diferença (4M) poderá ser informada como excedentes. Duas opções são possíveis:

Você aumenta a quantidade de viagens / tarefas que está informando para nós (acelerar o plano de otimização), portanto, limites maiores são aplicáveis. Nesse caso, você precisaria 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 mais barato do que os excedentes.

Sabemos que a estimativa de custo, dependendo do tamanho e da complexidade do seu negócio, e que os casos de uso podem ser complexos, fale com seu parceiro ou com o Google para determinar qual é a melhor maneira de se preparar para o lançamento de produção usando seus projetos atuais.

Em resumo, para criar um plano de evolução adequado, as seguintes etapas são necessárias: 1. Identificar quais casos de uso estão relacionados à mobilidade e quais não estão de acordo com a política de implementação. 2. Identificar quais APIs da Plataforma Google Maps são usadas atualmente para os casos de uso relevantes e os volumes delas. 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, se o cálculo da HEC ocorre automaticamente no Fleet Engine, talvez não seja mais necessário fazer isso 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 à sua empresa. 5. Confira se os Limites de Uso são suficientes para seus casos. 6. Para casos de uso relacionados a mobilidade, identifique o momento em que todas as solicitações da Plataforma Google Maps podem ser transferidas para a conta de faturamento do mobilidade.

Conclusão

Em resumo, configurar corretamente a conta de faturamento é essencial para garantir a previsibilidade e a transparência dos preços. Usando nossa tecnologia de mobilidade que incorpora os melhores serviços de localização da categoria, as empresas podem ter 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 a tomada de decisões de negócios informadas. Além disso, a transparência oferecida por esse sistema permite que as empresas tenham uma compreensão clara das despesas, levando a uma melhor gestão de 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 sobre serviços de mobilidade
- Ativar, desativar ou alterar o faturamento de um projeto "favorite_border".