Inizializzare l'SDK consumer

Prima di iniziare queste procedure, assicurati di aver attivato i servizi e l'SDK Consumer appropriati, come descritto nelle sezioni precedenti.

Per inizializzare l'SDK Consumer:

  1. Recupera l'istanza ConsumerAPI
  2. Inizializza Maps SDK per richiedere un renderer preferito

Recupera l'istanza ConsumerApi

Per utilizzare l'SDK Consumer, la tua app deve inizializzare il singletonConsumerApi in modo asincrono. Il metodo di inizializzazione prende la classe AuthTokenFactory per generare nuovi token JWT per l'utente, se necessario.

providerId è l'ID progetto del tuo progetto Google Cloud. Per ulteriori informazioni sulla creazione di un progetto Fleet Engine, consulta Creare il progetto Fleet Engine nella guida di Fleet Engine.

L'app deve implementare AuthTokenFactory come descritto in Autentificazione dell'SDK consumer.

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 Maps e visualizzatori delle mappe

Consumer SDK v2.0.0 e versioni successive supportano Maps SDK for Android v18.1.0 e versioni successive. La tabella riportata di seguito riassume il renderer predefinito in base alla versione di Maps SDK e alla supportabilità di entrambi i renderer. Se possibile, utilizza il renderer più recente. Se devi utilizzare il renderer precedente, specificalo esplicitamente utilizzando MapsInitializer.initialize().

Versione SDK Maps Supporta il renderer più recente Supporta il vecchio motore di rendering Renderer predefinito
V18.1.0 e versioni precedenti Sì Sì Legacy*
V18.2.0 Sì Sì Più recenti

* Con l'implementazione del nuovo visualizzatore di Maps, il visualizzatore più recente sarà quello predefinito.

Se devi utilizzare un renderer preferito, esegui tutte le operazioni di rendering dell'interfaccia utente dopo che OnMapsSdkInitializedCallback ha restituito un risultato. Le operazioni di rendering dell'interfaccia utente includono le seguenti operazioni:

  • Espansione di una visualizzazione contenente GoogleMapView o ConsumerMapView.

  • Inserire gli indicatori su ConsumerMapView.

Se non esegui queste operazioni dopo aver ricevuto il risultato OnMapsSdkInitializedCallback, l'SDK Maps non alloca il visualizzatore preferito e la visualizzazione mappa viene visualizzata dal visualizzatore predefinito.

Inizializza Maps SDK prima di inizializzare l'SDK Consumer

  1. Nella classe Application o di avvio Activity, chiama MapsInitializer.initialize()

  2. Attendi il risultato della richiesta del renderer prima di inizializzare l'SDK consumer.

Per maggiori dettagli, vedi gli esempi riportati di seguito.

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()
      }
    })
  }

Note su SSL/TLS

Internamente, l'implementazione di SDK consumer utilizza SSL/TLS per comunicare in modo sicuro con il servizio Fleet Engine. Le versioni API Android 23 o precedenti potrebbero richiedere una patch SecurityProvider per comunicare con il server. Per ulteriori informazioni sull'utilizzo di SSL in Android, consulta Provider GMS Security. L'articolo contiene anche esempi di codice per applicare patch al provider di sicurezza.

Passaggi successivi

Configurare una mappa