Relatórios de uso do plano Premium

Observação: o plano Premium da Plataforma Google Maps não está mais disponível para inscrições ou novos clientes.

Esta página é destinada apenas a clientes com a nova versão do plano Premium da Plataforma Google Maps, que foi disponibilizada em janeiro de 2016.

Você tem o plano Premium ou uma licença anterior?
Para determinar qual licença você tem, faça o seguinte:
> No Google Cloud Support Portal, clique em Maps: relatório de uso à esquerda.
> O ID na parte superior do relatório tem o formato a seguir?
   gme-[company] & proj-[number] ([type])
Em caso afirmativo, você tem o plano Premium.
Se não, você tem uma licença anterior (API Maps for Work ou API Maps for Business).

Visão geral

Por ser cliente do plano Premium, você pode usar a ferramenta de relatórios de uso do Google Maps para rastrear a utilização da Plataforma Google Maps e o consumo dos créditos de APIs Maps. Com a ferramenta, você consegue ver relatórios diários e mensais com detalhes sobre todas as APIs incluídas no seu plano Premium da Plataforma Google Maps. Os dados do relatório estão disponíveis para solicitações de API que incluem um ID do cliente ou do projeto.

Observação: a ferramenta de relatórios de uso fornece as mesmas informações usadas pelo Google para determinar a utilização do aplicativo para fins de cobrança.

Tipos de relatórios

Relatório de solicitações concluídas

Esse relatório mostra o total diário ou mensal de solicitações efetuadas pelo aplicativo para cada API. Use essas informações para comparar o uso entre períodos diferentes e identificar tendências e horários de pico de uso. O relatório de solicitações concluídas pode ser usado também para ver as seguintes informações:

  • Erros de solicitação: para cada API, o relatório diário também mostra o número de solicitações concluídas e não concluídas (erros). Além disso, para APIs Web Service acessadas pelo aplicativo usando um ID do cliente, o relatório mostra os códigos de erro, o que é útil para solucionar o problema.
  • Dados de canais: ao incluir o parâmetro de canal nas suas solicitações, é possível gerar um relatório de solicitações concluídas que mostra o detalhamento das solicitações de API do seu aplicativo em diferentes plataformas que usam o mesmo ID do cliente (como acesso externo x acesso interno). O uso de canais permite gerar relatórios mais detalhados sobre a utilização do aplicativo.

Relatório de créditos de APIs Maps

Este relatório mostra o consumo total diário ou mensal de créditos pelo aplicativo para todas as APIs combinadas. Use esse relatório para determinar a quantidade de créditos a comprar. Para mais informações sobre o consumo de créditos do seu aplicativo, consulte Taxas e limites de uso.

Recursos do relatório

  • Gráficos fáceis de ler: os relatórios diários incluem gráficos mostrando as tendências de uso ao longo do tempo. Veja os detalhes do relatório passando o cursor do mouse sobre o gráfico.

  • Dados históricos: veja relatórios para qualquer período do último ano.
  • Dados para download: faça o download de solicitações e totais de créditos mensais em um arquivo com valores separados por vírgula (CSV) para análises mais detalhadas usando planilhas ou ferramentas de inteligência de negócios ou para compartilhar os dados com outras pessoas.
  • Detalhar dados: acesse relatórios diários diretamente nos relatórios mensais clicando nos totais mensais ou nos cabeçalhos das colunas do documento. Por exemplo:

Acessar relatórios de uso

Para acessar os relatórios de uso do Google Maps, faça o seguinte:

  1. Acesse o Google Cloud Support Portal.
  2. No painel esquerdo, clique em Maps: relatório de uso.

Geração de relatórios

O padrão é o relatório mensal de solicitações concluídas nos últimos 12 meses. Para gerar relatórios diferentes, use os filtros:

Filtro Descrição
ID do cliente
Disponível apenas se você tiver vários IDs de clientes. Selecione o ID do cliente cujo relatório você quer ver.
ID do canal
Disponível apenas para relatórios de solicitações concluídas. Selecione um canal cujos dados de uso você quer ver ou Exibir tudo para ver esses dados de todos os canais.
De / a Selecione um período de até um ano para o relatório. Clique em "Atualizar" para gerar um novo relatório.
Tipo de relatório
Selecione o relatório Solicitações concluídas ou Créditos de APIs Maps.
Selecione a granularidade do tempo Escolha o relatório Mensal ou Diário. Os relatórios mensais também contêm links para os relatórios diários. Os relatórios diários mostram solicitações concluídas e não concluídas e os códigos de erro.
Tipo de API Disponível apenas para relatórios diários. Selecione a API cujo relatório você quer ver.

Perguntas frequentes

Relatório de solicitações concluídas

Em quanto tempo os dados de uso aparecem nos relatórios?

Os dados dos relatórios não ficam disponíveis em tempo real. Os dados de uso de solicitações com um ID do cliente são processados diariamente. Como as datas do relatório são baseadas no horário do Pacífico, o processo pode levar até dois dias. Os dados das solicitações que usam uma chave de API exigem processamento adicional e podem levar até quatro dias para aparecer nos relatórios.

O que são carregamentos de mapas da API Maps JavaScript? Qual é a diferença entre eles e as visualizações de páginas?

Com o plano premium da Plataforma Google Maps, o uso da API Maps JavaScript é determinado por carregamentos de mapas, ou seja, ele ocorre quando os mapas são realmente exibidos em uma página. Os carregamentos de mapas são diferentes das visualizações de página, que eram usadas para calcular o uso da API Maps JavaScript com as licenças anteriores da API Maps for Business ou da API Maps for Work. Para mais informações, consulte Taxas e limites de uso.

Por que o número de carregamentos de mapa não corresponde às estatísticas de acesso dos nossos servidores da Web?

Veja a seguir alguns motivos que explicam por que o número dos carregamentos de mapa em uma página é diferente de número de hits do respectivo URL nos registros dos servidores da Web:

  • O uso de mapas pode variar em uma página: um carregamento de mapa é gerado sempre que o objeto google.maps.Map é criado em uma página. Ao comparar os relatórios de carregamentos de mapa com as estatísticas de acesso do servidor da Web, analise cuidadosamente o uso dos mapas em cada página da Web buscando identificar os motivos das discrepâncias, como os seguintes:
    • Uma página tem mais de um mapa e, por isso, vários objetos "Map" foram criados.
    • Uma página não exibe um mapa, mas mesmo assim criou o objeto "Map". Isso poderá ocorrer, por exemplo, se o objeto "Map" estiver anexado a um elemento HTML div oculto.
    • Uma página exige que o usuário execute uma ação (como clicar em um botão) para exibir um mapa. Se essa ação não foi executada, o objeto "Map" não foi criado.
    • Uma página não tem nenhum mapa e, por isso, o objeto "Map" não foi criado.
  • Os fusos horários são diferentes: os relatórios derivam de registros definidos para o fuso horário do Pacífico. Você pode analisar os registros do servidor com base no fuso horário do Pacífico para reduzir as diferenças causadas pelos registros no fuso horário local.
  • O HTML é armazenado em cache: os carregamentos de mapa não são armazenados em cache. Se um usuário recarregar a página, outro carregamento de mapa será gerado para obter um token de sessão. No entanto, nesse caso, o navegador poderá carregar o HTML do cache, resultando em um número de carregamentos de mapa maior que o de hits nos registros do servidor.
Por que o número de solicitações é maior que o esperado para a API Distance Matrix?

O relatório da API Distance Matrix mostra o número de elementos (pares origem/destino) em vez de solicitações. Para detalhes sobre elementos, consulte o Guia do desenvolvedor.

Erros de solicitação

Como faço para ver os erros de solicitação de um aplicativo?

Gere um relatório diário de solicitações concluídas e escolha uma API na lista Tipo de API. Serão exibidos um gráfico e uma tabela com o número de solicitações concluídas e não concluídas efetuadas pelo aplicativo. Para as APIs Web Service acessadas pelo aplicativo usando um ID do cliente, também serão exibidos os códigos de status retornados por essas solicitações:

Qual é o significado dos códigos de status?

A ferramenta de relatórios de uso mostra códigos de status para APIs Web Service acessadas pelo aplicativo usando um ID do cliente. As descrições dos códigos estão no guia do desenvolvedor de cada API:

A API Geolocation, a API Places e a API Roads sempre exigem uma chave de API. Para essas e outras APIs acessadas pelo aplicativo usando uma chave, verifique os códigos de status no Developers Console.

Os erros consomem créditos de APIs Maps?

Não. Solicitações que recebem um código de erro não consomem créditos. Já aquelas que recebem os códigos OK ou ZERO_RESULTS consomem.

Dados dos canais

O que são canais?

Para rastrear o uso em diferentes aplicativos com o mesmo ID do cliente ou a mesma chave de API, utilize o parâmetro channel com suas solicitações de API. Ao especificar valores channel diferentes para aspectos distintos do seu aplicativo, você determina com precisão como ele é usado.

Por exemplo, seu site externo pode acessar uma API usando um channel definido como customer, enquanto seu departamento de marketing interno usa um channel definido como mkting. Os relatórios detalham o uso das APIs por esses valores de canal.

Quais APIs são compatíveis com o uso de canais?

Os relatórios de canais estão disponíveis para aplicativos que usam a API Maps JavaScript, a API Maps Static, a API Street View Static e os serviços da Web da Plataforma Google Maps. Os canais não estão disponíveis para a API Geolocation, a API Places, a API Roads e os SDKs para dispositivos móveis do Google Maps.

Quantos canais posso usar?

Você pode usar até 2.000 canais diferentes por ID do cliente ou chave de API.

Como é possível configurar canais para as solicitações de um aplicativo?

Verifique se o valor channel nas solicitações atende aos seguintes requisitos:

  • É uma string ASCII alfanumérica.
  • Aceita sublinhado (_) e hífen (-).
  • É indiferente a maiúsculas: os parâmetros channel que contenham letras maiúsculas são mesclados ao equivalente em minúsculas. Por exemplo, o uso do canal CUSTOMER será combinado ao do canal customer.
  • É estático e atribuído por instância de aplicativo (não pode ser gerado de forma dinâmica). Por exemplo, não é possível usar valores de canal para rastrear usuários individuais.

Veja como adicionar o parâmetro de canal às solicitações:

APIs do lado do cliente

Anexe o parâmetro de canal ao valor de src da tag do script:

<script src="https://maps.googleapis.com/maps/api/js?v=3
&client=gme-yourclientid
&channel=your_channel"></script>

API Maps Static e API Street View Static

Inclua esse parâmetro de canal no URL da solicitação:

https://maps.googleapis.com/maps/api/staticmap
?center=15.800513,-47.91378
&zoom=11
&size=300x300
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Serviços da Web

Inclua esse parâmetro de canal no URL da solicitação:

https://maps.googleapis.com/maps/api/geocode/json
?address=101+Main+St
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Relatório de créditos de APIs Maps

O que são créditos de APIs Maps?

As solicitações de um aplicativo às APIs consomem créditos de APIs Maps de um conjunto de créditos que você compra com o plano Premium da Plataforma Google Maps. Para mais informações sobre créditos e como eles são consumidos pelos aplicativos, consulte Taxas e limites de uso.

Em quanto tempo os dados dos créditos aparecem nos relatórios?

Os dados de consumo de crédito dos relatórios de uso do Google Maps exigem processamento e podem levar até três dias para aparecer nos relatórios.