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 প্রোজেক্ট তৈরি করুন দেখুন।

আপনার অ্যাপে AuthTokenFactory প্রয়োগ করতে হবে, যেমন গ্রাহক SDK যাচাইকরণ-এ বর্ণনা করা হয়েছে।

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 এবং Maps রেন্ডারার

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 ইমপ্লিমেন্টেশন SSL/TLS ব্যবহার করে Fleet Engine পরিষেবার সাথে নিরাপদে যোগাযোগ করে। Android API ভার্সন ২৩ বা তার আগের ভার্সনে সার্ভারের সাথে যোগাযোগ করার জন্য SecurityProvider প্যাচের প্রয়োজন হতে পারে। Android-এ SSL-এর সাথে কাজ করার বিষয়ে আরও তথ্যের জন্য, নিরাপত্তা GMS প্রদানকারী দেখুন। নিরাপত্তা প্রদানকারীকে প্যাচ করার জন্য কোড স্যাম্পেলও এই নিবন্ধে রয়েছে।

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

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