Antes de iniciar esses procedimentos, verifique se ativou os serviços e o SDK do consumidor, conforme descrito nas seções anteriores.
Para inicializar o SDK do consumidor, siga estas etapas:
Acesse a instância ConsumerApi
Para usar o SDK do consumidor, seu app precisa inicializar o Singleton
ConsumerApi
de forma assíncrona. O método de inicialização leva
Classe AuthTokenFactory
para gerar novos tokens JWT para o usuário quando necessário.
O providerId
é o ID do projeto do Google Cloud. Para mais
informações sobre como criar um projeto do Fleet Engine, consulte
Crie um projeto do Fleet Engine no guia.
Seu app precisa implementar o AuthTokenFactory
, conforme descrito em SDK do consumidor
Autenticação.
Java
Task<ConsumerApi> consumerApiTask = ConsumerApi.initialize(
this, "myProviderId", authTokenFactory);
consumerApiTask.addOnSuccessListener(
consumerApi -> this.consumerApi = consumerApi);
Kotlin
val consumerApiTask =
ConsumerApi.initialize(this, "myProviderId", authTokenFactory)
consumerApiTask?.addOnSuccessListener { consumerApi: ConsumerApi ->
this@YourActivity.consumerApi = consumerApi
}
SDK do Maps e renderizadores de mapas
O SDK para consumidor v2.0.0 e versões posteriores são compatíveis com as versões 18.1.0 e 18.1.0 do SDK do Maps para Android
mais tarde. A tabela a seguir resume o renderizador padrão por versão do SDK do Maps
e a compatibilidade dos dois renderizadores. Se possível, use o renderizador mais recente.
Se você precisa usar o renderizador legado, especifique-o explicitamente usando
MapsInitializer.initialize()
Versão do SDK do Maps | Compatível com o renderizador mais recente | Compatível com o renderizador legado | Renderizador padrão |
---|---|---|---|
V18.1.0 e anteriores | Sim | Sim | Legado* |
V18.2.0 | Sim | Sim | Mais recentes |
* Com o lançamento do novo renderizador do Maps, a versão mais recente será a padrão.
Se você precisar usar um renderizador preferido, execute todas as operações de renderização de interface
after OnMapsSdkInitializedCallback
retorna um resultado. Renderização de interface
incluem as seguintes operações:
Inflar uma visualização que contém
GoogleMapView
ouConsumerMapView
.Colocando marcadores em
ConsumerMapView
.
Se você não executar essas operações depois de receber a
OnMapsSdkInitializedCallback
resultado, o SDK do Maps não aloca sua
o renderizador preferido e a visualização de mapa será renderizada pelo renderizador padrão.
Inicialize o SDK do Maps antes de inicializar o SDK do consumidor
Na classe
Application
ou de inicializaçãoActivity
, chame MapsInitializer.initialize()Aguarde o resultado da solicitação do renderizador antes de inicializar o SDK do consumidor.
Consulte os exemplos abaixo para mais detalhes.
Java
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
initViews();
MapsInitializer.initialize(getApplicationContext(), Renderer.LATEST,
new OnMapsSdkInitializedCallback() {
@Override
public void onMapsSdkInitialized(Renderer renderer) {
switch (renderer) {
case LATEST:
Log.i("maps_renderer", "LATEST renderer");
break;
case LEGACY:
Log.i("maps_renderer", "LEGACY renderer");
break;
}
initializeConsumerSdk();
}
});
}
Kotlin
fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.main)
initViews()
MapsInitializer.initialize(
getApplicationContext(), Renderer.LATEST,
object : OnMapsSdkInitializedCallback() {
fun onMapsSdkInitialized(renderer: Renderer?) {
when (renderer) {
LATEST -> Log.i("maps_renderer", "LATEST renderer")
LEGACY -> Log.i("maps_renderer", "LEGACY renderer")
}
initializeConsumerSdk()
}
})
}
Observações sobre SSL/TLS
Internamente, a implementação do SDK para consumidor usa SSL/TLS para se comunicar com segurança.
com o serviço Fleet Engine. A versão 23 ou anteriores da API do Android podem exigir uma
SecurityProvider
para se comunicar com o servidor. Para mais informações
sobre como trabalhar com SSL no Android, consulte Security GMS
Provedor.
O artigo também contém exemplos de código para aplicar patches ao provedor de segurança.