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 idiomática 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.

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.

Primeira tela do app de exemplo do Places KTX, mostrando suas escolhas
Tela do app de demonstração da Pesquisa do Google Places

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 única a secrets.properties
      PLACES_API_KEY="YOUR_API_KEY"
      , em que YOUR_API_KEY é a chave de API que você recebeu 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'.