Uso e faturamento da API Places

Sobre máscaras de campo

Para Place Details (novo), Nearby Search (novo) e Text Search (novo), use o cabeçalho FieldMask em solicitações de API para especificar a lista de campos a serem retornados na resposta. Em seguida, você recebe uma cobrança pelo SKU mais alto aplicável à sua solicitação. Isso significa que, se você selecionar campos nas SKUs do Essentials e do Pro, a cobrança será feita com base na SKU do Pro.

Usar mascaramento de campo é uma boa prática de design para garantir que você não solicite dados desnecessários, o que ajuda a evitar tempo de processamento e cobranças desnecessárias.

Sobre as sessões do Autocomplete (novo)

Uma sessão do Autocomplete (novo) inclui uma ou mais solicitações do Autocomplete (novo) e uma solicitação do Place Details (novo) ou da Address Validation. O mesmo token de sessão é transmitido para a solicitação do Autocomplete (novo) e para a solicitação subsequente do Place Details (novo) ou de Address Validation.

Uma sessão começa com a primeira solicitação do Autocomplete (novo). Uma solicitação de Place Details (novo) ou de Address Validation é feita quando o usuário seleciona uma das sugestões do Autocomplete (novo). Se uma sessão for abandonada, ou seja, nenhuma solicitação de Place Details (New) ou Address Validation for feita, as solicitações de Autocomplete (New) serão cobradas como se nenhum token de sessão tivesse sido fornecido.

Depois que o usuário seleciona um lugar (ou seja, faz uma solicitação de Place Details (New) ou de Address Validation), é preciso iniciar uma nova sessão usando um novo token.

Um token é válido para uma sessão e não pode ser usado para mais de uma. Se você reutilizar um token, a sessão será considerada inválida, e as solicitações serão cobradas como se nenhum token de sessão tivesse sido fornecido.

Detalhes e preços da SKU para a API Places

A tabela a seguir mostra os detalhes e os preços da SKU da API Places.

CategoriaDetalhes da SKU da API Places (nova)Preços de SKU
Noções básicas SKU: Autocomplete Requests Lista de preços principal
Lista de preços da Índia
Noções básicas SKU: Autocomplete Session Usage Lista de preços principal
Lista de preços da Índia
Noções básicas SKU: Place Details Essentials (IDs Only) Lista de preços principal
Lista de preços da Índia
Noções básicas SKU: Place Details Essentials Lista de preços principal
Lista de preços da Índia
Noções básicas SKU: Text Search Essentials (IDs Only) Lista de preços principal
Lista de preços da Índia
Pro SKU: Nearby Search Pro Lista de preços principal
Lista de preços da Índia
Pro SKU: Place Details Pro Lista de preços principal
Lista de preços da Índia
Pro SKU: Text Search Pro Lista de preços principal
Lista de preços da Índia
Enterprise SKU: Nearby Search Enterprise Lista de preços principal
Lista de preços da Índia
Enterprise SKU: Pesquisa nas proximidades Enterprise Plus Lista de preços principal
Lista de preços da Índia
Enterprise SKU: Place Details Enterprise Lista de preços principal
Lista de preços da Índia
Enterprise SKU: Place Details Enterprise + Atmosphere Lista de preços principal
Lista de preços da Índia
Enterprise SKU: Text Search Enterprise Lista de preços principal
Lista de preços da Índia
Enterprise SKU: Text Search Enterprise + Atmosphere Lista de preços principal
Lista de preços da Índia
Enterprise SKU: Place Details Photos Lista de preços principal
Lista de preços da Índia
CategoriaDetalhes da SKU da API Places (legada)Preços de SKU
Noções básicas SKU: Autocomplete – por solicitação Lista de preços principal
Lista de preços da Índia
Noções básicas SKU: Autocomplete (incluído no Place Details) – por sessão Lista de preços principal
Lista de preços da Índia
Noções básicas SKU: Basic Data Lista de preços principal
Lista de preços da Índia
Noções básicas SKU: Find Place – somente ID Lista de preços principal
Lista de preços da Índia
Noções básicas SKU: Place Details Essentials – ID Refresh Lista de preços principal
Lista de preços da Índia
Noções básicas SKU: Query Autocomplete – por solicitação Lista de preços principal
Lista de preços da Índia
Pro SKU: Autocomplete sem Place Details – por sessão Lista de preços principal
Lista de preços da Índia
Pro SKU: Find Place Lista de preços principal
Lista de preços da Índia
Pro SKU: Places – Nearby Search Lista de preços principal
Lista de preços da Índia
Pro SKU: Places – Text Search Lista de preços principal
Lista de preços da Índia
Pro SKU: Place Details Pro Lista de preços principal
Lista de preços da Índia
Enterprise SKU: Atmosphere Data Lista de preços principal
Lista de preços da Índia
Enterprise SKU: Contact Data Lista de preços principal
Lista de preços da Índia
Enterprise SKU: Place Photos Lista de preços principal
Lista de preços da Índia

Limites de uso

Para revisar e gerenciar suas cotas e limites de uso, consulte Cotas e alertas de cota.

  • API Places (nova): o limite de taxa por minuto é por método de API por projeto. Isso significa que cada método de API tem uma cota separada.

  • API Places (legada): o limite de taxa por minuto é calculado como a soma das solicitações do lado do cliente e do servidor para todos os aplicativos que usam as credenciais do mesmo projeto.

Ajustar cota

Os limites de cota definem o número máximo de solicitações permitidas para uma API ou um serviço específico em um determinado período. Quando o número de solicitações no seu projeto atinge o limite da cota, o serviço para de responder às solicitações.

Para modificar um valor de cota da sua API, siga estas etapas:

  1. No console do Cloud, navegue até Plataforma Google Maps > Cotas.
  2. Selecione a API para a qual você quer modificar a cota.
  3. Identifique e marque o valor da cota que você quer mudar usando a caixa de seleção.
  4. Clique em Editar, insira um novo valor de cota e clique em Enviar solicitação.

Ver solicitações de aumento de cota

Para ver todas as solicitações de aumento de cota, incluindo as pendentes e anteriores:

  1. No console do Cloud, navegue até Plataforma Google Maps > Cotas.
  2. Selecione a API para a qual você quer ver o pedido de aumento de cota.
  3. Clique em Aumentar solicitações.

Restrições dos Termos de Uso

Para informações sobre os Termos de Uso, consulte as políticas da API Places e a seção Restrições de licença dos Termos de Serviço da Plataforma Google Maps.