ডেমো ব্যবহারের করে দেখুন

Android-এর জন্য Navigation SDK ইন্টিগ্রেট করার মাধ্যমে, আপনার অ্যাপ এক্সটার্নাল ম্যাপ ভিউতে লিঙ্ক করার থেকেও বেশি কিছু করতে পারে। Google Maps নেভিগেশনের মাধ্যমে, আপনার অ্যাপ ব্যবহারকারীর যাত্রা সম্পর্কে ডেটার ডাইনামিক রিট্রিভাল এবং সিঙ্গেল-লুক রিপোর্টিং অফার করতে পারে। এই নির্দেশিকা ব্যাখ্যা করে যে কীভাবে Navigation SDK ডেমো অ্যাপ চালাতে হয়, যা GitHub-এ উপলভ্য।

রেডি হন

Navigation SDK ব্যবহার শুরু করতে, আপনার কাছে নিম্নলিখিত আইটেমগুলি আছে কিনা তা ভালভাবে দেখে নিন।

  • Navigation SDK-এর সাথে ব্যবহারের জন্য একটি API কী প্রদান করা হয়েছে। 'কী' তৈরি ও সীমাবদ্ধ করা সম্পর্কে আরও তথ্য পেতে API কী ব্যবহার করা দেখুন।
  • SDK আর্টিফ্যাক্ট। Navigation SDK-এর জন্য Maven ব্যবহার করতে আপনার প্রোজেক্ট কনফিগার করা আছে কিনা তা যাচাই করুন।
  • এক বা একাধিক ডেমো অ্যাপ।
  • Android Studio, Navigation SDK-এর সাহায্যে অ্যাপ তৈরি করার জন্য প্রস্তাবিত ডেভেলপমেন্ট এনভায়রনমেন্ট।

এই ডকুমেন্টেশনটি Android ডেভেলপমেন্ট এবং অবজেক্ট-ওরিয়েন্টেড প্রোগ্রামিং কনসেপ্ট সম্পর্কে পরিচিত ব্যক্তিদের জন্য ডিজাইন করা হয়েছে। এছাড়াও, ব্যবহারকারীর দৃষ্টিকোণ থেকে Google Maps সম্পর্কে আপনার ধারণা থাকা উচিত।

ডেমো অ্যাপ পান

আপনার অভিজ্ঞতার লেভেলের উপর নির্ভর করে, Google Maps API-এর উপরে Navigation SDK কী অফার করে তা বুঝতে সাহায্য করার জন্য Google দুটি অ্যাপ প্রদান করে। Google Maps API-এর সাথে পরিচিত ডেভেলপাররা GoogleNavigation ডেমোতে মনোযোগ দিতে পারেন। যেসব ডেভেলপার দুটি প্রোজেক্টেই নতুন, তারা দুটি অ্যাপই সহায়ক হিসেবে পাবেন।

Android v4.1-এর জন্য Navigation SDK-এর ক্ষেত্রে, নিম্নলিখিত ডেমো অ্যাপ দুটিই ডাউনলোড করার জন্য GitHub-এ উপলভ্য।

  • GoogleNavigation ডেমো: API-এর আচরণ ও ভিউয়ের ইন্টিগ্রেশন দেখায়, কারণ এগুলি গাইডেড-নেভিগেশন সেশন চলাকালীন ব্যবহারকারীর অভিজ্ঞতার সাথে সম্পর্কিত।

  • GoogleMap ডেমো: ম্যাপের লুক ও প্রেজেন্টেশন কাস্টমাইজ করার জন্য GoogleMap ইন্টারফেসের স্বতন্ত্র আচরণ প্রদর্শন করে।

GoogleNavigation ডেমো

লেটেস্ট GoogleNavigation ডেমো GitHub-এ উপলভ্য।

বিল্ড করো

  1. Android Studio-তে, ডেমো অ্যাপ ইমপোর্ট করুন এবং Gradle-কে রান করার অনুমতি দিন।

  2. local.defaults.properties খুলুন এবং MAPS_API_KEY প্রপার্টির ভ্যালু আপডেট করুন:

      MAPS_API_KEY=YOUR_API_KEY

  3. বিল্ড বিকল্পে ক্লিক করে SDK প্রয়োগের বিবরণ পরীক্ষা করুন।

    • Java ক্লাসে, ইমপ্লিমেন্টেশন কোডটি নোট করুন।

    • লেআউট XML-এ, লেআউট ডিজাইন এবং টেক্সট নোট করুন।

    • build.gradle ফাইলে, ডিপেন্ডেন্সিতে SDK নোট করুন।

কীভাবে API কী ম্যানিফেস্টে যোগ করা হয় সেই সম্পর্কে আরও জানতে Secrets Gradle প্লাগ-ইন ডকুমেন্টেশন দেখুন।

চালান

  1. আপনার কম্পিউটারে Android ডিভাইস কানেক্ট করুন বা এমুলেটর ব্যবহার করুন।

    • Android ডিভাইস—আপনার Android ডিভাইসে ডেভেলপার বিকল্প চালু করতে এবং ডিভাইস শনাক্ত করার জন্য আপনার সিস্টেম কনফিগার করতে নির্দেশাবলী দেখুন।
    • এমুলেটর—ভার্চুয়াল ডিভাইস কনফিগার করতে Android Virtual Device (AVD) Manager ব্যবহার করুন। এমুলেটর বেছে নেওয়ার সময়, Google API আছে এমন ছবি বেছে নিতে ভুলবেন না।

  2. Android Studio-তে, রান মেনু বিকল্পে (বা প্লে বোতাম আইকন) ক্লিক করুন; এবং তারপর ডিপ্লয়মেন্ট টার্গেট বেছে নিন।

অ্যাপটি তৈরি ও লঞ্চ করার পরে, ব্যবহারকারীকে বিকল্পের তালিকা সহ একটি ল্যান্ডিং পৃষ্ঠা দেখানো হয়।

NavSDK-এর নতুন ব্যবহারকারীরা সম্ভবত এই দুটি বিকল্পকে সবচেয়ে বেশি উপযোগী বলে মনে করবেন।

বিকল্প ১: NavViewActivity NavigationView ব্যবহার করে আচরণ দেখায় এর সাথে Navigator।

বিকল্প ২: দ্বিতীয় বিকল্প, যার নাম NavFragmentActivity, Navigator-এর পাশাপাশি NavigationFragment ব্যবহার করে আচরণ দেখায়।

আপনি এইসব বিকল্পের মধ্যে কোনও একটিতে ক্লিক করলে, আপনাকে নিম্নলিখিত তথ্য দেখানো হবে:

  • নেভিগেশন UI
  • অ্যাপের মেনুতে "গন্তব্য সেট করুন" বোতাম
  • একটি ওভারলে যার সাথে আপনি ইন্টার‍্যাক্ট করে API-তে ডায়নামিকভাবে পদ্ধতি ইনভোক করতে পারবেন
  • আরও বিকল্প সহ ওভারফ্লো মেনু

শুরু করতে, গন্তব্য সেট করুন বিকল্পে ক্লিক করে একটি ঠিকানা বেছে নিন। তারপর অ্যাপটি আপনার বর্তমান লোকেশন থেকে সেই ঠিকানায় যাওয়ার ট্রিপ সিমুলেট করে। আপনি কোনও API কল করলে কী হয় তা দেখতে কন্ট্রোল প্যানেল ওভারলে ব্যবহার করুন। যেমন, SDK-কে নাইট-মোডে জোর করে নিয়ে গিয়ে সেটি কেমন দেখতে লাগে তা দেখার জন্য পদ্ধতি দেখুন বিকল্পে ক্লিক করুন।

SwappingMapAndNavActivity বিকল্প

SwappingMapAndNavActivity-এ নিম্নলিখিত সাধারণ প্যাটার্ন দেখানো হয়:

  • MapView দেখানো হচ্ছে
  • নেভিগেশন শুরু হওয়ার সময় NavigationView-এ সোয়্যাপ করা
  • নেভিগেশন শেষ হলে MapView-এ ফিরে যাওয়া

GoogleMap ডেমো

লেটেস্ট GoogleNavigation ডেমো GitHub-এ উপলভ্য।

বিল্ড করো

  1. Android Studio-তে, ডেমো অ্যাপ ইমপোর্ট করুন এবং Gradle-কে রান করার অনুমতি দিন।

  2. local.defaults.properties খুলুন এবং MAPS_API_KEY প্রপার্টির ভ্যালু আপডেট করুন:

      MAPS_API_KEY=YOUR_API_KEY

  3. বিল্ড বিকল্পে ক্লিক করে SDK প্রয়োগের বিবরণ পরীক্ষা করুন।

    • Java ক্লাসে, ইমপ্লিমেন্টেশন কোডটি নোট করুন।

    • লেআউট XML-এ, লেআউট ডিজাইন এবং টেক্সট নোট করুন।

    • build.gradle ফাইলে, ডিপেন্ডেন্সিতে SDK নোট করুন।

API কী কীভাবে ম্যানিফেস্টে যোগ করা হয় সেই সম্পর্কে আরও জানতে, Secrets Gradle প্লাগ-ইন দেখুন।

চালান

  1. আপনার কম্পিউটারে Android ডিভাইস কানেক্ট করুন বা এমুলেটর ব্যবহার করুন।

    • Android ডিভাইস আপনার Android ডিভাইসে ডেভেলপার বিকল্প চালু করতে এবং ডিভাইস শনাক্ত করার জন্য আপনার সিস্টেম কনফিগার করতে নির্দেশাবলী দেখুন।
    • এমুলেটর ভার্চুয়াল ডিভাইস কনফিগার করতে Android ভার্চুয়াল ডিভাইস (AVD) ম্যানেজার ব্যবহার করুন। এমুলেটর বেছে নেওয়ার সময়, Google API আছে এমন ছবি বেছে নিতে ভুলবেন না।

  2. Android Studio-তে, রান মেনু বিকল্পে (বা প্লে বোতাম আইকন) ক্লিক করুন; এবং তারপর ডিপ্লয়মেন্ট টার্গেট বেছে নিন।

অ্যাপটি তৈরি এবং লঞ্চ করার পরে, এটি ব্যবহারকারীকে ডেমোর একটি তালিকা সহ একটি ল্যান্ডিং পৃষ্ঠা দেখায়।

এই প্রেজেন্টেশন প্যাটার্ন এবং সোর্স কোডের সংশ্লিষ্ট স্ট্রাকচার Google Maps SDK ডেমোর ব্যবহারকারীদের কাছে পরিচিত হওয়া উচিত। এর কারণ হল GoogleMap ডেমোটি Maps API ডেমো অ্যাপ-এর মতো করে ডিজাইন করা হয়েছে। প্রাথমিক পার্থক্য হল Navigation SDK ডেমো ব্যবহারকারীকে বেছে নিতে দেয় যে তারা কোন ভিউ ক্লাসে ডেমো টেস্ট-রান করতে চান: NavigationView অথবা MapView, যেখানে প্রযোজ্য।

Google সাধারণত ব্যবহারকারীদের NavigationView ব্যবহার করতে উৎসাহিত করে। এই ডেমো আমাদের ডেমো অ্যাপে দুটি ভার্সনেই এই আচরণগুলি চেষ্টা করার এবং আপনার জন্য যেটি কাজ করে সেটি বেছে নেওয়ার নমনীয়তা প্রদান করে। যেমন, আপনি যদি এমন কোনও থার্ড-পার্টি লাইব্রেরি ব্যবহার করেন যা MapView-এর সাথে ইন্টার‍্যাক্ট করবে বলে আশা করা হয়, তাহলে এখনও MapView ব্যবহার করার প্রয়োজন হতে পারে।