Como estimar o uso de créditos da Plataforma Google Maps

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 seguinte formato?
   gme-[company] & proj-[number] ([type])
Se sim, você tem o plano Premium.
Caso contrário, você tem uma licença anterior (API Maps for Work ou API Maps for Business).

Introdução

Com o plano Premium da Plataforma Google Maps, as solicitações para APIs do seu aplicativo 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 seu aplicativo consumirá por ano. Para facilitar os cálculos, use a Calculadora do plano Premium das APIs Maps.

Exemplo 1: mapa de imóveis anunciados

Experiência do usuário

Os corretores imobiliários podem visualizar todos os anúncios ativos da empresa em um mapa no seu site interno. Eles podem 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, o endereço e o tamanho do imóvel e uma imagem do Street View. Na janela de informações, os corretores podem clicar no botão "Como chegar", selecionar o local da imobiliária e ver as rotas até o imóvel.

APIs Maps usadas

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

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 da Web de geocodificação.

Hipóteses de uso dos corretores

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

  • um corretor visualize a janela de informações de 5 imóveis;
  • um corretor solicite rotas para 1 imóvel.

Cálculo dos Maps APIs Credits

Uso de carregamentos de mapa

API Utilização
API Maps JavaScript 1 carregamento de mapa x 3.000 visitantes x 1 crédito = 3.000 créditos
API Street View Static 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 x 365 dias = 2.463.750 créditos por ano

Uso das APIs de serviços da Web

API Utilização
API Geocoding 25.000 geocódigos por dia
API Directions 1 solicitação x 3.000 visitantes = 3.000 consultas

QPD total: 25.000 + 3.000 = 28.000 QPD

O QPD está abaixo do limite diário gratuito de 100.000, por isso não é necessário mais créditos.

Maps APIs Credits anuais necessários

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

Exemplo 2: localizador de lojas

Experiência do usuário

Seu cliente pode usar o localizador de lojas no seu site ou em um aplicativo para dispositivos móveis (Android/iOS) para encontrar até 50 lojas próximas de um local específico. O cliente informa sua localização atual ou o endereço de outro ponto de partida ou 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 apresenta os marcadores das 50 lojas mais próximas a esse 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. Depois, ele pode escolher ver as rotas até a loja.

APIs Maps usadas

API Recursos oferecidos
API Maps JavaScript Exibe o mapa no site
SDKs para dispositivos móveis (Android/iOS) Exibe o mapa em dispositivos móveis
API Street View Static Mostra imagens panorâmicas estáticas (não interativas) na janela de informações
API Geocoding Fornece as coordenadas da loja em latitude/longitude (lat/long) usando sua lista de endereços de loja
API Distance Matrix 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
API Directions Mostra rotas até a loja
Serviços da Web e biblioteca
JavaScript da API Places
  • 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") que o cliente selecionou 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 da Web de geocodificação.
  • Você usa a função de distância do banco de dados para pesquisar todos os endereços geocodificados e encontrar as 50 lojas mais próximas do ponto de partida do visitante.
  • Chama a API Distance Matrix para exibir a distância e o tempo de percurso do ponto de partida até as 50 lojas mais próximas recuperadas pelo 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 pesquise 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 dos Maps APIs Credits

Uso de carregamentos de mapa

API Utilização
API Maps JavaScript 1 carregamento de mapa x 1.000 visitantes x 1 crédito = 1.000 créditos
SDK para dispositivos móveis 1 carregamento de mapa x 1.000 visitantes x 1 crédito = 1.000 créditos
API Street View Static 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 x 365 dias = 1.095.000 créditos necessários por ano

Uso das APIs Maps JavaScript/de serviços da Web

API Utilização
API Geocoding 1.500 geocódigos = 1.500 consultas (por mês)
API Directions 1 solicitação x 2.000 visitantes = 2.000 consultas
API Distance Matrix 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 gratuitos = 2.000 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 API Places

API Utilização
Place Autocomplete na API Places 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 API Places 1 solicitação x 2.000 visitantes x 2 créditos = 4.000 créditos

Uso total da API Places: 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 mapas +187.000 créditos para QPD excedente + 2.0044.000 créditos para solicitações para API Places = 3.326.000 créditos