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 şu 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 öğesini Tüketici SDK'sı bölümünde açıklandığı şekilde uygulamalıdır. Kimlik doğrulama.

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şturucu
V18.1.0 ve önceki sürümler Evet Evet Eski*
V18.2.0 Evet Evet Son yüklenenler

* Yeni Haritalar Oluşturucu'nun kullanıma sunulmasıyla birlikte En son oluşturucu varsayılandı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şlemler, 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 uygulamak için kullanılan kod örnekleri de yer almaktadır.

Sırada ne var?

Harita oluşturma