Relatórios de uso do Google Maps

Esta página é exclusiva para clientes que têm a nova versão do Google Maps APIs Premium Plan, disponibilizada em janeiro de 2016.

Tem uma licença antiga do Maps APIs for Work ou do Maps API for Business? Leia nosso guia de licenças do Maps APIs for Work. Para descobrir se você tem uma licença antiga: No Google Cloud Support Portal, clique em Maps: Usage Report, à esquerda. Se o ID na parte superior do relatório está no formato a seguir, você tem o novo Premium Plan:
gme-[company] & proj-[number] ([type])
Se não, você tem uma licença antiga.

Visão geral

A ferramenta de relatórios de uso do Google Maps ajuda a rastrear o uso das Google Maps APIs e o consumo dos Maps APIs Credits por um aplicativo. A ferramenta permite ver relatórios diários e mensais detalhados sobre todas as APIs incluídas no Google Maps APIs Premium Plan. Os dados do relatório estão disponíveis para solicitações de API que incluem um ID do cliente ou um ID do projeto.

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

Tipos de relatórios

Relatório de solicitações bem-sucedidas

Esse relatório mostra o total diário ou mensal de solicitações efetuadas pelo aplicativo para cada API. Use esse relatório para comparar o uso entre períodos diferentes para identificar tendências e horários de pico de uso. Além disso, o relatório de solicitações bem-sucedidas pode ser usado para ver estas informações:

  • Erros de solicitações: para cada API, o relatório diário também mostra o número de solicitações bem-sucedidas e malsucedidas (erros). Além disso, para Web Service APIs acessadas pelo aplicativo usando um ID do cliente, o relatório mostra os códigos de erro, úteis para solucionar o problema.
  • Dados de canal: se você incluir o parâmetro de canal nas solicitações, poderá gerar um relatório de solicitações bem-sucedidas que mostra o detalhamento das solicitações de APIs do aplicativo entre diversos aplicativos que usam o mesmo ID do cliente (como aplicativos voltados ao público externo versus os voltados ao público interno). O uso de canais permite gerar relatórios com dados mais detalhados sobre como o aplicativo é usado.

Relatório de Maps APIs Credits

Este relatório mostra o consumo total de créditos pelo aplicativo para todas as APIs combinadas por dia ou por mês. Use esse relatório para determinar a quantidade de créditos a comprar. Para obter informações sobre como o aplicativo consome créditos, consulte Taxas e limites de uso.

Recursos do relatório

  • Gráficos de fácil leitura: os relatórios diários fornecem gráficos para ajudar a visualizar tendências 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 no último ano.
  • Dados para download: faça o download de solicitações e totais de créditos mensais para 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.
  • Detalhamento de dados: acesse relatórios diários diretamente dos relatórios mensais clicando nos totais mensais ou nos cabeçalhos de colunas do relatório. Por exemplo:

    <img src="/maps/premium/reports/images/usage_rep_mo_total.png" width="200px" /" style="float: left; width: 30%; margin-right: 1%; margin-bottom: 0.5em;"><img src="/maps/premium/reports/images/usage_rep_mo_heading.png" width="200px" /" style="float: left; width: 30%; margin-right: 1%; margin-bottom: 0.5em;">

Acessar relatórios de uso

Para acessar os relatórios de uso do Google Maps:

  1. Faça login no Google Cloud Support Portal.
  2. No painel esquerdo, clique em Maps: Usage Report.

Geração de relatórios

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

Filtro Descrição
Client ID
Disponível apenas se você tiver vários IDs do cliente. Selecione o ID do cliente para o qual você quer ver relatórios.
Channel ID
Disponível apenas para relatórios de solicitações bem-sucedidas. Selecione um canal para o qual você quer ver dados de uso. Ou selecione Show all para ver os dados de uso de todos os canais.
From / To Selecione um período de até um ano para o relatório. Clique em Update para gerar um novo relatório.
Type of report
Selecione o relatório Successful Requests ou Maps APIs Credits.
Select time granularity Escolha o relatório Monthly ou Daily. Os relatórios mensais também contêm links para os relatórios diários. Os relatórios diários mostram solicitações bem-sucedidas e malsucedidas com códigos de erro.
API type Disponível apenas para relatórios diários. Selecione a API para a qual você quer ver um relatório.

Perguntas frequentes

Relatório de solicitações bem-sucedidas

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

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

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

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

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

Veja a seguir alguns motivos pelos quais o número de carregamentos de mapas em uma página é diferente do número de acessos nesse URL nos logs dos servidores 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 mapas com as estatísticas de acesso do servidor Web, analise cuidadosamente o uso dos mapas em cada página da Web para identificar os motivos das discrepâncias, como:
    • Uma página tem mais de um mapa, portanto, 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 Mapa 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, portanto, o objeto Map não foi criado.
  • Fusos horários diferentes: os relatórios são obtidos de logs configurados com o fuso horário do Pacífico. Analise os logs dos seus servidores com base no fuso horário do Pacífico para reduzir as diferenças causadas pelo registro em log usando o fuso horário local.
  • O HTML é armazenado em cache: os carregamentos de mapas não são armazenados em cache. Se um usuário recarregar a página, será gerado outro carregamento de mapa 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 mapas maior que o número de acessos nos logs do servidor.
Por que o número de solicitações é maior que o esperado para a Google Maps Distance Matrix API?

O relatório da Google Maps Distance Matrix API mostra o número de elementos (pares origem/destino) em vez do número de solicitações. Para obter mais 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 bem-sucedidas e escolha uma API na lista API type. Serão exibidos um gráfico e uma tabela que mostram o número de solicitações bem-sucedidas e malsucedidas efetuadas pelo aplicativo. Para Web Service APIs 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 Web Service APIs acessadas pelo aplicativo usando um ID do cliente. As descrições dos códigos estão no guia do desenvolvedor para cada API:

As APIs Geolocation API, Places API e Roads API exigem sempre 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 Maps APIs Credits?

Não. Solicitações que recebem um código de erro não consomem créditos. No entanto, as solicitações que recebem os códigos OK ou ZERO_RESULTS consomem créditos.

Dados de canais

O que são canais?

O parâmetro channel pode ser usado nas solicitações de API para controlar o uso de diferentes aplicativos que usam o mesmo ID do cliente. A especificação de valores de channel diferentes para aspectos distintos do aplicativo permite determinar precisamente o seu uso.

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

Quais APIs permitem o uso de canais?

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

Quantos canais posso usar?

Você pode usar até 2.000 canais diferentes por ID do cliente.

Como faço para configurar canais para as solicitações de um aplicativo?

Verifique se o valor de channel nas solicitações cumpre os seguintes requisitos:

  • Deve ser uma string ASCII alfanumérica.
  • Pode incluir os caracteres ponto (.), sublinhado (_) e hífen (-).
  • Diferencia maiúsculas de minúsculas: parâmetros channel em maiúsculas e em maiúsculas e minúsculas são mesclados em seu equivalente em minúsculas. Por exemplo, o uso do canal CUSTOMER será combinado com o uso do canal customer.
  • Deve ser estático e atribuído por instância de aplicativo (não pode ser gerado dinamicamente). 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 script:

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

APIs Static Maps e Street View

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 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 Maps APIs Credits

O que são Maps APIs Credits?

As solicitações de API do aplicativo consomem Maps APIs Credits de um conjunto de recursos adquirido com o Google Maps APIs Premium Plan. Para obter mais informações sobre créditos e como são consumidos pelos aplicativos, consulte Taxas e limites de uso.

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

Os dados de consumo de créditos dos relatórios de uso do Google Maps exigem processamento e podem demorar até 3 dias para aparecer nos relatórios.