অ্যান্ড্রয়েডের জন্য নেভিগেশন SDK সংহত করে, আপনার অ্যাপটি একটি বাহ্যিক মানচিত্র দৃশ্যের সাথে লিঙ্ক করার বাইরে যেতে পারে। Google Maps নেভিগেশনের মাধ্যমে, আপনার অ্যাপটি ব্যবহারকারীর যাত্রা সম্পর্কে ডাটা ডাইনামিক পুনরুদ্ধার এবং একক-লুক রিপোর্টিং অফার করতে পারে। এই গাইডটি ব্যাখ্যা করে কিভাবে গিটহাবে উপলব্ধ ন্যাভিগেশন SDK ডেমো অ্যাপগুলি চালাতে হয়।
প্রস্তুত হও
নেভিগেশন SDK দিয়ে শুরু করতে, নিম্নলিখিত আইটেমগুলি আছে তা নিশ্চিত করুন৷
- নেভিগেশন SDK-এর সাথে ব্যবহারের জন্য একটি API কী ব্যবস্থা করা হয়েছে। কী তৈরি এবং সীমাবদ্ধ করার বিষয়ে আরও তথ্যের জন্য API কী ব্যবহার করা দেখুন।
- SDK আর্টিফ্যাক্ট। নিশ্চিত করুন যে আপনার প্রকল্পটি নেভিগেশন SDK-এর জন্য Maven ব্যবহার করার জন্য কনফিগার করা হয়েছে ।
- এক বা একাধিক ডেমো অ্যাপ ।
- অ্যান্ড্রয়েড স্টুডিও , নেভিগেশন SDK দিয়ে একটি অ্যাপ তৈরি করার জন্য প্রস্তাবিত উন্নয়ন পরিবেশ।
এই ডকুমেন্টেশনটি Android ডেভেলপমেন্ট এবং অবজেক্ট-ওরিয়েন্টেড প্রোগ্রামিং ধারণার সাথে পরিচিত লোকদের জন্য ডিজাইন করা হয়েছে। আপনার ব্যবহারকারীর দৃষ্টিকোণ থেকে Google মানচিত্রের সাথেও পরিচিত হওয়া উচিত।
ডেমো অ্যাপস পান
আপনার অভিজ্ঞতার স্তরের উপর নির্ভর করে Google Maps API-এর উপরে নেভিগেশন SDK কী অফার করে তা বুঝতে সাহায্য করার জন্য Google দুটি অ্যাপ প্রদান করে। Google Maps API-এর সাথে পরিচিত ডেভেলপাররা GoogleNavigation ডেমোতে তাদের মনোযোগ কেন্দ্রীভূত করতে পারে। উভয় প্রকল্পে নতুন বিকাশকারীরা উভয় অ্যাপই সহায়ক বলে মনে করবেন।
Android v4.1 এর জন্য নেভিগেশন SDK অনুযায়ী, নিম্নলিখিত ডেমো অ্যাপ দুটিই ডাউনলোড করার জন্য GitHub- এ উপলব্ধ।
GoogleNavigation ডেমো : API আচরণ এবং ভিউগুলির একীকরণ প্রদর্শন করে কারণ সেগুলি একটি গাইডেড-নেভিগেশন সেশনে থাকাকালীন ব্যবহারকারীর অভিজ্ঞতার সাথে সম্পর্কিত৷
GoogleMap ডেমো : মানচিত্রের অনুভূতি এবং উপস্থাপনা কাস্টমাইজ করতে
GoogleMap
ইন্টারফেসের পৃথক আচরণ প্রদর্শন করে।
Google নেভিগেশন ডেমো
সর্বশেষ Google নেভিগেশন ডেমো GitHub- এ উপলব্ধ।
বিল্ডিং
অ্যান্ড্রয়েড স্টুডিওতে , ডেমো অ্যাপ আমদানি করুন এবং গ্রেডলকে চালানোর অনুমতি দিন।
local.defaults.properties
খুলুন এবংMAPS_API_KEY
সম্পত্তির মান আপডেট করুন:MAPS_API_KEY=YOUR_API_KEY
বিল্ড এ ক্লিক করুন এবং SDK বাস্তবায়নের বিবরণ পরীক্ষা করুন।
জাভা ক্লাসে, বাস্তবায়ন কোডটি নোট করুন।
লেআউট XML-এ, লেআউট ডিজাইন এবং টেক্সট নোট করুন।
build.gradle
ফাইলে, নির্ভরতার মধ্যে SDK নোট করুন।
এপিআই কী কীভাবে ম্যানিফেস্টে যোগ করা হয় সে সম্পর্কে আরও তথ্যের জন্য সিক্রেটস গ্রেডল প্লাগইন ডকুমেন্টেশন দেখুন।
চলছে
আপনার কম্পিউটারে একটি অ্যান্ড্রয়েড ডিভাইস সংযুক্ত করুন বা একটি এমুলেটর ব্যবহার করুন৷
- অ্যান্ড্রয়েড ডিভাইস — আপনার অ্যান্ড্রয়েড ডিভাইসে বিকাশকারী বিকল্পগুলি সক্ষম করতে নির্দেশাবলী পড়ুন এবং ডিভাইসটি সনাক্ত করতে আপনার সিস্টেম কনফিগার করুন।
- এমুলেটর mdash; একটি ভার্চুয়াল ডিভাইস কনফিগার করতে Android ভার্চুয়াল ডিভাইস (AVD) ম্যানেজার ব্যবহার করুন। একটি এমুলেটর নির্বাচন করার সময়, নিশ্চিত করুন যে আপনি এমন একটি ছবি বাছাই করেছেন যাতে Google API গুলি অন্তর্ভুক্ত থাকে৷
অ্যান্ড্রয়েড স্টুডিওতে , রান মেনু বিকল্পে ক্লিক করুন (বা প্লে বোতাম আইকন); এবং তারপর একটি স্থাপনার লক্ষ্য নির্বাচন করুন।
নির্মিত এবং চালু হলে, অ্যাপটি ব্যবহারকারীকে বিকল্পগুলির একটি তালিকার একটি ল্যান্ডিং পৃষ্ঠা উপস্থাপন করে।
NavViewActivity এবং NavFragmentActivity বিকল্প
NavSDK এর নতুন গ্রহণকারীরা সম্ভবত এই দুটি বিকল্পকে সবচেয়ে দরকারী বলে মনে করবে।
বিকল্প 1 : NavViewActivity
Navigator
সাথে একযোগে NavigationView
ব্যবহার করে আচরণ প্রদর্শন করে।
বিকল্প 2 : NavFragmentActivity
শীর্ষক দ্বিতীয় বিকল্পটি Navigator
পাশাপাশি SupportNavigationFragment
ব্যবহার করে আচরণ প্রদর্শন করে।
আপনি যখন এই বিকল্পগুলির একটিতে ক্লিক করেন, তখন আপনাকে নিম্নলিখিতগুলি উপস্থাপন করা হবে:
- নেভিগেশন UI
- অ্যাপের মেনুতে একটি "গন্তব্য সেট করুন" বোতাম
- একটি ওভারলে যা আপনি API-তে গতিশীলভাবে পদ্ধতি চালু করতে ইন্টারঅ্যাক্ট করতে পারেন
- আরও বিকল্প সহ একটি ওভারফ্লো মেনু
শুরু করতে, গন্তব্য সেট করুন ক্লিক করুন এবং একটি ঠিকানা চয়ন করুন। অ্যাপটি তখন আপনার বর্তমান অবস্থান থেকে সেই ঠিকানায় একটি ট্রিপ সিমুলেট করে। আপনি একটি API কল করলে কি হয় তা দেখতে কন্ট্রোল প্যানেল ওভারলে ব্যবহার করুন। উদাহরণ স্বরূপ, আপনি SDK-কে নাইট-মোডে বাধ্য করার চেষ্টা করতে দেখুন পদ্ধতিতে ক্লিক করতে পারেন এটি দেখতে কেমন দেখাচ্ছে।
SwappingMapAndNavActivity বিকল্প
SwappingMapAndNavActivity
নিম্নলিখিত সাধারণ নিদর্শনগুলি দেখায়:
- একটি
MapView
প্রদর্শন করা হচ্ছে - নেভিগেশন শুরু হলে একটি
NavigationView
অদলবদল করা - নেভিগেশন শেষ হলে একটি
MapView
এ ফিরে আসা
GoogleMap ডেমো
সর্বশেষ Google নেভিগেশন ডেমো GitHub- এ উপলব্ধ।
বিল্ডিং
অ্যান্ড্রয়েড স্টুডিওতে , ডেমো অ্যাপ আমদানি করুন এবং গ্রেডলকে চালানোর অনুমতি দিন।
local.defaults.properties
খুলুন এবংMAPS_API_KEY
সম্পত্তির মান আপডেট করুন:MAPS_API_KEY=YOUR_API_KEY
বিল্ড এ ক্লিক করুন এবং SDK বাস্তবায়নের বিবরণ পরীক্ষা করুন।
জাভা ক্লাসে, বাস্তবায়ন কোডটি নোট করুন।
লেআউট XML-এ, লেআউট ডিজাইন এবং টেক্সট নোট করুন।
build.gradle
ফাইলে, নির্ভরতার মধ্যে SDK নোট করুন।
এপিআই কী কীভাবে ম্যানিফেস্টে যোগ করা হয় সে সম্পর্কে আরও তথ্যের জন্য সিক্রেটস গ্রেডল প্লাগইন দেখুন।
চলছে
আপনার কম্পিউটারে একটি অ্যান্ড্রয়েড ডিভাইস সংযুক্ত করুন বা একটি এমুলেটর ব্যবহার করুন৷
- Android ডিভাইস আপনার Android ডিভাইসে বিকাশকারী বিকল্পগুলি সক্ষম করতে নির্দেশাবলী পড়ুন এবং ডিভাইসটি সনাক্ত করতে আপনার সিস্টেম কনফিগার করুন৷
- এমুলেটর একটি ভার্চুয়াল ডিভাইস কনফিগার করতে Android ভার্চুয়াল ডিভাইস (AVD) ম্যানেজার ব্যবহার করুন। একটি এমুলেটর নির্বাচন করার সময়, নিশ্চিত করুন যে আপনি এমন একটি ছবি বাছাই করেছেন যাতে Google API গুলি অন্তর্ভুক্ত থাকে৷
অ্যান্ড্রয়েড স্টুডিওতে , রান মেনু বিকল্পে ক্লিক করুন (বা প্লে বোতাম আইকন); এবং তারপর একটি স্থাপনার লক্ষ্য নির্বাচন করুন।
নির্মিত এবং চালু হলে, অ্যাপটি ব্যবহারকারীকে ডেমোর তালিকার একটি ল্যান্ডিং পৃষ্ঠা উপস্থাপন করে।
এই প্রেজেন্টেশন প্যাটার্ন এবং সোর্স কোডের সংশ্লিষ্ট কাঠামোটি Google Maps SDK ডেমোর ব্যবহারকারীদের কাছে পরিচিত হওয়া উচিত। এর কারণ হল GoogleMap ডেমোকে Maps API ডেমো অ্যাপের মতো ডিজাইন করা হয়েছে। প্রাথমিক পার্থক্য হল ন্যাভিগেশন SDK ডেমো ব্যবহারকারীকে বেছে নিতে দেয় যে তারা কোন ভিউ ক্লাসে একটি ডেমো পরীক্ষা-চালনা করতে চায়: NavigationView
বা MapView
, যেখানে প্রযোজ্য।
Google সাধারণত NavigationView
ব্যবহার করতে গ্রহণকারীদের উৎসাহিত করে। এই ডেমোটি আমাদের ডেমো অ্যাপের উভয় সংস্করণেই এই আচরণগুলি চেষ্টা করার নমনীয়তা প্রদান করে এবং আপনার জন্য যেটি কাজ করে তা চয়ন করুন৷ উদাহরণ স্বরূপ, এমন পরিস্থিতিতে একটি MapView
ব্যবহার করার প্রয়োজন হতে পারে যেখানে আপনি একটি তৃতীয় পক্ষের লাইব্রেরি ব্যবহার করছেন যা সেই শ্রেণীর সাথে ইন্টারঅ্যাক্ট করার আশা করে।
অ্যান্ড্রয়েডের জন্য নেভিগেশন SDK সংহত করে, আপনার অ্যাপটি একটি বাহ্যিক মানচিত্র দৃশ্যের সাথে লিঙ্ক করার বাইরে যেতে পারে। Google Maps নেভিগেশনের মাধ্যমে, আপনার অ্যাপটি ব্যবহারকারীর যাত্রা সম্পর্কে ডাটা ডাইনামিক পুনরুদ্ধার এবং একক-লুক রিপোর্টিং অফার করতে পারে। এই গাইডটি ব্যাখ্যা করে কিভাবে গিটহাবে উপলব্ধ ন্যাভিগেশন SDK ডেমো অ্যাপগুলি চালাতে হয়।
প্রস্তুত হও
নেভিগেশন SDK দিয়ে শুরু করতে, নিম্নলিখিত আইটেমগুলি আছে তা নিশ্চিত করুন৷
- নেভিগেশন SDK-এর সাথে ব্যবহারের জন্য একটি API কী ব্যবস্থা করা হয়েছে। কী তৈরি এবং সীমাবদ্ধ করার বিষয়ে আরও তথ্যের জন্য API কী ব্যবহার করা দেখুন।
- SDK আর্টিফ্যাক্ট। নিশ্চিত করুন যে আপনার প্রকল্পটি নেভিগেশন SDK-এর জন্য Maven ব্যবহার করার জন্য কনফিগার করা হয়েছে ।
- এক বা একাধিক ডেমো অ্যাপ ।
- অ্যান্ড্রয়েড স্টুডিও , নেভিগেশন SDK দিয়ে একটি অ্যাপ তৈরি করার জন্য প্রস্তাবিত উন্নয়ন পরিবেশ।
এই ডকুমেন্টেশনটি Android ডেভেলপমেন্ট এবং অবজেক্ট-ওরিয়েন্টেড প্রোগ্রামিং ধারণার সাথে পরিচিত লোকদের জন্য ডিজাইন করা হয়েছে। আপনার ব্যবহারকারীর দৃষ্টিকোণ থেকে Google মানচিত্রের সাথেও পরিচিত হওয়া উচিত।
ডেমো অ্যাপস পান
আপনার অভিজ্ঞতার স্তরের উপর নির্ভর করে Google Maps API-এর উপরে নেভিগেশন SDK কী অফার করে তা বুঝতে সাহায্য করার জন্য Google দুটি অ্যাপ প্রদান করে। Google Maps API-এর সাথে পরিচিত ডেভেলপাররা GoogleNavigation ডেমোতে তাদের মনোযোগ কেন্দ্রীভূত করতে পারে। উভয় প্রকল্পে নতুন বিকাশকারীরা উভয় অ্যাপই সহায়ক বলে মনে করবেন।
Android v4.1 এর জন্য নেভিগেশন SDK অনুযায়ী, নিম্নলিখিত ডেমো অ্যাপ দুটিই ডাউনলোড করার জন্য GitHub- এ উপলব্ধ।
GoogleNavigation ডেমো : API আচরণ এবং ভিউগুলির একীকরণ প্রদর্শন করে কারণ সেগুলি একটি গাইডেড-নেভিগেশন সেশনে থাকাকালীন ব্যবহারকারীর অভিজ্ঞতার সাথে সম্পর্কিত৷
GoogleMap ডেমো : মানচিত্রের অনুভূতি এবং উপস্থাপনা কাস্টমাইজ করতে
GoogleMap
ইন্টারফেসের পৃথক আচরণ প্রদর্শন করে।
Google নেভিগেশন ডেমো
সর্বশেষ Google নেভিগেশন ডেমো GitHub- এ উপলব্ধ।
বিল্ডিং
অ্যান্ড্রয়েড স্টুডিওতে , ডেমো অ্যাপ আমদানি করুন এবং গ্রেডলকে চালানোর অনুমতি দিন।
local.defaults.properties
খুলুন এবংMAPS_API_KEY
সম্পত্তির মান আপডেট করুন:MAPS_API_KEY=YOUR_API_KEY
বিল্ড এ ক্লিক করুন এবং SDK বাস্তবায়নের বিবরণ পরীক্ষা করুন।
জাভা ক্লাসে, বাস্তবায়ন কোডটি নোট করুন।
লেআউট XML-এ, লেআউট ডিজাইন এবং টেক্সট নোট করুন।
build.gradle
ফাইলে, নির্ভরতার মধ্যে SDK নোট করুন।
এপিআই কী কীভাবে ম্যানিফেস্টে যোগ করা হয় সে সম্পর্কে আরও তথ্যের জন্য সিক্রেটস গ্রেডল প্লাগইন ডকুমেন্টেশন দেখুন।
চলছে
আপনার কম্পিউটারে একটি অ্যান্ড্রয়েড ডিভাইস সংযুক্ত করুন বা একটি এমুলেটর ব্যবহার করুন৷
- অ্যান্ড্রয়েড ডিভাইস — আপনার অ্যান্ড্রয়েড ডিভাইসে বিকাশকারী বিকল্পগুলি সক্ষম করতে নির্দেশাবলী পড়ুন এবং ডিভাইসটি সনাক্ত করতে আপনার সিস্টেম কনফিগার করুন।
- এমুলেটর mdash; একটি ভার্চুয়াল ডিভাইস কনফিগার করতে Android ভার্চুয়াল ডিভাইস (AVD) ম্যানেজার ব্যবহার করুন। একটি এমুলেটর নির্বাচন করার সময়, নিশ্চিত করুন যে আপনি এমন একটি ছবি বাছাই করেছেন যাতে Google API গুলি অন্তর্ভুক্ত থাকে৷
অ্যান্ড্রয়েড স্টুডিওতে , রান মেনু বিকল্পে ক্লিক করুন (বা প্লে বোতাম আইকন); এবং তারপর একটি স্থাপনার লক্ষ্য নির্বাচন করুন।
নির্মিত এবং চালু হলে, অ্যাপটি ব্যবহারকারীকে বিকল্পগুলির একটি তালিকার একটি ল্যান্ডিং পৃষ্ঠা উপস্থাপন করে।
NavViewActivity এবং NavFragmentActivity বিকল্প
NavSDK এর নতুন গ্রহণকারীরা সম্ভবত এই দুটি বিকল্পকে সবচেয়ে দরকারী বলে মনে করবে।
বিকল্প 1 : NavViewActivity
Navigator
সাথে একযোগে NavigationView
ব্যবহার করে আচরণ প্রদর্শন করে।
বিকল্প 2 : NavFragmentActivity
শীর্ষক দ্বিতীয় বিকল্পটি Navigator
পাশাপাশি SupportNavigationFragment
ব্যবহার করে আচরণ প্রদর্শন করে।
আপনি যখন এই বিকল্পগুলির একটিতে ক্লিক করেন, তখন আপনাকে নিম্নলিখিতগুলি উপস্থাপন করা হবে:
- নেভিগেশন UI
- অ্যাপের মেনুতে একটি "গন্তব্য সেট করুন" বোতাম
- একটি ওভারলে যা আপনি API-তে গতিশীলভাবে পদ্ধতি চালু করতে ইন্টারঅ্যাক্ট করতে পারেন
- আরও বিকল্প সহ একটি ওভারফ্লো মেনু
শুরু করতে, গন্তব্য সেট করুন ক্লিক করুন এবং একটি ঠিকানা চয়ন করুন। অ্যাপটি তখন আপনার বর্তমান অবস্থান থেকে সেই ঠিকানায় একটি ট্রিপ সিমুলেট করে। আপনি একটি API কল করলে কি হয় তা দেখতে কন্ট্রোল প্যানেল ওভারলে ব্যবহার করুন। উদাহরণ স্বরূপ, আপনি SDK-কে নাইট-মোডে বাধ্য করার চেষ্টা করতে দেখুন পদ্ধতিতে ক্লিক করতে পারেন এটি দেখতে কেমন দেখাচ্ছে।
SwappingMapAndNavActivity বিকল্প
SwappingMapAndNavActivity
নিম্নলিখিত সাধারণ নিদর্শনগুলি দেখায়:
- একটি
MapView
প্রদর্শন করা হচ্ছে - নেভিগেশন শুরু হলে একটি
NavigationView
অদলবদল করা - নেভিগেশন শেষ হলে একটি
MapView
এ ফিরে আসা
GoogleMap ডেমো
সর্বশেষ Google নেভিগেশন ডেমো GitHub- এ উপলব্ধ।
বিল্ডিং
অ্যান্ড্রয়েড স্টুডিওতে , ডেমো অ্যাপ আমদানি করুন এবং গ্রেডলকে চালানোর অনুমতি দিন।
local.defaults.properties
খুলুন এবংMAPS_API_KEY
সম্পত্তির মান আপডেট করুন:MAPS_API_KEY=YOUR_API_KEY
বিল্ড এ ক্লিক করুন এবং SDK বাস্তবায়নের বিবরণ পরীক্ষা করুন।
জাভা ক্লাসে, বাস্তবায়ন কোডটি নোট করুন।
লেআউট XML-এ, লেআউট ডিজাইন এবং টেক্সট নোট করুন।
build.gradle
ফাইলে, নির্ভরতার মধ্যে SDK নোট করুন।
এপিআই কী কীভাবে ম্যানিফেস্টে যোগ করা হয় সে সম্পর্কে আরও তথ্যের জন্য সিক্রেটস গ্রেডল প্লাগইন দেখুন।
চলছে
আপনার কম্পিউটারে একটি অ্যান্ড্রয়েড ডিভাইস সংযুক্ত করুন বা একটি এমুলেটর ব্যবহার করুন৷
- Android ডিভাইস আপনার Android ডিভাইসে বিকাশকারী বিকল্পগুলি সক্ষম করতে নির্দেশাবলী পড়ুন এবং ডিভাইসটি সনাক্ত করতে আপনার সিস্টেম কনফিগার করুন৷
- এমুলেটর একটি ভার্চুয়াল ডিভাইস কনফিগার করতে Android ভার্চুয়াল ডিভাইস (AVD) ম্যানেজার ব্যবহার করুন। একটি এমুলেটর নির্বাচন করার সময়, নিশ্চিত করুন যে আপনি এমন একটি ছবি বাছাই করেছেন যাতে Google API গুলি অন্তর্ভুক্ত থাকে৷
অ্যান্ড্রয়েড স্টুডিওতে , রান মেনু বিকল্পে ক্লিক করুন (বা প্লে বোতাম আইকন); এবং তারপর একটি স্থাপনার লক্ষ্য নির্বাচন করুন।
নির্মিত এবং চালু হলে, অ্যাপটি ব্যবহারকারীকে ডেমোর তালিকার একটি ল্যান্ডিং পৃষ্ঠা উপস্থাপন করে।
এই প্রেজেন্টেশন প্যাটার্ন এবং সোর্স কোডের সংশ্লিষ্ট কাঠামোটি Google Maps SDK ডেমোর ব্যবহারকারীদের কাছে পরিচিত হওয়া উচিত। এর কারণ হল GoogleMap ডেমোকে Maps API ডেমো অ্যাপের মতো ডিজাইন করা হয়েছে। প্রাথমিক পার্থক্য হল ন্যাভিগেশন SDK ডেমো ব্যবহারকারীকে বেছে নিতে দেয় যে তারা কোন ভিউ ক্লাসে একটি ডেমো পরীক্ষা-চালনা করতে চায়: NavigationView
বা MapView
, যেখানে প্রযোজ্য।
Google সাধারণত NavigationView
ব্যবহার করতে গ্রহণকারীদের উৎসাহিত করে। এই ডেমোটি আমাদের ডেমো অ্যাপের উভয় সংস্করণেই এই আচরণগুলি চেষ্টা করার নমনীয়তা প্রদান করে এবং আপনার জন্য যেটি কাজ করে তা চয়ন করুন৷ উদাহরণ স্বরূপ, এমন পরিস্থিতিতে একটি MapView
ব্যবহার করার প্রয়োজন হতে পারে যেখানে আপনি একটি তৃতীয় পক্ষের লাইব্রেরি ব্যবহার করছেন যা সেই শ্রেণীর সাথে ইন্টারঅ্যাক্ট করার আশা করে।