Uso e faturamento da API Places

Sobre as 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. A cobrança será feita pela SKU mais alta aplicável à sua solicitação. Isso significa que, se você selecionar campos nas SKUs Essentials e Pro, o faturamento será baseado na SKU Pro.

O uso do 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ça desnecessários.

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 do 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 da Validação de endereço subsequente.

Uma sessão começa com a primeira solicitação de Autocomplete (Nova). Uma solicitação de Place Details (New) ou de Address Validation é feita quando o usuário seleciona uma das sugestões do Autocomplete (New). Se uma sessão for abandonada, ou seja, se nenhuma solicitação de Place Details (New) ou de 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 detalhes do lugar (novo) ou de validação de endereço), é preciso iniciar uma nova sessão usando um novo token.

Um token de sessão é 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 de SKUs 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: Uso da sessão de preenchimento automático 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 (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: 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 – 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 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

Outros 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. Ou seja, cada método de API tem uma cota separada.

  • API Places: 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.

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.