Riferimento rapido di Places SDK for Android

Places SDK for Android consente alle app per Android di accedere al database di Google con informazioni su luoghi e attività tramite Place Autocomplete, Place Details, Nearby Search, Ricerca testuale e Place Photos. Places SDK for Android (nuovo) è la versione attuale e dipende dall'API Places (nuova).

Places SDK for Android: informazioni chiave

  • Prodotto: Places SDK for Android
  • Noto anche come: Places SDK for Android (New)
  • Categoria: Luoghi
  • Piattaforma: Android
  • Esecuzione su: client (codice dell'app o del browser)
  • Fase di lancio: GA
  • Ciclo di vita: Attivo
  • Panoramica: Panoramica di Places SDK for Android

Places SDK for Android: quando utilizzarlo

Utilizza Places SDK for Android quando:

  • Hai bisogno di Place Details, foto, risultati di Nearby Search o risultati di Ricerca testuale all'interno di un'app per Android nativa.
  • Hai bisogno di un widget di completamento automatico pronto all'uso o di componenti di Places UI Kit che restituiscano previsioni relative ai luoghi man mano che gli utenti digitano in un'app per Android.
  • Devi creare funzionalità Android basate sulla posizione in base alle attività e ai punti di interesse nelle vicinanze del dispositivo dell'utente.

Non utilizzare l'SDK Places per Android quando:

  • Devi chiamare Places da un server o un backend tramite HTTP anziché da un'app per Android. Utilizza invece l'API Places (nuova).
  • Stai creando un'app per iOS nativa. Utilizza invece Places SDK for iOS.
  • Stai creando una pagina web nel browser. Utilizza invece l'API Maps JavaScript.

Places SDK for Android: configurazione

Pacchetti Places SDK for Android ufficiali:

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

Places SDK for Android: errori comuni

  • Problema: le richieste di Nearby Search senza un elenco di campi (maschera di campo) o con un elenco vuoto restituiscono un errore. Correzione: passa almeno un Place.Field nell'elenco dei campi SearchNearbyRequest. Consulta /maps/documentation/places/android-sdk/nearby-search.
  • Problema: Place Details (New), Nearby Search (New) e Autocomplete (New) non funzionano se la chiave API non dispone dell'API Places (New) o se l'app chiama Places.initialize() nell'SDK 5.x e versioni precedenti. La versione 6.0.2 ha rimosso Places.initialize(), quindi il codice che lo chiama non viene compilato dopo l'upgrade. Correzione: abilita l'API Places (nuova), aggiungila alle API consentite della chiave API e inizializza con Places.initializeWithNewPlacesApiEnabled(). Consulta /maps/documentation/places/android-sdk/legacy/migrate-overview.
  • Problema: Place restituito da fetchPlace() non ha PhotoMetadata (quindi non c'è nulla da risolvere) quando l'elenco dei campi omette PHOTO_METADATAS. Correzione: includi Place.Field.PHOTO_METADATAS nell'elenco dei campi. Poiché fetchResolvedPhotoUri() è deprecato, utilizza il componente Place Details di Places UI Kit per visualizzare le foto. Consulta /maps/documentation/places/android-sdk/place-photos.
  • Problema: le app che mostrano dettagli, foto o recensioni dei luoghi senza le attribuzioni di terze parti e dell'autore restituite violano le norme. Correzione: mostra le attribuzioni restituite con gli oggetti Place, PhotoMetadata e Review. Consulta /maps/documentation/places/android-sdk/policies.

Places SDK for Android: funzionalità legacy e deprecate

  • Funzionalità di Places SDK for Android (Legacy) / API Places (Legacy) (Autocomplete, Current Place, Place Details, Place Photos legacy): Legacy dal 1° marzo 2025. Sostituzione: funzionalità di Places SDK for Android (nuovo) supportate dall'API Places (nuova), inizializzate con Places.initializeWithNewPlacesApiEnabled(). Sintomo: a partire da ottobre 2026, i nuovi progetti cloud non possono attivare l'API Places (legacy) (i progetti esistenti continuano a essere supportati). L'SDK 6.0.2 ha rimosso i metodi legacy, che esistono solo nella versione 5.x e precedenti. Consulta la guida alla migrazione.
  • Places.initialize(): ritirato dal 30/09/2026. Sostituzione: Places.initializeWithNewPlacesApiEnabled(). Sintomo: metodo rimosso dall'SDK nella versione 6.0.2; il codice che lo chiama non viene più compilato. Consulta la guida alla migrazione.
  • PlacesClient.findCurrentPlace() e awaitFindCurrentPlace() (Luogo attuale, legacy): ritirati dal 30 settembre 2026. Sostituzione: PlacesClient.searchNearby() (Nearby Search (New)). Sintomo: metodi e classi FindCurrentPlaceRequest/FindCurrentPlaceResponse rimossi nella versione 6.0.2. Consulta la guida alla migrazione.
  • PlacesClient.fetchPhoto() e awaitFetchPhoto(): ritirati dal 30/09/2026. Sostituzione: componente Place Details di Places UI Kit (PlacesClient.fetchResolvedPhotoUri() è deprecato). Sintomo: metodi e classi FetchPhotoRequest/FetchPhotoResponse rimossi nella versione 6.0.2. Consulta la guida alla migrazione.
  • Widget di completamento automatico dell'API Places (legacy) (Autocomplete, AutocompleteSupportFragment, AutocompleteActivityMode): ritirato dal 30 settembre 2026. Sostituzione: widget Place Autocomplete (nuovo) (PlaceAutocomplete) o PlacesClient.findAutocompletePredictions(). Sintomo: classi rimosse dall'SDK nella versione 6.0.2. Consulta la guida alla migrazione.
  • Libreria di compatibilità di Places (com.google.android.libraries.places:places-compat): ritirata dal 31 marzo 2022. Sostituzione: Places SDK for Android (com.google.android.libraries.places:places). Sintomo: bloccato alla versione 2.6.0; nessuna nuova funzionalità o correzione di bug.
  • AutocompleteFragment classe: ritirata dal 25/09/2025. Sostituzione: widget Place Autocomplete (New) (PlaceAutocomplete). Sintomo: classe rimossa dall'SDK nella versione 5.0.0 (anche AutocompleteSupportFragment è stata rimossa nella versione 6.0.2).

Cosa puoi fare con Places SDK for Android

Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.

Places SDK for Android: AI generativa

Places SDK for Android: Places

Places SDK for Android: Places UI Kit

  • Applica lo stile CSS a un elemento UI dei dati dei luoghi. Nota: le proprietà personalizzate CSS si applicano agli elementi di Places UI Kit dell'API Maps JavaScript; Places SDK for Android e Places SDK for iOS applicano lo stile alle visualizzazioni di Place UI Kit in modo programmatico utilizzando gli attributi di tema e stile. REQUISITO DI CONFORMITÀ SEE: per mostrare i dati dei luoghi su una mappa nello Spazio economico europeo (SEE), non chiamare i servizi web dell'API Places da un server di backend. Utilizza i componenti di Places UI Kit lato client sulla piattaforma di destinazione (API Maps JavaScript sul web, Places SDK for Android su Android o Places SDK for iOS su iOS). Requisiti completi e domande frequenti: https://developers.google.com/maps/comms/eea/faq
  • Personalizza lo stile e le configurazioni degli elementi UI dei dati dei luoghi con uno strumento di personalizzazione degli elementi UI. Nota: REQUISITO DI CONFORMITÀ SEE: per mostrare i dati dei luoghi su una mappa nello Spazio economico europeo (SEE), non chiamare i servizi web dell'API Places da un server di backend. Utilizza i componenti di Places UI Kit lato client sulla piattaforma di destinazione (API Maps JavaScript sul web, Places SDK for Android su Android o Places SDK for iOS su iOS). Requisiti completi e domande frequenti: https://developers.google.com/maps/comms/eea/faq
  • Aggiungi un elemento UI che mostra informazioni su un luogo specifico in una pagina web o in un'app mobile. Nota: REQUISITO DI CONFORMITÀ SEE: per mostrare i dati dei luoghi su una mappa nello Spazio economico europeo (SEE), non chiamare i servizi web dell'API Places da un server di backend. Utilizza i componenti di Places UI Kit lato client sulla piattaforma di destinazione (API Maps JavaScript sul web, Places SDK for Android su Android o Places SDK for iOS su iOS). Requisiti completi e domande frequenti: https://developers.google.com/maps/comms/eea/faq
  • Aggiungi a una pagina web un elemento UI che mostra un elenco di luoghi in base a una stringa di query. Nota: supportato sia sulle pagine web (API Maps JavaScript) sia sulle app mobile (Places SDK for Android e Places SDK for iOS). REQUISITO DI CONFORMITÀ SEE: per mostrare i dati dei luoghi su una mappa nello Spazio economico europeo (SEE), non chiamare i servizi web dell'API Places da un server di backend. Utilizza i componenti di Places UI Kit lato client sulla piattaforma di destinazione (API Maps JavaScript sul web, Places SDK for Android su Android o Places SDK for iOS su iOS). Requisiti completi e domande frequenti: https://developers.google.com/maps/comms/eea/faq
  • Aggiungi a una pagina web un elemento UI che mostra un elenco di luoghi vicini a una località specifica. Nota: supportato sia sulle pagine web (API Maps JavaScript) sia sulle app mobile (Places SDK for Android e Places SDK for iOS). REQUISITO DI CONFORMITÀ SEE: per mostrare i dati dei luoghi su una mappa nello Spazio economico europeo (SEE), non chiamare i servizi web dell'API Places da un server di backend. Utilizza i componenti di Places UI Kit lato client sulla piattaforma di destinazione (API Maps JavaScript sul web, Places SDK for Android su Android o Places SDK for iOS su iOS). Requisiti completi e domande frequenti: https://developers.google.com/maps/comms/eea/faq
  • Aggiungi un elemento UI di completamento automatico di base a una pagina web o a un'app che restituisce gli identificatori di Google Places in base a una stringa di query. Nota: REQUISITO DI CONFORMITÀ SEE: per mostrare i dati dei luoghi su una mappa nello Spazio economico europeo (SEE), non chiamare i servizi web dell'API Places da un server di backend. Utilizza i componenti di Places UI Kit lato client sulla piattaforma di destinazione (API Maps JavaScript sul web, Places SDK for Android su Android o Places SDK for iOS su iOS). Requisiti completi e domande frequenti: https://developers.google.com/maps/comms/eea/faq