Descripción general y configuración de Places para Android KTX

Places Android KTX es una colección de extensiones de Kotlin para el SDK de Places para Android. Estas extensiones proporcionan funciones de lenguaje Kotlin que te permiten escribir Kotlin idiomático y conciso cuando desarrollas utilizando el SDK de Places para Android. Places KTX es de código abierto y está disponible en GitHub junto con ejemplos.

Instala KTX para el SDK de Places

Para instalar KTX para el SDK de Places para Android, agrega las siguientes dependencias a tu archivo build.gradle.kts a nivel de la app.

dependencies {

    // Modern Android projects use version catalogs to manage dependencies. To include the Places SDK for Android,
    // first add the following to your gradle/libs.versions.toml file:
    //
    // [versions]
    // places = "5.3.0"
    //
    // [libraries]
    // places = { group = "com.google.android.libraries.places", name = "places", version.ref = "places" }
    //
    // Places SDK for Android (Kotlin extensions and coroutines are built directly into the Places SDK)
    implementation(libs.places)

    // If your project does not use a version catalog, you can use the following dependency instead:
    //
    //    implementation("com.google.android.libraries.places:places:5.3.0")
}

Prueba la app de muestra

El repositorio de GitHub para esta biblioteca también contiene una app de demo que muestra cómo puedes utilizar la biblioteca Places KTX en tu propia app.

Primera pantalla de la app de ejemplo de KTX de Places, que muestra tus opciones
Pantalla de la app de demostración de Places Search

Para probar la app de demo, sigue estos pasos:

  1. En GitHub, clona o descarga el archivo ZIP.
  2. En Android Studio, elige File -> Open , navega a el directorio y abre la carpeta que acabas de clonar o descargar.
  3. Agrega una clave de API a la app de demo.
    1. Obtén una clave de API de Places.
    2. En el directorio raíz, crea un archivo llamado secrets.properties. Este archivo NO debe estar bajo control de versión para proteger tu clave de API.
    3. Agrega esta única línea a secrets.properties
      PLACES_API_KEY="YOUR_API_KEY"
      donde YOUR_API_KEY es la clave de API real que obtuviste en el primer paso. Puedes consultar local.defaults.properties como ejemplo.
  4. En la configuración de ejecución, selecciona el módulo app-places-ktx.
  5. Selecciona Run 'app-places-ktx'.