Configurar um projeto do console do Google Cloud

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

  1. Configure o projeto do app para dispositivos móveis.
  2. Adicione o SDK Driver ao seu app.
  3. Adicione a chave de API ao seu app.
  4. Inclua as atribuições necessárias no 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, configure um. Para mais informações, consulte Criar seu projeto do Fleet Engine.
  2. No console do Google Cloud, selecione o mesmo projeto e 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 Driver ao seu app

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

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

No exemplo a seguir, substitua VERSION_NUMBER pela versão selecionada do SDK 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 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 seu projeto de 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 API.

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

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 seu 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 amostra:

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

Inclua as atribuições necessárias no app

Se você usa o Driver SDK no seu app, inclua o texto de atribuição e as licenças de código aberto na 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.

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 fazer isso.

A seguir

Declarar dependências