পালাক্রমে ডেটা ফিড সক্ষম করুন

টার্ন-বাই-টার্ন ডেটা ফিড এমন ডিভাইসগুলোকে শুধুমাত্র নেভিগেশন-সংক্রান্ত তথ্য প্রদান করে, যেগুলো ম্যাপ-ভিত্তিক নেভিগেশন নির্দেশনার জন্য ডিজাইন করা হয়নি। এটি আপনার সরবরাহ করা উপাদানসহ আসন্ন চালনাগুলো প্রদান করে:

  • আইকন (বাম, ডান, ইউ-টার্ন)
  • গোলচত্বরে টার্ন নম্বর
  • রাস্তার নাম
  • পরবর্তী নেভিগেশন ধাপ বা চূড়ান্ত গন্তব্যে পৌঁছানোর আনুমানিক দূরত্ব এবং সময়

আপনি টার্ন-বাই-টার্ন ফিড ব্যবহার করে এমন অভিজ্ঞতা তৈরি করতে পারেন যেখানে সম্পূর্ণ নেভিগেশন SDK UI উপযুক্ত নয়, যেমন অ্যান্ড্রয়েড অটো বা ছোট স্ক্রিনের ডিসপ্লের জন্য যেখানে সম্পূর্ণ অ্যান্ড্রয়েড স্ট্যাক উপলব্ধ নেই। উদাহরণস্বরূপ, আপনি এটি দুই চাকার যানবাহনের চালকদের জন্য ব্যবহার করতে পারেন, যেখানে আপনি শুধুমাত্র নেভিগেশন নির্দেশনা প্রজেক্ট করে তাদের ন্যূনতম মনোযোগ বিঘ্নিত করে দ্রুত এবং আরও আত্মবিশ্বাসের সাথে তাদের গন্তব্যে পৌঁছাতে সাহায্য করতে পারেন।

SDK ব্যবহার করার জন্য, আপনাকে একটি সার্ভিস তৈরি করে Android-এর জন্য Navigation SDK-এর সাথে রেজিস্টার করতে হবে, যাতে এটি রিয়েল টাইমে (নেভিগেশনের সময় প্রায় প্রতি সেকেন্ডে একবার) নতুন নেভিগেশন তথ্য গ্রহণ করতে পারে।

এই ডকুমেন্টটিতে দেখানো হয়েছে কীভাবে একটি নেভিগেশন সার্ভিস তৈরি ও রেজিস্টার করতে হয়, যা SDK থেকে নেভিগেশন তথ্য গ্রহণ করে এবং গ্রহণকারী ডিভাইসে নেভিগেশন স্টেট সরবরাহ করে।

সংক্ষিপ্ত বিবরণ

এই বিভাগে টার্ন-বাই-টার্ন ফিচারটি সক্রিয় করার উচ্চ-স্তরের কার্যপ্রবাহের সারসংক্ষেপ দেওয়া হয়েছে।

TurnByTurn বৈশিষ্ট্য ব্যবহার করে

টার্ন-বাই-টার্ন ফিচারটি চালু করার প্রধান ধাপগুলো এখানে দেওয়া হলো। পরবর্তী বিভাগগুলোতে প্রতিটি ধাপ সম্পর্কে বিস্তারিত আলোচনা করা হয়েছে।

  1. ন্যাভিগেশন আপডেট গ্রহণ করার জন্য একটি সার্ভিস তৈরি করুন ।

  2. পরিষেবাটি নিবন্ধন করুন ।

  3. নেভিগেশন অবস্থাগুলো বুঝুন ।

নেভিগেশন আপডেট পেতে একটি পরিষেবা তৈরি করুন

নেভিগেশন এসডিকে আপনার TurnByTurn সার্ভিসের সাথে যুক্ত হয় এবং অ্যান্ড্রয়েড মেসেঞ্জারের মাধ্যমে এতে নেভিগেশন আপডেট পাঠায়। আপনি এই আপডেটগুলির জন্য একটি নতুন নেভিগেশন সার্ভিস তৈরি করতে পারেন, অথবা একটি বিদ্যমান সার্ভিস ব্যবহার করতে পারেন।

ন্যাভিগেশন আপডেট পাওয়ার জন্য সার্ভিস ব্যবহারের সুবিধা হলো, সার্ভিসটি একটি আলাদা ব্যাকগ্রাউন্ড প্রসেসে থাকতে পারে।

নিম্নলিখিত উদাহরণে পরিষেবাটি নেভিগেশন তথ্য গ্রহণ করে এবং TurnByTurnManager ব্যবহার করে ডেটাটিকে একটি NavInfo অবজেক্টে রূপান্তর করে, যেটিতে নেভিগেশনের বিবরণ থাকে।

/**
 *   Receives turn-by-turn navigation information forwarded from NavSDK.
 */
public class NavInfoReceivingService extends Service {
  /** The messenger used by the service to receive nav step updates. */
  private Messenger incomingMessenger;
  private TurnByTurnManager turnByTurnManager;

  private final class IncomingNavStepHandler extends Handler {
    public IncomingNavStepHandler(Looper looper) {
      super(looper);
    }

    @Override
    public void handleMessage(Message msg) {
      // Identify the message through the msg.what field.
      if (TurnByTurnManager.MSG_NAV_INFO == msg.what) {
        // Extract the NavInfo object using the TurnByTurnManager.
        NavInfo navInfo = turnByTurnManager
          .readNavInfoFromBundle(msg.getData()));
      // Do something with the NavInfo
    }
  }
}

@Nullable
@Override
public IBinder onBind(Intent intent) {
  return incomingMessenger.getBinder();
}

@Override
public void onCreate() {
  turnByTurnManager = TurnByTurnManager.createInstance();
  HandlerThread thread =
    new HandlerThread("NavInfoReceivingService",
      Process.THREAD_PRIORITY_DEFAULT);
  thread.start();
  incomingMessenger = new Messenger(
    new IncomingNavStepHandler(thread.getLooper()));
}

বার্তা কোড

NavInfo মেসেজগুলোকে Message ক্লাসের Message.what ফিল্ডের মাধ্যমে শনাক্ত করা যায়, যার মান TurnByTurnManager.MSG_NAV_INFO -তে সেট করা থাকে।

নেভিগেশন আপডেটের জন্য পরিষেবাটি নিবন্ধন করা হচ্ছে

নিম্নলিখিত কোড স্নিপেটটি নেভিগেশন সার্ভিসটি রেজিস্টার করে।

boolean isNavInfoReceivingServiceRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(), NavInfoReceivingService.class.getName(), numNextStepsToPreview);

পরিষেবা শুরু এবং বন্ধ করা

নেভিগেশন সার্ভিসটি ততক্ষণ সক্রিয় থাকে যতক্ষণ নেভিগেশন SDK এর সাথে সংযুক্ত থাকে। আপনি ম্যানুয়ালি startService() এবং stopService() কল করে নেভিগেশন সার্ভিসের লাইফসাইকেল নিয়ন্ত্রণ করতে পারেন, কিন্তু যখন আপনি নেভিগেশন SDK-এর সাথে আপনার সার্ভিসটি রেজিস্টার করেন, তখন আপনার সার্ভিসটি স্বয়ংক্রিয়ভাবে চালু হয় এবং শুধুমাত্র আনরেজিস্টার করলেই বন্ধ হয়। আপনি আপনার অ্যাপটি কীভাবে সেট আপ করেছেন তার উপর নির্ভর করে, আপনি একটি ফোরগ্রাউন্ড সার্ভিস চালু করার কথা বিবেচনা করতে পারেন, যা অ্যান্ড্রয়েড ডকুমেন্টেশনের ' সার্ভিসেস ওভারভিউ' অংশে বর্ণনা করা হয়েছে।

পরিষেবাটি নিবন্ধনমুক্ত করা

ন্যাভিগেশন আপডেট পাওয়া বন্ধ করতে, ন্যাভিগেশন SDK থেকে সার্ভিসটি আনরেজিস্টার করুন।

navigator.unregisterServiceForNavUpdates();

নেভিগেশন অবস্থা বুঝুন

ন্যাভিগেশনের বর্তমান অবস্থা জানতে NavInfo.getNavState() ব্যবহার করুন, যা নিম্নলিখিতগুলির মধ্যে একটি:

  • এনরুট - ENROUTE অবস্থাটির অর্থ হলো, নির্দেশিত নেভিগেশন সক্রিয় আছে এবং ব্যবহারকারী প্রদত্ত রুটে রয়েছেন। বর্তমান ও আসন্ন চালনা ধাপ সম্পর্কে তথ্য উপলব্ধ থাকে।

  • রিরাউটিং - REROUTING মানে হলো নেভিগেশন চলছে, কিন্তু নেভিগেটর একটি নতুন রুট খুঁজছে। পরবর্তী ম্যানুভার ধাপটি উপলব্ধ নয়, কারণ এখনও কোনো নতুন রুট পাওয়া যায়নি। স্যাম্পল অ্যাপটিতে , নেভিগেশন তথ্য ডিসপ্লেতে একটি "Rerouting..." বার্তা দেখা যায়। একটি রুট খুঁজে পাওয়া গেলে, ENROUTE অবস্থা সহ একটি NavInfo বার্তা পাঠানো হয়।

  • বন্ধ - STOPPED মানে নেভিগেশন শেষ হয়ে গেছে। উদাহরণস্বরূপ, ব্যবহারকারী যখন অ্যাপের মধ্যে নেভিগেশন থেকে বেরিয়ে যান, তখন নেভিগেশন বন্ধ হয়ে যায়। নমুনা অ্যাপটিতে, একটি STOPPED অবস্থা নেভিগেশন তথ্যের প্রদর্শন মুছে দেয়, যাতে অবশিষ্ট ধাপ নির্দেশাবলী প্রদর্শিত না হয়।

ফিড ডিসপ্লে পূরণ করুন

এখন যেহেতু আপনি আপনার টার্ন-বাই-টার্ন পরিষেবা সেট আপ করে ফেলেছেন, এই বিভাগে সেইসব ভিজ্যুয়াল এবং টেক্সট উপাদানগুলো নিয়ে আলোচনা করা হয়েছে যা আপনি টার্ন-বাই-টার্ন ফিডের জন্য গাইডেন্স কার্ডগুলো পূরণ করতে ব্যবহার করতে পারেন।

মোবাইলের একটি স্ক্রিনে দেখা যাচ্ছে যে ১০০ ফুট দূরে W Ahwanee Ave-তে একটি বাম মোড় নিতে হবে। স্ক্রিনের নিচে, গন্তব্যে পৌঁছানোর জন্য বাকি সময় ৪৬ মিনিট, এবং বাকি দূরত্ব ৩৯ মাইল।

যখন ব্যবহারকারী গাইডেড নেভিগেশনে প্রবেশ করেন, তখন উপরে একটি নেভিগেশন কার্ড প্রদর্শিত হয়, যেখানে নেভিগেশন এসডিকে (SDK) থেকে পূরণ করা নেভিগেশন ডেটা থাকে। সংশ্লিষ্ট ছবিতে এই অপরিহার্য নেভিগেশন উপাদানগুলোর একটি উদাহরণ দেখানো হয়েছে।

এই সারণিতে নেভিগেশন তথ্যের ক্ষেত্রগুলো এবং সেগুলো কোথায় পাওয়া যাবে তা দেখানো হয়েছে।

প্রতিটি নেভিগেশন ধাপের জন্য ক্ষেত্র সামগ্রিক ভ্রমণের জন্য ক্ষেত্রসমূহ
StepInfo তে পাওয়া গেছে NavInfo তে পাওয়া গেছে
পুরো রাস্তার নাম অবশিষ্ট সময়
কৌশলের আইকন গন্তব্যের দূরত্ব
পরবর্তী ধাপের দূরত্ব
লেন নির্দেশিকা ক্ষেত্র

লেন নির্দেশনা

নেভিগেশন এসডিকে নেভিগেশন টার্ন কার্ডে লেনগুলোকে Lane এবং LaneDirection ডেটা অবজেক্ট হিসেবে উপস্থাপন করে। একটি Lane অবজেক্ট নেভিগেশনের সময় একটি নির্দিষ্ট লেনকে প্রতিনিধিত্ব করে এবং এতে LaneDirection অবজেক্টের একটি তালিকা থাকে, যা এই লেন থেকে নেওয়া যেতে পারে এমন সমস্ত বাঁকের বর্ণনা দেয়।

একটি নমুনা লেন নির্দেশিকা কনফিগারেশন।

কোনো লেনে ব্যবহারকারীর জন্য প্রস্তাবিত দিকটি 'isRecommended' ফিল্ড দ্বারা চিহ্নিত করা থাকে।

লেন নির্দেশনার উদাহরণ

নিম্নলিখিত কোড স্নিপেটটি উপরে প্রদর্শিত লেনগুলির ডেটা উপস্থাপনা তুলে ধরে।

// Lane 1
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false},
                  {/*laneShape=*/ SLIGHT_LEFT, /*isRecommended=*/ true}]

// Lane 2
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false}]

কৌশলের জন্য আইকন তৈরি করুন

Maneuver enum-টি নেভিগেট করার সময় ঘটতে পারে এমন প্রতিটি সম্ভাব্য কৌশলকে সংজ্ঞায়িত করে, এবং আপনি StepInfo.getManeuver() মেথড থেকে একটি নির্দিষ্ট ধাপের জন্য কৌশলটি পেতে পারেন।

আপনাকে ম্যানুভার আইকন তৈরি করতে হবে এবং সেগুলোকে তাদের সংশ্লিষ্ট ম্যানুভারের সাথে যুক্ত করতে হবে। কিছু ম্যানুভারের জন্য, আপনি একটি আইকনের সাথে এক-এক ম্যাপিং সেট আপ করতে পারেন, যেমন DESTINATION_LEFT এবং DESTINATION_RIGHT । তবে, যেহেতু কিছু ম্যানুভার একই রকম, তাই আপনি একটি আইকনের সাথে একাধিক ম্যানুভার ম্যাপ করতে চাইতে পারেন। উদাহরণস্বরূপ TURN_LEFT এবং ON_RAMP_LEFT উভয়ই বাম দিকে মোড় নেওয়ার আইকনের সাথে ম্যাপ করা যেতে পারে।

কিছু চালনার ক্ষেত্রে একটি অতিরিক্ত clockwise বা counterclockwise লেবেল থাকে, যা এসডিকে (SDK) কোনো দেশের ড্রাইভিং সাইডের উপর ভিত্তি করে নির্ধারণ করে। উদাহরণস্বরূপ, যেসব দেশে রাস্তার বাম দিকে গাড়ি চালানো হয়, সেখানকার চালকরা রাউন্ডঅ্যাবাউট বা ইউ-টার্ন ঘড়ির কাঁটার দিকে নেন, অন্যদিকে যেসব দেশে রাস্তার ডান দিকে গাড়ি চালানো হয়, সেখানে চালকরা ঘড়ির কাঁটার দিকে যান। নেভিগেশন এসডিকে (SDK) শনাক্ত করে যে চালনাটি বাম-দিকের নাকি ডান-দিকের ট্র্যাফিকের মধ্যে ঘটছে এবং সেই অনুযায়ী চালনাটি প্রদর্শন করে। তাই, ঘড়ির কাঁটার দিকে এবং ঘড়ির কাঁটার বিপরীত দিকের চালনার জন্য আপনার চালনার আইকনটি ভিন্ন হতে পারে।

বিভিন্ন কৌশলের উদাহরণ আইকনগুলো দেখতে প্রসারিত করুন।

নমুনা আইকন টার্নবাইটার্ন কৌশল
DEPART
UNKNOWN
STRAIGHT
ON_RAMP_UNSPECIFIED
OFF_RAMP_UNSPECIFIED
NAME_CHANGE
TURN_RIGHT
ON_RAMP_RIGHT
TURN_LEFT
ON_RAMP_LEFT
TURN_SLIGHT_RIGHT
ON_RAMP_SLIGHT_RIGHT
OFF_RAMP_SLIGHT_RIGHT
TURN_SLIGHT_LEFT
ON_RAMP_SLIGHT_LEFT
OFF_RAMP_SLIGHT_LEFT
TURN_SHARP_RIGHT
ON_RAMP_SHARP_RIGHT
OFF_RAMP_SHARP_RIGHT
TURN_SHARP_LEFT
ON_RAMP_SHARP_LEFT
OFF_RAMP_SHARP_LEFT
TURN_U_TURN_COUNTERCLOCKWISE
ON_RAMP_U_TURN_COUNTERCLOCKWISE
OFF_RAMP_U_TURN_COUNTERCLOCKWISE
TURN_U_TURN_CLOCKWISE
ON_RAMP_U_TURN_CLOCKWISE
OFF_RAMP_U_TURN_CLOCKWISE
ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_RIGHT_CLOCKWISE
ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
ROUNDABOUT_STRAIGHT_CLOCKWISE
ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
ROUNDABOUT_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_LEFT_CLOCKWISE
ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_SHARP_LEFT_CLOCKWISE
ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
ROUNDABOUT_U_TURN_CLOCKWISE
ROUNDABOUT_COUNTERCLOCKWISE
ROUNDABOUT_CLOCKWISE
ROUNDABOUT_EXIT_COUNTERCLOCKWISE
ROUNDABOUT_EXIT_CLOCKWISE
MERGE_RIGHT
OFF_RAMP_RIGHT
MERGE_LEFT
OFF_RAMP_LEFT
FORK_RIGHT
TURN_KEEP_RIGHT
ON_RAMP_KEEP_RIGHT
OFF_RAMP_KEEP_RIGHT
FORK_LEFT
TURN_KEEP_LEFT
ON_RAMP_KEEP_LEFT
OFF_RAMP_KEEP_LEFT
MERGE_UNSPECIFIED
DESTINATION
DESTINATION_RIGHT
DESTINATION_LEFT
FERRY_BOAT
FERRY_TRAIN

তৈরি করা আইকন ব্যবহার করুন

নেভিগেশন এসডিকে দ্বারা প্রদত্ত কয়েকটি জেনারেট করা আইকনের তালিকা।

অ্যান্ড্রয়েড অটো ব্যবহারের ক্ষেত্রগুলিকে সহজ করার জন্য, নেভিগেশন এসডিকে চালনা এবং লেন নির্দেশিকা আইকন তৈরি করা সমর্থন করে। এই আইকনগুলি অ্যান্ড্রয়েড অটো কার অ্যাপ লাইব্রেরির ছবির আকারের নির্দেশিকা মেনে চলে, যা একটি 500 x 74 dp বাউন্ডিং বক্স ব্যবহারের পরামর্শ দেয়। বিস্তারিত জানার জন্য অ্যান্ড্রয়েড রেফারেন্স ডকুমেন্টেশনে setsLaneImage এবং CarIcon দেখুন।

আইকন তৈরির উদাহরণ 

NavigationUpdatesOptions options =
  NavigationUpdatesOptions.builder()
             .setNumNextStepsToPreview(numNextStepsToPreview)
             .setGeneratedStepImagesType(GeneratedStepImagesType.BITMAP)
             .setDisplayMetrics(getResources().getDisplayMetrics())
             .build();
boolean isRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(),
              NavInfoReceivingService.class.getName(),
              options);

আপনি আইকন জেনারেশন সক্ষম করার পরে, TurnbyTurn StepInfo অবজেক্টটি maneuverBitmap এবং lanesBitmap ফিল্ডগুলিকে আইকন দিয়ে পূরণ করে।

এরপর কী?