Uso e faturamento do SDK do Places para Android

Erro: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

O SDK do Places para Android usa um modelo de pagamento por utilização. As solicitações do SDK do Places para Android são faturadas por SKU. Além dos Termos de Uso gerais do Google, existem limites de uso específicos para o SDK do Places para Android. Gerencie seus custos e uso com as ferramentas disponíveis no Console do Google Cloud.

Como o SDK do Places para Android é faturado

O SDK do Places para Android usa o modelo de preços de pagamento por utilização. As APIs e os SDKs da Plataforma Google Maps são cobrados por SKU. O uso é rastreado para cada SKU, e qualquer API ou SDK pode ter mais de uma SKU do produto. O custo é calculado por

uso de SKU × preço por uso

Use nossa calculadora de preços e uso para estimar seu custo de uso por API ou SDK. Para SKUs qualificadas da Plataforma Google Maps, um crédito de US$ 200 está disponível por mês para cada conta de faturamento. Esse crédito é aplicado automaticamente1 às SKUs qualificadas.

Preços do SDK do Places para Android

Sobre as sessões do Autocomplete

Uma sessão do Autocomplete inclui algumas solicitações do Autocomplete (para recuperar sugestões em um local conforme o usuário digita) e, no máximo, uma solicitação do Places Details (para recuperar detalhes sobre o local selecionado pelo usuário). O mesmo token de sessão é transmitido para o Autocomplete e para a próxima solicitação do Place Details. Uma sessão começa com a primeira solicitação do Autocomplete, que geralmente acontece quando o usuário começa a digitar. Uma chamada do Places Details é feita quando o usuário seleciona uma das sugestões do Autocomplete. Se um usuário não escolher uma sugestão, nenhuma chamada do Places Details será feita.

Depois que o usuário seleciona um lugar (ou seja, faz uma chamada do Places Details), é preciso iniciar outra sessão usando um novo token.

As sessões do Autocomplete podem ser geradas nas seguintes APIs:

Um token é válido para uma sessão, ou seja, não deve 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.

As solicitações do Autocomplete e do Places Details que usam sessões são faturadas em diferentes SKUs.

Sobre as SKUs de dados do Places

Uma ou mais SKUs de dados são acionadas em:

  • Android: cada solicitação para fetchPlace() ou findCurrentPlace().
  • iOS: cada chamada para fetchPlaceFromPlaceID: ou findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Serviço Web: cada solicitação do Places, dependendo dos campos especificados na solicitação.

As solicitações de dados geram uma cobrança adicional ao custo da solicitação do Places. As cobranças de dados estão sempre atreladas às solicitações do Places.


SKU: Basic Data

Com o parâmetro "fields" na solicitação do Places Details ou do Find Place, você pode limitar a resposta apenas aos campos especificados. Os campos na categoria Basic estão incluídos no custo base da solicitação do Places e não resultam em outras cobranças. A SKU do Basic Data é acionada quando algum destes campos é solicitado:

Android

Place.Field.ADDRESS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.ID, Place.Field.LAT_LNG, Place.Field.NAME, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT ou Place.Field.UTC_OFFSET

iOS

GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinesssStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode, GMSPlaceFieldTypes ou GMSPlaceFieldViewport

Serviço Web

address_component, adr_address, business_status, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity ou wheelchair_accessible_entrance

FAIXA DE VOLUME MENSAL
(Preço por CHAMADA)
0 a 100.000 100.001 a 500.000 Mais de 500.000
Custo de solicitação do Places
+ US$ 0
Custo de solicitação do Places
+ US$ 0
Custo de solicitação do Places
+ US$ 0

SKU: Contact Data

Com o parâmetro "fields" na solicitação do Place Details ou do Find Place para serviços Web, ou uma matriz de Place.Fields para Android ou iOS, você pode limitar a resposta apenas aos campos especificados. Os campos na categoria Contact geram uma cobrança extra. A SKU Contact Data é acionada quando algum destes campos é solicitado:

Android

Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER ou Place.Field.WEBSITE_URI

iOS

GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber ou GMSPlaceFieldWebsite

Serviço Web

formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours ou website

FAIXA DE VOLUME MENSAL
(Preço por CHAMADA)
0 a 100.000 100.001 a 500.000 Mais de 500.000
Custo de solicitação do Places
+ US$ 0,003 para cada um
(+ US$ 3 para 1.000)
Custo de solicitação do Places
+ US$ 0,0024 para cada um
(+ US$ 2,40 para 1.000)
Entre em contato com a equipe de vendas para saber os preços por volume

SKU: Atmosphere Data

Com o parâmetro fields na solicitação do Places Details ou do Find Place, você pode limitar a resposta apenas aos campos especificados. Os campos da categoria Atmosphere geram uma cobrança extra. A SKU do Atmosphere Data é acionada quando algum destes campos é solicitado:

  • Android:Place.Field.PRICE_LEVEL, Place.Field.RATING ou Place.Field.USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating ou GMSPlaceFieldUserRatingsTotal
  • JavaScript: consulte Campos (Place Details)
  • Serviço Web: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout ou user_ratings_total.
FAIXA DE VOLUME MENSAL
(Preço por CHAMADA)
0 a 100.000 100.001 a 500.000 Mais de 500.000
Custo de solicitação do Places
+ US$ 0,005 para cada um
(+ US$ 5 para 1.000)
Custo de solicitação do Places
+ US$ 0,004 para cada um
(+ US$ 4 para 1.000)
Entre em contato com a equipe de vendas para saber os preços por volume

SKU: Autocomplete – por solicitação

A SKU do Autocomplete – por solicitação é cobrada por qualquer uma destas chamadas ou solicitações que não incluam um token de sessão:

As chamadas feitas em uma sessão inválida do Autocomplete (por exemplo, uma que reutiliza um token de sessão) também são cobradas por uma SKU Autocomplete – por solicitação.

As solicitações de Autocomplete do widget Place Autocomplete da API Maps JavaScript poderão sofrer a cobrança de uma SKU Autocomplete – por solicitação caso essas chamadas sejam feitas em uma sessão inválida do Autocomplete. Isso pode acontecer quando um usuário digita vários endereços diferentes ou copia/cola endereços no widget e nem sempre seleciona uma previsão de preenchimento automático.

FAIXA DE VOLUME MENSAL
(Preço por SOLICITAÇÃO)
0 a 100.000 100.001 a 500.000 Mais de 500.000
US$ 0,00283 para cada um
(US$ 2,83 para 1.000)
US$ 0,00227 para cada um
(US$ 2,27 para 1.000)
Entre em contato com a equipe de vendas para saber os preços por volume

SKU: Autocomplete sem Place Details – por sessão

A SKU do Autocomplete sem Place Details – por sessão é cobrada por uma sessão do Autocomplete que não inclui uma solicitação do Place Details (nos primeiros minutos do início da sessão).

FAIXA DE VOLUME MENSAL
(Preço por SESSÃO)
0 a 100.000 100.001 a 500.000 Mais de 500.000
US$ 0,017 para cada um
(US$ 17 para 1.000)
US$ 0,0136 para cada um
(US$ 13,60 para 1.000)
Entre em contato com a equipe de vendas para saber os preços por volume

Exemplo

Se o aplicativo fizer estas duas chamadas em uma única sessão:

Android

iOS

Serviço Web

Na fatura, você vai ver esta SKU (ao visualizar por SKUs):

  • Autocomplete sem Place Details – por sessão (preço a partir de US$ 0,017 por sessão)

SKU: Autocomplete (incluído no Place Details) – por sessão

A SKU do Autocomplete (incluída no Place Details) – por sessão é cobrada por uma sessão do Autocomplete que inclui:

  • Android: uma chamada para fetchPlace()
  • iOS: uma chamada para fetchPlaceFromPlaceID:
  • Serviço Web: uma solicitação do Place Details

A solicitação do Autocomplete está disponível sem custos financeiros, e a chamada seguinte do Place Details é cobrada com base nos preços normais do Place Details.

Uma solicitação do Place Details gera SKUs de dados (Basic, Contact e/ou Atmosphere), dependendo dos campos especificados na solicitação.

Se você não especificar nenhum campo, todas as SKUs de dados vão ser acionadas (Basic, Contact e Atmosphere).

As solicitações de atualização do ID do Place Details (que especificam apenas o campo place_id) durante uma sessão do Autocomplete são faturadas como SKU: Autocomplete sem Place Details – por sessão.

FAIXA DE VOLUME MENSAL
(Preço por SESSÃO)
0 a 100.000 100.001 a 500.000 Mais de 500.000
US$ 0 US$ 0 US$ 0

Exemplo

Se o aplicativo fizer as três chamadas a seguir em uma única sessão:

Android

iOS

Serviço Web

Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):

  • Autocomplete (incluído no Place Details) – por sessão (cobrança de US$ 0)
  • Place Details (preço a partir de US$ 0,017 por sessão)
  • Basic Data (cobrança de US$ 0)

SKU: Place Details

As chamadas do Place Details são cobradas da seguinte maneira:

FAIXA DE VOLUME MENSAL
(Preço por CHAMADA)
0 a 100.000 100.001 a 500.000 Mais de 500.000
US$ 0,017 para cada um
(US$ 17 para 1.000)
US$ 0,0136 para cada um
(US$ 13,60 para 1.000)
Entre em contato com a equipe de vendas para saber os preços por volume

A SKU do Place Details é gerada com base nestas APIs:

Com a API e os serviços Web, a SKU do Place Details é cobrada independentemente de um token de sessão ser fornecido ou não.

Uma chamada ou solicitação do Place Details também gera SKUs de dados (Basic, Contact e/ou Atmosphere), dependendo dos campos especificados na chamada ou solicitação. Se NENHUM campo for especificado na chamada ou solicitação do Place Details, TODAS as SKUs de dados são acionadas, e cobramos você pela chamada ou solicitação do Places Details mais o custo de todos os dados.

Exemplos

  1. Faça uma destas chamadas ou solicitações:
    • Dispositivos móveis: chame fetchPlace() no Android ou fetchPlaceFromPlaceID: no iOS e especifique apenas o campo ADDRESS
    • API ou serviço Web: faça uma solicitação do Place Details e especifique apenas o campo de endereço: getPlaceDetails(fields: formatted_address)
    Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):
    • Place Details (preço a partir de US$ 0,017 por sessão)
    • Basic Data (cobrança de US$ 0)
  2. Faça uma destas chamadas ou solicitações:
    • Dispositivos móveis: chame fetchPlace() no Android ou fetchPlaceFromPlaceID: no iOS e especifique apenas o campo PHONE_NUMBER
    • API ou serviço Web: faça uma solicitação do Place Details e especifique apenas o campo de número de telefone: getPlaceDetails(fields: formatted_phone_number)
    Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):
    • Place Details (preço a partir de US$ 0,017 por sessão)
    • Contact Data (preço a partir de US$ 0,003 por solicitação)
  3. Faça uma destas chamadas ou solicitações:
    • Dispositivos móveis: chame fetchPlace() no Android ou fetchPlaceFromPlaceID: no iOS e especifique todos os campos
    • API ou serviço Web: faça uma solicitação do Place Details e especifique todos os campos. Esse tipo de solicitação é o padrão caso nenhum campo seja definido: getPlaceDetails().
    Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):
    • Place Details (preço a partir de US$ 0,017 por sessão)
    • Basic Data (cobrança de US$ 0)
    • Contact Data (preço a partir de US$ 0,003 por solicitação)
    • Atmosphere Data (a partir de US$ 0,005 por solicitação)

SKU: Find Current Place

O serviço Find Current Place é cobrado pelas chamadas para findCurrentPlace() (Android) ou findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

FAIXA DE VOLUME MENSAL
(Preço por CHAMADA)
0 a 100.000 100.001 a 500.000 Mais de 500.000
US$ 0,030 para cada um
(US$ 30 para 1.000)
US$ 0,024 para cada um
(US$ 24 para 1.000)
Entre em contato com a equipe de vendas para saber os preços por volume

As chamadas para findCurrentPlace() (Android) ou findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) também geram SKUs de dados (Basic ,Contact e/ou Atmosphere), dependendo dos campos especificados na chamada. Especifique os campos de dados para limitar a resposta somente a eles. A cobrança é feita pela chamada e pelos dados solicitados.

Exemplos

  1. Você chama findCurrentPlace() (Android) ou findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) e especifica apenas o campo ADDRESS. Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):
    • Find Current Place (a partir de US$ 0,03 por solicitação)
    • Basic Data (cobrança de US$ 0)
  2. Você chama findCurrentPlace() (Android) ou findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) e especifica o campo PHONE_NUMBER. Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):
    • Find Current Place (a partir de US$ 0,03 por solicitação)
    • Contact Data (preço a partir de US$ 0,003 por solicitação)
  3. Você chama findCurrentPlace() (Android) ou findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) e especifica campos dos três buckets de tipo de dados: Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):
    • Find Current Place (a partir de US$ 0,03 por solicitação)
    • Basic Data (cobrança de US$ 0)
    • Contact Data (preço a partir de US$ 0,003 por solicitação)
    • Atmosphere Data (a partir de US$ 0,005 por solicitação)

SKU: Place Photo

Uma SKU do Places Photo é cobrada por:

No serviço JavaScript, invocar o método PlacePhoto.getUrl() não gera cobranças até que o URL seja realmente usado para coletar dados de pixels.

FAIXA DE VOLUME MENSAL
(Preço por CHAMADA)
0 a 100.000 100.001 a 500.000 Mais de 500.000
US$ 0,007 para cada um
(US$ 7 para 1.000)
US$ 0,0056 para cada um
(US$ 5,60 para 1.000)
Entre em contato com a equipe de vendas para saber os preços por volume

Restrições dos Termos de Uso

Para informações sobre os Termos de Uso, consulte a seção Restrições de licença dos Termos de Serviço da Plataforma Google Maps.

Gerenciar seu custo de uso

Para gerenciar seu custo de uso das APIs da Plataforma Google Maps, defina limites de cota diários em todas as solicitações de qualquer API faturável. As cotas diárias são zeradas à meia-noite do fuso horário do Pacífico.

Para ver ou alterar limites de cota do SDK do Places para Android:

  1. No Console do Cloud, abra a página Cotas da Plataforma Google Maps.
  2. Clique no menu suspenso de APIs e selecione o SDK do Places para Android.
  3. Para ver os limites de cota, role a tela para baixo até o card Solicitações.
    Os nomes e limites de cota são exibidos em uma tabela.
  4. Para mudar um limite, clique no ícone Editar.
    Na caixa de diálogo exibida, no campo Limite de cota, insira o limite de cota diária faturável desejado (até o máximo especificado pelo Google, se houver) e clique em Salvar.

Se o seu uso da API atingir a cota faturável, o aplicativo não vai poder acessar a API durante o restante do dia.


  1. Os usuários na Índia precisam criar uma conta de faturamento do Google Cloud Platform antes de criar uma para receber o crédito da Plataforma Google Maps.