Riferimento rapido di Places SDK for iOS

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:

Places SDK for iOS: configurazione

Pacchetti Places SDK for iOS ufficiali:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

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, GMSAutocompleteFetcher e GMSAutocompleteViewController) non esistono nell'SDK 11.0.0 e versioni successive, interrompendo la compilazione. Consulta la guida alla migrazione.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner e GMSAutocompleteFetcher initWithBounds:filter: ritirato dal 13 ottobre 2020. Sostituzione: GMSAutocompleteFilter (locationBias o locationRestriction) su GMSAutocompleteRequest con GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: o i modificatori GooglePlacesSwift placeAutocomplete o basicPlaceAutocomplete per un widget UI. Sintomo: i metodi non esistono nell'SDK 4.0.0 e versioni successive (e GMSAutocompleteResultsViewController e GMSAutocompleteFetcher sono stati rimossi nell'SDK 11.0.0). Consulta la guida alla migrazione.
  • Limiti di completamento automatico basati su GMSCoordinateBounds (GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode; parametri bounds/boundsMode di findAutocompletePredictionsFromQuery e autocompleteQuery): ritirati dal 13/10/2020. Sostituzione: GMSAutocompleteRequest con GMSAutocompleteFilter (locationBias o locationRestriction) e GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: o i modificatori GooglePlacesSwift placeAutocomplete o basicPlaceAutocomplete per un widget UI. Sintomo: le proprietà e i parametri non esistono nell'SDK 4.0.0 e versioni successive (e GMSAutocompleteViewController e findAutocompletePredictionsFromQuery sono stati rimossi nell'SDK 11.0.0). Consulta la guida alla migrazione.
  • GMSPlace.openNowStatus: ritirato dal 13/10/2020. Sostituzione: GMSPlacesClient isOpenWithRequest:callback: (GMSPlaceIsOpenRequest) o PlacesClient.isPlaceOpen(with:) in GooglePlacesSwift. Sintomo: la proprietà non esiste nell'SDK 4.0.0 e versioni successive. Consulta la guida alla migrazione.
  • GMSPlaceField come NS_ENUM: Dismesso dal 13/10/2020. Sostituzione: costanti GMSPlaceProperty con classi di richiesta come GMSFetchPlaceRequest e GMSPlaceSearchByTextRequest o PlaceProperty in GooglePlacesSwift. Sintomo: sostituito da NS_OPTIONS nell'SDK 4.0.0 (GMSPlaceField come NS_OPTIONS appartiene 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

Places SDK for iOS: Places

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