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. Configure o projeto do app para dispositivos móveis.
  2. Adicione o SDK do Driver ao seu app.
  3. Adicione a chave de API ao seu app.
  4. Inclua as atribuições necessárias no seu app.

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

Configurar o projeto do app para dispositivos móveis

Nesta seção, descrevemos como configurar seu projeto de 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 seu projeto de mobilidade, configure um. Para mais informações, consulte Criar seu projeto do Fleet Engine.
  2. No console do Google Cloud, selecione o mesmo projeto do console do Google Cloud e a mesma chave de API que você está usando para o Fleet Engine.
  3. Selecione APIs e serviços, pesquise e ative o SDK do Maps para Android.

Adicionar o SDK do Driver ao seu app

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

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

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 seu app

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

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

Para otimizar essa tarefa, use a documentação do GitHub Plug-in Secrets Gradle para Android.

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

  1. Abra o arquivo build.gradle no nível raiz e adicione o seguinte código 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 seguinte código 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 seu projeto com o Gradle. Para mais detalhes, consulte Sincronizar seu 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 para 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>

Incluir as atribuições necessárias no app

Se você usa o SDK do Driver no seu 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. É melhor incluir as atribuições como um item de menu independente ou como parte de um item de menu Sobre.

As informações de licença estão no arquivo "third_party_licenses.txt" no arquivo AAR desarquivado.

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

A seguir

Declarar dependências