Uso e faturamento da API Places

A API Places (nova) usa um modelo de precificação de pagamento por uso. As solicitações da API Places (nova) e da API Places geram chamadas para qualquer uma das várias SKUs. Além dos Termos de Uso gerais do Google, existem limites de uso específicos para a API Places. Gerencie seus custos e uso com as ferramentas disponíveis no console do Google Cloud.

Como é feita a cobrança da API Places

A API Places (nova) usa um modelo 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.

Preços da API Places (nova)

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 na SKU (básica) e na SKU (avançada), o faturamento será feito com base na SKU (avançada).

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.

SKU: Solicitações de Autocomplete

Uma SKU Autocomplete Requests é cobrada por cada solicitação para a API Autocomplete (New) 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) é faturada usando a SKU: uso da sessão do Autocomplete.
  • Abandone ou encerre a sessão fazendo uma chamada para a SKU: Place Details (Only IDs). Todas as solicitações de 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) é 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.

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)

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:

Serviço da Web: attributions
id
name*
photos

* O campo name contém o nome do recurso do lugar no formato: places/PLACE_ID. Use displayName para acessar o nome do lugar.

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 (Only Location)

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:

Serviço da Web: addressComponents
adrFormatAddress
formattedAddress
location
plusCode
shortFormattedAddress
types
viewport

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)

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:

Serviço da Web: accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks*
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
utcOffsetMinutes

* O campo googleMapsLinks está na fase de pré-lançamento da GA e não há cobrança, ou seja, o faturamento é de US $0,00, para uso durante a fase de pré-lançamento.

Se uma sessão do Autocomplete for encerrada por uma chamada do Place Details que solicita qualquer campo da SKU: Place Details (Basic, Advanced ou Preferred), a chamada será faturada em SKU: Place Details (Preferred). Para mais informações, consulte SKU: Uso da sessão de preenchimento automático.

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)

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:

Serviço da Web: currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
userRatingCount
websiteUri

Se uma sessão do Autocomplete for encerrada por uma chamada do Place Details que solicita qualquer campo da SKU: Place Details (Basic, Advanced ou Preferred), a chamada será faturada em SKU: Place Details (Preferred). Para mais informações, consulte SKU: Uso da sessão de preenchimento automático.

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:

Serviço da Web: allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeOptions
fuelOptions
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
routingSummaries*
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout

* Somente Pesquisa de texto e Pesquisa por proximidade

Se uma sessão do Autocomplete for encerrada por uma chamada do Place Details que solicita qualquer campo da SKU: Place Details (Basic, Advanced ou Preferred), a chamada será faturada em SKU: Place Details (Preferred). Para mais informações, consulte SKU: Uso da sessão de preenchimento automático.

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)

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:

Serviço da Web: places.accessibilityOptions
places.addressComponents
places.adrFormatAddress
places.attributions
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks*
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.id
places.location
places.name**
places.photos
places.plusCode
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* O campo places.googleMapsLinks está na fase de pré-lançamento da GA e não há cobrança, ou seja, o faturamento é de US $0, para uso durante a fase de pré-lançamento.

** O campo places.name contém o nome do recurso do lugar no formato: places/PLACE_ID. Use places.displayName para acessar o nome do lugar.

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)

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:

Serviço da Web: places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

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:

Serviço da Web: places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeOptions
places.fuelOptions
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.routingSummaries*
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout

* Somente Pesquisa de texto e Pesquisa por proximidade

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)

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:

Serviço da Web: places.attributions
places.id
places.name*
nextPageToken

* O campo places.name contém o nome do recurso do lugar no formato: places/PLACE_ID. Use places.displayName para acessar o nome do lugar.

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)

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:

Serviço da Web: places.accessibilityOptions
places.addressComponents
places.adrFormatAddress
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks*
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.location
places.photos
places.plusCode
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* O campo places.googleMapsLinks está na fase de pré-lançamento da GA e não há cobrança, ou seja, o faturamento é de US $0,00, para uso durante a fase de pré-lançamento.

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 de texto (avançada)

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:

Serviço da Web: places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

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:

Serviço da Web: places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeOptions
places.fuelOptions
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.routingSummaries*
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout

* Somente Pesquisa de texto e Pesquisa por proximidade

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 da API Places

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, depois que uma chamada do Places Details é feita), é preciso iniciar uma nova sessão usando um novo token.

As sessões do Autocomplete podem ser geradas a partir das seguintes APIs:

Um token de sessão é válido para uma sessão de usuário e 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.

Para o serviço da Web, estas solicitações das APIs do Places permitem especificar os campos de dados que serão retornados:

Para o serviço Web, as seguintes chamadas das APIs do Places NÃO permitem especificar os campos retornados. Essas chamadas sempre retornam todos os dados do Places, cobrando as três SKUs de dados do Places, além da cobrança de cada solicitação de API:

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

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

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 podem sofrer a cobrança de uma SKU do Autocomplete – Por solicitação caso essas chamadas sejam feitas em uma sessão 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

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í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

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: Query Autocomplete – por solicitação

Uma SKU do Query Autocomplete – por solicitação é cobrada para cada solicitação de:

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

O preço por sessão do Autocomplete não é aplicado com o Query Autocomplete. As chamadas seguintes do Places Details são cobradas com base nos preços normais do Places Details.

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:

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

Use a solicitação do Place Details para atualizar os IDs de lugares desatualizados. Esses tipos de solicitações estão disponíveis sem custos financeiros.

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

Exemplo

Você faz uma solicitação do Places Details especificando apenas o campo de ID do lugar: getPlaceDetails(fields: place_id). Na fatura, você vai ver esta SKU (ao visualizar por SKUs):

  • Places Details – atualização de ID (cobrança de US$ 0)

SKU: Find Place

O serviço Find Place é cobrado por uma solicitação.

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

Uma solicitação do Find Place também gera SKUs de dados (Basic, Contact e/ou Atmosphere), dependendo dos campos especificados na solicitação. Assim como nas solicitações do Place Details, é possível usar o parâmetro "fields" na solicitação do Find Place para limitar a resposta apenas aos campos especificados. A cobrança é feita pela solicitação e pelos dados solicitados. Por padrão, se os campos NÃO forem solicitados, somente o ID do lugar vai ser retornado. Portanto, não haverá outras cobranças de dados.

Exemplos

  1. Você faz uma solicitação do Find Place e especifica apenas o campo de endereço: FindPlace(fields: formatted_address). Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):
    • Find Place (a partir de US$ 0,017 por chamada)
    • Basic Data (cobrança de US$ 0)
  2. Você faz uma solicitação do Find Place e especifica o campo de número de telefone: FindPlace(fields: formatted_phone_number). Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):
    • Find Place (a partir de US$ 0,017 por chamada)
    • Contact Data (preço a partir de US$ 0,003 por solicitação)
  3. Você faz uma solicitação do Find Place e especifica campos dos três buckets de tipo de dados: FindPlace(fields: formatted_address, opening_hours, price_level). Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):
    • Find Place (a partir de US$ 0,017 por chamada)
    • 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 Place – somente ID

O serviço Find Place – somente ID é cobrado pelas solicitações do Find Place que especificam apenas o ID do lugar que será retornado. Por padrão, se nenhum campo for especificado na solicitação do Find Place, somente o ID do lugar vai ser retornado.

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

Exemplo

Você faz uma solicitação do Find Place e especifica apenas o campo place_id: FindPlace(fields: place_id). Na fatura, você vai ver esta SKU (ao visualizar por SKUs):

  • Find Place – somente ID (cobrança de US$ 0)

O serviço Places – Nearby Search é cobrado nas solicitações para o serviço Place Nearby Search da API Maps JavaScript (nearbySearch()) ou para o serviço Nearby Search da API Places.

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

As solicitações do Nearby Search retornam uma lista de lugares, mas não é possível especificar quais campos são retornados. Elas retornam um subconjunto dos campos de dados compatíveis. É cobrado o valor de pelo menos US$ 0,032 por solicitação do Nearby Search e por todas as SKUs de tipos de dados (Basic Data, Contact Data e Atmosphere Data).

Exemplo

Você faz uma solicitação do Nearby Search, como NearbySearch (San Francisco, 100 meters). Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):

  • Places – Nearby Search (preço a partir de US$ 0,032 por chamada)
  • 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 – Text Search

O serviço Places – Text Search é cobrado nas solicitações para o serviço Place Text Search da API Maps JavaScript (textSearch()) ou para o serviço Text Search da API Places.

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

As solicitações do Text Search retornam uma lista de lugares, mas não é possível especificar quais campos são retornados. Elas retornam um subconjunto dos campos de dados compatíveis. É cobrado o valor de pelo menos US$ 0,032 por solicitação do Text Search e por todas as SKUs de tipos de dados (Basic Data, Contact Data e Atmosphere Data).

A SKU do Place – Text Search também é gerada pelo widget Place SearchBox da API Maps JavaScript: método getPlaces() depois que o usuário seleciona uma consulta de lugar (ícone: lupa), não um resultado (ícone: alfinete), conforme ilustrado aqui:

Seleção da consulta no widget da caixa de pesquisa do Places Detail
Nos resultados do widget da caixa de pesquisa, depois que o usuário digita "pizza" na caixa de pesquisa, veja que entrega de pizza passa a mostrar um ícone de alfinete, indicando que é uma consulta de lugar (e não um resultado).

Exemplo

Você faz uma solicitação do Text Search, como TextSearch(123 Main Street). Na fatura, você vai ver estas SKUs (ao visualizar por SKUs):

  • Places – Text Search (preço a partir de US$ 0,032 por chamada)
  • 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:

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, os seguintes limites de uso ainda se aplicam:

  • API Places (nova): o limite de taxa é de 600 QPM (solicitações por minuto) por método da API por projeto. Ou seja, cada método de API tem uma cota separada.

  • API Places: o limite de taxa é de 6.000 QPM (solicitações por minuto). Ela é calculada 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.

Gerenciar seu custo de uso

Para gerenciar seu custo de uso da API Places 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.

Para conferir ou mudar os limites de cota da API Places:

  1. No console do Cloud, abra a página Cotas da Plataforma Google Maps.
  2. Clique no menu suspenso de APIs e selecione a API Places.
  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.