Configurar um projeto do console do Google Cloud

Para configurar um projeto do console do Google Cloud para usar o SDK do Driver para Android, siga estas etapas.

1. Configurar o projeto do app para dispositivos móveis.
2. Adicionar o SDK do Driver ao app.
3. Adicionar a chave de API ao app.
4. Incluir as atribuições necessárias no app.

Para mais detalhes sobre cada etapa, consulte as seções a seguir.

Observação: o app precisa segmentar a minSdkVersion 23 ou mais recente.

Configurar o projeto do app para dispositivos móveis

Esta seção descreve como configurar o projeto do app para dispositivos móveis para o SDK do Driver.

Para configurar o projeto do app para dispositivos móveis, siga estas etapas:

1. Se você não tiver um projeto de desenvolvimento do console do Google Cloud e uma chave de API para o projeto de mobilidade, configure um. Para mais informações, consulte Criar um projeto do Fleet Engine.
2. No console do Google Cloud, selecione o mesmo projeto do console do Google Cloud e a chave de API que você está usando para o Fleet Engine.
3. Selecione APIs e serviços e pesquise e ative o SDK do Maps para Android.

Adicionar o SDK do Driver ao app

O SDK do Driver está disponível no repositório Maven do Google. O repositório inclui os arquivos de modelo de objeto do projeto (.pom) e os Javadocs do SDK.

Para adicionar o SDK do Driver ao app, adicione as dependências do SDK do Driver e do SDK do Navigation à configuração do Gradle ou do Maven.

Observação: o SDK do Driver depende do SDK do Navigation. Defina sua dependência para uma versão definida explicitamente do SDK do Navigation, conforme mostrado neste exemplo. Caso contrário, omita o bloco de código de exemplo para permitir que o projeto sempre faça o download da versão mais recente do SDK do Navigation na versão de lançamento principal. Os comportamentos combinados das versões mais recentes do SDK do Driver e do SDK do Navigation passaram por testes rigorosos antes do lançamento.

No exemplo a seguir, substitua VERSION_NUMBER pela versão selecionada do SDK do Driver.

Gradle

Adicione o seguinte ao seu build.gradle:

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

Maven

Adicione o seguinte ao seu pom.xml:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation.driver</groupId>
    <artifactId>transportation-driver</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>5.0.0</version>
  </dependency>
</dependencies>

Adicionar a chave de API ao app

Depois de adicionar o SDK do Driver ao app, adicione a chave de API. Você precisa usar a chave de API do projeto que recebeu ao configurar o projeto de desenvolvimento. Para mais detalhes, consulte Configurar o projeto do app para dispositivos móveis.

Esta seção descreve como armazenar a chave de API para que ela possa ser referenciada com mais segurança pelo app. Para mais informações sobre as práticas recomendadas de segurança da chave de API, consulte o artigo da Plataforma Google Maps sobre práticas recomendadas de segurança de API.

Importante: não faça check-in da chave de API no sistema de controle de versões. Em vez disso, armazene-a no arquivo local.properties, que está localizado no diretório raiz do projeto. Para mais informações sobre o arquivo local.properties, consulte Arquivos de propriedades do Gradle.

Para otimizar essa tarefa, use o plug-in Secrets Gradle para Android da documentação do GitHub (link em inglês).

Para instalar o plug-in e armazenar a chave de API, siga estas etapas:

1. Abra o arquivo build.gradle de nível raiz e adicione o código a seguir ao elemento dependencies em buildscript.

   Groovy

   buildscript {
         dependencies {
             // ...
             classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0"
         }
   }
   

   Kotlin

   buildscript {
       dependencies {
           // ...
           classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0")
       }
   }
   

2. Abra o arquivo build.gradle no nível do app e adicione o código a seguir ao elemento plugins.

   Groovy

   id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
   

   Kotlin

   id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
   

3. Se você usa o Android Studio, sincronize o projeto com o Gradle. Para mais detalhes, consulte Sincronizar o projeto com o Gradle.

4. Abra o local.properties no diretório do nível do projeto e adicione o seguinte código. Substitua YOUR_API_KEY pela sua chave de API.

   MAPS_API_KEY=YOUR_API_KEY

5. No arquivo AndroidManifest.xml, acesse com.google.android.geo.API_KEY e atualize o atributo android:value da seguinte maneira:

       <meta-data
           android:name="com.google.android.geo.API_KEY"
           android:value="${MAPS_API_KEY}" />

O exemplo a seguir mostra um manifesto completo de um app de exemplo:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.driverapidemo" >
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
        <application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:supportsRtl="true"
            android:theme="@style/_AppTheme" >

            <meta-data
                android:name="com.google.android.geo.API_KEY"
                android:value="${MAPS_API_KEY}" />

            <activity android:name=".MainActivity" >
                <intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>
            </activity>
        </application>
    </manifest>

Observação: para a melhor experiência de navegação, o motorista precisa conceder as seguintes permissões: android.permission.ACCESS_COARSE_LOCATION e android.permission.ACCESS_FINE_LOCATION. Solicite as duas permissões durante a execução no app.

Incluir as atribuições necessárias no app

Se você usa o SDK do Driver no app, precisa incluir o texto de atribuição e as licenças de código aberto como parte da seção de avisos legais do app. É recomendável incluir as atribuições como um item de menu independente ou como parte de um item de menu Sobre.

Você pode encontrar as informações de licença no arquivo "third_party_licenses.txt" no arquivo AAR não arquivado.

Consulte Incluir avisos de código aberto para saber como incluir avisos de código aberto.

A seguir

Declarar dependências