Consumer SDK চালু করা

এইসব পদ্ধতি শুরু করার আগে, আগের বিভাগে যেমন বর্ণনা করা হয়েছে সেই অনুযায়ী আপনি উপযুক্ত পরিষেবা এবং গ্রাহক SDK চালু করেছেন কিনা তা নিশ্চিত করুন।

Consumer SDK শুরু করতে, এই ধাপগুলি অনুসরণ করুন:

  1. ConsumerAPI ইনস্ট্যান্স পান
  2. পছন্দের রেন্ডারারের জন্য অনুরোধ করতে Maps SDK ইনিশিয়ালাইজ করা

ConsumerApi ইনস্ট্যান্স পান

Consumer SDK ব্যবহার করতে, আপনার অ্যাপকে অ্যাসিঙ্ক্রোনাসভাবে সিঙ্গলটন ConsumerApi ইনিশিয়ালাইজ করতে হবে। প্রয়োজন হলে ব্যবহারকারীর জন্য নতুন JWT টোকেন জেনারেট করতে, ইনিশিয়ালাইজেশন পদ্ধতি AuthTokenFactory ক্লাস ব্যবহার করে।

providerId হল আপনার Google Cloud প্রোজেক্টের প্রোজেক্ট আইডি। Fleet Engine প্রোজেক্ট তৈরি করা সম্পর্কে আরও তথ্য পেতে, Fleet Engine নির্দেশিকায় আপনার Fleet Engine প্রোজেক্ট তৈরি করুন দেখুন।

Consumer SDK Authentication-এ বর্ণিত AuthTokenFactory আপনার অ্যাপে প্রয়োগ করা উচিত।

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
}

Maps SDK ও ম্যাপ রেন্ডারার

Consumer SDK v2.0.0 ও এর পরের যেকোনও ভার্সন Maps SDK for Android v18.1.0 ও এর পরের যেকোনও ভার্সনে কাজ করে। Maps SDK ভার্সন অনুসারে ডিফল্ট রেন্ডারার এবং দুটি রেন্ডারারেরই সাপোর্ট করার ক্ষমতা নিচের সারণীতে সংক্ষিপ্তভাবে দেখানো হয়েছে। সম্ভব হলে, লেটেস্ট রেন্ডারার ব্যবহার করুন। আপনাকে যদি লিগ্যাসি রেন্ডারার ব্যবহার করতেই হয়, তাহলে MapsInitializer.initialize() ব্যবহার করে স্পষ্টভাবে তা উল্লেখ করুন।

Maps SDK ভার্সন লেটেস্ট রেন্ডারার সাপোর্ট করে পুরনো রেন্ডারার কাজ করে ডিফল্ট রেন্ডারার
V18.1.0 ও তার আগের যেকোনও ভার্সন হ্যাঁ হ্যাঁ লিগ্যাসি*
V18.2.0 হ্যাঁ হ্যাঁ লেটেস্ট

* নতুন Maps রেন্ডারার রোল-আউট করার সাথে সাথে, লেটেস্ট রেন্ডারার ডিফল্ট হিসেবে সেট হয়ে যাবে।

আপনাকে যদি কোনও পছন্দের রেন্ডারার ব্যবহার করতেই হয়, তাহলে OnMapsSdkInitializedCallback ফলাফল দেখানোর পরে সমস্ত UI-রেন্ডারিং অপারেশন চালান। UI-রেন্ডারিং অপারেশনের মধ্যে নিম্নলিখিত অপারেশন অন্তর্ভুক্ত:

  • GoogleMapView বা ConsumerMapView থাকা ভিউ বড় করা।

  • ConsumerMapView-এ মার্কার প্লেস করা হচ্ছে।

আপনি যদি OnMapsSdkInitializedCallback ফলাফল পাওয়ার পরে এইসব অপারেশন না চালান, তাহলে Maps SDK আপনার পছন্দের রেন্ডারার অ্যাসাইন করে না এবং পরিবর্তে ডিফল্ট রেন্ডারার দ্বারা ম্যাপ ভিউ রেন্ডার করা হয়।

Consumer SDK ইনিশিয়ালাইজ করার আগে Maps SDK ইনিশিয়ালাইজ করুন

  1. আপনার Application বা স্টার্ট-আপ Activity ক্লাসে, কল করুন MapsInitializer.initialize()

  2. Consumer SDK শুরু করার আগে রেন্ডারার অনুরোধের ফলাফলের জন্য অপেক্ষা করুন।

বিবরণের জন্য নিম্নলিখিত উদাহরণ দেখুন।

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 সংক্রান্ত নোট

অভ্যন্তরীণভাবে, Consumer SDK-এর প্রয়োগ Fleet Engine পরিষেবার সাথে নিরাপদে যোগাযোগ করতে SSL/TLS ব্যবহার করে। Android API ভার্সন ২৩ বা তার আগের ভার্সনে সার্ভারের সাথে যোগাযোগ করার জন্য SecurityProvider প্যাচের প্রয়োজন হতে পারে। Android-এ SSL-এর সাথে কাজ করা সম্পর্কে আরও তথ্য পেতে, Security GMS প্রোভাইডার দেখুন। নিরাপত্তা প্রদানকারীকে প্যাচ করার জন্য নিবন্ধে কোডের নমুনাও রয়েছে।

এর পরে কী করতে হবে

ম্যাপ সেট-আপ করা