Uso e faturamento do SDK do Places para iOS

Lembrete:para usar o SDK do Places para iOS, é necessário incluir uma chave de API em todas as solicitações de API e ativar o faturamento em cada um dos seus projetos.

Erro: kGMSPlacesRateLimitExceeded

Aviso:se o app iOS estiver apresentando erros kGMSPlacesRateLimitExceeded, talvez você esteja usando uma versão descontinuada da API Places. A versão 2.7.0 da API Places foi descontinuada em 29 de janeiro de 2019 e desativada em 29 de julho de 2019. Uma nova versão da API Places está disponível. Recomendamos que você atualize para a nova versão assim que possível. Para mais detalhes, consulte o guia de migração.

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

Como o SDK do Places para iOS é faturado

O SDK do Places para iOS versão 8.5.0 oferece suporte a duas versões do SDK: o SDK do Places para iOS atual e o SDK do Places para iOS (novo), a versão da próxima geração do SDK. Para saber as principais diferenças entre as duas versões do SDK, consulte Escolher a versão do SDK.

A versão do SDK escolhida controla os preços dos detalhes do lugar e da pesquisa de texto. Para informações detalhadas sobre preços, consulte Preços do SDK do Places para iOS (novo) e Preços do SDK do Places para iOS.

O preço do Place Autocomplete, do Current Place e do Place Photos é o mesmo para os dois SDKs.

O SDK do Places para iOS (novo) e o SDK do Places para iOS usam um modelo de preços de pagamento por uso. 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 automaticamente aos SKUs qualificados.

Observação: a oferta de crédito mensal de US $200 da Plataforma Google Maps é válida até 28 de fevereiro de 2025, às 23h59 (horário local). A partir de 1º de março de 2025, o crédito de US $200 será substituído por um limite de uso sem custo financeiro para cada API. Para mais informações, consulte as Perguntas frequentes.

Preços do SDK do Places para iOS (novo)

Sobre as máscaras de campo

Use máscaras de campo, também chamadas de listas de campos, nas suas solicitações para especificar a lista de campos a serem retornados na resposta. A cobrança será feita com a SKU mais alta aplicável ao seu pedido. Isso significa que, se você selecionar campos na SKU (básica) e na SKU (avançada), o faturamento será baseado na SKU (avançada).

Usar uma máscara 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.

Observação : os tokens de sessão podem se sobrepor entre projetos, mas precisam ser exclusivos para cada projeto. Por exemplo, um app que usa o Projeto A e outro que usa o Projeto B podem usar o mesmo token de sessão, mas vários apps que usam o Projeto A não podem usar o mesmo 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. 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.

SKU: solicitações de preenchimento automático

Uma SKU de solicitações do Autocomplete é cobrada para cada solicitação da API Autocomplete (nova) que não inclui um token de sessão.

Também será cobrada se você usar tokens de sessão e:

• Encerrar as sessões com uma única solicitação para o Place Details (New), que solicita todos os campos definidos pela SKU: Place Details (Only Location).
  • Cada solicitação do Autocomplete (novo), até 12 solicitações, é faturada usando a SKU: solicitações do Autocomplete.
  • Cada solicitação de Autocomplete (novo) subsequente é faturada usando a SKU: uso da sessão do Autocomplete.
  Observação: se você fizer uma chamada para SKU: Address Validation Preferred antes que o token de sessão expire, a chamada SKU: Place Details (Only Location) não será cobrada e sua sessão será faturada com base na SKU: Autocomplete Session Usage.
• Abandone ou encerre a sessão fazendo uma chamada para a SKU: Place Details (Only IDs). Todas as solicitações do Autocomplete (New) são faturadas usando a SKU: Autocomplete Requests.

FAIXA DE VOLUME MENSAL (Preço por CHAMADA)
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: uso da sessão do Autocomplete

Uma SKU do Uso da sessão do Autocomplete é cobrada para cada solicitação à API Autocomplete (nova) que inclui um token de sessão.

Essa SKU é cobrada nestes cenários:

• Sessão de preenchimento automático encerrada por uma chamada para SKU: Place Details (Only Location):

  • Cada solicitação do Autocomplete (novo), até 12 solicitações, é faturada usando a SKU: solicitações do Autocomplete.
  • Cada solicitação de Autocomplete (novo) subsequente é faturada usando a SKU: uso da sessão do Autocomplete.

• A sessão de preenchimento automático foi encerrada com uma chamada para SKU: Place Details (Basic, Advanced, or Preferred).

  Uma chamada do Place Details que solicita qualquer campo da SKU: Place Details (Basic, Advanced ou Preferred) é faturada na SKU: Place Details (Preferred).

• A sessão do Autocomplete foi encerrada com uma chamada para SKU: Address Validation Preferred.

  Observação: se você fizer uma chamada para SKU: Place Details (Only Location) e depois para SKU: Address Validation Preferred antes do vencimento do token de sessão, a chamada SKU: Place Details (Only Location) não será cobrada, e sua sessão será faturada apenas pela chamada para SKU: Address Validation Preferred.

Para mais informações, consulte Preenchimento automático (novo) e preços de sessão.

FAIXA DE VOLUME MENSAL (Preço por CHAMADA)
0 a 100.000	100.001 a 500.000	Mais de 500.000
US$ 0,00 para cada um (US$ 0,00 para 1.000)	US$ 0,00 para cada um (US$ 0,00 para 1.000)	US$ 0,00 para cada um (US$ 0,00 para 1.000)

---

SKU: Place Details (somente IDs)

Observação:se você selecionar campos da SKU "Place Details (Only Location)", o faturamento será feito nessa taxa. Se você selecionar campos da SKU Place Details (Basic), o faturamento será feito nessa taxa. Se você selecionar campos da SKU "Detalhes do lugar (avançado)", o faturamento será feito nessa taxa. Se você selecionar campos da SKU de detalhes do lugar (preferencial), o faturamento será feito nessa taxa.

Com uma máscara de campo ou uma lista de campos na solicitação do Place Details (New), você pode limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você somente solicita os seguintes campos:

iOS: GMSPlacePropertyPlaceID, GMSPlacePropertyName, GMSPlacePropertyPhotos

FAIXA DE VOLUME MENSAL (Preço por CHAMADA)
0 a 100.000	100.001 a 500.000	Mais de 500.000
US$ 0,00 para cada um (US$ 0,00 para 1.000)	US$ 0,00 para cada um (US$ 0,00 para 1.000)	US$ 0,00 para cada um (US$ 0,00 para 1.000)

---

SKU: Place Details (somente localização)

Observação:se você selecionar campos da SKU "Detalhes do lugar (básico)", o faturamento será feito nessa taxa. Se você selecionar campos da SKU "Detalhes do lugar (avançado)", o faturamento será feito nessa taxa. Se você selecionar campos da SKU "Detalhes do lugar (preferencial)", o faturamento será feito nessa taxa.

Com uma máscara de campo ou uma lista de campos na solicitação do Place Details (New), você pode limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você somente solicita os seguintes campos:

iOS: GMSPlacePropertyAddressComponents, GMSPlacePropertyFormattedAddress, GMSPlacePropertyCoordinate, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyViewport

FAIXA DE VOLUME MENSAL (Preço por CHAMADA)
0 a 100.000	100.001 a 500.000	Mais de 500.000
US$ 0,005 para cada um (US$ 5 para 1.000)	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: Place Details (Básico)

Observação:se você selecionar campos da SKU "Detalhes do lugar (avançado)", o faturamento será feito nessa taxa. Se você selecionar campos da SKU "Detalhes do lugar (preferencial)", o faturamento será feito nessa taxa.

Com uma máscara de campo ou uma lista de campos na solicitação do Place Details (New), você pode limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você somente solicita os seguintes campos:

iOS: GMSPlacePropertyBusinessStatus, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyWheelchairAccessibleEntrance

FAIXA DE VOLUME MENSAL (Preço por CHAMADA)
0 a 100.000	100.001 a 500.000	Mais de 500.000
US$ 0,0170 para cada (US$ 17,00 por 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

---

SKU: Place Details (Avançado)

Observação:se você selecionar qualquer campo da SKU "Detalhes do lugar (preferencial)", o faturamento será feito nessa taxa.

Com uma máscara de campo ou uma lista de campos na solicitação do Place Details (New), você pode limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você somente solicita os seguintes campos:

iOS: GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours, GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel, GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

FAIXA DE VOLUME MENSAL (Preço por CHAMADA)
0 a 100.000	100.001 a 500.000	Mais de 500.000
US$ 0,020 para cada (US$ 20,00 para 1.000)	US$ 0,016 para cada um (US$ 16 para 1.000)	Entre em contato com a equipe de vendas para saber os preços por volume

---

SKU: Place Details (Preferencial)

Com uma máscara de campo ou uma lista de campos na solicitação do Place Details (New), você pode limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você somente solicita os seguintes campos:

iOS: GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

FAIXA DE VOLUME MENSAL (Preço por CHAMADA)
0 a 100.000	100.001 a 500.000	Mais de 500.000
US$ 0,025 para cada um (US$ 25,00 para 1.000)	US$ 0,020 para cada (US$ 20,00 para 1.000)	Entre em contato com a equipe de vendas para saber os preços por volume

---

SKU: Pesquisa por proximidade (básico)

Observação:se você selecionar campos da SKU de Pesquisa nas proximidades (avançada), o faturamento será feito com base nessa taxa. Se você selecionar campos do SKU de pesquisa por proximidade (preferencial), o faturamento será feito nessa taxa.

Usando uma máscara de campo ou uma lista de campos na sua solicitação de pesquisa por proximidade (nova), você pode limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você somente solicita os seguintes campos:

iOS: GMSPlacePropertyAddressComponents, GMSPlacePropertyBusinessStatus, GMSPlacePropertyCoordinate, GMSPlacePropertyFormattedAddress, GMSPlacePropertyName, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyPhotos, GMSPlacePropertyPlaceID, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyViewport, GMSPlacePropertyWheelchairAccessibleEntrance

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

---

SKU: Pesquisa por proximidade (avançado)

Observação:se você selecionar campos da SKU de pesquisa por proximidade (preferencial), o faturamento será feito nessa taxa.

Usando uma máscara de campo ou uma lista de campos na sua solicitação de pesquisa por proximidade (nova), você pode limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você somente solicita os seguintes campos:

iOS: GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours, GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel, GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

FAIXA DE VOLUME MENSAL (Preço por CHAMADA)
0 a 100.000	100.001 a 500.000	Mais de 500.000
US$ 0,035 para cada (US$ 35,00 para 1.000)	US$ 0,028 para cada (US$ 28,00 para 1.000)	Entre em contato com a equipe de vendas para saber os preços por volume

---

SKU: Pesquisa nas proximidades (preferencial)

Usando uma máscara de campo ou uma lista de campos na sua solicitação de pesquisa por proximidade (nova), você pode limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você somente solicita os seguintes campos:

iOS: GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

FAIXA DE VOLUME MENSAL (Preço por CHAMADA)
0 a 100.000	100.001 a 500.000	Mais de 500.000
US$ 0,040 para cada (US$ 40,00 para 1.000)	US$ 0,032 para cada um (US$ 32 para 1.000)	Entre em contato com a equipe de vendas para saber os preços por volume

---

SKU: Text Search (somente ID)

Observação:se você selecionar campos da SKU de pesquisa de texto (básico), o faturamento será feito nessa taxa. Se você selecionar campos da SKU de pesquisa de texto (avançada), o faturamento será feito com base nessa taxa. Se você selecionar campos da SKU de pesquisa de texto (preferencial), o faturamento será feito com base nessa taxa.

Usando uma máscara de campo ou uma lista de campos na solicitação de pesquisa de texto (nova), você pode limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você somente solicita os seguintes campos:

iOS: GMSPlacePropertyPlaceID, GMSPlacePropertyName

FAIXA DE VOLUME MENSAL (Preço por CHAMADA)
0 a 100.000	100.001 a 500.000	Mais de 500.000
US$ 0,00 para cada um (US$ 0,00 para 1.000)	US$ 0,00 para cada um (US$ 0,00 para 1.000)	US$ 0,00 para cada um (US$ 0,00 para 1.000)

---

SKU: Text Search (Básico)

Observação:se você selecionar campos da SKU de pesquisa de texto (avançada), o faturamento será feito com base nessa taxa. Se você selecionar campos da SKU de pesquisa de texto (preferencial), a cobrança será feita nessa taxa.

Usando uma máscara de campo ou uma lista de campos na solicitação de pesquisa de texto (nova), você pode limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você somente solicita os seguintes campos:

iOS: GMSPlacePropertyAddressComponents, GMSPlacePropertyBusinessStatus, GMSPlacePropertyFormattedAddress, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyCoordinate, GMSPlacePropertyPhotos, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyViewport, GMSPlacePropertyWheelchairAccessibleEntrance

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

---

SKU: Text Search (Avançado)

Observação:se você selecionar campos da SKU de pesquisa de texto (preferencial), o faturamento será feito nessa taxa.

Usando uma máscara de campo ou uma lista de campos na solicitação de pesquisa de texto (nova), você pode limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você somente solicita os seguintes campos:

iOS: GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours, GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel, GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

FAIXA DE VOLUME MENSAL (Preço por CHAMADA)
0 a 100.000	100.001 a 500.000	Mais de 500.000
US$ 0,035 para cada (US$ 35,00 para 1.000)	US$ 0,028 para cada (US$ 28,00 para 1.000)	Entre em contato com a equipe de vendas para saber os preços por volume

---

SKU: Text Search (Preferencial)

Usando uma máscara de campo ou uma lista de campos na solicitação de pesquisa de texto (nova), você pode limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você somente solicita os seguintes campos:

iOS: GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

FAIXA DE VOLUME MENSAL (Preço por CHAMADA)
0 a 100.000	100.001 a 500.000	Mais de 500.000
US$ 0,040 para cada (US$ 40,00 para 1.000)	US$ 0,032 para cada um (US$ 32 para 1.000)	Entre em contato com a equipe de vendas para saber os preços por volume

---

SKU: Place Photo

Uma SKU do Places Photo é cobrada para cada solicitação à API.

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

---

Preços do SDK do Places para iOS

Os preços a seguir são da página de preços da Plataforma Google Maps. Para a Índia, consulte a página de preços da Índia.

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:

• O serviço Place Autocomplete da API Places ou o serviço Place Autocomplete da API Maps JavaScript. Você precisa criar seu aplicativo para que ele ofereça tokens de sessão. Talvez seja necessário mudar o código atual.
• O widget do Autocomplete da API Maps JavaScript. O faturamento com base em sessões é ativado nesses widgets automaticamente, sem a necessidade de mudança no código.

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

Os três tipos de SKUs do Places são: Basic Data, Contact Data e Atmosphere Data.

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 SKUs de dados são sempre cobradas além da SKU da solicitação que as aciona. Por exemplo, uma solicitação do Place Details que inclui campos de dados básicos será cobrada no nível da SKU Basic Data e da SKU Place Details.

---

SKU: Basic Data

Observação: essa é uma SKU de dados cobrada além da SKU da solicitação que a acionou.

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 Basic Data é acionada quando algum destes campos é solicitado:

• Android:Place.Field.ACCESSIBILITY_OPTIONS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_MASK_URL, Place.Field.ID, Place.Field.LOCATION, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT ou Place.Field.UTC_OFFSET.
Observação:os campos Place.Field.ADDRESS, Place.Field.ICON_URL, Place.Field.LAT_LNG, Place.Field.NAME e Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE foram descontinuados na versão 4.0 do SDK do Places para Android. Use Place.Field.FORMATTED_ADDRESS, Place.Field.ICON_MASK_URL, Place.Field.LOCATION, Place.Field.DISPLAY_NAME e Place.ACCESSIBILITY_OPTIONS, respectivamente. Place.Field.ACCESSIBILITY_OPTIONS está disponível apenas para "Detalhes do lugar (novo)".
• iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode, GMSPlaceFieldTypes ou GMSPlaceFieldViewport
• Serviço da 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

Observação: essa é uma SKU de dados cobrada além da SKU da solicitação que a acionou.

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.CURRENT_OPENING_HOURS, Place.Field.INTERNATIONAL_PHONE_NUMBER, Place.Field.OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS ou Place.Field.WEBSITE_URI
Observação:o campo Place.Field.PHONE_NUMBER foi descontinuado na versão 4.0 do SDK do Places para Android. Em vez dela, use Place.Field.INTERNATIONAL_PHONE_NUMBER.
• 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

Observação: essa é uma SKU de dados cobrada além da SKU da solicitação que a acionou.

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.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.EDITORIAL_SUMMARY, Place.Field.DINE_IN, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.RESERVABLE, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT ou Place.Field.USER_RATING_COUNT
  
  Observação:o campo Place.Field.USER_RATINGS_TOTAL foi descontinuado na versão 4.0 do SDK do Places para Android. Use Place.Field.USER_RATING_COUNT.
• iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch ou GMSPlaceFieldServesVegetarianFood
• 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:

• Android: findAutocompletePredictions()
• iOS: findAutocompletePredictionsFromQuery:
• JavaScript: o serviço Place Autocomplete da API Maps JavaScript
• Serviço Web: o serviço Place Autocomplete da API Places

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 without Place Details – Per Session é 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

• findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))

iOS

• placesClient?.findAutocompletePredictions(fromQuery: "par" …
• placesClient?.findAutocompletePredictions(fromQuery: "paris" …

Serviço Web

• Solicitação do Place Autocomplete (input="par", session_token: XYZ)
• Solicitação do Place Autocomplete (input="paris", session_token: XYZ)

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

Observação: a SKU aparece nos relatórios de faturamento, mas não na página Faturamento > Preço no console do Google Cloud.

A SKU do Autocomplete (incluído 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 without Place Details – Per Session.

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

• findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
• fetchPlace() (com um FetchPlaceRequest, incluindo o ID do lugar e o campo ADDRESS)

iOS

• placesClient?.findAutocompletePredictions(fromQuery: "par" …
• placesClient?.findAutocompletePredictions(fromQuery: "paris" …
• fetchPlaceFromPlaceID: (incluindo o ID do lugar e o campo GMSPlaceFieldFormattedAddress)

Serviço Web

• Solicitação do Places Autocomplete (input="par", session_token: XYZ)
• Solicitação do Places Autocomplete (input="paris", session_token: XYZ)
• Places Details (place_id, session_token: XYZ, fields:formatted_address)

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: Places Details

As chamadas do Places 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 Places Details é gerada com base nestas APIs:

• Android: SDK do Places para Android (fetchPlace())
• iOS: SDK do Places para iOS (fetchPlaceFromPlaceID:)
• JavaScript: serviço Place Details da API Maps JavaScript (getDetails)
• JavaScript: widget Place Autocomplete da API Maps JavaScript (getPlace)
• JavaScript: widget Place SearchBox da API Maps JavaScript: método getPlaces() depois que o usuário seleciona um resultado de lugar (ícone: alfinete), *não* uma consulta (ícone: lupa), conforme ilustrado aqui:

  

  Nos resultados do widget da caixa de pesquisa, depois de digitar "pizza" na caixa de pesquisa, observe que a Pizza Autentico tem um ícone de alfinete ao lado dela, indicando que é um resultado de lugar (não uma consulta).

• Serviço Web: serviço Place Details da API Places

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 os campos NÃO forem especificados na chamada ou solicitação do Place Details, TODAS as SKUs de dados serão acionadas, e você vai receber a cobrança pela chamada ou solicitação do Place 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: Places Photo

Uma SKU do Places Photo é cobrada por:

• Android: chamadas para fetchPhoto()
• iOS: chamadas para loadPlacePhoto:
• JavaScript: para a biblioteca Places e o serviço Place Photos da API Maps JavaScript ao solicitar dados dos URLs retornados por PlacePhoto.getUrl() para carregar dados de pixels de imagem
• Serviço Web: solicitações para o serviço Place Photos da API Places

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

---

Outros limites de uso

Não existe um número máximo de solicitações por dia. Mesmo assim, o limite de uso a seguir ainda se aplica ao usar o SDK do Places para iOS:

• O limite de taxa é de 6.000 QPM (solicitações por minuto). Ele é 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 detalhes 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 do SDK do Places para iOS ou atender à demanda do tráfego de produção, defina limites diários de cota em todas as solicitações de qualquer API. As cotas diárias são zeradas à meia-noite do fuso horário do Pacífico.

Observação: só é possível definir limites diários de cota faturável em APIs passíveis de cobrança. Se o projeto não usa APIs faturáveis, não é possível definir limites diários.

Para conferir ou mudar os limites de cota do SDK do Places para iOS:

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 iOS.
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.

Recursos de gerenciamento de custos relacionados

• Faturamento e preços da Plataforma Google Maps
• Geração de relatórios e monitoramento da Plataforma Google Maps

---