Esempi di codice di Places SDK per iOS

Seleziona la piattaforma: Android iOS JavaScript

L'app demo di Places SDK for iOS su GitHub fornita con Places SDK for iOS mostra una serie di funzionalità, tra cui Place Autocomplete e Place Photos. Inoltre, puoi trovare snippet di codice in ogni pagina di questa guida per gli sviluppatori. Importa e crea l'app, aggiungi la chiave API, visualizza la demo e utilizza il codice campione fornito come punto di partenza per la tua app.

Quando esegui l'app di esempio, viene visualizzato un elenco di esempi disponibili che puoi eseguire sul tuo dispositivo. Seleziona una delle opzioni.

Eseguire l'app di esempio completa in locale

L'app di esempio di Places SDK for iOS è disponibile come archivio scaricabile da GitHub Segui questi passaggi per installare e provare l'app di esempio di Places SDK for iOS.

  1. Scarica l'archivio dell'esempio di codice da GitHub ed estrailo. In alternativa, clona il repository in una directory locale: 
    git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git

  2. Apri una finestra del terminale, vai alla directory in cui hai espanso i file di esempio e visualizza in dettaglio la directory della versione che vuoi utilizzare:

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeproj

    Objective-C

    cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj
  3. Nel progetto Xcode, vai a File > Add Package Dependencies (File > Aggiungi dipendenze pacchetto). Inserisci https://github.com/googlemaps/ios-places-sdk come URL, premi Invio per estrarre il pacchetto e fai clic su Add Package.
  4. Abilita Places SDK for iOS e Maps SDK for iOS per il progetto della console Google Cloud.
  5. Ottieni una chiave API dal tuo progetto con l'API Places e/o l'API Places (novità) abilitata.
  6. Aggiungi la chiave API all'app seguendo le istruzioni appropriate riportate di seguito.

    SwiftUI

    Crea un file di configurazione locale denominato GooglePlacesDemos.xcconfig per la chiave API, nella stessa directory del file Info.plist dell'applicazione demo (GooglePlacesDemos/GooglePlacesDemos).

    Aggiungi due righe al file di configurazione per definire le chiavi API:

    PLACES_API_KEY = YOUR_PLACES_API_KEY e MAPS_API_KEY = YOUR_MAPS_API_KEY.

    Sostituisci YOUR_PLACES_API_KEY e YOUR_MAPS_API_KEY con le chiavi API dei passaggi precedenti.

    Per assistenza nella creazione di un file di configurazione locale, consulta Formato del file delle impostazioni di configurazione (xcconfig).

    Swift

    Modifica il file SDKDemoAPIKey e incolla la chiave API nella costante appropriata. Ad esempio:

    let placesAPIKey = "YOUR_API_KEY"

    Se presente, rimuovi la seguente riga:

    #error (Register for API Key and insert here. Then delete this line.)

    Se Xcode ti chiede di sbloccare il file SDKDemoAPIKey per la modifica, scegli Unlock (Sblocca).

    Objective-C

    Modifica il file SDKDemoAPIKey e incolla la chiave API nella costante appropriata. Ad esempio:

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    Se presente, rimuovi la seguente riga:

    #error (Register for API Key and insert here. Then delete this line.)

    Se Xcode ti chiede di sbloccare il file SDKDemoAPIKey per la modifica, scegli Unlock (Sblocca).

  7. Crea l'app.
  8. Se la build non va a buon fine o l'app si arresta in modo anomalo con un errore relativo alla chiave API al primo avvio, assicurati di aver fornito le chiavi richieste nelle istruzioni riportate sopra.
  9. Se esegui l'app di esempio, nella finestra del simulatore iOS viene visualizzato un elenco di demo di Places.
  10. Se ti viene chiesto di consentire all'app demo di accedere alla tua posizione, scegli Consenti.
  11. L'esempio che hai scelto è ora pronto per essere eseguito.