Configurar um projeto do console do Google Cloud

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

  1. Configure seu projeto de desenvolvimento.
  2. Adicione o SDK do consumidor 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 próximas seções.

Configurar seu projeto de desenvolvimento

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 detalhes, consulte Criar seu projeto no guia do Fleet Engine.

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

Adicionar o SDK do consumidor ao seu 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 à sua configuração do Gradle ou do Maven.

Nos exemplos a seguir, 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. É preciso usar a chave de API que você recebeu ao configurar o projeto de desenvolvimento. Para mais detalhes, consulte Configurar seu projeto de desenvolvimento na etapa 3 deste guia.

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 da chave 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 (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ê usa o SDK do consumidor no seu app, é necessário 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 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