Configurar um projeto do console do Google Cloud

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

  1. Configure seu projeto de desenvolvimento.
  2. Adicione o SDK do consumidor 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 seu projeto de desenvolvimento

Se você não tiver um projeto de desenvolvimento do Google Cloud Console e uma chave de API para seu projeto de mobilidade, será necessário configurar um. Para mais detalhes, consulte Criar seu projeto no guia da Fleet Engine.

Ao selecionar seu projeto de desenvolvimento para o SDK do consumidor, escolha o mesmo projeto do console do Google Cloud e a chave de API que você está usando para o Fleet Engine.

Adicionar o SDK do consumidor ao app

O SDK do consumidor 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 consumidor ao seu app, adicione as dependências do SDK do consumidor e do SDK do Maps à configuração do Gradle ou do Maven.

Nos exemplos abaixo, substitua VERSION_NUMBER pela versão necessária do SDK do consumidor:

Gradle

Adicione o seguinte ao seu build.gradle:

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

Maven

Adicione o seguinte ao seu pom.xml:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

Adicionar a chave de API ao seu app

Depois de adicionar o SDK do consumidor 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 desenvolvimento na etapa 3 deste guia.

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 (link em inglês).

Para instalar o plug-in e armazenar sua chave de API, siga estas instruções:

  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 saber mais, consulte Sincronizar seu projeto com o Gradle na documentação do Android.

  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.consumerapidemo">
        <uses-permission android:name="android.permission.ACCESS_FINE_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 consumidor no seu 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 https://developers.google.com/android/guides/opensource para saber como incluir avisos de código aberto.

A seguir

Receber tokens de autenticação