Referência rápida do SDK do Places para Android

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:

SDK do Places para Android: configuração

Pacotes oficiais do SDK do Places para Android:

  • maven: com.google.android.libraries.places:places

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.Field na lista de campos SearchNearbyRequest. 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 removeu Places.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 com Places.initializeWithNewPlacesApiEnabled(). Consulte /maps/documentation/places/android-sdk/legacy/migrate-overview.
  • Problema: o Place retornado por fetchPlace() não tem PhotoMetadata (portanto, não há nada para resolver) quando a lista de campos omite PHOTO_METADATAS. Correção: inclua Place.Field.PHOTO_METADATAS na lista de campos. Como o fetchResolvedPhotoUri() 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, PhotoMetadata e Review. 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() e awaitFindCurrentPlace() (Local atual, legado): desativados desde 30/09/2026. Substituição: PlacesClient.searchNearby() (Nearby Search (New)). Sintoma: métodos e classes FindCurrentPlaceRequest/FindCurrentPlaceResponse removidos na versão 6.0.2. Consulte o guia de migração.
  • PlacesClient.fetchPhoto() e awaitFetchPhoto(): desativados desde 30/09/2026. Substituição: componente Place Details do Kit de Interface do Places (PlacesClient.fetchResolvedPhotoUri() foi descontinuado). Sintoma: métodos e classes FetchPhotoRequest/FetchPhotoResponse removidos 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) ou PlacesClient.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 (AutocompleteSupportFragment també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

SDK do Places para Android: Places

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