Geração de relatórios da Plataforma Google Maps

Os relatórios da Plataforma Google Maps fornecem um conjunto de recursos visuais predefinidos relatórios de uso básico da API, cota e informações de faturamento no console do Google Cloud. Use esses relatórios para determinar o número de solicitações chamadas realizadas, quanto falta para você atingir as cotas de uso da API e o uso do faturamento ao longo do tempo.

Os tipos de relatório incluem:

  • Relatórios de uso: informa o número de solicitações que o projeto faz para as APIs da Plataforma Google Maps usando as credenciais associadas a ele.
  • Relatórios de cotas: informa o uso de cotas em gráficos que podem ser agrupados em solicitações por minuto. Os limites de cota atuais para as APIs selecionadas são mostrados nas tabelas abaixo dos gráficos de uso da cota.
  • Relatórios de faturamento: informa os custos ao longo do tempo como um gráfico de linhas empilhadas. Confira a utilização das cotas no mês atual, incluindo todos os créditos específicos de uso aplicados e os custos estimados para todo o mês.
  • Relatórios de engajamento: oferecem insights comerciais sobre como os usuários interagem com seus apps de mapas.

Para uma lista completa dos status e códigos de resposta que definem se uma solicitação aparece nos campos Uso, Cota, e/ou Faturamento, consulte Status de resposta e relatórios.

Veja os relatórios de uso, cota e faturamento da Plataforma Google Maps com o Console do Cloud.

Relatórios de uso

O uso é baseado no número de solicitações que o projeto faz ao APIs da Plataforma Google Maps que usam as credenciais associadas à sua em um projeto de IA. As solicitações incluem solicitações bem-sucedidas, solicitações que resultam em solicitações erros e solicitações que resultam em erros do cliente. As credenciais contêm as chaves de API e IDs de cliente (para plano Premium e projetos Premium migrados). Para mais detalhes, consulte a Visão geral do plano Premium e informações sobre como usar um ID do cliente.

As métricas de uso são mostradas em tabelas (solicitações, erros e latência) e gráficos (tráfego, erros e latência). Para fins de rastreamento, as seguintes condições se aplicam:

  • Todas as APIs: é possível filtrar e agrupar as métricas de uso de todas as APIs nessas maneiras:

    • Filtre por período e API.
    • Consulte tráfego, erro e latência agrupados por código de resposta, API e credencial.
  • Uma API específica: você pode filtrar e agrupar as métricas de uso de uma API específica das seguintes maneiras:

    • Filtrar por período, versão da API, credenciais e métodos.
    • Veja tráfego, erro e latência agrupados por código de resposta e método de API versão e credencial.

Página do painel de APIs e serviços

As APIs e Serviços Painel fornece uma visão geral das métricas de uso de todas as APIs ativadas para seu projeto: as APIs da Plataforma Google Maps, bem como outras APIs e serviços.

  • A página Painel apresenta três gráficos e uma tabela. É possível filtrar o uso exibidos nos gráficos e nas tabelas selecionando um período de 1 hora até os últimos 30 dias.

  • O gráfico Tráfego mostra o uso em consultas por minuto (QPM) por API.

  • O gráfico Erros mostra a porcentagem de solicitações que resultaram em erros por API.

  • O gráfico de Latência mostra a latência mediana das solicitações por API.

Abaixo dos gráficos, há uma tabela que exibe as APIs e os serviços ativados. As solicitações representam o número de solicitações para o período selecionado. Os erros indicam o número dessas solicitações que resultaram em erros. A latência (média e percentil) é a latência das solicitações.

monitoramento de APIs

Para acessar a página do painel de APIs e serviços:

  1. Abra a página do seletor de projetos no Console do Cloud:

    Página do seletor de projetos

  2. Selecione o projeto. A página do painel de APIs e serviços é exibida.

    Se a página não aparecer, selecione o botão de menu menu e, depois, APIs e serviços.

Para mais informações, consulte Como monitorar o uso da API.

Página de visão geral do Google Maps

A página Visão geral do Google Maps inclui uma tabela que mostra as APIs ativadas e as solicitações de uso dos últimos 30 dias. As solicitações por API também aparecem na forma de gráfico. Um gráfico de faturamento detalha a fatura atual e o uso total nos últimos três meses.

Captura de tela de um gráfico de visão geral mostrando uma tabela que lista as APIs ativadas e as solicitações de API dos últimos 30 dias.

Para acessar a página de visão geral da Plataforma Google Maps:

  1. Abra a página da Plataforma Google Maps no Console do Cloud:

    Acessar a página da Plataforma Google Maps

  2. No menu à esquerda, selecione Visão geral.

APIs da Plataforma Google Maps e Página de serviços

O Google Maps APIs e página "Serviços" contém uma grade de blocos que representam as APIs, os SDKs e outros serviços disponíveis para seu projeto. Em cada bloco, é possível ativar ou desativar esse serviço selecionando Ativar ou Desativar e acessar as credenciais informações, métricas e guias do usuário para APIs ativadas. Você também pode usar os filtros de página para visualizar serviços ativados ou desativados e outras categorias de serviços.

APIs

Para acessar as APIs da Plataforma Google Maps e Página de serviços:

  1. Abra a página da Plataforma Google Maps no Console do Cloud:

    Acessar a página da Plataforma Google Maps

  2. No menu à esquerda, selecione APIs e Serviços.

Página de métricas do Google Maps

A página Métricas do Google Maps mostra três gráficos: Tráfego, Erros e Latência mediana. É possível agrupar os dados de uso deles por classe do código de resposta, API, método de API, credencial, plataforma ou domínio.

Abaixo dos gráficos, a página Métricas inclui uma tabela de APIs que informa as solicitações, os erros e a latência das APIs escolhidas.

Usando a lista suspensa da API na parte de cima e as opções de filtragem no painel à direita, agrupe e filtre as métricas de uso selecionando uma ou mais opções de API, credencial, classe do código de resposta, tipo da plataforma e/ou domínio. Também é possível escolher um período (entre 1 hora e os últimos 30 dias) e a granularidade (por segundo ou dia) para as métricas de uso mostradas.

A página de métricas mostrando três gráficos: Tráfego, Erros e Latência mediana.

As imagens a seguir mostram os filtros Plataforma e Domínio de uma única API quando a opção de agrupar por Plataforma e Domínio está selecionada na lista suspensa Agrupado por:

O filtro "Plataforma" só aparece quando uma única API é selecionada. O filtro "Plataforma" só aparece quando uma única API é selecionada.

Para acessar a página de métricas da API da Plataforma Google Maps:

  1. Abra a página da Plataforma Google Maps no Console do Cloud:

    Acessar a página da Plataforma Google Maps

  2. No menu à esquerda, selecione Métricas.

Relatórios de credenciais

É possível filtrar e agrupar métricas pela credencial usada para carregar o API.

Formato da credencial Significado
Nome da chave
Por exemplo, "Chave de app para dispositivos móveis".
Uma chave de API foi usada para carregar a API usando ?key=...: você encontra os nomes das chaves na Plataforma Google Maps Console em Chaves e Credenciais.
Número do projeto
Por exemplo, "project_number:123456", em que 123456 é o número do seu projeto.
Há duas possibilidades caso essa credencial apareça:
  1. Para APIs que aceitam IDs de cliente da Plataforma Google Maps: A O ID do cliente da Plataforma Google Maps foi usado para carregar a API. Por exemplo: usando &client=gme-_mycompany_.

    Estas APIs aceitam IDS de clientes: API Maps JavaScript, Maps Static API, API Street View Static, API Elevation, API Directions, API Distance API Matrix, API Geocoding, API Time Zone. Para mais informações, consulte Gerenciamento de ID do cliente no Plano Premium.

  2. Para APIs que aceitam OAuth: a API foi carregada. usando o OAuth sem uma chave de API.

Gráficos de código de resposta

Os gráficos Tráfego por código de resposta e Erro por código de resposta são divididos por classe do código de resposta HTTP. Esta tabela mostra o mapeamento entre o status da resposta da API da Plataforma Google Maps e a classe do código de resposta em HTTP:

Status da API Maps Classe do código de resposta em HTTP: relatório de uso
(2xx, 3xx, 4xx, 5xx)
Observações
OK 2xx Resposta bem-sucedida.

Essa é uma solicitação faturável que consome a cota.
OK 3xx Resposta bem-sucedida.

Essa é uma solicitação faturável que consome a cota.

Por exemplo, as solicitações bem-sucedidas do Place Photo retornam redirecionamento 302 para a imagem referenciada.
DATA_NOT_AVAILABLE 4xx(1) Resposta bem-sucedida indicando que não há dados disponíveis para o locais de entrada.

Essa é uma solicitação faturável que consome a cota.
ZERO_RESULTS 4xx(1) A resposta foi bem-sucedida, mas não retornou nenhum resultado.

Essa é uma solicitação faturável que consome a cota.
NOT_FOUND 4xx(1) Para o API Directions, esta mensagem indica que pelo menos um dos locais especificados no não foi possível geocodificar a origem, o destino ou os waypoints da solicitação.

Para o API Places esta mensagem indica que o local indicado (place_id) não foi no banco de dados do Places.

Essa é uma solicitação faturável e que consome a cota.
INVALID_REQUEST (valor de parâmetro inválido),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED e outros.
4xx Erro causado por um valor de parâmetro inválido. Veja a resposta da API para mais detalhes.

Essa é uma solicitação faturável que consome a cota.
REQUEST_DENIED 4xx Erro de cliente causado por erros de autenticação, de acesso, entre outros. Verifique a resposta da API para mais detalhes.
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
rateLimitExceeded,
dailyLimitExceeded,
userRateLimitExceeded
4xx Erro de cliente causado por muitas solicitações no período permitido. Tentar de novo a solicitação mais tarde. Verifique a resposta da API para mais detalhes.
INVALID_REQUEST (parâmetro inválido ou ausente, solicitação de análise ou validação) 4xx Erro de cliente causado por uma solicitação inválida. Confira a resposta da API para mais detalhes.
NOT_FOUND (404) 4xx Para o API Geolocation, esta mensagem indica que as entradas não foram suficientes para uma estimativa de local.

Para a API Roads, esta mensagem indica que não foi possível ajustar as entradas às estradas.

Essa é uma solicitação faturável e consumirá a cota.
UNKNOWN_ERROR 5xx Erro de servidor indicando que não é possível prosseguir com a solicitação: interno erro, serviço sobrecarregado, indisponível, erro de tempo limite, entre outros.
1 Para aumentar a consistência dos relatórios sobre códigos de erro, as APIs da Plataforma Google Maps estão sendo migradas: 1) da classe do código de resposta HTTP 2xx para 4xx nos status da API Maps: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTSstatus, 2) da classe do código de resposta HTTP 2xx para 4xx nos status da API Maps: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) da classe do código de resposta HTTP 2xx para 5xx nos status da API Maps: UNKNOWN_ERROR. Os dois códigos de resposta ficam aparentes durante o período de transição. Os códigos retornados nas respostas da API Maps não vão mudar. Confirme se um aumento de 4xx e/ou 5xx nas métricas da Plataforma Google Maps está relacionado a essa migração. Para isso, descubra exatamente qual código de resposta aumenta no Metrics Explorer (saiba como usar o Google Cloud Monitoring na Plataforma Google Maps).

Para mais informações sobre códigos de status e mensagens de erro, consulte a resposta documentação da API em que você tem interesse (por exemplo, Respostas do Geocoding ou Respostas de rotas).

Parâmetro de soluções da Plataforma Google Maps

A Plataforma Google Maps oferece muitos tipos de exemplo de código para ajudar você a rapidamente e em execução. Por exemplo, é possível usar Criador rápido de soluções no console do Cloud, siga as soluções do setor guias de implementação, e aprender com codelabs.

Para entender o uso e as formas de melhorar nossas soluções, o Google inclui o Parâmetro de consulta solution_channel em chamadas de API para coletar informações sobre o uso do exemplo de código:

  • O parâmetro de consulta solution_channel é incluído por padrão. no exemplo de código da solução.
  • O parâmetro de consulta retorna análises sobre a implementação da solução no Google para melhorar a qualidade dela em iterações futuras.
  • Para desativar, exclua a consulta solution_channel e o valor dele no exemplo de código.
  • Não há requisito para manter o parâmetro. Como remover a consulta não afeta o desempenho.
  • O parâmetro de consulta é usado apenas para gerar relatórios de uso do exemplo de código.
  • O parâmetro de consulta é separado de qualquer análise específica da API e geração de relatórios. Isso significa remover o parâmetro do exemplo de código da solução não desativa os relatórios internos da API Maps JavaScript.

Relatórios de cotas

As cotas definem limites quanto ao número de solicitações que seu projeto pode fazer para o APIs da Plataforma Google Maps. As solicitações podem ser limitadas de três maneiras: por dia, por minuto e por usuário por minuto. Somente solicitações bem-sucedidas e as solicitações que causam erros de servidor são contabilizadas na cota. Solicitações que com falha na autenticação não são contabilizados na cota.

O uso da cota aparece nos gráficos da página Cotas no console do Cloud. e podem ser agrupadas em solicitações por minuto. Os limites de cota atuais para as APIs selecionadas são mostradas nas tabelas abaixo do uso da cota gráficos.

Para saber o valor da cota por minuto de qualquer produto da API GMP, use este calculadora.

Página de cotas do Google Maps

A página Cotas do Google Maps apresenta os limites e o consumo de cota da API selecionada.

O gráfico de uso de cota no Console do Google Cloud mostra o tráfego total das chaves de API e dos IDs de cliente. O tráfego do ID do cliente também está disponível no gráfico de métricas no Console do Cloud.

A página mostra apenas as solicitações que consomem cota: solicitações concluídas (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) e aquelas que causam erros de servidor (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (valor de parâmetro inválido), UNKNOWN_ERROR).

Solicitações que causam erros de cliente: autenticação, autorização e erros de argumento inválido (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST) (parâmetro inválido, erro de análise da solicitação) — não consomem a cota e não são exibidos.

A unidade de cota é uma solicitação para a maioria das APIs da Plataforma Google Maps (API Maps Static, API Street View Static, as APIs Geocoding e Directions, API Places, API Time Zone API Geolocation e API Elevation), mas com algumas exceções:

  • Na API Distance Matrix, a unidade de cota é um elemento, que é um par de origem e destino.
  • Na API Maps JavaScript, é um carregamento de mapa.
  • Nos SDKs do Maps para Android e iOS, a unidade de cota é uma solicitação do Street View ou um panorama carregar. Os carregamentos de mapa estão disponíveis sem custos financeiros e não consomem a cota.

Captura de tela da página "Cotas" do Maps no console do Google Cloud. Lá, são mostradas cotas por API usando um seletor e carregamentos de mapa em relação às cotas definidas para a API em questão.

Para acessar a página de cotas da Plataforma Google Maps:

  1. Abra a página da Plataforma Google Maps no Console do Cloud:

    Acessar a página da Plataforma Google Maps

  2. No menu à esquerda, selecione Cotas.
  3. Selecione uma API na lista suspensa.

Unidades de cota

Esta tabela mostra a unidade de cota das APIs da Plataforma Google Maps.

API da Plataforma Google Maps Unidade de cota
Maps
SDK do Maps para Android 1 panorama
SDK do Maps para iOS 1 panorama
API Map Tiles 1 solicitação
API Maps Aerial View 1 solicitação
API Maps Static 1 solicitação
API Maps JavaScript 1 carregamento de mapa
API Street View Static 1 solicitação
API Maps Embed 1 carregamento de mapa
Routes
API Routes (Compute Routes) 1 solicitação
API Routes (Compute Route Matrix) 1 elemento (par de origem e destino)
API Directions 1 solicitação
API Distance Matrix 1 elemento (par de origem e destino)
API Roads 1 solicitação
API Route Optimization 1 solicitação
Places
API Places 1 solicitação
API Address Validation 1 solicitação
API Geocoding 1 solicitação
API Geolocation 1 solicitação
API Time Zone 1 solicitação
Ambiente
API Air Quality (CurrentConditions e HeatmapTile) 1 solicitação
API Air Quality (histórico) 1 página
API Pollen 1 solicitação
API Solar 1 solicitação

Relatórios de faturamento

Ver seu relatório de faturamento

Os relatórios de faturamento para uso dos produtos da Plataforma Google Maps são disponíveis no console do Google Cloud. Para mais informações, consulte Faturamento.

Para acessar os relatórios de faturamento, faça o seguinte:

  1. Abra a página do seletor de projetos no Console do Cloud:

    Página do seletor de projetos

  2. Selecione um projeto.
  3. Selecione o botão de menu menu e, depois, escolha Faturamento.
  4. Se você tiver várias contas de faturamento, selecione Acessar a conta de faturamento vinculada para abrir a página Visão geral dessa conta.
  5. No menu à esquerda, selecione Relatórios para abrir a página Relatórios de faturamento da conta de faturamento vinculada.

Como ler o gráfico do relatório de faturamento

Os relatórios de faturamento exibem o custo ao longo do tempo como um gráfico de linhas empilhadas. O padrão mostra os custos diários de uso do mês atual agrupados por projeto (para todos os produtos), incluindo todos os créditos de uso aplicados; bem como o custo total previsto para todo o mês atual. Cada linha do gráfico e da tabela de resumo corresponde a um projeto, classificados por custo: do menor ao maior. Saiba mais sobre como interpretar o gráfico do relatório de faturamento.

Captura de tela do relatório de faturamento exibindo o gráfico e a tabela na visualização predefinida padrão
Figura 1:o relatório de faturamento exibindo o gráfico e usando a visualização predefinida padrão.

Dica: analisar o uso e o custo por SKU

Para entender melhor os detalhes do modelo de preços de pagamento por uso e como isso afeta a implementação, veja o uso e o custo por SKU.

Relatório de faturamento agrupado por SKU
Figura 2:a tabela de faturamento exibindo dados de uso e de custo dos itens de linha por SKU.
Captura de tela dos filtros do relatório de faturamento
Figura 3: os filtros do relatório de faturamento.
Alterar a vista de relatórios para mostrar itens de linha por SKU:
  1. No painel à direita do gráfico, abra o filtro Agrupar por.
  2. Selecione a SKU.

Outros filtros de relatórios de faturamento disponíveis incluem Período, Projetos, Produtos, SKUs e Locais, que permitem filtrar por onde de onde as solicitações de API são atendidas.

Para categorizar a origem do uso e o produto, agrupe o faturamento por um dos valores listados. As três chaves relacionadas As APIs da Plataforma Google Maps são goog-maps-api-key-suffix (as quatro últimas caracteres de uma chave de API), goog-maps-platform-type (a plataforma: Android, iOS, JavaScript ou webservice) e goog-maps-channel (um conjunto channel de uma consulta de API). Mais informações sobre filtragem e agrupamento.

Mude a visualização do gráfico para excluir créditos de uso específico limpando a caixa de seleção Incluir créditos no custo no painel à direita.

Monitorar e restringir o consumo

Para poder planejar seu orçamento e controlar os custos, faça o seguinte:

  • Defina um alerta de orçamento para acompanhar o aumento dos gastos em relação a um determinado valor. A definição de um orçamento não limita o uso da API, apenas informa quando seu gasto está próximo do valor especificado.
  • Limite o uso diário da API para gerenciar o custo de uso das APIs faturáveis. Ao definir limites nas solicitações por dia, você pode restringir seus gastos. Use uma equação simples para determinar o limite diário, dependendo de quanto você quer gastar. Por exemplo: (gasto mensal /preço unitário)/30 = limite de solicitações por dia (para uma API).

Rastreamento de uso por canal

Para acompanhar o uso com canais numéricos, adicione o parâmetro "channel" às solicitações de API. Os únicos valores de canal aceitáveis são números de 0 a 999. Veja alguns exemplos:

  • API Geocoding Web Service
    https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
  • API Maps JavaScript
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
    async defer></script>

Monitore o uso do canal diretamente no relatório de faturamento. Os canais serão incluídos em Rótulos como a chave goog-maps-channel.

Filtrar por rótulos
Figura 4: filtrar por SKU e canais
Filtrar seu relatório de faturamento por SKU e canal
  1. Use o filtro de SKU Agrupar por.
  2. Selecione o cursor de texto Rótulos.
  3. Selecione o menu suspenso Chave e escolha goog-maps-channel.
  4. Selecione o menu suspenso Valor e escolha os canais numéricos que você quer filtrar.

Agrupe pela chave de rótulo goog-maps-channel para ver o custo gerado em cada canal.

Depois de implementar os dados de uso de canal nas solicitações, poderá haver um pequeno atraso (de até 24 horas) até que os dados apareçam no seu relatório de faturamento.

Exportar dados de faturamento com o BigQuery

É possível também exportar seus dados de faturamento para o BigQuery.

Com o BigQuery Export, você exporta dados detalhados do Cloud Billing (como informações de uso e de estimativa de custos) automaticamente ao longo do dia para um conjunto de dados do BigQuery. Depois, você poderá acessar seus dados de faturamento do BigQuery para uma análise detalhada. Isso proporciona uma camada adicional de granularidade para entender a origem do uso da Plataforma Google Maps.

Para começar a usar o BigQuery Export e fazer consultas de dados, confira o exemplo abaixo. Antes de realizar essa consulta, você precisa seguir estas etapas:

  • Ative o faturamento e a exportação de faturamento do BigQuery na sua conta.
  • O formato da tabela é PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID, em que:
    • PROJECT_ID é o ID do projeto real (por exemplo, "my-project-123456").
    • DATASET_NAME é o nome do conjunto de dados que você criou (por exemplo, "SampleDataSet").
    • BILLING_ACCOUNT_ID é uma referência do ID da conta de faturamento, com o prefixo "gcp_billing_exportv1" e a alteração de traços (-) para sublinhados (_). Por exemplo, o ID da conta de faturamento 123456-7890AB-CDEF01 seria gcp_billing_export_v1_123456_789AB_CDEF01.

  #standardSQL
  SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
           invoice.month                                 AS invoice_month,
           service.description                           AS service,
           sku.description                               AS sku,
           (
                  SELECT l.value
                  FROM   Unnest(labels) AS l
                  WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
           Round(Sum(usage.amount), 2)                 AS usage_amount,
           usage.unit                                  AS usage_unit,
           Round(Sum(cost), 2)                         AS cost,
           cost_type,
           currency
  FROM     PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
  WHERE    invoice.month = '202002' -- Change the invoice month with the same format as the example.
  GROUP BY billing_day,
           invoice_month,
           service,
           sku,
           goog_maps_channel,
           usage_unit,
           cost_type,
           currency
  ORDER BY billing_day,
           service,
           sku
  

Cloud Billing:

Plataforma Google Maps:

Status de resposta e relatórios

A tabela abaixo mostra o mapeamento entre o status da API Maps, o código de resposta em HTTP retornado nas respostas da API Maps e a classe do código de resposta em HTTP no Relatório de uso, além de indicar se a solicitação correspondente aparece nos relatórios "Uso", "Cota" e "Faturamento".

O Relatório de uso nas métricas da Plataforma Google Maps informa a granularidade de HTTP response code class. Se precisar de mais detalhes, consulte a seção Códigos dos status de resposta referente ao Monitoramento de uso da Plataforma Google Maps.

Códigos de resposta disponíveis nas respostas da API Maps Disponível no Relatório de uso Informado para
Status da API Maps Código de resposta em HTTP Classe do código de resposta em HTTP Uso Cota Faturamento
OK 200,
204,
302
2xx,
3xx
Sim Sim Sim
DATA_NOT_AVAILABLE,
NOT_FOUND,
ZERO_RESULTS
200,
404
4xx1 Sim Sim Sim
INVALID_REQUEST (valor de parâmetro inválido),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
etc.
200,
400,
4xx Sim Sim Sim
INVALID_REQUEST (parâmetro inválido/faltando, erro de análise da solicitação) 200,
400,
4xx Sim Não Não
REQUEST_DENIED 200,
400,
403
4xx1 Sim Não Não
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded
200,
403,
429
4xx1 Sim Não Não
UNKNOWN_ERROR 200,
500,
503
5xx1 Sim Sim Não
1 Para aumentar a consistência dos relatórios sobre códigos de erro, as APIs da Plataforma Google Maps estão sendo migradas: 1) da classe do código de resposta HTTP 2xx para 4xx nos status da API Maps: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTSstatus, 2) da classe do código de resposta HTTP 2xx para 4xx nos status da API Maps: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) da classe do código de resposta HTTP 2xx para 5xx nos status da API Maps: UNKNOWN_ERROR. Os dois códigos de resposta ficam aparentes durante o período de transição. Os códigos retornados nas respostas da API Maps não vão mudar. Confirme se um aumento de 4xx e/ou 5xx nas métricas da Plataforma Google Maps está relacionado a essa migração. Para isso, descubra exatamente qual código de resposta aumenta no Metrics Explorer (saiba como usar o Google Cloud Monitoring na Plataforma Google Maps).

Relatórios de engajamento

Insights comerciais

A Plataforma Google Maps dá insights sobre como os usuários interagem com seus mapas. Esses dados incluem métricas de engajamento importantes, como visualizações em um mapa ou interações com um PDI. Eles podem ser analisados para otimizar a experiência do usuário ou identificar locais conhecidos onde você pode veicular anúncios e fazer divulgações.

Confira alguns recursos dos relatórios de insights comerciais:

  • Resumo de alto nível para consultar as principais tendências nos insights comerciais
  • Detalhamento para analisar uma métrica específica no console e entender melhor todas as métricas
  • Exportação das métricas para o formato CSV, o que permite analisar os dados dos insights comerciais na sua ferramenta favorita

As métricas de engajamento disponíveis incluem:

  • Visualizações de mapa: acompanhe as visualizações no mapa resultantes de movimentações, aplicações de zoom ou inclinações. Elas são computadas por CEP semanalmente (de domingo a sábado, horário do Pacífico). Novos dados são liberados toda semana, na primeira quarta-feira após o período de observação.

Os usuários podem consultar os insights comerciais na página Métricas do console do Cloud. O projeto deve ativar a API Maps JavaScript.

Você pode analisar as métricas de engajamento diretamente no console com os recursos "Filtro" e "Agrupar por". Por exemplo, filtre por região para saber como está a tendência das visualizações de mapa somente nos CEPs dessa região. Se preferir, você também pode agrupar por região para agregar as interações nela.

Os usuários podem exportar todo o conjunto de dados ou uma visualização filtrada para o formato CSV e analisar na ferramenta de preferência. É possível fazer o download de até 90 dias por vez. Downloads maiores do que 60 mil células ficam truncados. A exportação dos dados de visualizações de mapa para CSV pode levar alguns minutos, dependendo do período selecionado.

Como exportar os insights comerciais

As métricas dos insights comerciais são anonimizadas e, portanto, só refletem as tendências gerais de engajamento com seus mapas. Números baixos podem ser arredondados para zero, e as contribuições de outliers podem ser reduzidas.

É possível controlar o acesso aos insights comerciais do seu projeto do Cloud no console usando a permissão das ferramentas de análise do Google Maps. Proprietários de projetos recebem essa autorização por padrão e conseguem dar acesso a outros usuários.

Os insights comerciais não devem ser utilizados para estimar os custos de uso. Consulte os relatórios de uso para mais detalhes.

Locator Plus

Para os usuários do Locator Plus, um painel ajuda a analisar e gerar insights com base nas suas informações, oferecendo mais detalhes sobre o engajamento dos compradores com o localizador de lojas. Você pode medir sua performance a cada semana, incluindo o número de visualizações e de interações com a Pesquisa e o Place Details, além da taxa de engajamento geral. Além disso, o painel mostra comparações importantes sobre a sua implementação e a de outros varejistas.

Com o relatório comparativo, é possível corresponder seus dados aos dados agregados do setor provenientes de outras empresas. Isso oferece contexto importante e ajuda você a definir metas significativas, entender as tendências e comparar sua performance com a da concorrência.

Para que você possa acessar os dados de comparativo de mercado, seus dados de engajamento são incluídos anonimamente nos comparativos de mercado do Google. Se quiser desativar a visualização e a inclusão anônima dos dados de engajamento nos relatórios de comparação, abra um tíquete de suporte. O tíquete de suporte geralmente é resolvido em até três dias.