Inicializar o SDK do consumidor

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:

  1. Acesse a instância ConsumerAPI
  2. Inicializar o SDK do Maps para solicitar o renderizador preferido

Acesse a instância ConsumerApi

Para usar o SDK do consumidor, o 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 do consumidor v2.0.0 e versões mais recentes oferece suporte ao SDK do Maps para Android v18.1.0 e versões mais recentes. 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 versões 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:

  • Aumento de uma visualização que contém GoogleMapView ou ConsumerMapView.

  • Inserindo 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.

Inicializar o SDK do Maps antes de inicializar o SDK do consumidor

  1. Na classe Application ou Activity de inicialização, chame MapsInitializer.initialize().

  2. Aguarde o resultado da solicitação do renderizador antes de inicializar o SDK do consumidor.

Confira os exemplos a seguir 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()
      }
    })
  }

Notas sobre SSL/TLS

Internamente, a implementação do SDK do consumidor usa SSL/TLS para se comunicar com segurança com o serviço do 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.

A seguir

Configurar um mapa