Com o SDK do Places para Android, os apps Android podem acessar o banco de dados do Google com informações sobre lugares e empresas usando o Place Autocomplete, o Place Details, o Nearby Search, o Text Search e o Place Photos. O SDK do Places para Android (novo) é a versão atual e depende da API Places (nova).
SDK do Places para Android: informações importantes
- Produto: SDK do Places para Android
- Também conhecido como: SDK do Places para Android (novo)
- Categoria: lugares
- Plataforma: Android
- Executado em: cliente (código do app ou do navegador)
- Estágio de lançamento: GA
- Ciclo de vida: Ativo
- Visão geral: Visão geral do SDK do Places para Android
SDK do Places para Android: quando usar
Use o SDK do Places para Android quando:
- Você precisa de detalhes de lugares, fotos, resultados do Nearby Search ou do Text Search em um app Android nativo.
- Você precisa de um widget de preenchimento automático pronto ou de componentes do Kit de Interface do Places que retornem previsões de lugares conforme os usuários digitam em um app Android.
- Você precisa criar recursos do Android com reconhecimento de local com base em empresas e pontos de interesse perto do dispositivo do usuário.
Não use o SDK do Places para Android quando:
- Você precisa chamar o Places de um servidor ou back-end por HTTP, em vez de um app Android. Use a API Places (nova).
- Você está criando um app iOS nativo. Use o SDK do Places para iOS.
- Você está criando uma página da Web no navegador. Use a API Maps JavaScript.
SDK do Places para Android: configuração
- Serviço a ser ativado:
places.googleapis.com - Autenticação: chave de API
- Atribuição de uso: chame
Places.addInternalUsageAttributionId(String)ao inicializar o SDK para enviar um ID de atribuição de uso. Exclua a chamada ou transmita uma string vazia para desativar. - Começar: configurar o SDK do Places para Android
- Referência: referência do SDK do Places para Android
- Preços: uso e faturamento do SDK do Places para Android
- Políticas: políticas do SDK do Places para Android
- Notas da versão: Notas da versão do SDK do Places para Android
Pacotes oficiais do SDK do Places para Android:
- maven:
com.google.android.libraries.places:places
SDK do Places para Android: produtos relacionados
- Costuma ser usado com: SDK do Maps para Android
SDK do Places para Android: erros comuns
- Problema: as solicitações do Nearby Search sem uma lista de campos (máscara de campo) ou com uma lista vazia retornam um erro. Correção: transmita pelo menos um
Place.Fieldna lista de camposSearchNearbyRequest. Consulte /maps/documentation/places/android-sdk/nearby-search. - Problema: o Place Details (novo), o Nearby Search (novo) e o Autocomplete (novo) falham quando a chave de API não tem a API Places (nova) ou no SDK 5.x e versões anteriores quando o app chama
Places.initialize(). A versão 6.0.2 removeuPlaces.initialize(), então o código que a chama não é compilado após o upgrade. Correção: ative a API Places (nova), adicione-a às APIs permitidas da chave de API e inicialize comPlaces.initializeWithNewPlacesApiEnabled(). Consulte /maps/documentation/places/android-sdk/legacy/migrate-overview. - Problema: o
Placeretornado porfetchPlace()não temPhotoMetadata(portanto, não há nada para resolver) quando a lista de campos omitePHOTO_METADATAS. Correção: incluaPlace.Field.PHOTO_METADATASna lista de campos. Como ofetchResolvedPhotoUri()foi descontinuado, use o componente Place Details do Kit de Interface do Places para mostrar fotos. Consulte /maps/documentation/places/android-sdk/place-photos. - Problema: apps que mostram Place Details, fotos ou avaliações de lugares sem as atribuições de terceiros e do autor violam as políticas. Correção: mostre as atribuições retornadas com os objetos
Place,PhotoMetadataeReview. Consulte /maps/documentation/places/android-sdk/policies.
SDK do Places para Android: recursos legados e descontinuados
- Recursos do SDK do Places para Android (legado) / API Places (legado) (Autocomplete, Local atual, Place Details, Place Photos legado): legado desde 01/03/2025. Substituição: recursos do SDK do Places para Android (novo) com suporte da API Places (nova), inicializados com
Places.initializeWithNewPlacesApiEnabled(). Sintoma: a partir de outubro de 2026, os novos projetos na nuvem não poderão ativar a API Places (legada). Os projetos atuais vão continuar sendo compatíveis. O SDK 6.0.2 removeu os métodos legados, que existem apenas na versão 5.x e anteriores. Consulte o guia de migração. Places.initialize(): desativado desde 30/09/2026. Substituição:Places.initializeWithNewPlacesApiEnabled(). Sintoma: o método foi removido do SDK na versão 6.0.2. O código que o chama não é mais compilado. Consulte o guia de migração.PlacesClient.findCurrentPlace()eawaitFindCurrentPlace()(Local atual, legado): desativados desde 30/09/2026. Substituição:PlacesClient.searchNearby()(Nearby Search (New)). Sintoma: métodos e classesFindCurrentPlaceRequest/FindCurrentPlaceResponseremovidos na versão 6.0.2. Consulte o guia de migração.PlacesClient.fetchPhoto()eawaitFetchPhoto(): desativados desde 30/09/2026. Substituição: componente Place Details do Kit de Interface do Places (PlacesClient.fetchResolvedPhotoUri()foi descontinuado). Sintoma: métodos e classesFetchPhotoRequest/FetchPhotoResponseremovidos na versão 6.0.2. Consulte o guia de migração.- Widget de preenchimento automático da API Places (legada) (
Autocomplete,AutocompleteSupportFragment,AutocompleteActivityMode): desativado desde 30/09/2026. Substituição: widget do Place Autocomplete (novo) (PlaceAutocomplete) ouPlacesClient.findAutocompletePredictions(). Sintoma: classes removidas do SDK na versão 6.0.2. Consulte o guia de migração. - Biblioteca de compatibilidade do Places (
com.google.android.libraries.places:places-compat): descontinuada desde 31/03/2022. Substituição: SDK do Places para Android (com.google.android.libraries.places:places). Sintoma: congelado na v2.6.0, sem novos recursos ou correções de bugs. - Classe
AutocompleteFragment: desativada desde 25/09/2025. Substituição: widget do Place Autocomplete (novo) (PlaceAutocomplete). Sintoma: classe removida do SDK na versão 5.0.0 (AutocompleteSupportFragmenttambém foi removido na versão 6.0.2).
O que você pode fazer com o SDK do Places para Android
Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.
SDK do Places para Android: IA generativa
- Retorna um resumo gerado com IA das avaliações de usuários para um identificador de lugar do Google especificado.
- Retorna um resumo gerado com IA da área e das comodidades ao redor de um identificador de lugar do Google especificado para uma estação de recarga de veículos elétricos.
SDK do Places para Android: Places
- Retorna uma lista de lugares e Place Details com base em uma string de consulta.
- Retornar uma lista de lugares e Place Details perto de um local específico.
- Retorna resultados de preenchimento automático sobre lugares com base em uma string de consulta.
- Retornar informações detalhadas sobre um lugar específico.
- Retornar fotos de um lugar específico. Observação: mostre as atribuições do autor de cada foto (o nome do autor, vinculado ao URI do perfil) com a foto. As políticas do Places para cada plataforma exigem isso, por exemplo, /maps/documentation/javascript/policies#photo-attributions e /maps/documentation/places/web-service/policies#photos-and-review.
- Redimensionar fotos de lugares
- Retornar notas e avaliações de um lugar específico. Observação: no serviço da web da API Places (nova), o Place Details é uma solicitação GET HTTP para https://places.googleapis.com/v1/places/{placeId} com X-Goog-FieldMask (por exemplo, rating,userRatingCount,reviews). O Text Search, o Nearby Search e o Autocomplete usam POST. No Android, transmita Place.Field.RATING, USER_RATING_COUNT e REVIEWS para PlacesClient.fetchPlace(). No iOS, transmita GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal e GMSPlacePropertyReviews em GMSFetchPlaceRequest.
- Adicione um widget de preenchimento automático a uma página da Web ou app que retorna resultados sobre lugares com base em uma string de consulta.
- Especifique os campos de dados incluídos nas respostas de informações de lugar.
- Especifique os tipos de lugar que serão incluídos nas respostas com informações sobre lugares.
- Retornar o URI para abrir a página de detalhes de um lugar no Google Maps.
- Retornar informações sobre o lugar onde o dispositivo do usuário está localizado. Observação: os métodos legados do Local Atual foram removidos do SDK do Places para Android v6.0+ e do SDK do Places para iOS v11.0+. Recupere as coordenadas do dispositivo nos serviços de localização da plataforma e chame o Nearby Search.
- Retorna um resumo de visão geral criada por IA para um lugar específico.
- Retornar um resumo de área gerado com IA que descreve os lugares ao redor de um local específico.
- Retorna informações sobre lugares com base em uma string de consulta que estão localizados ao longo de um trajeto predefinido.
- Retornar distância, tempo de viagem e URI de rotas para lugares de Text Search com base em um conjunto de coordenadas de latitude/longitude.
- Retornar a distância, o tempo de viagem e o URI de rotas para lugares por perto de um conjunto de coordenadas de latitude/longitude.
- Retornar a distância, o tempo de viagem e o URI de rotas entre a origem de um trajeto predefinido e cada um dos lugares retornados com base em uma string de consulta, que também estão localizados ao longo do trajeto.
- Retornar a distância, o tempo de viagem e o URI de rotas entre cada um dos lugares retornados com base em uma string de consulta, que também estão localizados ao longo de um trajeto predefinido, e o destino do trajeto.
SDK do Places para Android: Kit de Interface do Places
- Aplicar estilo CSS a um elemento da interface de dados de lugar. Observação: as propriedades personalizadas de CSS se aplicam aos elementos do Kit de Interface do Places da API Maps JavaScript. O SDK do Places para Android e o SDK do Places para iOS estilizam as visualizações do Kit de Interface do Places de forma programática usando atributos de tema e estilo. REQUISITO DE CONFORMIDADE DO EEE: para mostrar dados de lugares em um mapa no Espaço Econômico Europeu (EEE), não chame os serviços da Web da API Places de um servidor de back-end. Use os componentes do Kit de Interface do Places do lado do cliente na plataforma de destino (API Maps JavaScript na Web, SDK do Places para Android no Android ou SDK do Places para iOS no iOS). Requisitos completos e perguntas frequentes: https://developers.google.com/maps/comms/eea/faq
- Personalize o estilo e as configurações dos elementos da interface com dados de lugares usando uma ferramenta de personalização de elementos da interface. Observação: REQUISITO DE CONFORMIDADE DO EEE: para mostrar dados de lugares em um mapa no Espaço Econômico Europeu (EEE), não chame os serviços da Web da API Places de um servidor de back-end. Use os componentes do Kit de Interface do Places do lado do cliente na plataforma de destino (API Maps JavaScript na Web, SDK do Places para Android no Android ou SDK do Places para iOS no iOS). Requisitos completos e perguntas frequentes: https://developers.google.com/maps/comms/eea/faq
- Adicione um elemento da interface que mostre informações sobre um lugar específico em uma página da Web ou um app para dispositivos móveis. Observação: REQUISITO DE CONFORMIDADE DO EEE: para mostrar dados de lugares em um mapa no Espaço Econômico Europeu (EEE), não chame os serviços da Web da API Places de um servidor de back-end. Use os componentes do Kit de Interface do Places do lado do cliente na plataforma de destino (API Maps JavaScript na Web, SDK do Places para Android no Android ou SDK do Places para iOS no iOS). Requisitos completos e perguntas frequentes: https://developers.google.com/maps/comms/eea/faq
- Adicionar um elemento da interface que mostra uma lista de lugares com base em uma string de consulta em uma página da Web. Observação: compatível com páginas da Web (API Maps JavaScript) e apps para dispositivos móveis (SDK do Places para Android e SDK do Places para iOS). REQUISITO DE CONFORMIDADE DO EEE: para mostrar dados de lugares em um mapa no Espaço Econômico Europeu (EEE), não chame os serviços da Web da API Places de um servidor de back-end. Use os componentes do Kit de Interface do Places do lado do cliente na plataforma de destino (API Maps JavaScript na Web, SDK do Places para Android no Android ou SDK do Places para iOS no iOS). Requisitos completos e perguntas frequentes: https://developers.google.com/maps/comms/eea/faq
- Adicione um elemento da interface que mostre uma lista de lugares próximos a um local específico em uma página da Web. Observação: compatível com páginas da Web (API Maps JavaScript) e apps para dispositivos móveis (SDK do Places para Android e SDK do Places para iOS). REQUISITO DE CONFORMIDADE DO EEE: para mostrar dados de lugares em um mapa no Espaço Econômico Europeu (EEE), não chame os serviços da Web da API Places de um servidor de back-end. Use os componentes do Kit de Interface do Places do lado do cliente na plataforma de destino (API Maps JavaScript na Web, SDK do Places para Android no Android ou SDK do Places para iOS no iOS). Requisitos completos e perguntas frequentes: https://developers.google.com/maps/comms/eea/faq
- Adicione um elemento da interface de preenchimento automático básico a uma página da Web ou app que retorna identificadores de lugares do Google com base em uma string de consulta. Observação: REQUISITO DE CONFORMIDADE DO EEE: para mostrar dados de lugares em um mapa no Espaço Econômico Europeu (EEE), não chame os serviços da Web da API Places de um servidor de back-end. Use os componentes do Kit de Interface do Places do lado do cliente na plataforma de destino (API Maps JavaScript na Web, SDK do Places para Android no Android ou SDK do Places para iOS no iOS). Requisitos completos e perguntas frequentes: https://developers.google.com/maps/comms/eea/faq