একটি মানচিত্র শৈলী

এই দস্তাবেজটি কভার করে যে কীভাবে একটি মানচিত্রের চেহারা এবং অনুভূতি কাস্টমাইজ করা যায় এবং ডেটা দৃশ্যমানতা এবং ভিউপোর্ট বিকল্পগুলি নিয়ন্ত্রণ করা যায়। আপনি নিম্নলিখিত উপায়ে এটি করতে পারেন:

• ক্লাউড-ভিত্তিক মানচিত্র স্টাইলিং ব্যবহার করুন
• আপনার নিজের কোডে সরাসরি মানচিত্র শৈলী বিকল্প সেট করুন

ক্লাউড-ভিত্তিক মানচিত্রের স্টাইলিং দিয়ে মানচিত্রটিকে স্টাইল করুন

ক্লাউড-ভিত্তিক মানচিত্র স্টাইলিং ব্যবহার করে মানচিত্রের উপাদানটির চেহারা এবং অনুভূতি কাস্টমাইজ করুন। আপনি Google ক্লাউড কনসোলে আপনার যেকোনও অ্যাপের জন্য ম্যাপ স্টাইল তৈরি এবং সম্পাদনা করেন যা Google ম্যাপ ব্যবহার করে, আপনার কোডে কোনো পরিবর্তন না করেই। আরও তথ্যের জন্য, ক্লাউড-ভিত্তিক মানচিত্রের স্টাইলিং দেখুন।

ConsumerMapView এবং ConsumerMapFragment উভয় ক্লাসই ক্লাউড-ভিত্তিক মানচিত্র স্টাইলিং সমর্থন করে। ক্লাউড-ভিত্তিক মানচিত্র স্টাইলিং ব্যবহার করার জন্য, নিশ্চিত করুন যে নির্বাচিত মানচিত্র রেন্ডারার LATEST । নিম্নলিখিত বিভাগগুলি আপনার প্রকল্পের সাথে ক্লাউড-ভিত্তিক মানচিত্র স্টাইলিং কীভাবে ব্যবহার করবেন তার উদাহরণগুলি দেখায়৷

ConsumerMapView

ConsumerMapView এ ক্লাউড-ভিত্তিক মানচিত্র স্টাইলিং ব্যবহার করতে, GoogleMapOptions এ mapId ক্ষেত্র সেট করুন এবং getConsumerGoogleMapAsync(ConsumerMapReadyCallback, Fragment, GoogleMapOptions) বা getConsumerGoogleMapAsync,FC, FMapAsync,C,C,,এ GoogleMapOptions পাস করুন GoogleMapOptions)

উদাহরণ

জাভা

public class SampleAppActivity extends AppCompatActivity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ConsumerMapView mapView = findViewById(R.id.consumer_map_view);

    if (mapView != null) {
      GoogleMapOptions optionsWithMapId = new GoogleMapOptions().mapId("map-id");
      mapView.getConsumerGoogleMapAsync(
          new ConsumerMapReadyCallback() {
            @Override
            public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
              // ...
            }
          },
          /* fragmentActivity= */ this,
          /* googleMapOptions= */ optionsWithMapId);
    }
  }
}

কোটলিন

class SampleAppActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val mapView = findViewById(R.id.consumer_map_view) as ConsumerMapView

    val optionsWithMapId = GoogleMapOptions().mapId("map-id")
    mapView.getConsumerGoogleMapAsync(
      object : ConsumerGoogleMap.ConsumerMapReadyCallback() {
        override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
          // ...
        }
      },
      /* fragmentActivity= */ this,
      /* googleMapOptions= */ optionsWithMapId)
  }
}

ConsumerMapFragment

ConsumerMapFragments এ ক্লাউড-ভিত্তিক মানচিত্র স্টাইলিং ব্যবহার করার দুটি উপায় রয়েছে:

• স্থিরভাবে এক্সএমএল দিয়ে।
• newInstance সাথে গতিশীলভাবে।

স্থিরভাবে এক্সএমএল দিয়ে

ConsumerMapFragment এ XML-এর সাথে ক্লাউড-ভিত্তিক মানচিত্র স্টাইলিং ব্যবহার করতে, নির্দিষ্ট mapId এর সাথে map:mapId XML অ্যাট্রিবিউট যোগ করুন। নিম্নলিখিত উদাহরণ দেখুন:

<fragment
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    android:name="com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapFragment"
    android:id="@+id/consumer_map_fragment"
    map:mapId="map-id"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

newInstance সাথে গতিশীলভাবে

ConsumerMapFragment এ newInstance এর সাথে ক্লাউড-ভিত্তিক মানচিত্র স্টাইলিং ব্যবহার করতে, GoogleMapOptions এ mapId ক্ষেত্র সেট করুন এবং GoogleMapOptions কে newInstance এ পাস করুন। নিম্নলিখিত উদাহরণ দেখুন:

জাভা

public class SampleFragmentJ extends Fragment {

  @Override
  public View onCreateView(
      @NonNull LayoutInflater inflater,
      @Nullable ViewGroup container,
      @Nullable Bundle savedInstanceState) {

    final View view = inflater.inflate(R.layout.consumer_map_fragment, container, false);

    GoogleMapOptions optionsWithMapId = new GoogleMapOptions().mapId("map-id");
    ConsumerMapFragment consumerMapFragment = ConsumerMapFragment.newInstance(optionsWithMapId);

    getParentFragmentManager()
        .beginTransaction()
        .add(R.id.consumer_map_fragment, consumerMapFragment)
        .commit();

    consumerMapFragment.getConsumerGoogleMapAsync(
        new ConsumerMapReadyCallback() {
          @Override
          public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
            // ...
          }
        });

    return view;
  }
}

কোটলিন

class SampleFragment : Fragment() {
  override fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?): View? {

    val view = inflater.inflate(R.layout.consumer_map_fragment, container, false)

    val optionsWithMapId = GoogleMapOptions().mapId("map-id")
    val consumerMapFragment = ConsumerMapFragment.newInstance(optionsWithMapId)

    parentFragmentManager
      .beginTransaction()
      .add(R.id.consumer_map_fragment, consumerMapFragment)
      .commit()

    consumerMapFragment.getConsumerGoogleMapAsync(
      object : ConsumerMapReadyCallback() {
        override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
          // ...
        }
      })

    return view
  }
}

আপনার জাভাস্ক্রিপ্ট ভোক্তা ট্রিপ শেয়ারিং মানচিত্রে একটি মানচিত্র শৈলী প্রয়োগ করতে, আপনি যখন JourneySharingMapView তৈরি করবেন তখন একটি mapId এবং অন্য যেকোন mapOptions নির্দিষ্ট করুন৷

দ্রষ্টব্য: JourneySharingMapView তাৎক্ষণিক হওয়ার পরে আপনি একটি mapId পরিবর্তন বা যোগ করতে পারবেন না।

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

জাভাস্ক্রিপ্ট

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

টাইপস্ক্রিপ্ট

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

আপনার নিজের কোডে সরাসরি স্টাইল মানচিত্র

আপনি যখন JourneySharingMapView তৈরি করেন তখন আপনি মানচিত্রের বিকল্পগুলি সেট করে মানচিত্রের স্টাইলিং কাস্টমাইজ করতে পারেন। নিম্নলিখিত উদাহরণগুলি দেখায় যে কীভাবে মানচিত্রের বিকল্পগুলি ব্যবহার করে একটি মানচিত্রের স্টাইল করা যায়। আপনি কোন মানচিত্রের বিকল্পগুলি সেট করতে পারেন সে সম্পর্কে আরও তথ্যের জন্য, Google মানচিত্র জাভাস্ক্রিপ্ট API রেফারেন্সে mapOptions দেখুন৷

জাভাস্ক্রিপ্ট

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

টাইপস্ক্রিপ্ট

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

SDK-তে টাস্ক ডেটার দৃশ্যমানতা নিয়ন্ত্রণ করুন

আপনি দৃশ্যমানতা নিয়ম ব্যবহার করে মানচিত্রে নির্দিষ্ট টাস্ক অবজেক্টের দৃশ্যমানতা নিয়ন্ত্রণ করতে পারেন।

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

টাস্ক ডেটা ডিফল্ট দৃশ্যমানতা

ডিফল্টরূপে, গাড়ির জন্য নির্ধারিত কাজের ডেটা দৃশ্যমান হয় যখন গাড়িটি টাস্কের 5 স্টপের মধ্যে থাকে । টাস্ক সম্পূর্ণ বা বাতিল হলে দৃশ্যমানতা শেষ হয়।

এই টেবিলটি প্রতিটি ধরনের কাজের জন্য ডিফল্ট দৃশ্যমানতা দেখায়। আপনি অনেক কাজের জন্য দৃশ্যমানতা কাস্টমাইজ করতে পারেন, কিন্তু সব নয়। কাজের ধরন সম্পর্কে আরও বিশদ বিবরণের জন্য, নির্ধারিত টাস্ক গাইডে টাস্কের ধরন দেখুন।

টাস্কের ধরন	ডিফল্ট দৃশ্যমানতা	কাস্টমাইজযোগ্য?	বর্ণনা
অনুপলব্ধ কাজ	দৃশ্যমান নয়	না	ড্রাইভার ব্রেক এবং রিফুয়েলিং জন্য ব্যবহৃত. কোনো ডেলিভারি টাস্কের রুটে যদি অন্য গাড়ির স্টপ থাকে, তাহলে সেই স্টপে দেখানো হয় না যদি শুধুমাত্র অনুপলব্ধ কাজ থাকে। আনুমানিক আগমনের সময় এবং আনুমানিক টাস্ক সমাপ্তির সময় এখনও ডেলিভারি টাস্কের জন্য দেখানো হয়।
যানবাহনের কাজগুলি খুলুন	দৃশ্যমান	হ্যাঁ	টাস্ক সম্পূর্ণ বা বাতিল হলে দৃশ্যমানতা শেষ হয়। আপনি খোলা যানবাহন কাজের দৃশ্যমানতা কাস্টমাইজ করতে পারেন। যানবাহনের খোলা কাজের দৃশ্যমানতা কাস্টমাইজ করুন দেখুন।
বন্ধ গাড়ির কাজ	দৃশ্যমান নয়	না	আপনি বন্ধ গাড়ির কাজগুলির দৃশ্যমানতা কাস্টমাইজ করতে পারবেন না।

খোলা যানবাহন কাজগুলির দৃশ্যমানতা কাস্টমাইজ করুন

TaskTrackingInfo ইন্টারফেস অনেকগুলি টাস্ক ডেটা উপাদান সরবরাহ করে যা কনজিউমার SDK এর সাথে দৃশ্যমান করা যেতে পারে।

কাস্টমাইজযোগ্য টাস্ক ডেটা উপাদান
রুট পলিলাইন পৌঁছানোর আনুমানিক সময় আনুমানিক টাস্ক সমাপ্তির সময়	টাস্ক ড্রাইভিং দূরত্ব অবশিষ্ট অবশিষ্ট স্টপ গণনা গাড়ির অবস্থান

টাস্ক প্রতি দৃশ্যমানতার বিকল্প

ফ্লিট ইঞ্জিনের মধ্যে একটি টাস্ক তৈরি বা আপডেট করার সময় আপনি TaskTrackingViewConfig সেট করে প্রতি-টাস্ক ভিত্তিতে দৃশ্যমানতা কনফিগারেশন কাস্টমাইজ করতে পারেন। একটি টাস্ক উপাদানের দৃশ্যমানতা নির্ধারণ করতে মানদণ্ড তৈরি করতে নিম্নলিখিত দৃশ্যমানতার বিকল্পগুলি ব্যবহার করুন:

দৃশ্যমানতার বিকল্প
অবশিষ্ট স্টপ গণনা আনুমানিক আগমনের সময় পর্যন্ত সময়কাল অবশিষ্ট ড্রাইভিং দূরত্ব	সর্বদা দৃশ্যমান কখনো দেখা যায় না

দ্রষ্টব্য: যে কোনো প্রদত্ত ডেটা উপাদান শুধুমাত্র একটি দৃশ্যমান বিকল্পের সাথে যুক্ত হতে পারে। OR বা AND ব্যবহার করে মানদণ্ড একত্রিত করা সম্ভব নয়।

ব্যাখ্যা করার জন্য, ধরুন একটি উদাহরণ কাস্টমাইজেশন নিম্নলিখিত টেবিলে দেখানো মানদণ্ড ব্যবহার করে তিনটি ডেটা উপাদানের জন্য দৃশ্যমানতা সামঞ্জস্য করে। অন্যান্য সমস্ত উপাদান ডিফল্ট দৃশ্যমানতা নিয়ম অনুসরণ করে।

সামঞ্জস্য করার জন্য ডেটা উপাদান	দৃশ্যমানতা	মানদণ্ড
রুট পলিলাইন	দেখান	গাড়িটি 3 স্টপেজের মধ্যে রয়েছে।
ETA	দেখান	অবশিষ্ট ড্রাইভিং দূরত্ব 5000 মিটারের কম।
অবশিষ্ট স্টপ গণনা	কখনো দেখাবেন না	গাড়িটি 3 স্টপেজের মধ্যে রয়েছে।

নিম্নলিখিত উদাহরণ এই কনফিগারেশন দেখায়:

"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "estimatedArrivalTimeVisibility": {
    "remainingDrivingDistanceMetersThreshold": 5000
  },
  "remainingStopCountVisibility": {
    "never": true
  }
}

দ্রষ্টব্য: আপনি সহায়তা দলের সাথে যোগাযোগ করে আপনার প্রকল্পের জন্য ডিফল্ট দৃশ্যমানতার বিকল্পগুলিও কাস্টমাইজ করতে পারেন৷

রুট পলিলাইন এবং গাড়ির অবস্থান দৃশ্যমানতার নিয়ম

রুট পলিলাইনগুলি দৃশ্যমান হতে পারে না যদি না গাড়ির অবস্থানও দৃশ্যমান হয়; অন্যথায় পলিলাইনের শেষে গাড়ির অবস্থান অনুমান করা যেতে পারে।

মূল পয়েন্ট: রুটের পলিলাইন দৃশ্যমানতা নিয়মগুলি অবশ্যই গাড়ির অবস্থানের জন্য দৃশ্যমানতার নিয়মগুলির চেয়ে সমানভাবে সীমাবদ্ধ বা আরও বেশি সীমাবদ্ধ হতে হবে৷

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

একই দৃশ্যমানতার বিকল্প	দৃশ্যমানতার মানদণ্ড	নির্দেশনা
	রুট পলিলাইন বিকল্পগুলি সর্বদা দৃশ্যমান হিসাবে সেট করা হয়েছে৷	গাড়ির অবস্থান সর্বদা দৃশ্যমান হিসাবে সেট করুন।
	যানবাহনের অবস্থান কখনই দৃশ্যমান নয় বলে সেট করা হয়েছে৷	রুট পলিলাইনগুলি কখনই দৃশ্যমান না হওয়ার জন্য সেট করুন৷
	দৃশ্যমানতার বিকল্প হল: বাকি স্টপ গণনা ETA পর্যন্ত সময়কাল অবশিষ্ট ড্রাইভিং দূরত্ব	রুট পলিলাইন বিকল্পগুলিকে গাড়ির অবস্থানের জন্য সেট করা মানের থেকে কম বা সমান একটি মান সেট করুন৷ যেমন: "taskTrackingViewConfig": { "routePolylinePointsVisibility": { "remainingStopCountThreshold": 3 }, "vehicleLocationVisibility": { "remainingStopCountThreshold": 5 }, }
বিভিন্ন দৃশ্যমানতার বিকল্প	দৃশ্যমানতার মানদণ্ড	নির্দেশনা
	গাড়ির অবস্থান দৃশ্যমান	এটি তখনই ঘটে যখন গাড়ির অবস্থান এবং পলিলাইন দৃশ্যমানতার বিকল্প উভয়ই সন্তুষ্ট হয়। যেমন: "taskTrackingViewConfig": { "routePolylinePointsVisibility": { "remainingStopCountThreshold": 3 }, "vehicleLocationVisibility": { "remainingDrivingDistanceMetersThreshold": 3000 }, } এই উদাহরণে, গাড়ির অবস্থানটি কেবল তখনই দৃশ্যমান হয় যদি অবশিষ্ট থামার সংখ্যা কমপক্ষে 3 হয় এবং অবশিষ্ট ড্রাইভিং দূরত্ব কমপক্ষে 3000 মিটার হয়৷

স্বয়ংক্রিয় ফিটিং অক্ষম করুন

আপনি স্বয়ংক্রিয় ফিটিং অক্ষম করে মানচিত্রটিকে গাড়ি এবং প্রত্যাশিত রুটে স্বয়ংক্রিয়ভাবে ভিউপোর্ট ফিট করা থেকে থামাতে পারেন। নিচের উদাহরণটি দেখায় কিভাবে আপনি যখন যাত্রা শেয়ারিং ম্যাপ ভিউ কনফিগার করেন তখন স্বয়ংক্রিয় ফিটিং অক্ষম করতে হয়।

জাভাস্ক্রিপ্ট

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

টাইপস্ক্রিপ্ট

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

এরপর কি

• মার্কার কাস্টমাইজ করুন
• পলিলাইন কাস্টমাইজ করুন