Esta página foi traduzida pela API Cloud Translation.

Uso e faturamento do SDK do Places para Android

Erro: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

Clique no ícone info info para conferir o sumário desta página.

Faturamento e preços do SDK do Places para Android

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.

Detalhes da SKU do produto do SDK do Places para Android

Sobre as máscaras de campo

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

Usar uma máscara de campo é uma boa prática de design para garantir que você não solicite dados desnecessários, o que ajuda a evitar tempo de processamento e cobrança desnecessários.

Sobre as sessões do Autocomplete (novo)

Uma sessão do Autocomplete (novo) inclui uma ou mais solicitações do Autocomplete (novo) e uma solicitação do Place Details (novo) ou do Address Validation. O mesmo token de sessão é transmitido para a solicitação do Autocomplete (novo) e para a solicitação do Place Details (novo) ou da Validação de endereço subsequente.

Uma sessão começa com a primeira solicitação de Autocomplete (Nova). Uma solicitação de Place Details (New) ou de Address Validation é feita quando o usuário seleciona uma das sugestões do Autocomplete (New). Se uma sessão for abandonada, ou seja, se nenhuma solicitação de Place Details (New) ou de Address Validation for feita, as solicitações de Autocomplete (New) serão cobradas como se nenhum token de sessão tivesse sido fornecido.

Depois que o usuário seleciona um lugar (ou seja, faz uma solicitação de detalhes do lugar (novo) ou de validação de endereço), é preciso iniciar uma nova sessão usando um novo token.

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 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. 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 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: Android: `Place.Field.DISPLAY_NAME` `Place.Field.ID` `Place.Field.PHOTO_METADATAS` `Place.Field.RESOURCE_NAME` Campos descontinuados: O campo `Place.Field.NAME` foi descontinuado na versão 4.0 do SDK do Places para Android. Em vez disso, use `Place.Field.DISPLAY_NAME`. O campo `RESOURCE_NAME` contém o nome do recurso de lugar no formulário: `places/PLACE_ID`. Use `DISPLAY_NAME` para acessar o nome do lugar.
	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: Android: `Place.Field.ADDRESS_COMPONENTS` `ADR_FORMAT_ADDRESS` `Place.Field.FORMATTED_ADDRESS` `Place.Field.LOCATION` `Place.Field.PLUS_CODE` `Place.Field.SHORT_FORMATTED_ADDRESS` `Place.Field.TYPES` `Place.Field.VIEWPORT` Campos descontinuados:os campos `Place.Field.ADDRESS` e `Place.Field.LAT_LNG` foram descontinuados na versão 4.0 do SDK do Places para Android. Em vez disso, use `Place.Field.FORMATTED_ADDRESS` e `Place.Field.LOCATION`, respectivamente.
	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: Android: `Place.Field.ACCESSIBILITY_OPTIONS` `Place.Field.BUSINESS_STATUS` `Place.Field.GOOGLE_MAPS_URI` `Place.Field.ICON_BACKGROUND_COLOR` `Place.Field.ICON_MASK_URL` `Place.Field.PRIMARY_TYPE` `Place.Field.PRIMARY_TYPE_DISPLAY_NAME` `Place.Field.SUB_DESTINATIONS` `Place.Field.UTC_OFFSET` Campos descontinuados:os campos `Place.Field.ICON_URL` e `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE` foram descontinuados na versão 4.0 do SDK do Places para Android. Em vez disso, use `Place.Field.ICON_MASK_URL` e `Place.Field.ACCESSIBILITY_OPTIONS`, respectivamente. `Place.Field.ACCESSIBILITY_OPTIONS` está disponível apenas para "Detalhes do lugar (novo)".
	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: Android: `Place.Field.CURRENT_OPENING_HOURS` `Place.Field.CURRENT_SECONDARY_OPENING_HOURS` `Place.Field.INTERNATIONAL_PHONE_NUMBER` `Place.Field.NATIONAL_PHONE_NUMBER` `Place.Field.OPENING_HOURS` `Place.Field.PRICE_LEVEL` `Place.Field.RATING` `Place.Field.SECONDARY_OPENING_HOURS` `Place.Field.USER_RATING_COUNT` `Place.Field.WEBSITE_URI` Campos descontinuados:os campos `Place.Field.PHONE_NUMBER` e `Place.Field.USER_RATINGS_TOTAL` foram descontinuados na versão 4.0 do SDK do Places para Android. Em vez disso, use `Place.Field.INTERNATIONAL_PHONE_NUMBER` e `Place.USER_RATING_COUNT`, respectivamente. Se você encerrar uma sessão do Autocomplete com uma chamada do Place Details que solicita qualquer campo da SKU: Place Details (Basic, Advanced ou Preferred), a chamada será faturada na SKU: Place Details (Preferred). 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: Android: `Place.Field.ALLOWS_DOGS` `Place.Field.CURBSIDE_PICKUP` `Place.Field.DELIVERY` `Place.Field.DINE_IN` `Place.Field.EDITORIAL_SUMMARY` `Place.Field.EV_CHARGE_OPTIONS` `Place.Field.FUEL_OPTIONS` `Place.Field.GOOD_FOR_CHILDREN` `Place.Field.GOOD_FOR_GROUPS` `Place.Field.GOOD_FOR_WATCHING_SPORTS` `Place.Field.LIVE_MUSIC` `Place.Field.MENU_FOR_CHILDREN` `Place.Field.OUTDOOR_SEATING` `Place.Field.PARKING_OPTIONS` `Place.Field.PAYMENT_OPTIONS` `Place.Field.RESERVABLE` `Place.Field.RESTROOM` `Place.Field.REVIEWS` `Place.Field.SERVES_BEER` `Place.Field.SERVES_BREAKFAST` `Place.Field.SERVES_BRUNCH` `Place.Field.SERVES_COCKTAILS` `Place.Field.SERVES_COFFEE` `Place.Field.SERVES_DESSERT` `Place.Field.SERVES_DINNER` `Place.Field.SERVES_LUNCH` `Place.Field.SERVES_VEGETARIAN_FOOD` `Place.Field.SERVES_WINE` `Place.Field.TAKEOUT` Se uma sessão do Autocomplete for encerrada por uma chamada do Place Details que solicita qualquer campo da SKU: Place Details (Basic, Advanced ou Preferred), a chamada será faturada em SKU: Place Details (Preferred). Para mais informações, consulte SKU: Uso da sessão de preenchimento automático.
	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: Android: `Place.Field.ADDRESS_COMPONENTS` `Place.Field.BUSINESS_STATUS` `Place.Field.ADDRESS` `Place.Field.ICON_BACKGROUND_COLOR` `Place.Field.ICON_URL` `Place.Field.LAT_LNG` `Place.Field.PHOTO_METADATAS` `Place.Field.PLUS_CODE` `Place.Field.PRIMARY_TYPE` `Place.Field.PRIMARY_TYPE_DISPLAY_NAME` `Place.Field.ID` `Place.Field.NAME` `Place.Field.TYPES` `Place.Field.UTC_OFFSET` `Place.Field.VIEWPORT` `Place.Field.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: 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: Android: `Place.Field.CURRENT_OPENING_HOURS` `Place.Field.CURRENT_SECONDARY_OPENING_HOURS` `Place.Field.INTERNATIONAL_PHONE_NUMBER` `Place.Field.NATIONAL_PHONE_NUMBER` `Place.Field.OPENING_HOURS` `Place.Field.PRICE_LEVEL` `Place.Field.RATING` `Place.Field.SECONDARY_OPENING_HOURS` `Place.Field.USER_RATING_COUNT` `Place.Field.WEBSITE_URI` Campos descontinuados:os campos `Place.Field.PHONE_NUMBER` e `Place.Field.USER_RATINGS_TOTAL` foram descontinuados na versão 4.0 do SDK do Places para Android. Em vez disso, use `Place.Field.INTERNATIONAL_PHONE_NUMBER` e `Place.USER_RATING_COUNT`, respectivamente.
	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: Android: `Place.Field.ALLOWS_DOGS` `Place.Field.CURBSIDE_PICKUP` `Place.Field.DELIVERY` `Place.Field.DINE_IN` `Place.Field.EDITORIAL_SUMMARY` `Place.Field.EV_CHARGE_OPTIONS` `Place.Field.FUEL_OPTIONS` `Place.Field.GOOD_FOR_CHILDREN` `Place.Field.GOOD_FOR_GROUPS` `Place.Field.GOOD_FOR_WATCHING_SPORTS` `Place.Field.LIVE_MUSIC` `Place.Field.MENU_FOR_CHILDREN` `Place.Field.OUTDOOR_SEATING` `Place.Field.PARKING_OPTIONS` `Place.Field.PAYMENT_OPTIONS` `Place.Field.RESERVABLE` `Place.Field.RESTROOM` `Place.Field.REVIEWS` `Place.Field.SERVES_BEER` `Place.Field.SERVES_BREAKFAST` `Place.Field.SERVES_BRUNCH` `Place.Field.SERVES_COCKTAILS` `Place.Field.SERVES_COFFEE` `Place.Field.SERVES_DESSERT` `Place.Field.SERVES_DINNER` `Place.Field.SERVES_LUNCH` `Place.Field.SERVES_VEGETARIAN_FOOD` `Place.Field.SERVES_WINE` `Place.Field.TAKEOUT`
	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: Android: `Place.Field.DISPLAY_NAME` `Place.Field.ID` `Place.Field.RESOURCE_NAME` Campos descontinuados: O campo `Place.Field.NAME` foi descontinuado na versão 4.0 do SDK do Places para Android. Em vez disso, use `Place.Field.DISPLAY_NAME`. O campo `RESOURCE_NAME` contém o nome do recurso de lugar no formulário: `places/PLACE_ID`. Use `DISPLAY_NAME` para acessar o nome do lugar.
	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: Android: `Place.Field.ACCESSIBILITY_OPTIONS` `Place.Field.ADDRESS_COMPONENTS` `Place.Field.ADR_FORMAT_ADDRESS` `Place.Field.BUSINESS_STATUS` `Place.Field.FORMATTED_ADDRESS` `Place.Field.GOOGLE_MAPS_URI` `Place.Field.ICON_BACKGROUND_COLOR` `Place.Field.ICON_MASK_URL` `Place.Field.LOCATION` `Place.Field.PHOTO_METADATAS` `Place.Field.PLUS_CODE` `Place.Field.PRIMARY_TYPE` `Place.Field.PRIMARY_TYPE_DISPLAY_NAME` `Place.Field.SHORT_FORMATTED_ADDRESS` `Place.Field.SUB_DESTINATIONS` `Place.Field.TYPES` `Place.Field.UTC_OFFSET` `Place.Field.VIEWPORT` Campos descontinuados:os campos `Place.Field.ADDRESS`, `Place.Field.ICON_URL`, `Place.Field.LAT_LNG` e `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE` foram descontinuados na versão 4.0 do SDK do Places para Android. Em vez disso, use `Place.Field.FORMATTED_ADDRESS`, `Place.Field.ICON_MASK_URL`, `Place.Field.LOCATION` e `Place.ACCESSIBILITY_OPTIONS`, respectivamente. `Place.Field.ACCESSIBILITY_OPTIONS` está disponível apenas para "Detalhes do lugar (novo)".
	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: Android: `Place.Field.CURRENT_OPENING_HOURS` `Place.Field.CURRENT_SECONDARY_OPENING_HOURS` `Place.Field.INTERNATIONAL_PHONE_NUMBER` `Place.Field.NATIONAL_PHONE_NUMBER` `Place.Field.OPENING_HOURS` `Place.Field.PRICE_LEVEL` `Place.Field.RATING` `Place.Field.SECONDARY_OPENING_HOURS` `Place.Field.USER_RATING_COUNT` `Place.Field.WEBSITE_URI` Campos descontinuados:os campos `Place.Field.PHONE_NUMBER` e `Place.Field.USER_RATINGS_TOTAL` foram descontinuados na versão 4.0 do SDK do Places para Android. Em vez disso, use `Place.Field.INTERNATIONAL_PHONE_NUMBER` e `Place.USER_RATING_COUNT`, respectivamente.
	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: Android: `Place.Field.ALLOWS_DOGS` `Place.Field.CURBSIDE_PICKUP` `Place.Field.DELIVERY` `Place.Field.DINE_IN` `Place.Field.EDITORIAL_SUMMARY` `Place.Field.EV_CHARGE_OPTIONS` `Place.Field.FUEL_OPTIONS` `Place.Field.GOOD_FOR_CHILDREN` `Place.Field.GOOD_FOR_GROUPS` `Place.Field.GOOD_FOR_WATCHING_SPORTS` `Place.Field.LIVE_MUSIC` `Place.Field.MENU_FOR_CHILDREN` `Place.Field.OUTDOOR_SEATING` `Place.Field.PARKING_OPTIONS` `Place.Field.PAYMENT_OPTIONS` `Place.Field.RESERVABLE` `Place.Field.RESTROOM` `Place.Field.REVIEWS` `Place.Field.SERVES_BEER` `Place.Field.SERVES_BREAKFAST` `Place.Field.SERVES_BRUNCH` `Place.Field.SERVES_COCKTAILS` `Place.Field.SERVES_COFFEE` `Place.Field.SERVES_DESSERT` `Place.Field.SERVES_DINNER` `Place.Field.SERVES_LUNCH` `Place.Field.SERVES_VEGETARIAN_FOOD` `Place.Field.SERVES_WINE` `Place.Field.TAKEOUT`
	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

Detalhes da SKU legada do SDK do Places para Android

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.

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: 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` `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`.
	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: 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: Find Current Place

Esse SKU é cobrado por solicitações do 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.

	Categorias	Pro
	Evento faturável	Solicitação
	gatilhos	Essa SKU cobra por solicitações para os seguintes métodos: `findCurrentPlace()` (Android) `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) 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 `findCurrentPlace()` (Android) ou `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) e especifica apenas o campo `ADDRESS`. Sua fatura mostra estas SKUs: Find Current Place Basic Data Você faz uma solicitação `findCurrentPlace()` (Android) ou `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) e especifica o campo `PHONE_NUMBER`. Sua fatura mostra estas SKUs: Find Current Place Contact Data Você faz uma solicitação `findCurrentPlace()` (Android) ou `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) e especifica campos dos três buckets 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: 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

Restrições dos Termos de Uso

Para detalhes sobre os Termos de Uso, consulte a seção Restrições de licença dos Termos de Serviço da Plataforma Google Maps.