Para configurar o console do Google Cloud para usar o SDK Consumer para Android, siga estas etapas.
- Configure seu projeto de desenvolvimento.
- Adicione o SDK do consumidor ao seu app.
- Adicione a chave de API ao seu app.
- 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:
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ê 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.