Places SDK for iOS consente alle app per iOS di ottenere informazioni sui luoghi (attività, punti di interesse, posizioni geografiche) tramite Place Details, Place Photos, Ricerca testuale, Nearby Search e Autocomplete. L'API Places (nuova) è la versione corrente dell'SDK.
Places SDK for iOS: informazioni chiave
- Prodotto: Places SDK for iOS
- Noto anche come: Places SDK for iOS (nuovo)
- Categoria: Luoghi
- Piattaforma: iOS
- Esecuzione su: client (codice dell'app o del browser)
- Fase di lancio: GA
- Ciclo di vita: Attivo
- Panoramica: Panoramica di Places SDK for iOS
Places SDK for iOS: quando utilizzarlo
Utilizza Places SDK for iOS quando:
- Hai bisogno di Place Details, foto, Ricerca testuale o risultati di Nearby Search all'interno di un'app per iOS nativa.
- Devi completare automaticamente il nome o l'indirizzo di un luogo mentre gli utenti digitano in un'app per iOS.
- Vuoi componenti predefiniti di Places UI Kit (Place Details, ricerca, completamento automatico) in un'app per iOS.
Non utilizzare Places SDK for iOS quando:
- Stai creando un'app per Android nativa. Utilizza invece Places SDK for Android.
- Stai creando una pagina web nel browser. Utilizza invece l'API Maps JavaScript.
- Devi inserire i dati da un server o un backend tramite HTTP anziché in un client iOS. Utilizza l'API Places (novità).
Places SDK for iOS: configurazione
- Servizio da attivare:
places.googleapis.com - Autenticazione: chiave API
- Attribuzione di utilizzo: chiama il metodo della classe
addInternalUsageAttributionIDsuGMSPlacesClient(Objective-C/Swift) oPlacesClient(GooglePlacesSwift) per aggiungere un ID di attribuzione di utilizzo; l'eliminazione della chiamata comporta la disattivazione. - Inizia: configura Places SDK for iOS
- Riferimento: Riferimento di Places SDK for iOS
- Prezzi: Utilizzo e fatturazione di Places SDK for iOS
- Policy: Policy di Places SDK for iOS
- Note di rilascio: note di rilascio di Places SDK for iOS
Pacchetti Places SDK for iOS ufficiali:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
Places SDK for iOS: prodotti correlati
- Spesso utilizzato con: Maps SDK for iOS
Places SDK for iOS: errori comuni
- Problema: le chiamate a Places SDK for iOS (New) non vanno a buon fine se l'API Places (New) non è abilitata nel progetto cloud o non è presente nell'elenco delle API autorizzate della chiave API. Correzione: abilita l'API Places (novità) e aggiungila alle restrizioni delle chiavi API utilizzate dall'app. Consulta /maps/documentation/places/ios-sdk/legacy/migrate-overview.
- Problema:
kGMSPlacesRateLimitExceeded(-7) indica che la chiave API ha superato il limite di frequenza di utilizzo; anche le app su versioni SDK 2.x disattivate (disattivate il 29 luglio 2019) ricevono questo errore. Correzione: controlla la quota e l'utilizzo dell'API Places (nuova) nella console Google Cloud e aggiorna le app alle versioni dell'SDK precedenti alla 3.0. Consulta /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode. - Problema: i token di sessione riutilizzati tra app nello stesso progetto o tra sessioni interrompono il raggruppamento della fatturazione delle sessioni di completamento automatico. Correzione: genera un token di sessione univoco (si consiglia l'uso di UUID versione 4) per ogni sessione di completamento automatico. I token devono essere univoci per progetto. Consulta /maps/documentation/places/ios-sdk/use-session-tokens.
- Problema: le app mostrano i dati dei luoghi senza le attribuzioni restituite dall'API. Correzione: mostra tutte le attribuzioni pertinenti restituite con i dati di Places, come indicato nella pagina delle norme. Consulta /maps/documentation/places/ios-sdk/overview.
Places SDK for iOS: funzionalità legacy e deprecate
- Places SDK for iOS (versione precedente): versione precedente dal 1° marzo 2025. Sostituzione: Places SDK for iOS (nuovo) (richiede l'API Places (nuova)). Sintomo: le classi e i metodi legacy (ad esempio
fetchPlaceFromPlaceID,GMSAutocompleteFetchereGMSAutocompleteViewController) non esistono nell'SDK 11.0.0 e versioni successive, interrompendo la compilazione. Consulta la guida alla migrazione. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornereGMSAutocompleteFetcherinitWithBounds:filter: ritirato dal 13 ottobre 2020. Sostituzione:GMSAutocompleteFilter(locationBiasolocationRestriction) suGMSAutocompleteRequestconGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:o i modificatoriGooglePlacesSwiftplaceAutocompleteobasicPlaceAutocompleteper un widget UI. Sintomo: i metodi non esistono nell'SDK 4.0.0 e versioni successive (eGMSAutocompleteResultsViewControllereGMSAutocompleteFetchersono stati rimossi nell'SDK 11.0.0). Consulta la guida alla migrazione.- Limiti di completamento automatico basati su
GMSCoordinateBounds(GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode; parametribounds/boundsModedifindAutocompletePredictionsFromQueryeautocompleteQuery): ritirati dal 13/10/2020. Sostituzione:GMSAutocompleteRequestconGMSAutocompleteFilter(locationBiasolocationRestriction) eGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:o i modificatoriGooglePlacesSwiftplaceAutocompleteobasicPlaceAutocompleteper un widget UI. Sintomo: le proprietà e i parametri non esistono nell'SDK 4.0.0 e versioni successive (eGMSAutocompleteViewControllerefindAutocompletePredictionsFromQuerysono stati rimossi nell'SDK 11.0.0). Consulta la guida alla migrazione. GMSPlace.openNowStatus: ritirato dal 13/10/2020. Sostituzione:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) oPlacesClient.isPlaceOpen(with:)inGooglePlacesSwift. Sintomo: la proprietà non esiste nell'SDK 4.0.0 e versioni successive. Consulta la guida alla migrazione.GMSPlaceFieldcomeNS_ENUM: Dismesso dal 13/10/2020. Sostituzione: costantiGMSPlacePropertycon classi di richiesta comeGMSFetchPlaceRequesteGMSPlaceSearchByTextRequestoPlacePropertyinGooglePlacesSwift. Sintomo: sostituito daNS_OPTIONSnell'SDK 4.0.0 (GMSPlaceFieldcomeNS_OPTIONSappartiene all'API precedente e non esiste nell'SDK 11.0.0 e versioni successive). Consulta la guida alla migrazione.- Places SDK per iOS versione 2.7.0: Dismesso dal 29-07-2019. Sostituzione: versione attuale di Places SDK for iOS. Sintomo: errori
kGMSPlacesRateLimitExceeded.
Cosa puoi fare con Places SDK for iOS
Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.
Places SDK for iOS: 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 iOS: 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 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 versioni successive e in Places SDK for iOS v11.0 e versioni successive; 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.
Places SDK for iOS: 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