Tüketici SDK'sını başlatma

Bu prosedürlere başlamadan önce uygun hizmetlerini ve Tüketici SDK'sını kullanmasını gerektirir.

Tüketici SDK'sını başlatmak için aşağıdaki adımları uygulayın:

  1. ConsumerAPI örneğini alın
  2. Tercih edilen oluşturucu istemek için Haritalar SDK'sını başlatın

ConsumerApi örneğini alın

Tüketici SDK'sını kullanmak için uygulamanızın tekilleştirmeyi başlatması gerekir eşzamansız olarak ConsumerApi. Başlatma yöntemi, AuthTokenFactory sınıfını kullanın.

providerId, Google Cloud projenizin proje kimliğidir. Daha fazla daha fazla bilgi için bkz. Fleet Engine kılavuzunda Fleet Engine projenizi oluşturun.

Uygulamanız, AuthTokenFactory'yi Consumer SDK Kimlik Doğrulaması bölümünde açıklandığı şekilde uygulamalıdır.

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
}

Haritalar SDK'sı ve harita oluşturucuları

Tüketici SDK'sı v2.0.0 ve sonraki sürümleri, Android v18.1.0 ve daha sonra. Aşağıdaki tabloda, Haritalar SDK'sı sürümüne göre varsayılan oluşturucu özetlenmektedir ve her iki oluşturucunun desteklenebilirliği. Mümkünse en son oluşturucuyu kullanın. Eski oluşturucuyu kullanmanız gerekiyorsa bunu MapsInitializer.initialize().

Haritalar SDK'sı sürümü En son oluşturucuyu destekliyor Eski oluşturucuyu destekler Varsayılan oluşturma aracı
V18.1.0 ve önceki sürümler Evet Evet Eski*
V18.2.0 Evet Evet Son yüklenenler

* Yeni Haritalar Oluşturucu kullanıma sunulduğunda en son oluşturucu varsayılan olarak kullanılacaktır.

Tercih edilen oluşturucu kullanmanız gerekiyorsa tüm kullanıcı arayüzü oluşturma işlemlerini çalıştırın sonra OnMapsSdkInitializedCallback bir sonuç döndürür. Kullanıcı arayüzü oluşturma işlemleri aşağıdaki işlemleri içerir:

  • GoogleMapView veya ConsumerMapView içeren bir görünümü şişirme.

  • ConsumerMapView konumuna işaretçi yerleştiriliyor.

Bu işlemleri gerçekleştirmezseniz OnMapsSdkInitializedCallback sonucunda, Haritalar SDK'sı oluşturucu tarafından oluşturulur ve bunun yerine harita görünümü varsayılan oluşturucu tarafından oluşturulur.

Tüketici SDK'sını başlatmadan önce Haritalar SDK'sını başlatın

  1. Application veya başlangıç Activity sınıfınızda şu numarayı arayın: MapsInitializer.initialize()

  2. Tüketici SDK'sını başlatmadan önce oluşturucu istek sonucunu bekleyin.

Ayrıntılar için aşağıdaki örneklere bakın.

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

SSL/TLS ile İlgili Notlar

Tüketici SDK'sı uygulaması dahili olarak, güvenli iletişim kurmak için SSL/TLS kullanır test edebilirsiniz. Android API 23 veya önceki sürümler Sunucuyla iletişim kurmak için kullanılan SecurityProvider yaması. Okuyucu Gelirleri Yöneticisi'ni hakkında bilgi için bkz. Güvenlik GMS'si Sağlayıcı. Makalede, güvenlik sağlayıcıya yama uygulamayla ilgili kod örnekleri de verilmiştir.

Sırada ne var?

Harita oluşturma