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, 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 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 processo seja relativamente simples, os parceiros do Maps podem trabalhar com você para garantir que seus projetos sejam movidos 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. Isso 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 nela. Isso significa que a configuração abordada neste documento é feita no seu projeto do Google Cloud.

Contas de faturamento

Todas as empresas que usam produtos do Google Maps hoje têm um projeto do Google Cloud associado a elas. O 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 todos os meses com base nesse uso.

Para o Mobility, uma conta de faturamento especial é provisionada. Essa conta de faturamento deve ser usada apenas com casos de uso relacionados à mobilidade, como: carona compartilhada, entrega e logística.

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

Um único projeto apontando para a mesma conta de faturamento:

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

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

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

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

Como dito acima, uma única conta de faturamento pode apontar para vários projetos. Se você tiver mais de um projeto, identifique quais vão usar nossos serviços de mobilidade e vincule-os a uma conta de faturamento de mobilidade. Os projetos que não têm um caso de uso de mobilidade associado a eles devem continuar apontando para a conta de faturamento normal da Plataforma Google Maps que você usa hoje. Para ter uma conta de faturamento de mobilidade, um contrato de mobilidade precisa ser assinado com o Google ou por um parceiro. Abaixo, você pode conferir como uma conta de faturamento se encaixa em todo o esquema e as diferentes configurações possíveis:

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

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

Falando em preços, na Plataforma Google Maps, há diferentes níveis de descontos disponíveis por meio de parceiros do Maps ou diretamente com o Google em alguns cenários. Esses níveis são baseados em volume. Portanto, quanto mais você usa nossos produtos, menos paga (os descontos são aplicados a cada SKU individualmente). Nosso sistema de faturamento identifica seus projetos com base na credencial usada para chamar nossos produtos. 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 que o faturamento seja feito adequadamente.

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, cobramos com base no volume de transações de mobilidade faturáveis, que são viagens ou tarefas (envios, não retiradas) concluídas com sucesso. Isso é definido antes da assinatura do contrato. Se você é uma empresa de transporte por aplicativo ou de entrega de comida, concluir uma corrida ou entrega é sua métrica de sucesso, que corresponde a uma viagem. As tarefas são usadas por empresas de logística e varejistas que precisam entregar pacotes com sucesso.

Reconhecemos que os clientes de mobilidade também usam produtos da Plataforma Google Maps na execução de viagens e entregas. Portanto, se você estiver usando uma conta de faturamento de mobilidade, poderá ligar para 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, para cada viagem concluída, é possível chamar a API Geocoding dez vezes. Para saber mais sobre esses limites, consulte Limites de uso na documentação de mobilidade. Qualquer mudança nos limites exige uma alteração no contrato. Por isso, trabalhe 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 em (i) o número de viagens ou tarefas concluídas informadas no sistema e (ii) qualquer volume de chamadas de API da Plataforma Google Maps além dos limites pré-estabelecidos (excedentes). Nossos limites estão alinhados ao que consideramos necessário no mercado.

Recomendamos que você leia com atenção a documentação oficial de faturamento de mobilidade, que pode ser encontrada aqui.

Projetos piloto e avaliação

Os clientes podem executar 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 de um contrato. Se quiser fazer um teste piloto, fale com seu parceiro do Maps ou com o representante do 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. 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 durante essa fase.

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

Para resumir:

Fase de piloto / desenvolvimento: você só paga 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 valores de uso sem custo financeiro para cada SKU da Plataforma Google Maps em qualquer 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ó serão cobrados se o uso exceder os limites do contrato. Se sim, você vai pagar por excedentes. Os excedentes são cobrados 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 seus diferentes ambientes, como QA (garantia de qualidade) e produção. Antes disso, você provavelmente tem apenas um ambiente, o de desenvolvimento.

Requisitos

Uma pessoa ao seu lado que pode:

Gerenciar contas de faturamento no Google Cloud, geralmente feito pelo administrador da conta de faturamento ou proprietário do projeto.
Acesso ao novo ID da conta de faturamento que veio na 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.

Configuração de novo projeto

Criação de projetos

[Você] Crie um projeto do GCP no console do Google Cloud para cada novo ambiente. Por exemplo, produção, preparo e controle de qualidade.
[Parceiro ou equipe do Google] Adicione novos projetos a uma lista de permissões para ter acesso aos produtos de mobilidade. Entre em contato com seu representante de vendas no Google ou parceiro e informe 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 seu 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 dos papéis corretos do Mobility Identify & Access Management (IAM) (com base em viagem e com base em 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ê] Crie 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ê] Ative APIs como "Viagens e entregas locais" e outras APIs da Plataforma Google Maps necessárias (por exemplo, Geocoding, Autocomplete e Address Validation).
[Você] Cota: se precisar aumentar as QPM (consultas por minuto) de determinadas APIs, abra um tíquete de suporte. Saiba como fazer isso aqui. É necessário adicionar uma justificativa comercial explicando 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 e 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á assinou um contrato diretamente com o Google (quando aplicável) ou por um parceiro. Esse é um pré-requisito para receber a conta de faturamento da mobilidade na carta de boas-vindas, que será usada nas próximas etapas.

[Você] Verifique se um ID de conta de faturamento de mobilidade foi recebido como parte da Carta de recepção, que é enviada pelo Google por e-mail após a assinatura e execução do contrato. Importante: a carta de boas-vindas é enviada para os 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 o e-mail e peça que essa pessoa forneça o ID da conta de faturamento, que é uma série de caracteres e números separados por um 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 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 faturamento em geral aqui e aqui.

Validação de faturamento

A validação de faturamento é importante para garantir que você receba a cobrança correta. Às vezes, as empresas implementam APIs incorretamente por acidente, o que gera mais cobranças ou subnotificação.

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

Verificar se as solicitações às APIs da Plataforma Google Maps têm um tripId (ou taskId) no cabeçalho da solicitação. Mais detalhes aqui.
Verificar se as viagens (ou tarefas) estão sendo informadas corretamente. Isso depende do Pacote Mobilidade que está sendo usado:
- Mobility Starter e Optimize ou Accelerate (com base em viagens): é necessária a integração com a API ReportBillableEvent. Isso significa que, sempre que uma viagem é concluída com sucesso, uma solicitação precisa ser feita a essa API. Para validar se isso está acontecendo corretamente, siga as etapas descritas aqui.
- Mobility Accelerate (baseado em tarefas): o faturamento não precisa ser acionado por uma chamada de API. Isso acontece automaticamente quando o resultado de uma tarefa de entrega é definido como "SUCCEEDED". Portanto, é muito importante definir corretamente o resultado da tarefa como FAILED ou SUCCEEDED. Os 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 mostradas, significa que seus 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 corresponde ao número de chamadas informadas. Às vezes, vemos eventos de faturamento sendo informados, mas eles não correspondem ao valor total de viagens ou tarefas que foram 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 de serviços de mobilidade, é importante verificar se a integração com o Fleet Engine (API Local Rides and Deliveries) foi implementada corretamente.

Para 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 — **Consultar erros usando o Cloud Logging**

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

**Criação de métricas com base em consultas do Cloud Logging**

Como esses são produtos do Google Cloud, pode haver custos adicionais. Fale com seu parceiro ou representante do Google para mais informações.

Configuração da conta de faturamento

Se todos os seus sistemas estiverem informando viagens ou tarefas corretamente e não houver erros de integração, é hora de direcionar 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 nessa etapa. 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 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" desse projeto. Um atalho é acessar este link: https://console.cloud.google.com/billing
Faturamento > Clique em "Gerenciar contas de faturamento":

Seu projeto pode ter uma aparência diferente da mostrada acima.
Em "Faturamento", clique no ícone de três pontos ao lado de um dos projetos de produção criados 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. Em seguida, clique em "DEFINIR CONTA":
O projeto será vinculado à nova conta de faturamento:

Importante: a partir deste 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 sido feita, não vincule a conta de faturamento.
Depois que o novo método de faturamento for adicionado, acesse "Visão geral > Visão geral de pagamentos" 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 entre em contato com seu parceiro ou representante do Google.

Relatórios de faturamento

Com os relatórios de faturamento, você entende os custos associados à conta de faturamento vinculada ao projeto.

Observação: se você estiver trabalhando com um parceiro do Maps, entre em contato com ele para garantir que as informações de faturamento relevantes necessárias 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órios de faturamento**

A principal configuração a ser considerada é o filtro Agrupar por por SKU, que mostra informações detalhadas sobre viagens e tarefas, além de outras APIs, se usadas. Isso inclui se houve excedentes ou não, conforme explicado anteriormente:

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

Plano de ampliação

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

Além disso, em muitos casos, nem todo o tráfego pertence a um caso de uso de mobilidade, como localizadores de lojas, retirada na rua e outras soluções internas. Eles 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ê obedeça à política de implementação:

Modelo com base em viagem: "A Solução de viagens e entregas sob demanda é destinada ao uso em serviços comerciais de viagens e entregas sob demanda. Esses serviços normalmente 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 pareados com solicitações e dirigem um veículo para concluir os serviços".
Modelo baseado em tarefas: "A Solução para frotas de última milha da Plataforma Google Maps foi criada para uso em serviços comerciais de entrega de última milha e coleta de primeira milha. Esses serviços geralmente incluem (a) uma frota de veículos de entrega de propriedade do cliente ou contratados por ele, (b) entregas com base em um trajeto pré-planejado, (c) uma rede de centros de distribuição com equipes operacionais que apoiam a execução da entrega e (d) consumidores que rastreiam e recebem os envios".

Portanto, é necessário 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, isso significa que você pode chamar a API Geocoding um milhão de vezes. No entanto, se a sua empresa tiver 5 milhões de solicitações de geocodificação, essa diferença (4 milhões) poderá ser informada como excedente. Há duas opções:

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

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

Em resumo, para criar um plano de aumento gradual adequado, siga estas etapas: 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 seus volumes. 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 da ETA acontece automaticamente no Fleet Engine. Talvez não seja mais necessário calculá-las 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. Identificar o ponto de inflexão em que todas as solicitações da Plataforma Google Maps podem ser transferidas para a conta de faturamento de mobilidade em 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 só ajuda a reduzir custos, mas também fornece os dados e insights necessários para tomar decisões de negócios bem fundamentadas. Além disso, a transparência oferecida por esse sistema permite que as empresas tenham uma compreensão clara dos gastos, o que leva a uma melhor gestão do orçamento.

Próximas ações

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