Uso e faturamento da API Maps JavaScript

Lembrete:para usar a API Maps JavaScript, você precisa ativar o faturamento em cada um dos seus projetos e incluir uma chave de API ou um token OAuth com todas as solicitações de API ou SDK.

A API Maps JavaScript usa um modelo de pagamento por uso. Dependendo do tipo, as solicitações da API Maps JavaScript geram chamadas para duas SKUs diferentes: carregamentos de mapas ou panoramas. As chamadas para a biblioteca Places, a API Maps JavaScript e outros serviços JavaScript são cobradas separadamente das SKUs nativas do JavaScript. Além dos Termos de Uso gerais do Google, existem limites de uso específicos para a API Maps JavaScript. Gerencie seus custos e uso com as ferramentas disponíveis no console do Google Cloud.

Como é feita a cobrança da API Maps JavaScript

A API Maps JavaScript 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 às SKUs qualificadas.

Preços da API Maps JavaScript

SKU: Dynamic Maps

Um aplicativo que mostra um mapa carregado com ou sem o ID do mapa usando a API Maps JavaScript ou um mapa carregado com o ID do mapa utilizando o SDK do Maps para Android ou o SDK do Maps para iOS.

FAIXA DE VOLUME MENSAL (Preço por CARREGAMENTO DE MAPA)
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

Interações do usuário com o mapa, como deslocamento, ajuste de zoom ou alternância de camadas, não geram carregamentos de mapa adicionais.

---

SKU: Dynamic Street View

Os panoramas do Street View e os carregamentos de mapa agora são faturados separadamente. Um panorama do Street View dinâmico é cobrado a cada instanciação de um objeto de panorama em um aplicativo da API Maps JavaScript, do SDK do Maps para Android e do SDK do Maps para iOS.

FAIXA DE VOLUME MENSAL (Preço por PANORAMA)
0 a 100.000	100.001 a 500.000	Mais de 500.000
US$ 0,014 para cada um (US$ 14 para 1.000)	US$ 0,0112 para cada um (US$ 11,20 para 1.000)	Entre em contato com a equipe de vendas para saber os preços por volume

Uma instanciação de um objeto de panorama acontece:

• em JavaScript, com a classe google.maps.StreetViewPanorama() ou o método Map.getStreetView(); Nem a experiência integrada do Street View com base no controle do Pegman nem o uso da classe StreetViewService() são cobrados.
• No Android, com uma das classes StreetViewPanoramaFragment, SupportStreetViewPanoramaFragment ou StreetViewPanoramaView. Um panorama é contabilizado sempre que o método onCreate() relacionado é chamado.
• No iOS, com o objeto GMSPanoramaView.

Preços da biblioteca Places e da API Maps JavaScript

SKU: solicitações de preenchimento automático

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

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

• Encerre as sessões fazendo uma única solicitação ao Place Details (novo), que solicita qualquer campo definido pelo SKU: Place Details (Location Only).
  • Até 12 solicitações de Autocomplete (novo), são cobradas de acordo com o SKU: solicitações de Autocomplete.
  • Cada solicitação de Autocomplete (novo) subsequente é faturada usando o SKU: Autocomplete Session Usage.
  Observação: se você fizer uma chamada para SKU: Address Validation Preferred antes do token de sessão expirar, a chamada SKU: Place Details (Location Only) não será cobrada, e sua sessão será faturada com base no SKU: uso da sessão do Autocomplete.
• Saia da sessão ou encerre-a fazendo uma chamada para SKU: Place Details (somente IDs). Todas as solicitações de Autocomplete (novo) são então faturadas usando 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 de preenchimento automático

Uma SKU do Uso da sessão do Autocomplete é cobrada para cada solicitação feita à 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 (Location Only):

  • Até 12 solicitações de Autocomplete (novo), são cobradas de acordo com o SKU: solicitações de Autocomplete.
  • Cada solicitação de Autocomplete (novo) subsequente é faturada usando o SKU: Autocomplete Session Usage.

• A sessão do Autocomplete foi encerrada com uma chamada para SKU: Place Details (Basic, Advanced ou Preferred).

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

• A sessão de preenchimento automático foi encerrada com uma chamada para SKU: Address Validation Preferred.

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

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

---

SKU: Place Details (somente IDs)

Observação:se você selecionar qualquer campo da SKU do Place Details (somente local), será cobrado de acordo com essa taxa. Se você selecionar algum campo da SKU do Place Details (Basic), será cobrado com essa taxa. Se você selecionar qualquer campo da SKU do Place Details (Advanced), será cobrado com essa taxa. Se você selecionar qualquer campo da SKU do Place Details (Preferencial), será cobrado de acordo com essa taxa.

Com uma máscara ou lista de campos na sua solicitação do Place Details (novo), é possível limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você só solicita os seguintes campos:

Biblioteca Places, API Maps JavaScript: id, photos

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

---

SKU: Place Details (somente local)

Observação:se você selecionar qualquer campo da SKU do Place Details (Basic), a taxa será cobrada. Se você selecionar qualquer campo da SKU do Place Details (Advanced), será cobrado de acordo com essa taxa. Se você selecionar qualquer campo da SKU do Place Details (Preferencial), será cobrado de acordo com essa taxa.

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

Biblioteca Places, API Maps JavaScript: addressComponents, adrFormatAddress, formattedAddress, location, plusCode, 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 (Basic)

Observação:se você selecionar qualquer campo da SKU do Place Details (Advanced), vai receber a cobrança com base nessa taxa. Se você selecionar qualquer campo da SKU do Place Details (Preferencial), será cobrado de acordo com essa taxa.

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

Biblioteca Places, API Maps JavaScript: accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, primaryTypeDisplayName, svgIconMaskURI, types, utcOffsetMinutes

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

---

SKU: Place Details (Avançado)

Observação:se você selecionar qualquer campo da SKU do Place Details (Preferencial), essa taxa será cobrada.

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

Biblioteca Places, API Maps JavaScript: internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, userRatingCount, websiteUri

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 um (US$ 20 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 ou lista de campos na sua solicitação do Place Details (novo), é possível limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você apenas solicita os seguintes campos:

Biblioteca Places, API Maps JavaScript: hasCurbsidePickup, hasDelivery, hasDineIn, editorialSummary, parkingOptions, paymentOptions, priceLevel, isReservable, reviews, servesBeer, servesBreakfast, servesBrunch, servesDinner, servesLunch, servesVegetarianFood, servesWine, {18/hasTakeout

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 para 1.000)	US$ 0,020 para cada um (US$ 20 para 1.000)	Entre em contato com a equipe de vendas para saber os preços por volume

---

SKU: Nearby Search (Basic)

Observação:se você selecionar qualquer campo da SKU do Nearby Search (Advanced), essa taxa será cobrada. Se você selecionar qualquer campo da SKU do Nearby Search (Preferencial), será cobrado com essa taxa.

Ao usar uma máscara ou lista de campos na solicitação do Nearby Search (novo), é possível limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você apenas solicita os seguintes campos:

Biblioteca Places, API Maps JavaScript: accessibilityOptions, addressComponents, adrFormatAddress, businessStatus, displayName, formattedAddress, googleMapsUri, iconBackgroundColor, id, location, photos, plusCode, svgIconMaskURI, types, utcOffsetMinutes, viewport

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: Nearby Search (Avançado)

Observação:se você selecionar qualquer campo da SKU do Nearby Search (Preferencial), será cobrado de acordo com essa taxa.

Ao usar uma máscara ou lista de campos na solicitação do Nearby Search (novo), é possível limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você apenas solicita os seguintes campos:

Biblioteca Places, API Maps JavaScript: internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, userRatingCount, 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 um (US$ 35 para 1.000)	US$ 0,028 para cada um (US$ 28 para 1.000)	Entre em contato com a equipe de vendas para saber os preços por volume

---

SKU: Nearby Search (Preferencial)

Ao usar uma máscara ou lista de campos na solicitação do Nearby Search (novo), é possível limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você apenas solicita os seguintes campos:

Biblioteca Places, API Maps JavaScript: hasCurbsidePickup, hasDelivery, hasDineIn, editorialSummary, parkingOptions, paymentOptions, priceLevel, isReservable, reviews, servesBeer, servesBreakfast, servesBrunch, servesDinner, servesLunch, servesVegetarianFood, servesWine, {18/hasTakeout

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 um (US$ 40 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: Pesquisa de texto (somente ID)

Observação:se você selecionar qualquer campo da SKU do Text Search (Basic), será cobrado essa taxa. Se você selecionar algum campo da SKU do Text Search (avançado), será cobrado essa taxa. Se você selecionar qualquer campo da SKU do Text Search (Preferencial), será cobrado a essa taxa.

Ao usar uma máscara de campo ou uma lista de campos na solicitação do Text Search (novo), é possível limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você apenas solicita os seguintes campos:

Biblioteca Places, API Maps JavaScript: id

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

---

SKU: Text Search (Basic)

Observação:se você selecionar qualquer campo da SKU do Text Search (avançado), será cobrado essa taxa. Se você selecionar qualquer campo da SKU do Text Search (Preferencial), será cobrado a essa taxa.

Ao usar uma máscara de campo ou uma lista de campos na solicitação do Text Search (novo), é possível limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você apenas solicita os seguintes campos:

Biblioteca Places, API Maps JavaScript: accessibilityOptions, addressComponents, adrFormatAddress, businessStatus, displayName, formattedAddress, googleMapsUri, iconBackgroundColor, location, photos, plusCode, svgIconMaskURI, types, utcOffsetMinutes, viewport

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 qualquer campo da SKU do Text Search (Preferencial), será cobrado essa taxa.

Ao usar uma máscara de campo ou uma lista de campos na solicitação do Text Search (novo), é possível limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você apenas solicita os seguintes campos:

Biblioteca Places, API Maps JavaScript: internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, userRatingCount, 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 um (US$ 35 para 1.000)	US$ 0,028 para cada um (US$ 28 para 1.000)	Entre em contato com a equipe de vendas para saber os preços por volume

---

SKU: Text Search (Preferencial)

Ao usar uma máscara de campo ou uma lista de campos na solicitação do Text Search (novo), é possível limitar a resposta apenas aos campos especificados. Essa SKU é acionada quando você apenas solicita os seguintes campos:

Biblioteca Places, API Maps JavaScript: hasCurbsidePickup, hasDelivery, hasDineIn, editorialSummary, parkingOptions, paymentOptions, priceLevel, isReservable, reviews, servesBeer, servesBreakfast, servesBrunch, servesDinner, servesLunch, servesVegetarianFood, servesWine, {18/hasTakeout

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 um (US$ 40 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 Place 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

---

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.

Para o serviço Web, as seguintes chamadas das APIs do Places permitem especificar os campos de dados que vão ser retornados:

• Places Details
• Find Place

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:

• Places – Nearby Search
• Places – Text Search

---

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.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, Place.Field.UTC_OFFSET ou Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
• iOS:GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus, 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

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.OPENING_HOURS, Place.Field.PHONE_NUMBER, 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

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

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

• JavaScript: o serviço Places Autocomplete da API Maps JavaScript (getQueryPredictions()) e o uso do widget SearchBox da API Maps JavaScript. As solicitações do Query Autocomplete são geradas como os tipos de usuários.
• Serviço Web: o serviço Query Autocomplete da API Places

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

• 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 getPlaces()

  

• 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 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: Place Details – ID Refresh

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):

• Place Details – ID Refresh (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)

---

SKU: Place – Nearby Search

Place – Nearby Search é cobrado por solicitações para o serviço Place Nearby Search da API Maps JavaScript (nearbySearch()) ou 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: Place – Text Search

Place – Text Search é cobrado por solicitações para o serviço Place Text Search da API Maps JavaScript (textSearch()) ou 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 Places – 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), e não um resultado (ícone: alfinete), como ilustrado aqui:

Nos resultados do widget da caixa de pesquisa, depois de digitar "pizza" na caixa de pesquisa, observe que entrega de pizza tem um ícone de lupa ao lado, 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: Place 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

---

Preços dos serviços JavaScript

Os serviços JavaScript são precificados separadamente. Consulte a página de uso e faturamento do serviço em questão para mais detalhes:

• Directions Service: uso e faturamento da API Directions
• Distance Matrix Service: uso e faturamento da API Distance Matrix
• Elevation Service: uso e faturamento da API Elevation
• Geocoding Service: uso e faturamento da API Geocoding
• Street View Service: uso e faturamento da API Street View</a

Outros limites de uso

Não existe um número máximo de solicitações por dia, mas os limites de uso abaixo são aplicados à API Maps JavaScript:

• 30.000 QPM (solicitações por minuto).
• 300 QPM e por endereço IP. No console do Google Cloud, essa cota é chamada de Carregamentos de mapas por minuto e usuário.

Importante:projetos mais antigos podem ter uma cota legada de 60 QPM por endereço IP. Se você quiser aumentar esse valor para 300 QPM, entre em contato com a equipe de suporte e solicite um aumento de cota.

Limites de uso de mapas fotorrealistas em 3D no Maps JavaScript

Observação :durante a fase Experimental, o uso de mapas fotorrealistas em 3D no Maps JavaScript será: (i) sem custos financeiros e (ii) você vai precisar ativar o faturamento em cada um dos seus projetos usando mapas fotorrealistas em 3D no Maps JavaScript. Não temos a obrigação de notificar você quando o teste terminar e nos reservamos o direito de modificar ou encerrar o teste a qualquer momento, sem aviso prévio e a nosso critério exclusivo.

Os limites de uso a seguir são válidos para os mapas fotorrealistas em 3D do Google Maps JavaScript.

• 100 QPM (solicitações por minuto) .
• 10 QPM (solicitações por minuto) por endereço IP .

Restrições dos Termos de Uso

Para saber tudo sobre o uso permitido, consulte a seção Restrições de licença nos Termos de Serviço da Plataforma Google Maps.

Gerenciar seu custo de uso

Para gerenciar seu custo de uso da API Maps JavaScript 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. É impossível definir limites diários para projetos que não usam APIs faturáveis.

Para ver ou alterar limites de cota da API Maps JavaScript, faça o seguinte:

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

---