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, 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, o renderizador mais recente será o 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 ou ConsumerMapView.

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

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

  2. 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.

A seguir

Configurar um mapa