Panoramica e configurazione di Places per Android KTX
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Places Android KTX è una raccolta di estensioni Kotlin per
Places SDK for Android. Queste estensioni forniscono funzionalità del linguaggio Kotlin che ti consentono di scrivere codice Kotlin conciso e idiomatico durante lo sviluppo per Places SDK for Android.
Places KTX è open source e disponibile su
GitHub
insieme a degli esempi.
Installa KTX per Places SDK
Per installare KTX per Places SDK per Android, aggiungi le
seguenti dipendenze al file build.gradle.kts a livello di app.
dependencies{// KTX for the Places SDK for Android libraryimplementation("com.google.maps.android:places-ktx:3.3.1")}
Prova l'applicazione di esempio
Il repository GitHub per questa libreria contiene anche un'applicazione
demo
che mostra come utilizzare la libreria Places KTX nella tua app.
Nella directory root, crea un file denominato
secrets.properties. Questo file NON deve essere sottoposto a controllo
delle versioni per proteggere la tua chiave API.
Aggiungi questa singola riga a secrets.properties
PLACES_API_KEY="YOUR_API_KEY"
dove YOUR_API_KEY è la chiave API effettiva ottenuta nel
primo passaggio. Puoi esaminare
local.defaults.properties
come esempio.
Nella configurazione di esecuzione, seleziona il modulo
app-places-ktx.
[null,null,["Ultimo aggiornamento 2025-08-22 UTC."],[[["\u003cp\u003ePlaces Android KTX offers Kotlin extensions for streamlined Places SDK interaction using idiomatic Kotlin.\u003c/p\u003e\n"],["\u003cp\u003eNative Kotlin APIs within the Places SDK for Android (version 4.0.0 and later) can be used as an alternative to Places Android KTX extensions.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can easily integrate Places KTX by adding the specified dependency to their app's \u003ccode\u003ebuild.gradle.kts\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eA demo application within the GitHub repository provides practical examples of utilizing the Places KTX library.\u003c/p\u003e\n"]]],["Places KTX provides Kotlin extensions for the Places SDK for Android, enabling concise Kotlin development. Install it by adding the `com.google.maps.android:places-ktx:3.3.1` dependency to your app's `build.gradle.kts` file. A demo app is available on GitHub; to run it, clone the repository, obtain a Places API key, and store it in a `secrets.properties` file in the root directory. Select and Run the **app-places-ktx** module in Android Studio. The Places SDK also offers native Kotlin APIs as of version 4.0.0.\n"],null,["Places Android KTX is a collection of Kotlin extensions for the\nPlaces SDK for Android. These extensions provide Kotlin\nlanguage features that enable you to write concise and idiomatic Kotlin when\ndeveloping for the Places SDK for Android.\nPlaces KTX is open-sourced and available on\n[GitHub](https://github.com/googlemaps/android-places-ktx)\nalong with examples.\n| **Note:** As of [version\n| 4.0.0](/maps/documentation/places/android-sdk/release-notes), the Places SDK for Android includes native Kotlin APIs that can be used instead of the Places Android KTX extensions. For more information, see the Places SDK for Android [Reference\n| Overview](/maps/documentation/places/android-sdk/reference).\n\nInstall KTX for the Places SDK\n\nTo install KTX for the Places SDK for Android, add the\nfollowing dependencies to your app-level `build.gradle.kts` file. \n\n```carbon\ndependencies {\n\n // KTX for the Places SDK for Android library\n implementation(\"com.google.maps.android:places-ktx:3.3.1\")\n}\n```\n\nTry the sample application\n\nThe GitHub repository for this library also contains a [demo\napplication](https://github.com/googlemaps/android-places-ktx)\nthat shows how you can use the Places KTX library in your own app.\n\n|---|---|\n| | |\n\nTo try the demo application, follow these steps:\n\n1. From [GitHub](https://github.com/googlemaps/android-places-ktx), clone the or download the ZIP file.\n2. In Android Studio, choose **File -\\\u003e Open** and navigate to the directory and open the folder that you just cloned or downloaded.\n3. Add an API key to the demo app.\n 1. [Get a Places API key](/maps/documentation/places/android-sdk/get-api-key).\n 2. In the root directory, create a file called `secrets.properties`. This file should NOT be under version control to protect your API key.\n 3. Add this single line to `secrets.properties` \n\n ```\n PLACES_API_KEY=\"YOUR_API_KEY\"\n ```\n where `YOUR_API_KEY` is the actual API key you obtained in the first step. You can look at the [`local.defaults.properties`](https://github.com/googlemaps/android-places-ktx/blob/main/local.defaults.properties) as an example.\n4. Under the run configuration, select the module **app-places-ktx**.\n5. Select **Run 'app-places-ktx'.**"]]
