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

O KTX do Places para Android é uma coleção de extensões Kotlin para o SDK do Places para Android. Essas extensões oferecem recursos da linguagem Kotlin que permitem escrever códigos de maneira concisa e natural ao desenvolver para o SDK do Places para Android. O Places KTX é de código aberto e está disponível no GitHub (em inglês) com alguns exemplos.

Observação: a partir da versão 4.0.0, o SDK do Places para Android inclui APIs nativas do Kotlin que podem ser usadas em vez das extensões KTX do Places para Android. Para mais informações, consulte a Visão geral de referência do SDK do Places para Android.

Instalar o KTX para o SDK do Places

Para instalar o KTX no SDK do Places para Android, adicione as seguintes dependências ao arquivo build.gradle.kts no nível do app.

dependencies {

    // KTX for the Places SDK for Android library
    implementation("com.google.maps.android:places-ktx:3.2.0")
}

Testar o exemplo de aplicativo

O repositório do GitHub desta biblioteca também contém um aplicativo de demonstração que mostra como usar a biblioteca KTX do Places no seu app.

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

1. No 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 que você acabou de clonar ou baixar.
3. Adicione uma chave de API ao app de demonstração.
1. Gerar 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 a secrets.properties
   

   PLACES_API_KEY="YOUR_API_KEY"

   onde 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'.