Para configurar o console do Google Cloud para usar o SDK do consumidor para Android, siga estas etapas.
- Configure seu projeto de desenvolvimento.
- Adicione o SDK do consumidor ao app.
- Adicione a chave de API ao app.
- 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:
Abra o arquivo
build.gradle
no nível raiz e adicione o seguinte código ao elementodependencies
embuildscript
.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") } }
Abra o arquivo
build.gradle
no nível do app e adicione o seguinte código ao elementoplugins
.Groovy
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
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.
Abra o
local.properties
no diretório do nível do projeto e adicione o seguinte código. SubstituaYOUR_API_KEY
pela sua chave de API.MAPS_API_KEY=YOUR_API_KEY
No arquivo
AndroidManifest.xml
, acessecom.google.android.geo.API_KEY
e atualize o atributoandroid: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.