Anúncio:em breve, a Plataforma Google Maps vai ter um novo estilo de mapa de base. Essa atualização inclui uma nova paleta de cores padrão, pinos modernizados e melhorias nas experiências de mapa e na usabilidade. Todos os estilos de mapa serão atualizados automaticamente em março de 2025. Para mais informações sobre a disponibilidade e como ativar logo, consulte Novo estilo de mapa para a Plataforma Google Maps.

Esta página foi traduzida pela API Cloud Translation.

Uso e faturamento da API Maps JavaScript

As solicitações da API Maps JavaScript geram chamadas para duas SKUs diferentes, dependendo do tipo de solicitação: carregamentos de mapas ou panoramas. As chamadas para a biblioteca Places e a API Maps JavaScript e outros serviços do JavaScript são precificados separadamente das SKUs nativas do JavaScript. Clique no ícone info info para conferir o sumário desta página.

Faturamento e preços da API Maps JavaScript

Para saber como o Google calcula sua fatura e seus preços, consulte a lista de preços da Plataforma Google Maps ou a lista de preços da Plataforma Google Maps na Índia.

SKU: Dynamic Maps

Essa SKU é cobrada por carregamentos de mapa quando um aplicativo exibe um mapa.

	Categorias	Noções básicas
	Evento faturável	Carregamento de mapa
	gatilhos	Essa SKU é cobrada por carregamentos de mapa quando um aplicativo mostra um mapa carregado de uma das seguintes maneiras: Com ou sem um ID do mapa usando a API Maps JavaScript Com um ID do mapa usando o SDK do Maps para Android ou o SDK do Maps para iOS. Interações do usuário com o mapa, como movimentação, ajuste de zoom ou alternância de camadas, não geram outros carregamentos de mapa.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Dynamic Street View

Esse SKU fatura solicitações à API Street View Static que retornam um panorama dinâmico do Street View.

	Categorias	Pro
	Evento faturável	Panorama
	gatilhos	Esse SKU é acionado quando você instancia um objeto de panorama usando uma das seguintes classes ou métodos: JavaScript: use 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. Android: use uma das classes `StreetViewPanoramaFragment`, `SupportStreetViewPanoramaFragment` ou `StreetViewPanoramaView`. Um panorama é contabilizado sempre que o método `onCreate()` relacionado é chamado. iOS: use o objeto `GMSPanoramaView`. 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.
	Preços	Tabela de preços principal Tabela de preços da Índia

Preços da biblioteca Places e da API Maps JavaScript

SKU: Solicitações de Autocomplete

Essa SKU cobra por solicitações à API Autocomplete que não usam uma sessão. Para saber como usar a sessão para limitar o número de solicitações cobradas durante uma única sessão do Autocomplete, consulte Tokens de sessão ou SKU: uso da sessão do Autocomplete.

	Categorias	Noções básicas
	Evento faturável	Solicitação
	gatilhos	Esse SKU é acionado nas seguintes condições: Sua solicitação não inclui um token de sessão. Sua solicitação inclui um token de sessão, mas você abandona a sessão. Sua solicitação inclui um token de sessão, mas você encerra a sessão sob determinadas condições. Para saber mais sobre o uso da sessão do Autocomplete, consulte Tokens de sessão ou Uso da sessão do Autocomplete.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: uso da sessão do Autocomplete

Essa SKU é cobrada para cada solicitação à API Autocomplete (New) que inclui um token de sessão.

	Categorias	Noções básicas
	Evento faturável	Solicitação
	gatilhos	Essa SKU é acionada quando você envia uma solicitação para a API Autocomplete (New) que inclui um token de sessão. Essa SKU funciona como um wrapper para a SKU de solicitações de Autocomplete (Nova), que oferece uma maneira de limitar o número de solicitações cobradas durante uma única sessão de Autocomplete. Para informações sobre o uso da sessão do Autocomplete, consulte Tokens de sessão. Observação:se você não usar sessões com o Autocomplete (novo), o faturamento será por solicitação para o Autocomplete usando a SKU: Autocomplete Requests.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Essentials da API Places Place Details (somente IDs)

Essa SKU é cobrada por solicitações de Place Details que retornam apenas o ID do lugar.

	Categorias	Noções básicas
	Evento faturável	Solicitação com as máscaras de campo especificadas.
	gatilhos	Essa SKU é acionada quando você solicita os seguintes campos: Biblioteca Places, API Maps JavaScript: `id` `photos`
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Essentials de Place Details da API Places

Essa SKU cobra por solicitações à API Place Details que extraem os campos nela.

	Categorias	Noções básicas
	Evento faturável	Solicitação com as máscaras de campo especificadas.
	gatilhos	Essa SKU é acionada quando você solicita os seguintes campos de local: Biblioteca Places, API Maps JavaScript: `addressComponents` `adrFormatAddress` `formattedAddress` `location` `plusCode` `types` `viewport`
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: API Places Place Details Pro

Essa SKU cobra por campos especificados em uma solicitação do Place Details Pro.

	Categorias	Pro
	Evento faturável	Solicitação com as máscaras de campo especificadas.
	gatilhos	Essa SKU é acionada quando você somente solicita os seguintes campos ou campos de taxa mais baixa: Biblioteca Places, API Maps JavaScript: `accessibilityOptions` `businessStatus` `displayName` `googleMapsUri` `iconBackgroundColor` `primaryTypeDisplayName` `svgIconMaskURI` `types` `utcOffsetMinutes`
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Places API Place Details Enterprise

Essa SKU é cobrada por uma solicitação do Places que inclui campos Enterprise.

	Categorias	Enterprise
	Evento faturável	Solicitação com as máscaras de campo especificadas.
	gatilhos	Essa SKU é acionada quando você solicita os seguintes campos: Biblioteca Places, API Maps JavaScript: `internationalPhoneNumber` `nationalPhoneNumber` `priceLevel` `rating` `regularOpeningHours` `userRatingCount` `websiteUri` Se você encerrar uma sessão do Autocomplete com uma chamada do Place Details que solicita qualquer campo da SKU Place Details Essentials, Pro, Enterprise ou Enterprise + Atmosphere, a chamada será faturada na SKU Place Details Enterprise + Atmosphere. Para mais informações, consulte SKU: Uso da sessão de preenchimento automático.
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Place Details Enterprise + Atmosphere da API Places

Essa SKU cobra chamadas para a API Place Details que solicitam os campos de atmosfera especificados.

	Categorias	Enterprise
	Evento faturável	Solicitação
	gatilhos	Essa SKU é acionada quando você solicita os seguintes campos: Biblioteca Places, API Maps JavaScript: `allowsDogs` `editorialSummary` `evChargeOptions` `fuelOptions` `hasCurbsidePickup` `hasDelivery` `hasDineIn` `hasLiveMusic` `hasMenuForChildren` `hasOutdoorSeating` `hasRestroom` `hasTakeout` `hasWifi` `isGoodForChildren` `isGoodForGroups` `isGoodForWatchingSports` `isReservable` `parkingOptions` `paymentOptions` `priceLevel` `reviews` `servesBeer` `servesBreakfast` `servesBrunch` `servesCocktails` `servesCoffee` `servesDessert` `servesDinner` `servesLunch` `servesVegetarianFood` `servesWine` Se uma sessão do Autocomplete for encerrada por uma chamada do Place Details que solicite qualquer campo da SKU: Place Details Essentials, Pro, Enterprise ou Enterprise + Atmosphere, a chamada será faturada em SKU: Place Details Enterprise + Atmosphere. Para mais informações, consulte SKU: Uso da sessão de preenchimento automático.
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Places API Nearby Search Pro

Esse SKU cobra pelos campos especificados em uma solicitação de Nearby Search Pro.

	Categorias	Pro
	Evento faturável	Solicitação com as máscaras de campo especificadas.
	gatilhos	Essa SKU é acionada quando você somente solicita os seguintes campos ou campos de taxa mais baixa: Biblioteca Places, API Maps JavaScript: `accessibilityOptions` `addressComponents` `adrFormatAddress` `businessStatus` `displayName` `formattedAddress` `googleMapsUri` `iconBackgroundColor` `id` `location` `photos` `plusCode` `svgIconMaskURI` `types` `utcOffsetMinutes` `viewport`
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Places API Nearby Search Enterprise

Esse SKU é cobrado para solicitações de pesquisa por proximidade que incluem campos Enterprise.

	Categorias	Enterprise
	Evento faturável	Solicitação com as máscaras de campo especificadas.
	Gatilhos	Essa SKU é acionada quando você solicita os seguintes campos: Biblioteca Places, API Maps JavaScript: `internationalPhoneNumber` `nationalPhoneNumber` `priceLevel` `rating` `regularOpeningHours` `userRatingCount` `websiteUri`
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Places API Nearby Search Enterprise + Atmosphere

Esse SKU é cobrado para solicitações de pesquisa de pessoas próximas que incluem os campos de atmostphere especificados.

	Categorias	Enterprise
	Evento faturável	Solicitação
	gatilhos	Essa SKU é acionada quando você solicita os seguintes campos: Biblioteca Places, API Maps JavaScript: `allowsDogs` `editorialSummary` `evChargeOptions` `fuelOptions` `hasCurbsidePickup` `hasDelivery` `hasDineIn` `hasLiveMusic` `hasMenuForChildren` `hasOutdoorSeating` `hasRestroom` `hasTakeout` `hasWifi` `isGoodForChildren` `isGoodForGroups` `isGoodForWatchingSports` `isReservable` `parkingOptions` `paymentOptions` `priceLevel` `reviews` `servesBeer` `servesBreakfast` `servesBrunch` `servesCocktails` `servesCoffee` `servesDessert` `servesDinner` `servesLunch` `servesVegetarianFood` `servesWine`
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Essentials da pesquisa de texto da API Places (somente IDs)

Essa SKU é cobrada por solicitações à API Pesquisa de texto que retornam apenas IDs.

	Categorias	Noções básicas
	Evento faturável	Solicitação com as máscaras de campo especificadas.
	gatilhos	Essa SKU é acionada quando você solicita apenas os seguintes campos: Biblioteca Places, API Maps JavaScript: `id`
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Places API Text Search Pro

Essa SKU é uma SKU de dados que cobra pelos campos especificados em uma solicitação de Text Search Pro.

	Categorias	Pro
	Evento faturável	Solicitação com as máscaras de campo especificadas.
	gatilhos	Essa SKU é acionada quando você somente solicita os seguintes campos ou campos de taxa mais baixa: Biblioteca Places, API Maps JavaScript: `accessibilityOptions` `addressComponents` `adrFormatAddress` `businessStatus` `displayName` `formattedAddress` `googleMapsUri` `iconBackgroundColor` `location` `photos` `plusCode` `svgIconMaskURI` `types` `utcOffsetMinutes` `viewport`
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Places API Text Search Enterprise

Essa SKU é cobrada por solicitações de pesquisa de texto que incluem campos Enterprise.

	Categorias	Enterprise
	Evento faturável	Solicitação com as máscaras de campo especificadas.
	gatilhos	Essa SKU é acionada quando você solicita os seguintes campos: Biblioteca Places, API Maps JavaScript: `internationalPhoneNumber` `nationalPhoneNumber` `priceLevel` `rating` `regularOpeningHours` `userRatingCount` `websiteUri`
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Places API Text Search Enterprise + Atmosphere

Essa SKU é cobrada para solicitações de pesquisa de texto que incluem campos de ambiente.

	Categorias	Enterprise
	Evento faturável	Solicitação
	gatilhos	Essa SKU é acionada quando você solicita os seguintes campos: Biblioteca Places, API Maps JavaScript: `allowsDogs` `editorialSummary` `evChargeOptions` `fuelOptions` `hasCurbsidePickup` `hasDelivery` `hasDineIn` `hasLiveMusic` `hasMenuForChildren` `hasOutdoorSeating` `hasRestroom` `hasTakeout` `hasWifi` `isGoodForChildren` `isGoodForGroups` `isGoodForWatchingSports` `isReservable` `parkingOptions` `paymentOptions` `priceLevel` `reviews` `servesBeer` `servesBreakfast` `servesBrunch` `servesCocktails` `servesCoffee` `servesDessert` `servesDinner` `servesLunch` `servesVegetarianFood` `servesWine`
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Place Details Photos

Essa SKU é cobrada para solicitações de Place Details Photos.

	Categorias	Enterprise
	Evento faturável	Solicitação
	gatilhos	O faturamento é acionado quando você solicita uma foto da API Place Details.
	Preços	Tabela de preços principal Tabela 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, 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:

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

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

Essa SKU é uma SKU de dados que cobra pelos campos de dados básicos em uma solicitação do Place Details ou do Find Place. Essa SKU é cobrada além da SKU de base da solicitação que a acionou.

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.

	Categorias	Noções básicas
	Evento faturável	Solicitação com as máscaras de campo especificadas.
	gatilhos	A SKU Basic Data é acionada quando você solicita um destes campos: 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` `Place.Field.UTC_OFFSET`. Campos descontinuados:os seguintes campos foram descontinuados na versão 4.0 do SDK do Places para Android: `Place.Field.ADDRESS`, `Place.Field.ICON_URL`, `Place.Field.LAT_LNG`, `Place.Field.NAME` e `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE`. 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` `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` `wheelchair_accessible_entrance`
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Contact Data

Essa SKU é uma SKU de dados que cobra pelos campos Dados de contato em uma solicitação do Place Details ou do Find Place. Essa SKU é cobrada além da SKU de base 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.

	Categorias	Enterprise
	Evento faturável	Solicitação com as máscaras de campo especificadas.
	gatilhos	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` Campos descontinuados:o campo `Place.Field.PHONE_NUMBER` foi descontinuado na versão 4.0 do SDK do Places para Android. Em vez disso, 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`
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Atmosphere Data

Essa SKU cobra por solicitações à API Atmosphere Data que especificam os campos nela.

	Categorias	Enterprise
	Evento faturável	Solicitação com as máscaras de campo especificadas.
	gatilhos	O faturamento é acionado quando você solicita um destes campos: AndroidiOSJavaScript `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` `Place.Field.USER_RATING_COUNT` Campos descontinuados: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`. `GMSPlaceFieldPriceLevel` `GMSPlaceFieldRating` `GMSPlaceFieldUserRatingsTotal` `GMSPlaceFieldTakeout` `GMSPlaceFieldDelivery` `GMSPlaceFieldDineIn` `GMSPlaceFieldCurbsidePickup` `GMSPlaceFieldReservable` `GMSPlaceFieldServesBreakfast` `GMSPlaceFieldServesLunch` `GMSPlaceFieldServesDinner` `GMSPlaceFieldServesBeer` `GMSPlaceFieldServesWine` `GMSPlaceFieldServesBrunch` `GMSPlaceFieldServesVegetarianFood`. Consulte Campos (detalhes do lugar) `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` `user_ratings_total`.
	Exemplos de faturamento de máscara de campo	Estes são exemplos de como a solicitação é faturada com base nos campos selecionados na máscara de campo. Se a máscara de campo de solicitação incluir apenas campos desse SKU: a solicitação será faturada na taxa desse SKU. Por exemplo, você pode solicitar um ou mais campos desse SKU e vai receber cobranças de acordo com a taxa desse SKU. Se a máscara de campos do seu pedido incluir campos de outros SKUs: o pedido será cobrado com a maior taxa de SKU para os campos solicitados. Por exemplo, se você incluir campos de várias SKUs, como uma SKU Essentials e uma SKU Enterprise, a solicitação será faturada na taxa da SKU Enterprise.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Autocomplete – por solicitação

Essa SKU fatura solicitações que não incluem um token de sessão

Se você fizer uma solicitação em uma sessão inválida do Autocomplete (por exemplo, uma que reutiliza um token de sessão), também vai ser cobrada 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 quando você faz solicitações em uma sessão do Autocomplete inválida. Isso pode acontecer quando um usuário digita ou copia/cola vários endereços diferentes no widget e nem sempre seleciona uma previsão de preenchimento automático.

	Categorias	Noções básicas
	Evento faturável	Solicitação
	gatilhos	O faturamento é acionado para: 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
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Autocomplete sem Place Details – por sessão

Essa SKU é 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).

	Categorias	Pro
	Evento faturável	Sessão
	gatilhos	O faturamento é acionado se o aplicativo emitir estas duas solicitações 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 da Web Solicitação do Place Autocomplete (input="par", session_token: XYZ) Solicitação do Place Autocomplete (input="paris", session_token: XYZ) Ao visualizar a fatura por SKU, você vai encontrar esta SKU listada: Autocomplete sem Place Details – por sessão
	Preços	Tabela de preços principal Tabela de preços da Índia

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

As solicitações de preenchimento automático estão disponíveis sem custos financeiros. Essa SKU é cobrada quando você solicita o Place Details subsequente com base nos preços normais do Place Details.

	Categorias	Noções básicas
	Evento faturável	Sessão
	gatilhos	A SKU do Autocomplete (incluída no Place Details) – por sessão é cobrada por uma sessão do Autocomplete que inclui qualquer uma das seguintes solicitações: Android: uma chamada para `fetchPlace()` iOS: uma chamada para `fetchPlaceFromPlaceID:` Serviço Web: uma solicitação 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 pedir campos específicos na solicitação do Place Details, todas as SKUs de dados serão acionadas (Essentials, Pro, Enterprise e Enterprise + Atmosphere). Especifique apenas os campos necessários para evitar cobranças desnecessárias. Se você solicitar apenas uma atualização do ID do Place Details (sua solicitação especifica apenas o campo `place_id`) durante uma sessão de preenchimento automático, a sessão será faturada como SKU: Autocomplete without Place Details – Per Session.
	Exemplos	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 ENDEREÇO) iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... fetchPlaceFromPlaceID: (incluindo o ID do lugar e o campo `GMSPlaceFieldFormattedAddress`) Serviço Web Serviço Web Solicitação do Places Autocomplete (input="par", session_token: XYZ) Solicitação do Places Autocomplete (input="paris", session_token: XYZ) Detalhes do Places (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 Place Details Basic Data
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Query Autocomplete – por solicitação

Essa SKU legada é cobrada para solicitações de preenchimento automático de consulta.

	Categorias	Noções básicas
	Evento faturável	Solicitação
	gatilhos	Essa SKU é acionada quando você faz uma solicitação de preenchimento automático de consulta usando os seguintes serviços: 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 O preço por sessão do Autocomplete não é aplicado com o Query Autocomplete. As solicitações de Place Details seguintes são cobradas com base na SKU Place Details Pro.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Place Details Pro

Essa SKU é cobrada para solicitações legados de Place Details.

	Categorias	Pro
	Evento faturável	Solicitação
	gatilhos	O faturamento é acionado para solicitações das seguintes 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 Pizza Autentico tem um ícone de alfinete ao lado, indicando que é um resultado de lugar (e 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 você fornecer um token de sessão ou não. Essa SKU também aciona o faturamento de SKUs de dados: se você incluir campos de dados na solicitação, isso poderá acionar o faturamento adicional de SKUs de dados: Basic, Contact e Atmosphere. Especifique apenas os campos de dados que você quer evitar custos desnecessários. A cobrança é feita pela SKU e pelos dados solicitados.
	Exemplos	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 encontrar estas SKUs (ao visualizar por SKU): Place Details Basic Data 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 o campo de número de telefone: `getPlaceDetails(fields: formatted_phone_number)` Na fatura, você vai encontrar estas SKUs (ao visualizar por SKU): Place Details Contact Data 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 encontrar estas SKUs (ao visualizar por SKU): Place Details Basic Data Contact Data Atmosphere Data
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Place Details – ID Refresh

Essa SKU é cobrada para solicitações à API Place Details que atualizam IDs de lugares desatualizados.

	Categorias	Noções básicas
	Evento faturável	Solicitação
	gatilhos	O faturamento é acionado quando você faz uma solicitação de Place Details especificando apenas o campo do ID do lugar: `getPlaceDetails(fields: place_id)`.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Find Place

Essa SKU é cobrada por solicitações do Find Place que retornam mais campos além do ID do lugar.

Essa SKU também aciona o faturamento de SKUs de dados: se você incluir campos de dados na solicitação, isso poderá acionar o faturamento adicional de SKUs de dados: Basic, Contact e Atmosphere. Especifique apenas os campos de dados que você quer evitar custos desnecessários. A cobrança é feita pela SKU e pelos dados solicitados.

	Categorias	Pro
	Evento faturável	Solicitação
	gatilhos	Essa SKU cobra por solicitações para os seguintes métodos: Find Current Place Essa SKU também aciona o faturamento de SKUs de dados: se você incluir campos de dados na solicitação, isso poderá acionar o faturamento adicional de SKUs de dados: Basic, Contact e Atmosphere. Especifique apenas os campos de dados que você quer evitar custos desnecessários. A cobrança é feita pela SKU e pelos dados solicitados.
	Exemplos	Os exemplos a seguir mostram quais SKUs são cobrados ao fazer uma solicitação do Find Current Place e especificar campos das SKUs de dados Basic, Contact e Atmosphere. Para conferir as SKUs na fatura, acesse a fatura por SKU, conforme descrito em Analisar o uso e o custo por SKU. Você faz uma solicitação do Find Place e especifica apenas o campo de endereço: `FindPlace(fields: formatted_address)`. Sua fatura mostra estas SKUs: Find Place Basic Data Você faz uma solicitação do Find Place e especifica o campo de número de telefone: `FindPlace(fields: formatted_phone_number)`. Sua fatura mostra estas SKUs: Find Place Contact Data 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)`. Sua fatura mostra estas SKUs: Find Place Basic Data Contact Data Atmosphere Data
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Find Place – somente ID

Essa SKU é cobrada por solicitações do Find Place que retornam apenas o ID do lugar. Por padrão, se você não especificar nenhum campo na solicitação do Find Place, somente o ID do lugar será retornado.

	Categorias	Noções básicas
	Evento faturável	Solicitação
	gatilhos	Você faz uma solicitação do Find Place sem especificar nenhum campo ou especifica apenas o campo `place_id`: `FindPlace(fields: place_id)`.
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Places – Nearby Search

Essa SKU é cobrada para solicitações do Nearby Search.

	Categorias	Pro
	Evento faturável	Solicitação
	gatilhos	Essa SKU é acionada quando você faz uma solicitação de pesquisa do Google Maps usando uma das seguintes APIs: Serviço Place Nearby Search da API Maps JavaScript (`nearbySearch()`) Serviço Nearby Search da API Places Essa solicitação não aceita a especificação de quais campos devem ser retornados. A resposta retorna uma lista de lugares e um subconjunto dos campos de dados compatíveis. Essa SKU também aciona o faturamento de SKUs de dados: se você incluir campos de dados na solicitação, isso poderá acionar o faturamento adicional de SKUs de dados: Basic, Contact e Atmosphere. Especifique apenas os campos de dados que você quer evitar custos desnecessários. A cobrança é feita pela SKU e pelos dados solicitados.
	Exemplos	Você faz uma solicitação do Nearby Search, como `NearbySearch (San Francisco, 100 meters)`. A fatura mostra estas SKUs ao visualizar por SKU: Lugar Basic Data Contact Data Atmosphere Data
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: Places – Text Search

Esse SKU cobra por solicitações ao serviço Places Text Search.

	Categorias	Pro
	Evento faturável	Solicitação
	gatilhos	O faturamento é acionado para solicitações dos seguintes serviços: Serviço Place Text Search da API Maps JavaScript (`textSearch()`). Serviço Text Search da API Places As solicitações do Text Search retornam uma lista de lugares, mas não é possível especificar quais campos são retornados. As solicitações do Text Search 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 tipo de dados: Basic Data, Contact Data e Atmosphere Data. A SKU do Places – Text Search também é acionada 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: Nos resultados do widget da caixa de pesquisa, depois que o usuário digita "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	Se você fizer uma solicitação de pesquisa de texto, como `TextSearch(123 Main Street)`, a fatura vai mostrar estas SKUs ao visualizar por SKU: Place – Text Search Basic Data Contact Data Atmosphere Data
	Preços	Tabela de preços principal Tabela de preços da Índia

SKU: API Places Place Details Photos

Essa SKU é cobrada pelo serviço legado do Places Photo.

	Categorias	Enterprise
	Evento faturável	Solicitação
	gatilhos	O faturamento é acionado para: 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 pixel de imagem. Ele não aciona cobranças até que o URL seja realmente usado para coletar dados de pixel. Serviço Web:solicitações para o serviço Place Photos da API Places
	Preços	Tabela de preços principal Tabela de preços da Índia

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:

Outros limites de uso

Não existe um número máximo de solicitações por dia. Mesmo assim, 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.

Limites de uso de mapas 3D fotorrealistas na API Maps JavaScript

Os seguintes limites de uso estão em vigor para os mapas 3D fotorrealistas no JavaScript do Maps

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.