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 nas solicitações de API para especificar a lista de campos a serem retornados na resposta. Em seguida, você receberá a cobrança da SKU mais alta aplicável à sua solicitação. Isso significa que, se você selecionar campos nas SKUs Essentials e Pro, a cobrança será feita com base na SKU Pro.

O uso de máscaras 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 de Address Validation. O mesmo token de sessão é transmitido para a solicitação do Autocomplete (novo) e para a solicitação do Place Details (novo) ou de Address Validation subsequente.

Uma sessão começa com a primeira solicitação do Autocomplete (novo). Uma solicitação do Place Details (novo) ou do 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 do Place Details (novo) ou de Address Validation for feita, as solicitações do Autocomplete (novo) 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 do Place Details (novo) ou de Address Validation), é preciso iniciar uma nova sessão usando um novo token de sessão.

Um token de sessão é válido para uma sessão e não pode ser usado para mais de uma sessão. 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 da SKU e preços da API Places

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

CategoriaDetalhes da SKU da API Places (nova)Preços da SKU
Noções básicas SKU: solicitações do Autocomplete Lista de preços principal
Lista de preços da Índia
Noções básicas SKU: uso da sessão do Autocomplete Lista de preços principal
Lista de preços da Índia
Noções básicas SKU: Place Details Essentials (somente IDs) 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 (somente IDs) 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: Nearby Search Enterprise + Atmosphere 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 da 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 (com Place Details) – por sessão Lista de preços principal
Lista de preços da Índia
Noções básicas

SKU: Basic Data

Cobranças adicionais:

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 – atualização de ID 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

Cobranças adicionais:

Lista de preços principal
Lista de preços da Índia
Pro

SKU: Places – Nearby Search

Cobranças adicionais:

Lista de preços principal
Lista de preços da Índia
Pro

SKU: Places – Text Search

Cobranças adicionais:

Lista de preços principal
Lista de preços da Índia
Pro

SKU: Places Details

Cobranças adicionais:

Lista de preços principal
Lista de preços da Índia
Enterprise

SKU: Atmosphere Data

Cobranças adicionais:

Lista de preços principal
Lista de preços da Índia
Enterprise

SKU: Contact Data

Cobranças adicionais:

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 lado 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 serviço específico em um determinado período. Quando o número de solicitações no seu projeto atinge o limite de cota, o serviço para de responder a solicitações.

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

  1. No console do Cloud, acesse Plataforma Google Maps > Cotas.
  2. Selecione a API para a qual você quer modificar a cota.
  3. Identifique o valor da cota que você quer mudar e selecione-o 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 anteriores e pendentes:

  1. No console do Cloud, acesse Plataforma Google Maps > Cotas.
  2. Selecione a API para a qual você quer visualizar a solicitação de aumento de cota.
  3. Clique em Solicitações de aumento.

Restrições dos Termos de Uso

Para mais 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.