Visão geral e configuração do Android KTX do Places

O Places Android KTX é uma coleção de extensões Kotlin para o SDK do Places para Android. Essas extensões oferecem recursos de linguagem Kotlin que permitem escrever códigos de maneira concisa e natural quando você desenvolve para o SDK do Places para Android. O KTX do Places é de código aberto e está disponível no GitHub com exemplos.

Instalar o KTX para o SDK do Places

Se você quiser instalar o KTX para o SDK do Places para Android, adicione as seguintes dependências ao arquivo build.gradle.kts no nível do 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")
}

Testar o exemplo de aplicativo

No repositório do GitHub desta biblioteca há um aplicativo de demonstração ensinando como usar a biblioteca KTX do Places no seu app.

Primeira tela do app de exemplo Places KTX, mostrando suas opções
Tela do app de demonstração da Pesquisa de lugar

Para testar a demonstração, siga estas etapas:

  1. Acesse o GitHub, clone ou faça o download do arquivo ZIP.
  2. No Android Studio, escolha File -> Open, acesse o diretório e abra a pasta copiada ou baixada.
  3. Adicione uma chave de API ao app de demonstração.
    1. Gere uma chave da API Places.
    2. No diretório raiz, crie um arquivo chamado secrets.properties. Para proteger sua chave de API, ele NÃO pode estar sujeito ao controle de versões.
    3. Adicione esta linha única a secrets.properties
      PLACES_API_KEY="YOUR_API_KEY"
       em que YOUR_API_KEY é a chave de API obtida na primeira etapa. Um exemplo é o local.defaults.properties.
  4. Na configuração de execução, selecione o módulo app-places-ktx.
  5. Selecione Run 'app-places-ktx'.