Como estimar o uso de Google Maps APIs Credits

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.

Introdução

Com o Google Maps APIs Premium Plan, as solicitações do seu aplicativo às APIs consomem Maps APIs Credits, que são comprados anualmente. Os exemplos a seguir mostram como estimar o consumo anual de Maps APIs Credits para aplicativos de mapa comuns: um mapa simples de imóveis anunciados e um localizador de lojas mais complexo.

Para estimar o consumo de crédito do seu aplicativo nesses exemplos, considere o seguinte:

  • A experiência do usuário no aplicativo
  • As APIs que o aplicativo usa
  • Alguns detalhes de implementação
  • A frequência de uso do aplicativo

Com essas informações, é possível estimar o número de créditos que o seu aplicativo consumirá por ano. Para facilitar os cálculos, use a Calculadora premium das Google Maps APIs.

Exemplo 1: mapa de imóveis anunciados

Experiência do usuário

Os corretores imobiliários podem visualizar todos os anúncios ativas da empresa em um mapa no seu site interno. Um corretor pode clicar em um marcador de uma listagem do mapa para ver uma janela de informações com detalhes sobre o imóvel armazenados no seu banco de dados, incluindo o corretor da listagem, o endereço e o tamanho do imóvel e uma imagem do Street View. Na janela de informações, o corretor pode clicar no botão “Get Directions”, selecionar o local da sua imobiliária e ver as rotas para a propriedade.

Maps APIs usadas

API Recursos oferecidos
Google Maps JavaScript API Exibe o mapa na página da Web interna
Google Street View Image API Insere imagens panorâmicas na janela de informações
Google Maps Geocoding API Fornece as coordenadas da listagem em latitude/longitude (lat/long) usando o seu banco de dados de endereços de imóveis
Google Maps Directions API Oferece rotas para a propriedade

Detalhes da implementação

  • Você tem 30 imobiliárias no estado do Colorado, nos EUA, e aproximadamente 3.000 corretores.
  • Seu banco de dados de imóveis normalmente tem mais de 25.000 anúncios ativos.
  • Você geocodifica os anúncios diariamente usando o serviço Web de geocodificação.

Hipóteses de uso dos corretores

Você estima 3.000 acessos por dia ao mapa de listagens no seu site. Para cada acesso, espera-se que:

  • Um corretor visualize a janela de informações de 5 propriedades.
  • Um corretor solicite rotas para 1 propriedade.

Cálculo de Maps APIs Credits

Uso de carregamentos de mapa

API Uso
Maps JavaScript API 1 carregamento de mapa x 3.000 visitantes x 1 crédito = 3.000 créditos
Street View Image API 5 carregamentos de mapa x 3.000 visitantes x 0,25 crédito = 3.700 créditos

Total de carregamentos de mapa: 3.000 + 3.750 = 6.750 solicitações por dia × 365 dias = necessidade de 2.463.750 créditos por ano

Uso das Web Service APIs

API Uso
Geocoding API 25.000 códigos geográficos por dia
Directions API 1 solicitação x 3.000 visitantes = 3.000 consultas

QPD total: 25.000 + 3.000 = 28.000 QPD

A QPD está abaixo do limite diário gratuito de 100.000, por isso não há a necessidade de mais créditos.

Maps APIs Credits anuais necessários

2.463.750 créditos para carregamentos de mapa + 0 créditos para serviços Web = 2.463.750 créditos

Exemplo 2: localizador de lojas

Experiência do usuário

Seu cliente pode usar o localizador de lojas no seu site o em um aplicativo para dispositivos móveis (Android/iOS) para encontrar até 50 lojas próximas de uma localidade específica. O cliente informa sua localização atual ou o endereço de outro ponto de partida ou ponto de interesse. Enquanto o cliente digita o ponto de partida, o aplicativo exibe automaticamente uma lista de endereços ou nomes de local correspondentes. Quando o cliente seleciona um local da lista, o mapa exibe marcadores para 50 das lojas mais próximas desse local. Em seguida, o cliente pode clicar em um marcador para abrir uma janela de informações com detalhes sobre a loja, incluindo endereço e horário de funcionamento (armazenados no seu banco de dados de lojas), a distância e uma imagem panorâmica do local. Nesse momento, o cliente pode escolher ver rotas para a loja.

Maps APIs usadas

API Recursos oferecidos
Google Maps JavaScript API Exibe o mapa no site
SDKs para dispositivos móveis (Android/iOS) Exibe o mapa em dispositivos móveis
Google Street View Image API Disponibiliza as imagens panorâmicas estáticas (não interativas) na janela de informações
Google Maps Geocoding API Fornece as coordenadas da loja em latitude/longitude (lat/long) usando sua lista de endereços de loja
Google Maps Distance Matrix API Indica a distância e o tempo estimado do ponto de partida até as lojas do seu banco de dados — essas informações aparecem na janela de informações
Google Maps Directions API Fornece rotas à loja
Google Places API
Biblioteca JavaScript e
Web Service
  • Place Autocomplete, que fornece correspondência de endereços ou pontos de interesse independente de tipo
  • Places Details, que fornece o endereço do ponto de partida (ou “local”) selecionado pelo cliente nos resultados do Autocomplete

Detalhes da implementação

Veja alguns detalhes de implementação que afetam a estimativa de uso:

  • Você tem 1.500 lojas em todo o mundo.
  • Você geocodifica os 1.500 locais de loja a cada 30 dias usando o serviço Web de geocodificação.
  • Você usa a função de distância do banco de dados para pesquisar todos os endereços geocodificados e obter as 50 lojas mais próximas do ponto de partida do visitante.
  • Chama a Google Maps Distance Matrix API para exibir a distância de carro e o tempo estimado do ponto de partida às 50 lojas mais próximas obtidas do seu banco de dados. Ao calcular as distâncias para apenas 50 lojas, você mantém o número de elementos por solicitação bem abaixo do máximo de 625.

Hipóteses de uso do cliente

Você estima 2.000 acessos por dia ao localizador de loja: aproximadamente 1.000 acessos no site e 1.000 em dispositivos móveis. Para cada acesso, espera-se que:

  • Um cliente digite, em média, 8 caracteres para encontrar o ponto de partida.
  • Um cliente busque e selecione 1 ponto de partida.
  • Um cliente clique, em média, em 2 marcadores para abrir a janela de informações.
  • Um cliente solicite rotas para um local.

Cálculo de Maps APIs Credits

Uso de carregamentos de mapa

API Uso
Maps JavaScript API 1 carregamento de mapa x 1.000 visitantes x 1 crédito = 1.000 créditos
Mobile SDK 1 carregamento de mapa x 1.000 visitantes x 1 crédito = 1.000 créditos
Street View Image API 2 carregamentos de mapa x 2.000 visitantes x 0,25 crédito = 1.000 créditos

Total de carregamentos de mapa: 1.000 + 1.000 + 1.000 = 3.000 solicitações por dia × 365 dias = necessidade de 1.095.000 créditos por ano

Uso das Maps JavaScript/Web Service APIs

API Uso
Geocoding API 1.500 códigos geográficos = 1.500 consultas (por mês)
Directions API 1 solicitação x 2.000 visitantes = 2.000 consultas
Distance Matrix API 1 solicitação x 2.000 visitantes x 50 lojas mais próximas = 100.000 elementos

QPD total: 2.000 + 100.000 = 102.000 QPD

QPD total excedente: 102.000 - 100.000 QPD gratuita = 2.000 de QPD excedente × 0,25 crédito = 500 créditos por dia / 182.500 créditos por ano

QPD total para geocodificação: 1.500 × 0,25 crédito = 375 créditos por mês / 4.500 créditos por ano

Excedente anual total: 182.500 + 4.500 = 187.000 créditos por ano

Uso da Places API

API Uso
Place Autocomplete na Places API 1 pesquisa x 8 caracteres por pesquisa x 0,1 crédito = 0,8 x 2.000 visitantes = 1.600 créditos
Place Details na Places API 1 solicitação x 2.000 visitantes x 2 créditos = 4.000 créditos

Uso total da Places API: 1.600 + 4.000 = 5.600 solicitações por dia / 2.044.000 créditos por ano

Maps APIs Credits anuais necessários

1.095.000 créditos para carregamentos de mapa + 187.000 créditos para QPD excedente + 2.044.000 créditos para solicitações ao Places = 3.326.000 créditos