Google Maps APIs for Work Usage Dashboard

Esta página é destinada apenas a clientes que têm uma licença antiga do Maps APIs for Work ou do Maps API for Business. Esta página não se aplica a clientes com o novo Google Maps APIs Premium Plan, disponibilizado em janeiro de 2016.

Visão geral

O Google Maps APIs for Work Usage Dashboard oferece relatórios detalhados para ajudar a monitorar o uso e a integridade de aplicativos do Maps APIs for Work. Os dados do relatório estão disponíveis para todas as solicitações que usam um ID do cliente.

Com o Usage Dashboard, você pode conferir de forma rápida e fácil as seguintes informações sobre o aplicativo:

  • Visualizações de páginas e uso de serviços cliente e Web
  • Uso de consultas por segundo (QPS) para serviços Web
  • Visualizações de páginas e uso de serviços Web por domínio
  • Taxa de sucesso de solicitações e erros para serviços Web

Crie relatórios para qualquer período no último ano e exporte os dados para um arquivo para análises e compartilhamento adicionais. Todos os relatórios mostram dados para um ou mais aplicativos que usam o mesmo ID do cliente do Maps APIs for Work.

Benefícios dos relatórios

Os relatórios disponíveis no Google Maps APIs for Work Usage Dashboard são úteis para finalidades como desenvolvimento, marketing e compra de aplicativos. Por exemplo, use os relatórios para:

  • Comparar o uso entre períodos diferentes para identificar tendências e horários de pico de uso.
  • Determinar quantas visualizações de páginas e QPS devem ser adquiridas.
  • Consultar visualizações de páginas ou solicitações de serviços do lado do cliente em todos os domínios para comparar o uso por marca, público-alvo e outros fatores.
  • Verificar se o aplicativo está funcionando corretamente e resolver problemas.

O que está incluído nos relatórios

Dados Cliente/Web APIs/serviços incluídos
Visualizações de páginas Cliente JavaScript, Static Maps, Street View
Visualizações de páginas por domínio Cliente JavaScript, Static Maps, Street View
Solicitações de serviços Cliente Geocoding, Directions, Elevation
Solicitações de serviços Web Geocoding, Directions, Distance Matrix, Elevation, Time Zone
Solicitações de serviços por domínio Cliente Geocoding, Directions, Elevation
Consultas por segundo (QPS) Web Geocoding, Directions, Distance Matrix, Elevation, Time Zone
Taxa de sucesso de solicitações de serviço Web Geocoding, Directions, Elevation, Time Zone
Erros de solicitações de serviços Web Geocoding, Directions, Distance Matrix, Elevation, Time Zone

Observação: o Usage Dashboard não inclui relatórios para Google Places API, Google Maps Geolocation API, Google Maps Roads API e Google Maps Mobile SDK for Work.

Fazer login no Usage Dashboard

Fazer login pela primeira vez

Antes de fazer login no Usage Dashboard pela primeira vez, será necessário vincular sua conta do Google ao Usage Dashboard. Se você ainda não tiver uma conta do Google, consulte este artigo para saber como criar uma.

  1. Faça login no Google Cloud Support Portal.
  2. No painel à esquerda, clique em Maps: Usage Report.
  3. Selecione Access the new Usage Dashboard.
  4. Siga as instruções para selecionar e, se necessário fazer login em uma conta do Google.
  5. Na mensagem que solicita permissão para que o Usage Dashboard acesse sua conta do Google, clique em Approve. Essa aprovação vincula sua conta do Google à sua conta do portal de suporte.

Agora você poderá ver o Usage Dashboard.

Observação: se você não conseguir acessar o Usage Dashboard, entre em contato com o suporte.

Fazer login após a configuração inicial

Após vincular sua conta do Google ao Usage Dashboard, você poderá acessá-lo diretamente em:

https://maps-dashboard.appspot.com

Se ainda não fez login na sua conta do Google, faça login com a conta que você vinculou ao Usage Dashboard.

Usar os relatórios

Ver gráficos de relatórios

O Google Maps APIs for Work Usage Dashboard oferece relatórios gráficos para ajudar a visualizar tendências de uso ao longo do tempo. Para ver os dados de cada API em um relatório, basta passar o cursor do mouse sobre o gráfico. Por exemplo:

Alterar o período dos relatórios

O período padrão para relatórios é de sete dias, mas você pode criar facilmente relatórios personalizados para qualquer intervalo no último ano. (No entanto, os períodos dos relatórios da guia Dashboard são fixos.)

Observação: na guia Web Services, você pode detalhar os dados ainda mais para ver dados horários sobre a taxa de sucesso do aplicativo selecionando períodos de três ou menos dias.

Para alterar o período:

  1. Na guia Page Views, Client Services ou Web Services, clique no ícone Calendar imagem do ícone Calendar.
  2. Clique nos campos de data para selecionar as datas de início e término.
  3. Clique no botão de marca de verificação imagem do botão de marca de verificação.

O novo período será aplicado a todas as guias, exceto Dashboard.

Observação: todos os timestamps que contém apenas a data (data sem indicação de hora) mostrados no Usage Dashboard são exibidos no fuso horário do Pacífico. Timestamps mais precisos (com precisão de hora, minuto ou segundo) exibidos na guia Web Services quando um período curto é escolhido são mostrados no seu fuso horário local.

Exportar e analisar dados de relatórios

Se quiser analisar dados de relatórios em outras ferramentas ou compartilhá-los com outras pessoas, você poderá exportar todos os dados das guias Page Views, Client Services e Web Services para um arquivo com valores separados por vírgula (CSV).

Por exemplo, é possível abrir arquivos de dados em um programa de planilhas (como o Planilhas Google), uma plataforma de análises ou uma ferramenta de inteligência de negócios para analisar tendências, comparar o uso com o tráfego geral do site e estimar o uso futuro, entre outras atividades.

Para exportar os dados:

  1. Opcionalmente, altere o período do relatório.
  2. No canto esquerdo inferior de um painel de relatório, clique no imagem de botão de download de CSV.
  3. Salve o arquivo.

Relatórios de visualização de páginas

Ver um instantâneo de dados anuais e mensais

Na guia Dashboard, o painel Page View Consumption mostra as seguintes informações sobre o aplicativo:

  • Total de visualizações de páginas no último ano
  • Média mensal de visualizações de página
  • Média diária de visualizações de páginas

Dica: para calcular o número provável de visualizações de páginas que você precisará comprar nos próximos 12 meses, multiplique a média mensal de execução por 12.

No painel Total Request, será exibido um gráfico das visualizações de páginas do aplicativo nos últimos 30 dias.

Detalhes de visualizações de páginas

Clique na guia Page Views. O painel Total Requests mostra o total de solicitações de visualização de página para cada data no período selecionado. Os dados serão exibidos em um gráfico no painel à direita. Opcionalmente, altere o período do relatório e exporte os dados para análises adicionais.

Ver visualizações de páginas por domínio

Clique na guia Page Views. O painel By Authorized Domain mostra o total de solicitações de visualização de páginas para cada um dos seus domínios e para cada API no período selecionado. Se você especificou parâmetros de canal nas solicitações do aplicativo, os dados de uso serão agrupados por domínio e canal.

Observação: o relatório mostra todos os domínios registrados no Google Cloud Support Portal para um determinado ID do cliente que solicitou dados das Google Maps APIs.

Opcionalmente, altere o período do relatório e exporte os dados para análises adicionais.

Relatórios de serviços cliente

Ver o uso total do lado do cliente

Clique na guia Client Services. Para cada data no período selecionado, o painel Client-Side Services Usage mostra o total de solicitações efetuadas pela implementação JavaScript do aplicativo. Os dados serão exibidos em um gráfico no painel à direita.

Opcionalmente, altere o período do relatório e exporte os dados para análises adicionais.

Ver uso do lado do cliente por domínio

Clique na guia Client Services. O painel By Authorized Domain mostra as solicitações de serviços do lado do cliente para cada um dos domínios no período selecionado. Se você especificou parâmetros de canal nas solicitações do aplicativo, o uso será agrupado por domínio e canal.

Observação: o relatório mostra todos os domínios registrados no Google Cloud Support Portalpara um determinado ID do cliente.

Opcionalmente, altere o período do relatório e exporte os dados para análises adicionais.

Relatórios de serviços Web

Ver dados de consultas por segundo (QPS)

Clique na guia Web Services. O painel Queries Per Second mostra os dados a seguir para cada API no período selecionado:

  • Uso médio de QPS pelo aplicativo
  • Uso máximo de QPS pelo aplicativo
  • QPS usado pelo aplicativo 99% do tempo

Observe que, para a Distance Matrix API, o relatório mostra elementos (pares origem/destino) por segundo, em vez de solicitações.

Opcionalmente, altere o período do relatório.

Dica: use dados de QPS para determinar o número de QPS a adquirir.

Ver detalhes de uso de serviços Web

Clique na guia Web Services. O painel Total Requests mostra o total de solicitações de serviços Web para cada data no período selecionado. Observe que, para a Distance Matrix API, o relatório mostra elementos (pares origem/destino) por dia, em vez de solicitações.

Opcionalmente, altere o período do relatório e exporte os dados para análises adicionais.

Observação: o painel à direita mostra a taxa de sucesso das solicitações de serviços Web do aplicativo e todos os erros que ele recebeu. Para obter detalhes, consulte "Relatórios de integridade de aplicativos".

Relatórios de integridade de aplicativos

Obtenha um instantâneo da integridade do aplicativo

Na guia Dashboard, você encontrará um instantâneo do desempenho do aplicativo nos últimos dois dias no painel Application Status. Os ícones a seguir indicam a taxa de sucesso das solicitações de serviços Web do aplicativo para dados das Google Maps APIs:

Icon Descrição

Bom: pelo menos 95% das solicitações foram bem-sucedidas.

Aviso: de 80% a 94% das solicitações foram bem-sucedidas.

Alerta: menos de 80% das solicitações foram bem-sucedidas.

Sem solicitações: o aplicativo não usou essa API.

Passe o cursor do mouse sobre uma API para ver mais informações.

Verificar a taxa de sucesso de solicitações de serviços Web

Clique na guia Web Services. O gráfico do painel % Request Success mostra a taxa de sucesso das solicitações de serviços Web do aplicativo no período selecionado.

Opcionalmente, altere o período do relatório e exporte os dados para análises adicionais.

Verificar a ocorrência de erros de solicitação de serviços Web

Clique na guia Web Services. Abaixo do gráfico, no painel % Request Success, se a taxa de sucesso dos serviços Web do aplicativo for inferior a 100% no período selecionado, serão exibidos todos os códigos de erro recebidos pelo aplicativo. Opcionalmente, altere o período do relatório. Para ver dados horários, com timestamps por minuto, selecione um período de três ou menos dias. Para analisar e resolver problemas de erros em mais detalhes, exporte os dados para um arquivo.

O Usage Dashboard mostra os seguintes tipos de erros que podem ser recebidos pelo aplicativo quando solicita serviços Web das Google Maps APIs. Para obter soluções, consulte a seção de serviços Web das Google Maps APIs do site de desenvolvedores.

Código de erro Descrição
OVER_DAILY_LIMIT A solicitação do aplicativo excedeu o limite diário. Quando esse erro ocorrer, o serviço Web deixará de retornar dados até que o uso adicional seja permitido.
OVER_QPS_LIMIT O número de consultas por segundo (QPS) de serviços Web do aplicativo excedeu o limite por segundo. Quando esse erro ocorrer, o serviço Web deixará de retornar dados até que o uso adicional seja permitido.
INVALID_SIGNATURE A solicitação do aplicativo tinha uma assinatura digital inválida. Para obter mais informações sobre assinaturas e como gerá-las, consulte a seção de assinaturas digitaisna página de autenticação e autorização.
INVALID_REQUEST O serviço Web não conseguiu analisar a solicitação do aplicativo. Normalmente, esse erro ocorre quando faltam informações na solicitação.
INTERNAL_ERROR Houve um erro no processamento do aplicativo, mas o serviço Web não retornou um motivo.

Suporte e comentários

Obter suporte técnico

Se você precisar de ajuda com o Google Maps APIs for Work Usage Dashboard, registre um caso no Google Cloud Support Portal.

  1. Faça login no Google Cloud Support Portal.
    Observação: Se não tiver suas credenciais de acesso, você poderá solicitar acesso ao portal.
  2. Clique na guia Cases.
  3. Clique em Create New Case.
  4. Em Product Name, clique em My product isn’t listed. Escolha Google Maps na lista suspensa.
  5. Em Group Components do caso, selecione Other.
  6. Defina Priority de acordo com as designações de prioridade.
  7. Na descrição, inclua um resumo do problema e as etapas para reproduzi-lo. Não deixe de indicar que o problema ocorre no Google Maps APIs for Work Usage Dashboard.

Envie seus comentários

Você pode sugerir um recurso, relatar um problema ou enviar outros comentários sobre o Google Maps APIs for Work Usage Dashboard. Embora não seja possível responder pessoalmente, usaremos seus comentários para aprimorar a experiência do Usage Dashboard.

  1. No canto inferior esquerdo de qualquer guia Dashboard, clique no botão Send Feedback imagem do botão Feedback.
  2. Siga as instruções na tela.