এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

পালাক্রমে ডেটা ফিড সম্পর্কে বিশদ বিবরণ

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

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

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

অপরিহার্য নেভিগেশন ডিসপ্লে উপাদান

মোবাইলের স্ক্রিনে দেখা যাচ্ছে যে ৫০ ফুট দূরে চার্চ স্ট্রিটে একটি ডান মোড় রয়েছে। স্ক্রিনের নিচে, গন্তব্যে পৌঁছানোর জন্য বাকি সময় ১৩ মিনিট এবং বাকি দূরত্ব ২.১ মাইল।

প্রতিটি নেভিগেশন ধাপের প্রধান ফিল্ডগুলো হলো রাস্তার সম্পূর্ণ নাম, কৌশল এবং ধাপটির মোট দূরত্ব, যা GMSNavigationStepInfo তে পাওয়া যায়।

সম্পূর্ণ যাত্রার জন্য, আপনি বর্তমান ধাপ বা গন্তব্য পর্যন্ত অবশিষ্ট সময় ও দূরত্ব দেখতে চাইতে পারেন, যার সবগুলোই GMSNavigationNavInfo তে উপলব্ধ। ডানদিকের ছবিতে এই অপরিহার্য নেভিগেশন উপাদানগুলোর একটি উদাহরণ দেখানো হয়েছে।

একটি ইভেন্ট লিসেনার সেট আপ করুন

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

ইভেন্ট হ্যান্ডলার প্রয়োগ করতে, ম্যাপের ভিউ কন্ট্রোলারকে অবশ্যই GMSNavigatorListener প্রোটোকলটি ইমপ্লিমেন্ট করতে হবে। iOS-এর জন্য নেভিগেশন SDK-তে ইভেন্ট হ্যান্ডলিং সম্পর্কে বিস্তারিত তথ্যের জন্য, "নেভিগেশন ইভেন্ট শুনুন" দেখুন।

`didChangeNavInfo` ইভেন্টটি পরিচালনা করা

আপনার অ্যাপে টার্ন-বাই-টার্ন সাপোর্ট যোগ করতে didChangeNavInfo ইভেন্টের জন্য একটি লিসেনার তৈরি করুন। ইভেন্ট লিসেনারে, টার্ন-বাই-টার্ন নেভিগেশন নিয়ন্ত্রণ করতে নিম্নলিখিত ক্লাস এবং এনামগুলি ব্যবহার করুন:

GMSNavigationNavInfo — নেভিগেশনের অবস্থা সম্পর্কিত তথ্য সংজ্ঞায়িতকারী ক্লাস।
GMSNavigationStepInfo — একটি ক্লাস যা নেভিগেশন রুটের একটিমাত্র ধাপ সম্পর্কিত তথ্য সংজ্ঞায়িত করে।
GMSNavigationNavState — একটি এনুম যা একটি নেভিগেশনের বর্তমান অবস্থা নির্ধারণ করে, যেমন যাত্রাপথে আছে, পথ পরিবর্তন করছে, বা থেমে আছে।
GMSNavigationDrivingSide — এই ধাপটি ডান দিক দিয়ে নাকি বাম দিক দিয়ে যাওয়ার রুটে অবস্থিত, তা নির্ধারণকারী একটি Enum।
GMSNavigationManeuver — এটি একটি Enum যা করণীয় নেভিগেশন অ্যাকশন নির্ধারণ করে, যেমন বামে মোড় নেওয়া বা ডানে মোড় নেওয়া।

নিচে didChangeNavInfo ইভেন্টের জন্য কিছু উদাহরণ ইভেন্ট লিসেনার দেখানো হলো:

সুইফট

  // ViewController.swift
  class SomeViewController: UIViewController {
    ...
    mapView.navigator?.add(self);
    ...
  }

  extension SomeViewController: GMSNavigatorListener {
    func navigator(_ navigator: GMSNavigator,
                   didUpdateNavInfo navInfo: GMSNavigationNavInfo) {

      // Get the current step information
      if navInfo.navState == .enroute {
        if let currentStep = navInfo.currentStep {
          ...
          roadNameLabel.text = currentStep.simpleRoadName
          ...
        }
      }
    }
  }

উদ্দেশ্য-সি

  // ViewController.h
  @interface SomeViewController () <GMSNavigatorListener>

  @end

  // ViewController.m
  @implementation SomeViewController
  // Some initialization code.
  ... {
    ...
    [_mapView.navigator addListener:self];
    ...
  }

  #pragma mark GMSNavigatorListener
  - (void)navigator:(GMSNavigator *)navigator didUpdateNavInfo:(GMSNavigationNavInfo *)navInfo {
    // Get the current step information
    if (navInfo.navState == GMSNavigationNavStateEnroute) {
      GMSNavigationStepInfo *currentStep = navInfo.currentStep;
      if (currentStep) {
        ...
        roadNameLabel.text = currentStep.simpleRoadName;
        ...
      }
    }
    ...
  }

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

ন্যাভিগেশনের বর্তমান অবস্থা জানতে GMSNavigationNavInfo এর navState প্রপার্টি ব্যবহার করুন, যা নিম্নলিখিতগুলির মধ্যে একটি:

Enroute - GMSNavigationNavStateEnroute অবস্থাটির অর্থ হলো, নির্দেশিত নেভিগেশন সক্রিয় আছে এবং ব্যবহারকারী প্রদত্ত রুটে রয়েছেন। বর্তমান আসন্ন চালনা ধাপ সম্পর্কে তথ্য উপলব্ধ আছে।
রিরাউটিং - GMSNavigationNavStateRerouting এর অর্থ হলো নেভিগেশন প্রক্রিয়া চলমান আছে, কিন্তু নেভিগেটর একটি নতুন রুট খুঁজছে। পরবর্তী ম্যানুভার ধাপটি উপলব্ধ নয়, কারণ এখনও কোনো নতুন রুট নেই।
বন্ধ - GMSNavigationNavStateStopped এর অর্থ হলো নেভিগেশন শেষ হয়ে গেছে। উদাহরণস্বরূপ, ব্যবহারকারী যখন অ্যাপে নেভিগেশন থেকে বেরিয়ে যান, তখন নেভিগেশন বন্ধ হয়ে যায়। নমুনা অ্যাপটিতে, একটি GMSNavigationNavStateStopped স্টেট নেভিগেশন তথ্যের প্রদর্শন মুছে দেয়, যাতে অবশিষ্ট ধাপ নির্দেশাবলী প্রদর্শিত না হয়।

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

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

কোনো লেনে চালকের জন্য প্রস্তাবিত দিকটি recommended ’ ক্ষেত্রটি ব্যবহার করে চিহ্নিত করা হয়।

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

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

// Lane 1
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 2
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 3
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false}]

// Lane 4
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false},
{/*GMSNavigationLaneShape=*/ GMSNavigationLaneShapeNormalRight, /*recommended=*/ false}]

লেন নির্দেশিকা চিত্র

GMSNavigationStepInfo দ্বারা নির্দেশিত প্রতিটি নেভিগেশন ধাপের জন্য লেনের ছবি তৈরি করা নেভিগেশন SDK-এর সমর্থন রয়েছে। এই আইকনগুলো CarPlay-এর ছবির আকারের নির্দেশিকা মেনে চলে।

সুইফট

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)

উদ্দেশ্য-সি

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];

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

একটি কৌশলের প্রতীক

GMSNavigationManeuver enum-টি নেভিগেট করার সময় ঘটতে পারে এমন প্রতিটি সম্ভাব্য ম্যানুভারকে সংজ্ঞায়িত করে, এবং আপনি GMSNavigationStepInfo এর maneuver প্রপার্টি থেকে একটি নির্দিষ্ট স্টেপের জন্য ম্যানুভারটি পেতে পারেন।

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

কিছু চালনার ক্ষেত্রে একটি অতিরিক্ত "ঘড়ির কাঁটার দিকে" বা "ঘড়ির কাঁটার বিপরীত দিকে" লেবেল থাকে, যা 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`

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

ন্যাভিগেশন SDK একটি প্রদত্ত GMSNavigationStepInfo এর জন্য ম্যানুভার আইকন তৈরি করা সমর্থন করে। এই আইকনগুলো CarPlay-এর ছবির আকারের নির্দেশিকা মেনে চলে।

সুইফট

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)

উদ্দেশ্য-সি

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];

অপরিহার্য নেভিগেশন ডিসপ্লে উপাদান

একটি ইভেন্ট লিসেনার সেট আপ করুন

didChangeNavInfo ইভেন্টটি পরিচালনা করা

সুইফট

উদ্দেশ্য-সি

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

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

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

লেন নির্দেশিকা চিত্র

সুইফট

উদ্দেশ্য-সি

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

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

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

সুইফট

উদ্দেশ্য-সি

`didChangeNavInfo` ইভেন্টটি পরিচালনা করা