Configurar um projeto do console do Google Cloud

Configurar um 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 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 seções a seguir.

Configurar seu projeto de desenvolvimento

Se você não tiver um projeto de desenvolvimento no console do Google Cloud e uma chave de API para seu projeto de mobilidade, você precisa criar um. Para mais detalhes, consulte Crie seu projeto no guia do Fleet Engine.

Ao selecionar seu projeto de desenvolvimento para o SDK do consumidor, selecione o no mesmo projeto do console do Google Cloud e chave de API que você usa no Fleet Engine.

Adicionar o SDK do consumidor ao seu app

O SDK do consumidor está disponível em um repositório Maven particular. O repositório inclui os arquivos .pom (Project Object Model) do SDK e Javadocs. Para adicionar o SDK do consumidor ao seu app, siga estas etapas:

  1. Configure seu ambiente para acessar o repositório Maven do host, conforme descrito em Etapa 2 deste guia.

  2. Adicionar as dependências do SDK Consumer e do SDK do Maps ao seu Gradle ou Maven configuração do Terraform.

    Nos exemplos a seguir, substitua VERSION_NUMBER pelo valor obrigatório 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:VERSION_NUMBER"
    }
    

    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. Você deve usar a chave de API do projeto que você recebeu quando configurou seu projeto de desenvolvimento. Para Para mais detalhes, consulte Configurar seu projeto de desenvolvimento na Etapa 3 deste guia.

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 Secrets Gradle Plug-in para Android.

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

  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 na documentação do Android.

  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 seu arquivo AndroidManifest.xml, acesse com.google.android.geo.API_KEY e atualize o atributo android:value desta forma:

        <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 seu 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 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 https://developers.google.com/android/guides/opensource para saber como incluem avisos de código aberto.

A seguir

Receber tokens de autenticação