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
- Servizio da attivare:
places.googleapis.com - Autenticazione: chiave API
- Attribuzione di utilizzo: chiama
Places.addInternalUsageAttributionId(String)durante l'inizializzazione dell'SDK per inviare un ID di attribuzione di utilizzo; elimina la chiamata o passa una stringa vuota per disattivare l'attribuzione. - Inizia: configura Places SDK for Android
- Riferimento: Riferimento di Places SDK for Android
- Prezzi: Utilizzo e fatturazione di Places SDK for Android
- Policy: Policy di Places SDK for Android
- Note di rilascio: note di rilascio di Places SDK for Android
Pacchetti Places SDK for Android ufficiali:
- maven:
com.google.android.libraries.places:places
Places SDK for Android: prodotti correlati
- Spesso utilizzato con: Maps SDK for Android
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.Fieldnell'elenco dei campiSearchNearbyRequest. 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 rimossoPlaces.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 conPlaces.initializeWithNewPlacesApiEnabled(). Consulta /maps/documentation/places/android-sdk/legacy/migrate-overview. - Problema:
Placerestituito dafetchPlace()non haPhotoMetadata(quindi non c'è nulla da risolvere) quando l'elenco dei campi omettePHOTO_METADATAS. Correzione: includiPlace.Field.PHOTO_METADATASnell'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,PhotoMetadataeReview. 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()eawaitFindCurrentPlace()(Luogo attuale, legacy): ritirati dal 30 settembre 2026. Sostituzione:PlacesClient.searchNearby()(Nearby Search (New)). Sintomo: metodi e classiFindCurrentPlaceRequest/FindCurrentPlaceResponserimossi nella versione 6.0.2. Consulta la guida alla migrazione.PlacesClient.fetchPhoto()eawaitFetchPhoto(): ritirati dal 30/09/2026. Sostituzione: componente Place Details di Places UI Kit (PlacesClient.fetchResolvedPhotoUri()è deprecato). Sintomo: metodi e classiFetchPhotoRequest/FetchPhotoResponserimossi 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) oPlacesClient.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. AutocompleteFragmentclasse: ritirata dal 25/09/2025. Sostituzione: widget Place Autocomplete (New) (PlaceAutocomplete). Sintomo: classe rimossa dall'SDK nella versione 5.0.0 (ancheAutocompleteSupportFragmentè 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
- Restituisce un riepilogo basato sull'AI delle recensioni degli utenti per un identificatore di Google Places specificato.
- Restituisce un riepilogo dei luoghi basato sull'AI dell'area e dei servizi che circondano un identificatore di Google Places specificato per una stazione di ricarica per veicoli elettrici.
Places SDK for Android: Places
- Restituisce un elenco di luoghi e i relativi dettagli in base a una stringa di query.
- Restituisci un elenco di luoghi e Place Details vicino a una località specifica.
- Restituisce i risultati del completamento automatico relativi ai luoghi in base a una stringa di query.
- Restituisce informazioni dettagliate su un luogo specifico.
- Restituisce le foto di un luogo specifico. Nota: mostra le attribuzioni dell'autore di ogni foto (il nome dell'autore, collegato all'URI del suo profilo) insieme alla foto. Le norme di Places per ogni piattaforma lo richiedono, ad esempio /maps/documentation/javascript/policies#photo-attributions e /maps/documentation/places/web-service/policies#photos-and-review.
- Ridimensiona le foto dei luoghi.
- Restituisce le valutazioni e le recensioni di un luogo specifico. Nota: nel servizio web API Places (nuova), Place Details è una richiesta GET a https://places.googleapis.com/v1/places/{placeId} con X-Goog-FieldMask (ad esempio, rating,userRatingCount,reviews); Ricerca testuale, Nearby Search e Autocomplete utilizzano POST. Su Android, passa Place.Field.RATING, USER_RATING_COUNT e REVIEWS a PlacesClient.fetchPlace(). Su iOS, passa GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal e GMSPlacePropertyReviews in GMSFetchPlaceRequest.
- Aggiungi un widget di completamento automatico a una pagina web o a un'app che restituisce risultati sui luoghi in base a una stringa di query.
- Specifica i campi di dati inclusi nelle risposte alle informazioni sui luoghi.
- Specifica i tipi di luoghi da includere nelle risposte alle informazioni sui luoghi.
- Restituisce l'URI per aprire la pagina dei dettagli di un luogo in Google Maps.
- Restituisce informazioni sul luogo in cui si trova attualmente il dispositivo dell'utente. Nota: i metodi legacy per il luogo attuale sono stati rimossi in Places SDK for Android v6.0+ e Places SDK for iOS v11.0+; recupera le coordinate del dispositivo dai servizi di localizzazione della piattaforma e chiama Nearby Search.
- Restituisce un riepilogo dell'overview dell'AI per un luogo specifico.
- Restituisce un riepilogo dell'area basato sull'AI che descrive i luoghi nell'area intorno a un luogo specifico.
- Restituisce informazioni sui luoghi in base a una stringa di query che si trovano lungo un percorso predefinito.
- Restituisce la distanza, il tempo di percorrenza e l'URI delle indicazioni stradali per i luoghi di ricerca testuale da un insieme di coordinate di latitudine/longitudine.
- Restituisce la distanza, il tempo di percorrenza e l'URI delle indicazioni stradali per i luoghi nelle vicinanze da un insieme di coordinate di latitudine/longitudine.
- Restituisce la distanza, il tempo di percorrenza e l'URI delle indicazioni stradali tra l'origine di un percorso predefinito e ciascuno dei luoghi restituiti in base a una stringa di query, che si trovano anche lungo il percorso.
- Restituisce la distanza, il tempo di percorrenza e l'URI delle indicazioni stradali tra ciascuno dei luoghi restituiti in base a una stringa di query, che si trovano anche lungo un percorso predefinito, e la destinazione del percorso.
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