Configurar um projeto do console do Google Cloud

Configurar um projeto do Console do Google Cloud para usar o SDK do Driver para Android, siga estas etapas.

  1. Configure seu projeto de 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 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

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 do console do Google Cloud e A chave de API que você está usando no 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 e Javadocs do modelo de objeto do projeto (.pom) do SDK.

Para adicionar o SDK do Driver ao app, adicione os SDKs do Driver e do Navigation dependências da sua configuração do Gradle ou 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 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 Para mais detalhes, consulte Configurar seu projeto de app para dispositivos móveis.

Esta seção descreve como armazenar sua chave de API para que ela seja mais segura referenciadas pelo seu app. Para mais informações sobre 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 seu 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 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 Sincronize seu projeto com o Gradle.

  4. Abra o local.properties no diretório do nível do projeto e adicione o código a seguir. 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 app, precisa incluir texto de atribuição e 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 do menu Sobre item de menu.

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

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

A seguir

Declarar dependências