Uso e faturamento da API Places

Faturamento e preços da API Places

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.

SKUs de produtos do Places (novo)

Clique no ícone info info para ver o sumário desta página. As seções a seguir descrevem os detalhes de cada SKU:

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 nas SKUs Essentials e Pro, o faturamento será baseado na SKU Pro.

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

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 faturadas 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 do Autocomplete (novo), que oferece uma maneira de limitar o número de solicitações cobradas durante uma única sessão do Autocomplete. Para informações sobre o uso da sessão do Autocomplete, consulte Tokens de sessão. Para mais informações, consulte Preenchimento automático (novo) e preços de sessão.
	Preços	Tabela de preços principal Tabela de preços da Índia

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

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: Campos para 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.
	Faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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: Campos para serviço da Web addressComponents adrFormatAddress formattedAddress location plusCode postalAddress shortFormattedAddress types viewport
	Faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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: Campos para 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.
	Faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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: Campos para serviço da Web currentOpeningHours currentSecondaryOpeningHours internationalPhoneNumber nationalPhoneNumber priceLevel priceRange rating regularOpeningHours regularSecondaryOpeningHours 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.
	Faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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: 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 local 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	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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: Campos para 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.postalAddress 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 o uso durante a 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.
	Faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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: Campos para 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
	Faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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 locais próximos que incluem os campos de atmostphere especificados.

	Categorias	Enterprise
	Evento faturável	Solicitação
	gatilhos	Essa SKU é acionada quando você 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
	Exemplos de faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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: Campos para 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.
	Faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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: Campos para 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.postalAddress 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 pré-lançamento.
	Faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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 para 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: Campos para 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
	Faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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: 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
	Exemplos de faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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

SKUs de produtos legadas do 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:

• 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 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 cobranças extras.

	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 qualquer um destes campos: Campos para o SDK do Android Place.Field.ACCESSIBILITY_OPTIONS*    * Use em vez de Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (descontinuado) Place.Field.ADDRESS_COMPONENTS Place.Field.BUSINESS_STATUS Place.Field.DISPLAY_NAME*    * Use em vez de Place.Field.NAME (descontinuado) Place.Field.FORMATTED_ADDRESS*    * Use em vez de Place.Field.ADDRESS (descontinuado) Place.Field.ICON_BACKGROUND_COLOR Place.Field.ICON_MASK_URL*    * Use em vez de Place.Field.ICON_URL (descontinuado) Place.Field.ID Place.Field.LOCATION*    * Use em vez de Place.Field.LAT_LNG (descontinuado) Place.Field.PHOTO_METADATAS Place.Field.PLUS_CODE Place.Field.TYPES Place.Field.VIEWPORT Place.Field.UTC_OFFSET. Campos para iOS GMSPlaceFieldFormattedAddress GMSPlaceFieldBusinessStatus GMSPlaceFieldID GMSPlaceFieldCoordinate GMSPlaceFieldName GMSPlaceFieldPhotos GMSPlaceFieldPlusCode GMSPlaceFieldTypes GMSPlaceFieldViewport Campos para 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
	Faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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 Contact Data 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 da 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: Campos para o SDK do Android Place.Field.CURRENT_OPENING_HOURS Place.Field.INTERNATIONAL_PHONE_NUMBER*       * Use em vez de Place.Field.PHONE_NUMBER (descontinuado). Place.Field.OPENING_HOURS Place.Field.SECONDARY_OPENING_HOURS Place.Field.WEBSITE_URI Campos para o SDK do iOS GMSPlaceFieldOpeningHours GMSPlaceFieldPhoneNumber GMSPlaceFieldWebsite Campos para serviço da Web formatted_phone_number international_phone_number opening_hours current_opening_hours secondary_opening_hours website
	Faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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:
	Exemplos de faturamento de máscara de campo	Sua solicitação é faturada com base nos campos fornecidos na máscara de campo. Exemplo: Se a máscara de campo incluir apenas campos desse SKU: a solicitação será faturada com a taxa desse SKU. Se a máscara de campos incluir campos de outros SKUs: a solicitação será faturada com a taxa de SKU mais alta para os campos solicitados. Por exemplo, se você incluir campos de uma SKU Essentials e de 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 será 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 solicita detalhes do lugar. Mais especificamente: Android: uma chamada para fetchPlace() iOS: uma chamada para fetchPlaceFromPlaceID: Serviço Web: uma solicitação do Place Details Campos na solicitação: Especifique os campos necessários na solicitação para evitar cobranças desnecessárias. Dependendo dos campos especificados, uma solicitação do Place Details também gera estes SKUs de dados: Dados básicos (essenciais) Places: dados de contato (empresa) Places: Atmosphere (Enterprise) Se você não especificar campos na solicitação do Place Details, todas as SKUs de dados serão acionadas. 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 Autocomplete, a sessão será faturada como SKU: Autocomplete without Place Details – Per Session.
	Exemplos	Este exemplo ilustra uma série de solicitações, por plataforma, que resultaria nas seguintes SKUs na fatura, quando você consultar a fatura por SKU: Autocomplete (incluído no Place Details) – por sessão Place Details Basic Data Exemplo de solicitação por plataforma: Solicitações do Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) fetchPlace() (com um FetchPlaceRequest, incluindo o ID do lugar e o campo ADDRESS) Solicitações do iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... fetchPlaceFromPlaceID: (incluindo o ID do lugar e o campo GMSPlaceFieldFormattedAddress) Solicitações de serviço da 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)
	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 Query Autocomplete.

	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: 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 com apenas o campo ADDRESS: Sua fatura mostra estas SKUs: Find Current Place Basic Data Você faz uma solicitação do Find Place com apenas o campo PHONE_NUMBER: Sua fatura mostra estas SKUs: Find Current Place Contact Data Você faz uma solicitação do Find Place com os três campos de tipo de dados: Sua fatura mostra estas SKUs: Find Current 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 campos 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:
	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

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.