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. Adicione o SDK do Driver ao app.
  3. Adicione a chave de API ao app.
  4. Inclua as atribuições obrigatórias no app.

Para mais detalhes sobre cada etapa, consulte as próximas seções.

Configurar o projeto do app para dispositivos móveis

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

Para configurar seu projeto de 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, será necessário configurar um. Para mais informações, consulte Criar seu projeto do Fleet Engine.
  2. No console do Google Cloud, selecione o mesmo projeto e a mesma chave de API que você está usando para o Fleet Engine.
  3. Selecione APIs e serviços e procure 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 e Javadocs do modelo de objeto do projeto (.pom) do SDK.

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

No exemplo abaixo, 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 app, adicione a chave de API. É necessário usar a chave de API do projeto que você recebeu ao configurar o projeto de desenvolvimento. Para mais detalhes, consulte Configurar seu projeto de 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 de chaves de API, consulte o artigo da Plataforma Google Maps sobre Práticas recomendadas de segurança de API.

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

Para instalar o plug-in e armazenar a 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. Confira mais detalhes em 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ê usar o SDK do Driver no app, inclua 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 incluir avisos de código aberto.

A seguir

Declarar dependências