অ্যান্ড্রয়েডের জন্য নেভিগেশন SDK ব্যবহার করে, আপনি বিল্ট-ইন UI নিয়ন্ত্রণ এবং উপাদানগুলির মধ্যে কোনটি মানচিত্রে উপস্থিত হবে তা নির্ধারণ করে আপনার মানচিত্রের সাথে ব্যবহারকারীর অভিজ্ঞতা পরিবর্তন করতে পারেন৷ আপনি নেভিগেশন UI এর ভিজ্যুয়াল চেহারাও সামঞ্জস্য করতে পারেন। নেভিগেশন UI-তে গ্রহণযোগ্য পরিবর্তনের নির্দেশিকাগুলির জন্য নীতি পৃষ্ঠাটি পড়ুন।
এই নথিটি বর্ণনা করে কিভাবে আপনার মানচিত্রের ইউজার ইন্টারফেস দুটি উপায়ে পরিবর্তন করতে হয়:
মানচিত্র UI নিয়ন্ত্রণ
মানচিত্র UI নিয়ন্ত্রণগুলি সঠিক অবস্থান নিশ্চিত করতে নেভিগেশন ভিউতে কাস্টম UI উপাদানগুলি রাখার প্রস্তাবিত উপায়। যখন অন্তর্নির্মিত লেআউট পরিবর্তন হয়, তখন Android এর জন্য নেভিগেশন SDK স্বয়ংক্রিয়ভাবে আপনার কাস্টম নিয়ন্ত্রণগুলিকে পুনঃস্থাপন করে৷ আপনি প্রতিটি অবস্থানের জন্য একবারে একটি কাস্টম নিয়ন্ত্রণ দৃশ্য সেট করতে পারেন। যদি আপনার ডিজাইনের একাধিক UI উপাদানের প্রয়োজন হয়, আপনি সেগুলিকে একটি ViewGroup
রাখতে পারেন এবং এটি setCustomControl
পদ্ধতিতে পাস করতে পারেন।
setCustomControl
পদ্ধতিটি CustomControlPosition
enum- এ সংজ্ঞায়িত পজিশন প্রদান করে:
-
SECONDARY_HEADER
(শুধুমাত্র প্রতিকৃতি মোডে প্রদর্শিত হয়) -
BOTTOM_START_BELOW
-
BOTTOM_END_BELOW
-
FOOTER
একটি কাস্টম নিয়ন্ত্রণ যোগ করুন
- কাস্টম UI উপাদান বা ভিউগ্রুপ দিয়ে একটি অ্যান্ড্রয়েড ভিউ তৈরি করুন।
- XML স্ফীত করুন বা দৃশ্যের একটি উদাহরণ পেতে কাস্টম ভিউটি ইনস্ট্যান্টিয়েট করুন।
CustomControlPosition
enum থেকে নির্বাচিত কাস্টম নিয়ন্ত্রণ অবস্থানের সাথেNavigationView.setCustomControl
বাSupportNavigationFragment.setCustomControl
ব্যবহার করুন।নীচের উদাহরণটি একটি খণ্ড তৈরি করে এবং সেকেন্ডারি হেডার অবস্থানে একটি কাস্টম নিয়ন্ত্রণ যোগ করে।
mNavFragment.setCustomControl(getLayoutInflater(). inflate(R.layout.your_custom_control, null), CustomControlPosition.SECONDARY_HEADER); ```
একটি কাস্টম নিয়ন্ত্রণ সরান
একটি কাস্টম নিয়ন্ত্রণ সরাতে, একটি null
ভিউ প্যারামিটার এবং নির্বাচিত কাস্টম নিয়ন্ত্রণ অবস্থান সহ setCustomControl
পদ্ধতিতে কল করুন।
উদাহরণস্বরূপ, নিম্নোক্ত স্নিপেট যেকোনো কাস্টম সেকেন্ডারি হেডার সরিয়ে দেয় এবং ডিফল্ট সামগ্রীতে ফিরে আসে:
mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);
কাস্টম নিয়ন্ত্রণ অবস্থান
সেকেন্ডারি হেডার
এই কাস্টম কন্ট্রোল পজিশন ব্যবহার করতে, CustomControlPosition.SECONDARY_HEADER
setCustomControl
এ পাস করুন।
ডিফল্টরূপে, নেভিগেশন মোডে স্ক্রীন লেআউটগুলি প্রাথমিক শিরোনামের নীচে অবস্থিত একটি সেকেন্ডারি হেডারের জন্য একটি অবস্থান প্রদান করে। এই গৌণ শিরোনামটি যখন প্রয়োজন হয় তখন উপস্থিত হয়, যেমন লেন নির্দেশিকা সহ। আপনার অ্যাপ কাস্টম কন্টেন্টের জন্য লেআউটের এই সেকেন্ডারি হেডার পজিশন ব্যবহার করতে পারে। আপনি যখন এই বৈশিষ্ট্যটি ব্যবহার করেন, তখন আপনার নিয়ন্ত্রণ যেকোনো ডিফল্ট সেকেন্ডারি হেডার সামগ্রী কভার করে। যদি আপনার নেভিগেশন ভিউয়ের একটি পটভূমি থাকে, তবে সেই পটভূমিটি সেকেন্ডারি হেডার দ্বারা আচ্ছাদিত জায়গায় থাকে। যখন আপনার অ্যাপ কাস্টম নিয়ন্ত্রণ সরিয়ে দেয়, তখন যেকোনো ডিফল্ট সেকেন্ডারি হেডার তার জায়গায় উপস্থিত হতে পারে।
কাস্টম সেকেন্ডারি হেডার পজিশন প্রাথমিক হেডারের নিচের প্রান্তের সাথে তার উপরের প্রান্তটিকে সারিবদ্ধ করে। এই অবস্থানটি শুধুমাত্র portrait mode
সমর্থিত। landscape mode
, সেকেন্ডারি হেডার অনুপলব্ধ, এবং লেআউট পরিবর্তন হয় না।
নীচে শুরু
এই কাস্টম কন্ট্রোল পজিশন ব্যবহার করতে, CustomControlPosition.BOTTOM_START_BELOW
পজিশনটি পাস করুন। BOTTOM_START_BELOW setCustomControl
করতে।
এই কাস্টম কন্ট্রোল পজিশনটি মানচিত্রের নিচের শুরুর কোণায় বসে। portrait mode
এবং landscape mode
উভয় ক্ষেত্রেই, এটি ETA কার্ড এবং/অথবা কাস্টম ফুটারের উপরে বসে (অথবা যদি না থাকে তবে মানচিত্রের নীচে), এবং পুনঃ-কেন্দ্র বোতাম এবং Google লোগো সহ Nav SDK উপাদানগুলি অ্যাকাউন্টে চলে যায় কাস্টম নিয়ন্ত্রণ দৃশ্যের উচ্চতার জন্য। এই নিয়ন্ত্রণটি দৃশ্যমান মানচিত্রের সীমানার মধ্যে অবস্থিত, তাই মানচিত্রের নীচে বা সূচনা প্রান্তে যোগ করা যেকোনো প্যাডিং এই নিয়ন্ত্রণের অবস্থানও পরিবর্তন করবে।
নীচের প্রান্ত
এই কাস্টম কন্ট্রোল পজিশন ব্যবহার করতে, CustomControlPosition.BOTTOM_END_BELOW
পজিশনটি পাস করুন। BOTTOM_END_BELOW setCustomControl
করতে।
এই কাস্টম কন্ট্রোল পজিশনটি মানচিত্রের নিচের প্রান্তের কোণায় বসে আছে। portrait mode
, এটি ETA কার্ড এবং/অথবা কাস্টম ফুটারের উপরে বসে (অথবা মানচিত্রের নীচে যদি না থাকে), তবে landscape mode
এটি মানচিত্রের নীচের সাথে সারিবদ্ধ থাকে৷ কাস্টম কন্ট্রোল ভিউয়ের উচ্চতার জন্য শেষ দিকে (LTR-এ ডান দিকে) দৃশ্যমান যেকোনো Nav SDK উপাদান। এই নিয়ন্ত্রণটি দৃশ্যমান মানচিত্রের সীমানার মধ্যে অবস্থিত, তাই মানচিত্রের নীচে বা শেষ প্রান্তে যোগ করা যেকোন প্যাডিং এই নিয়ন্ত্রণের অবস্থান পরিবর্তন করবে।
ফুটার
এই কাস্টম কন্ট্রোল পজিশন ব্যবহার করতে, CustomControlPosition.FOOTER
কে setCustomControl
এ পাস করুন।
এই কাস্টম কন্ট্রোল পজিশন একটি কাস্টম ফুটার ভিউ এর জন্য ডিজাইন করা হয়েছে। যদি Nav SDK ETA কার্ডটি দৃশ্যমান হয়, তাহলে এই নিয়ন্ত্রণটি এর উপরে বসে। যদি না হয়, নিয়ন্ত্রণটি মানচিত্রের নীচের সাথে সারিবদ্ধ করা হয়৷ BOTTOM_START_BELOW
এবং BOTTOM_END_BELOW
কাস্টম নিয়ন্ত্রণের বিপরীতে, এই নিয়ন্ত্রণটি দৃশ্যমান মানচিত্রের সীমানার বাইরে অবস্থান করে, যার মানে মানচিত্রে যোগ করা যেকোনো প্যাডিং এই নিয়ন্ত্রণের অবস্থান পরিবর্তন করবে না।
portrait mode
, কাস্টম ফুটারটি সম্পূর্ণ প্রস্থ। CustomControlPosition.BOTTOM_START_BELOW
এবং CustomControlPosition.BOTTOM_END_BELOW
উভয় অবস্থানেই কাস্টম নিয়ন্ত্রণ, সেইসাথে রি-সেন্টার বোতাম এবং Google লোগোর মতো Nav SDK UI উপাদান, কাস্টম কন্ট্রোল ফুটারের উপরে অবস্থিত। শেভরনের ডিফল্ট অবস্থান কাস্টম ফুটারের উচ্চতা বিবেচনা করে।
landscape mode
, কাস্টম ফুটারটি অর্ধেক প্রস্থ এবং প্রারম্ভিক দিকের (LTR তে বাম দিকে) সারিবদ্ধ, ঠিক Nav SDK ETA কার্ডের মতো৷ CustomControlPosition.BOTTOM_START_BELOW
পজিশনে কাস্টম কন্ট্রোল। BOTTOM_START_BELOW অবস্থান এবং Nav SDK UI উপাদান যেমন রি-সেন্টার বোতাম এবং Google লোগো কাস্টম কন্ট্রোল পাদলেখের উপরে অবস্থান করে। CustomControlPosition.BOTTOM_END_BELOW
পজিশনে কাস্টম কন্ট্রোল। BOTTOM_END_BELOW অবস্থান এবং যেকোনও Nav SDK UI উপাদানগুলি প্রান্তের পাশে (LTR তে ডান দিকে) মানচিত্রের নীচের সাথে সারিবদ্ধ থাকে। শেভরনের ডিফল্ট অবস্থান পরিবর্তন হয় না যখন একটি কাস্টম ফুটার উপস্থিত থাকে কারণ ফুটারটি মানচিত্রের শেষ দিকে প্রসারিত হয় না।
CustomControlPosition.BOTTOM_START_BELOW
এবং CustomControlPosition.BOTTOM_END_BELOW
পজিশনে কাস্টম কন্ট্রোল, সেইসাথে রি-সেন্টার বোতাম এবং Google লোগোর মতো Nav SDK UI উপাদানগুলি কাস্টম কন্ট্রোল ফুটারের উপরে অবস্থিত।
ম্যাপ UI আনুষাঙ্গিক
অ্যান্ড্রয়েডের জন্য ন্যাভিগেশন SDK UI আনুষাঙ্গিক সরবরাহ করে যা নেভিগেশনের সময় Android অ্যাপ্লিকেশনের জন্য Google মানচিত্রের মতোই দেখা যায়। এই বিভাগে বর্ণিত হিসাবে আপনি এই নিয়ন্ত্রণগুলির দৃশ্যমানতা বা চাক্ষুষ চেহারা সামঞ্জস্য করতে পারেন। আপনি এখানে যে পরিবর্তনগুলি করেছেন তা পরবর্তী নেভিগেশন সেশনে প্রতিফলিত হবে৷
নেভিগেশন UI-তে গ্রহণযোগ্য পরিবর্তনের নির্দেশিকাগুলির জন্য নীতি পৃষ্ঠাটি পড়ুন।
কোডটি দেখুন
নেভিগেশন হেডার পরিবর্তন করুন
ন্যাভিগেশন হেডারের থিম পরিবর্তন করতে SupportNavigationFragment.setStylingOptions()
অথবা NavigationView.setStylingOptions()
ব্যবহার করুন এবং উপলভ্য থাকাকালীন হেডারের নিচে প্রদর্শিত পরবর্তী-টার্ন নির্দেশক।
আপনি নিম্নলিখিত বৈশিষ্ট্য সেট করতে পারেন:
অ্যাট্রিবিউট টাইপ | গুণাবলী |
---|---|
পটভূমির রঙ |
|
নির্দেশাবলীর জন্য পাঠ্য উপাদান |
|
পরবর্তী পদক্ষেপের জন্য পাঠ্য উপাদান |
|
ম্যানুভার আইকন |
|
লেন নির্দেশিকা |
|
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে স্টাইলিং বিকল্পগুলি সেট করতে হয়:
private SupportNavigationFragment mNavFragment;
mNavFragment = (SupportNavigationFragment) getFragmentManager()
.findFragmentById(R.id.navigation_fragment);
// Set the styling options on the fragment.
mNavFragment.setStylingOptions(new StylingOptions()
.primaryDayModeThemeColor(0xff1A237E)
.secondaryDayModeThemeColor(0xff3F51B5)
.primaryNightModeThemeColor(0xff212121)
.secondaryNightModeThemeColor(0xff424242)
.headerLargeManeuverIconColor(0xffffff00)
.headerSmallManeuverIconColor(0xffffa500)
.headerNextStepTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
.headerNextStepTextColor(0xff00ff00)
.headerNextStepTextSize(20f)
.headerDistanceTypefacePath("/system/fonts/NotoSerif-Italic.ttf")
.headerDistanceValueTextColor(0xff00ff00)
.headerDistanceUnitsTextColor(0xff0000ff)
.headerDistanceValueTextSize(20f)
.headerDistanceUnitsTextSize(18f)
.headerInstructionsTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
.headerInstructionsTextColor(0xffffff00)
.headerInstructionsFirstRowTextSize(24f)
.headerInstructionsSecondRowTextSize(20f)
.headerGuidanceRecommendedLaneColor(0xffffa500));
ট্র্যাফিক স্তর বন্ধ করুন
মানচিত্রে ট্রাফিক স্তর সক্ষম বা অক্ষম করতে GoogleMap.setTrafficEnabled()
ব্যবহার করুন৷ এই সেটিংটি সামগ্রিকভাবে মানচিত্রে দেখানো ট্রাফিক ঘনত্বের ইঙ্গিতকে প্রভাবিত করে৷ যাইহোক, এটি নেভিগেটর দ্বারা প্লট করা রুটে ট্র্যাফিক ইঙ্গিতকে প্রভাবিত করে না।
private GoogleMap mMap;
// Get the map, and when the async call returns, setTrafficEnabled
// (callback will be on the UI thread)
mMap = mNavFragment.getMapAsync(navMap -> navMap.setTrafficEnabled(false));
ট্রাফিক লাইট এবং স্টপ সাইন সক্রিয় করুন
আপনি মানচিত্র UI এ ট্রাফিক লাইট এবং স্টপ সাইন সক্ষম করতে পারেন। এই বৈশিষ্ট্যটির সাহায্যে, ব্যবহারকারী ট্র্যাফিক লাইট প্রদর্শন সক্ষম করতে পারে বা তাদের রুটে সাইন আইকন বন্ধ করতে পারে, আরও দক্ষ এবং সঠিক ভ্রমণের জন্য আরও ভাল প্রসঙ্গ প্রদান করে।
ডিফল্টরূপে, নেভিগেশন SDK-এ ট্র্যাফিক লাইট এবং স্টপ সাইনগুলি অক্ষম থাকে৷ এই বৈশিষ্ট্যটি সক্ষম করতে, প্রতিটি বৈশিষ্ট্যের জন্য স্বতন্ত্রভাবে DisplayOptions
কল করুন।
DisplayOptions displayOptions =
new DisplayOptions().showTrafficLights(true).showStopSigns(true);
কাস্টম মার্কার যোগ করুন
Android এর জন্য নেভিগেশন SDK এখন মার্কারগুলির জন্য Google মানচিত্র API ব্যবহার করে৷ আরও তথ্যের জন্য মানচিত্র API ডকুমেন্টেশনে যান।
ভাসমান পাঠ্য
আপনি আপনার অ্যাপের যেকোনো জায়গায় ভাসমান পাঠ্য যোগ করতে পারেন, যদি এটি Google অ্যাট্রিবিউশনকে কভার না করে। ন্যাভিগেশন SDK মানচিত্রের অক্ষাংশ/দ্রাঘিমাংশে বা লেবেলে পাঠ্যকে অ্যাঙ্করিং সমর্থন করে না। আরও তথ্যের জন্য তথ্য উইন্ডোতে যান।
গতি সীমা প্রদর্শন করুন
আপনি প্রোগ্রামগতভাবে গতি সীমা আইকন দেখাতে বা লুকাতে পারেন। গতিসীমা আইকন প্রদর্শন বা আড়াল করতে NavigationView.setSpeedLimitIconEnabled()
বা SupportNavigationFragment.setSpeedLimitIconEnabled()
ব্যবহার করুন। যখন সক্রিয় করা হয়, গতি সীমা আইকন নির্দেশিকা চলাকালীন নীচের কোণায় প্রদর্শিত হয়। আইকনটি গাড়িটি যে রাস্তায় চলাচল করছে তার গতিসীমা প্রদর্শন করে। আইকনটি শুধুমাত্র সেই স্থানেই প্রদর্শিত হবে যেখানে নির্ভরযোগ্য গতি সীমা ডেটা উপলব্ধ।
// Display the Speed Limit icon
mNavFragment.setSpeedLimitIconEnabled(true);
রিস্টার বোতামটি প্রদর্শিত হলে গতি সীমা আইকনটি সাময়িকভাবে লুকানো থাকে।
রাতের মোড সেট করুন
আপনি প্রোগ্রাম্যাটিকভাবে রাতের মোডের আচরণ নিয়ন্ত্রণ করতে পারেন। নাইট মোড চালু বা বন্ধ করতে NavigationView.setForceNightMode()
বা SupportNavigationFragment.setForceNightMode()
ব্যবহার করুন বা Android এর জন্য নেভিগেশন SDK কে এটি নিয়ন্ত্রণ করতে দিন।
-
AUTO
নেভিগেশন SDK কে ডিভাইসের অবস্থান এবং স্থানীয় সময় অনুযায়ী উপযুক্ত মোড নির্ধারণ করতে দেয়। -
FORCE_NIGHT
নাইট মোড চালু করে। -
FORCE_DAY
ফোর্স ডে মোড চালু করে৷
নিম্নলিখিত উদাহরণটি একটি নেভিগেশন ফ্র্যাগমেন্টের মধ্যে জোর করে নাইট মোড চালু করতে দেখায়:
// Force night mode on.
mNavFragment.setForceNightMode(FORCE_NIGHT);
দিকনির্দেশের তালিকা প্রদর্শন করুন
প্রথমে, ভিউ তৈরি করুন এবং এটি আপনার ক্রমানুসারে যোগ করুন।
void setupDirectionsListView() {
// Create the view.
DirectionsListView directionsListView = new DirectionsListView(getApplicationContext());
// Add the view to your view hierarchy.
ViewGroup group = findViewById(R.id.directions_view);
group.addView(directionsListView);
// Add a button to your layout to close the directions list view.
ImageButton button = findViewById(R.id.close_directions_button); // this button is part of the container we hide in the next line.
button.setOnClickListener(
v -> findViewById(R.id.directions_view_container).setVisibility(View.GONE));
}
জীবন চক্রের ইভেন্টগুলিকে DirectionsListView
এ ফরোয়ার্ড করতে ভুলবেন না ঠিক যেমন সেগুলি NavigationView
এর সাথে আছে। যেমন:
protected void onResume() {
super.onResume();
directionsListView.onResume();
}
বিকল্প রুট লুকানো
যখন ইউজার ইন্টারফেস অত্যধিক তথ্যের সাথে বিশৃঙ্খল হয়ে যায়, আপনি ডিফল্ট (দুটি) থেকে কম বিকল্প রুট প্রদর্শন করে বা কোন বিকল্প রুট প্রদর্শন করে বিশৃঙ্খলা কমাতে পারেন। আপনি নিম্নলিখিত গণনার মানগুলির একটি সহ RoutingOptions.alternateRoutesStrategy()
পদ্ধতিতে কল করে রুটগুলি আনার আগে এই বিকল্পটি কনফিগার করতে পারেন:
গণনা মান | বর্ণনা |
---|---|
AlternateRoutesStrategy.SHOW_ALL | ডিফল্ট দুটি বিকল্প রুট পর্যন্ত প্রদর্শন করে। |
AlternateRoutesStrategy.SHOW_ONE | একটি বিকল্প পথ প্রদর্শন করে (যদি একটি উপলব্ধ থাকে)। |
AlternateRoutesStrategy.SHOW_NONE | বিকল্প পথ লুকিয়ে রাখে। |
নিম্নলিখিত কোড উদাহরণটি দেখায় যে কীভাবে বিকল্প রুটগুলি সম্পূর্ণভাবে লুকিয়ে রাখা যায়।
RoutingOptions routingOptions = new RoutingOptions();
routingOptions.alternateRoutesStrategy(AlternateRoutesStrategy.SHOW_NONE);
navigator.setDestinations(destinations, routingOptions, displayOptions);
ট্রিপ অগ্রগতি বার
ট্রিপ প্রগ্রেস বার হল একটি উল্লম্ব বার যা নেভিগেশন শুরু হলে মানচিত্রের ডান প্রান্তে প্রদর্শিত হয়। সক্রিয় করা হলে, এটি ব্যবহারকারীর গন্তব্য এবং বর্তমান অবস্থান সহ একটি সম্পূর্ণ ভ্রমণের জন্য একটি ওভারভিউ প্রদর্শন করে৷
জুম ইন করার প্রয়োজন ছাড়াই ব্যবহারকারীদের যেকোনো আসন্ন সমস্যা, যেমন ট্রাফিকের মতো দ্রুত অনুমান করার ক্ষমতা প্রদান করে। প্রয়োজনে তারা ট্রিপটি পুনরায় রুট করতে পারে। ব্যবহারকারী যদি ট্রিপটিকে পুনরায় রুট করেন, তাহলে অগ্রগতি বারটি রিসেট হবে যেন সেই বিন্দু থেকে একটি নতুন ট্রিপ শুরু হয়েছে।
ট্রিপ প্রগ্রেস বার নিম্নলিখিত স্থিতি সূচকগুলি প্রদর্শন করে:
পথ কেটে গেছে —যাত্রার অতিবাহিত অংশ।
বর্তমান অবস্থান — ট্রিপে ব্যবহারকারীর বর্তমান অবস্থান।
ট্র্যাফিক অবস্থা - আসন্ন ট্র্যাফিকের অবস্থা।
চূড়ান্ত গন্তব্য —শেষ ভ্রমণের গন্তব্য।
NavigationView বা SupportNavigationFragment- এ setTripProgressBarEnabled()
পদ্ধতিতে কল করে ট্রিপ অগ্রগতি বার সক্রিয় করুন। যেমন:
// Enable the trip progress bar.
mNavFragment.setTripProgressBarEnabled(true);