Android-এর জন্য Google Maps API আপনাকে কিছু সহজ উপায়ে আপনার ম্যাপে আকার যোগ করার সুবিধা দেয় যাতে আপনি আপনার অ্যাপ্লিকেশনের জন্য সেগুলি কাস্টমাইজ করতে পারেন।
Polylineহল একাধিক সংযুক্ত লাইন সেগমেন্টের সিরিজ যা আপনার পছন্দমতো যেকোনও আকার তৈরি করতে পারে এবং ম্যাপে পথ ও রুট চিহ্নিত করতে ব্যবহার করা যেতে পারে।Polygonহল একটি ঘেরা আকৃতি যা ম্যাপে এলাকা চিহ্নিত করতে ব্যবহার করা যেতে পারে।Circleহল ম্যাপে আঁকা পৃথিবীর উপরিভাগের একটি বৃত্তের ভৌগোলিকভাবে সঠিক প্রজেকশন।
এইসব আকারের জন্য, আপনি একাধিক প্রপার্টি পরিবর্তন করে তাদের চেহারা কাস্টমাইজ করতে পারেন।
কোডের নমুনা
এলাকা ও রুট দেখানোর জন্য পলিগন ও পলিলাইন যোগ করার টিউটোরিয়ালে একটি সাধারণ Android অ্যাপের জন্য সব কোড অন্তর্ভুক্ত থাকে।
এছাড়াও, GitHub-এ ApiDemos রিপোজিটরি-তে আকৃতি ও সেগুলির ফিচারের ব্যবহার দেখায় এমন স্যাম্পেল অন্তর্ভুক্ত থাকে:
- CircleDemoActivity (Java / Kotlin): Circle
- PolygonDemoActivity (Java / Kotlin): Polygon
- PolylineDemoActivity (Java / Kotlin): পলিলাইন
পলিলাইন
Polyline ক্লাস ম্যাপে কানেক্ট করা লাইন সেগমেন্টের
একটি সেটকে সংজ্ঞায়িত করে। Polyline অবজেক্টে LatLng লোকেশনের সেট থাকে এবং এটি লাইন সেগমেন্টের সিরিজ তৈরি করে যা
একটি ক্রম অনুসারে সেইসব লোকেশনকে কানেক্ট করে।
এই ভিডিওতে, ম্যাপে পলিলাইন ব্যবহার করে পথ এঁকে, ব্যবহারকারীদের গন্তব্যে পৌঁছাতে সাহায্য করার ব্যাপারে আইডিয়া দেওয়া হয়েছে।
পলিলাইন তৈরি করতে, প্রথমে একটি PolylineOptions
অবজেক্ট তৈরি করুন এবং এতে পয়েন্ট যোগ করুন। পয়েন্ট পৃথিবীর পৃষ্ঠের একটি পয়েন্টকে দেখায়,
এবং LatLng অবজেক্ট হিসেবে প্রকাশ করা হয়। আপনি PolylineOptions অবজেক্টে যে ক্রমে পয়েন্ট যোগ করেছেন সেই ক্রম অনুযায়ী পয়েন্টগুলির মধ্যে লাইন সেগমেন্ট আঁকা হয়।
PolylineOptions অবজেক্টে পয়েন্ট যোগ করতে, PolylineOptions.add() কল করুন।
মনে রাখবেন যে এই পদ্ধতিতে প্যারামিটারের সংখ্যা পরিবর্তনশীল, তাই আপনি একবারে একাধিক পয়েন্ট যোগ করতে পারবেন (পয়েন্টগুলি আগে থেকেই কোনও তালিকায় থাকলে আপনি PolylineOptions.addAll(Iterable<LatLng>)-কেও কল করতে পারেন)।
তারপর আপনি GoogleMap.addPolyline(PolylineOptions) কল করে ম্যাপে পলিলাইন যোগ করতে পারবেন। এই
পদ্ধতিটি একটি Polyline অবজেক্ট রিটার্ন করে যার সাহায্যে আপনি পরে
পলিলাইন পরিবর্তন করতে পারবেন।
নিম্নলিখিত কোড স্নিপেট থেকে বোঝা যায় যে ম্যাপে কীভাবে আয়তক্ষেত্র যোগ করতে হয়:
Kotlin
// Instantiates a new Polyline object and adds points to define a rectangle val polylineOptions = PolylineOptions() .add(LatLng(37.35, -122.0)) .add(LatLng(37.45, -122.0)) // North of the previous point, but at the same longitude .add(LatLng(37.45, -122.2)) // Same latitude, and 30km to the west .add(LatLng(37.35, -122.2)) // Same longitude, and 16km to the south .add(LatLng(37.35, -122.0)) // Closes the polyline. // Get back the mutable Polyline val polyline = map.addPolyline(polylineOptions)
Java
// Instantiates a new Polyline object and adds points to define a rectangle PolylineOptions polylineOptions = new PolylineOptions() .add(new LatLng(37.35, -122.0)) .add( new LatLng( 37.45, -122.0)) // North of the previous point, but at the same // longitude .add(new LatLng(37.45, -122.2)) // Same latitude, and 30km to the west .add(new LatLng(37.35, -122.2)) // Same longitude, and 16km to the south .add(new LatLng(37.35, -122.0)); // Closes the polyline. // Get back the mutable Polyline Polyline polyline = map.addPolyline(polylineOptions);
ম্যাপে আয়তক্ষেত্রটি নিচে দেখানো ছবির মতো দেখা যাবে:
পলিলাইন যোগ করার পরে তার আকার পরিবর্তন করতে, আপনি
Polyline.setPoints() কল করতে এবং পলিলাইনের জন্য পয়েন্টের নতুন তালিকা প্রদান করতে পারবেন।
ম্যাপে পলিলাইন যোগ করার আগে ও পরে, উভয় ক্ষেত্রেই আপনি পলিলাইনের রূপ কাস্টমাইজ করতে পারবেন। আরও বিবরণের জন্য নিচে অ্যাপেরিয়েন্স কাস্টমাইজ করা সংক্রান্ত বিভাগ দেখুন।
পলিলাইন কাস্টমাইজেশন
পলিলাইনের চেহারা কাস্টমাইজ করার বিভিন্ন উপায় আছে:
- মাল্টিকালার পলিলাইন পলিলাইন সেগমেন্টকে বিভিন্ন রঙে সেট করে।
- গ্রেডিয়েন্ট পলিলাইন দুটি রঙের গ্রেডিয়েন্ট ব্যবহার করে পলিলাইনকে রঙ করে।
- স্ট্যাম্প করা পলিলাইন বারবার বিটম্যাপ ব্যবহার করে পলিলাইন স্টাইল করে।
পলিলাইন কাস্টমাইজেশন ব্যবহার করতে, আপনাকে অবশ্যই Android-এর জন্য Maps SDK-এর 18.1.0 বা তার পরবর্তী ভার্সন ব্যবহার করতে হবে এবং Android রেন্ডারারের জন্য লেটেস্ট Maps SDK ব্যবহার করতে হবে।
একাধিক রঙের পলিলাইন তৈরি করা হচ্ছে
আপনি StyleSpan অবজেক্ট তৈরি করে এবং addSpan()
বা addSpans() পদ্ধতি ব্যবহার করে PolylineOptions-এ যোগ করার মাধ্যমে, পলিলাইনের আলাদা আলাদা কালার সেগমেন্টে স্প্যান ব্যবহার করতে পারবেন। ডিফল্ট হিসেবে, অ্যারের প্রতিটি আইটেম সংশ্লিষ্ট লাইন সেগমেন্টের
রঙ সেট করবে। নিচের উদাহরণে লাল ও সবুজ সেগমেন্ট সহ পলিলাইন তৈরি করার জন্য
সেগমেন্টের রঙ সেট করা দেখানো হয়েছে:
Kotlin
val line = map.addPolyline( PolylineOptions() .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693)) .addSpan(StyleSpan(Color.RED)) .addSpan(StyleSpan(Color.GREEN)), )
Java
Polyline line = map.addPolyline( new PolylineOptions() .add( new LatLng(47.6677146, -122.3470447), new LatLng(47.6442757, -122.2814693)) .addSpan(new StyleSpan(Color.RED)) .addSpan(new StyleSpan(Color.GREEN)));
গ্রেডিয়েন্ট পলিলাইন তৈরি করা
আপনি দুটি ৩২-বিট আলফা-লাল-সবুজ-নীল (ARGB) পূর্ণসংখ্যা উল্লেখ করে গ্রেডিয়েন্ট নির্ধারণ করতে পারেন, যা স্ট্রোকের শুরু এবং শেষের রঙ নির্দিষ্ট করে। PolylineOptions.addSpan() কল করে শেপের বিকল্প অবজেক্টে এই
প্রপার্টি সেট করুন।
নিম্নলিখিত উদাহরণে দেখানো হয়েছে কীভাবে আলিপুর চিড়িয়াখানা থেকে
সল্টলেক, কলকাতা পর্যন্ত লাল থেকে হলুদ গ্রেডিয়েন্ট পলিলাইন তৈরি করতে হয়।
Kotlin
val line = map.addPolyline( PolylineOptions() .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693)) .addSpan( StyleSpan( StrokeStyle.gradientBuilder( Color.RED, Color.YELLOW, ).build(), ), ), )
Java
Polyline line = map.addPolyline( new PolylineOptions() .add( new LatLng(47.6677146, -122.3470447), new LatLng(47.6442757, -122.2814693)) .addSpan( new StyleSpan( StrokeStyle.gradientBuilder(Color.RED, Color.YELLOW) .build())));
স্ট্যাম্প করা পলিলাইন তৈরি করা হচ্ছে
আপনি রিপিটিং বিটম্যাপ টেক্সচারে পলিলাইনের চেহারা সেট করতে পারবেন। এটি করতে,
TextureStyle-এর StampStyle তৈরি করুন, তারপর এখানে দেখানো অনুযায়ী PolylineOptions.addSpan() কল করে
আকৃতির বিকল্প অবজেক্টে এই প্রপার্টি সেট করুন:
Kotlin
val stampStyle = TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build() val span = StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build()) map.addPolyline( PolylineOptions() .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693)) .addSpan(span), )
Java
StampStyle stampStyle = TextureStyle.newBuilder( BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)) .build(); StyleSpan span = new StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build()); map.addPolyline( new PolylineOptions() .add( new LatLng(47.6677146, -122.3470447), new LatLng(47.6442757, -122.2814693)) .addSpan(span));
পলিলাইন ইভেন্ট
ডিফল্ট হিসেবে, পলিলাইনে ক্লিক করা যায় না। Polyline.setClickable(boolean) কল করে আপনি
ক্লিক করার সুবিধা চালু বা বন্ধ করতে পারবেন।
ক্লিক করা যায় এমন পলিলাইনে ক্লিক ইভেন্ট শুনতে
OnPolylineClickListener ব্যবহার করুন। ম্যাপে এই লিসেনার সেট করতে,
GoogleMap.setOnPolylineClickListener(OnPolylineClickListener) কল করুন।
ব্যবহারকারী কোনও পলিলাইনে ক্লিক করলে, আপনি একটি
onPolylineClick(Polyline) কলব্যাক পাবেন।
বহুভুজ
Polygon অবজেক্টগুলি Polyline অবজেক্টের মতো, কারণ এগুলি একটি নির্দিষ্ট ক্রমে সাজানো স্থানাঙ্কের সিরিজ নিয়ে গঠিত। তবে, ওপেন-এন্ডেড হওয়ার পরিবর্তে, পলিগন এমনভাবে ডিজাইন করা হয় যাতে
ভিতরের অংশ ভর্তি করে একটি ক্লোজড লুপের মধ্যে অঞ্চলকে সংজ্ঞায়িত করা যায়।
আপনি যেভাবে Polyline যোগ করেন, ঠিক সেইভাবেই ম্যাপে Polygon যোগ করতে পারবেন। প্রথমে একটি PolygonOptions অবজেক্ট তৈরি করুন
এবং এতে কিছু পয়েন্ট যোগ করুন। এই পয়েন্টগুলি বহুভুজের আউটলাইন তৈরি করবে।
তারপর আপনি GoogleMap.addPolygon(PolygonOptions) কল করে ম্যাপে পলিগন যোগ করেন, যা
একটি Polygon অবজেক্ট রিটার্ন করবে।
নিম্নলিখিত কোড স্নিপেট ম্যাপে একটি আয়তক্ষেত্র যোগ করে।
Kotlin
// Instantiates a new Polygon object and adds points to define a rectangle val rectOptions = PolygonOptions() .add( LatLng(37.35, -122.0), LatLng(37.45, -122.0), LatLng(37.45, -122.2), LatLng(37.35, -122.2), LatLng(37.35, -122.0), ) // Get back the mutable Polygon val polygon = map.addPolygon(rectOptions)
Java
// Instantiates a new Polygon object and adds points to define a rectangle PolygonOptions polygonOptions = new PolygonOptions() .add( new LatLng(37.35, -122.0), new LatLng(37.45, -122.0), new LatLng(37.45, -122.2), new LatLng(37.35, -122.2), new LatLng(37.35, -122.0)); // Get back the mutable Polygon Polygon polygon = map.addPolygon(polygonOptions);
পলিগন যোগ করার পরে তার আকার পরিবর্তন করতে, আপনি
Polygon.setPoints() কল করতে পারেন এবং পলিগনের আউটলাইনের জন্য
পয়েন্টের নতুন তালিকা প্রদান করতে পারেন।
ম্যাপে পলিগন যোগ করার আগে এবং পরে, উভয় ক্ষেত্রেই আপনি পলিগনের চেহারা কাস্টমাইজ করতে পারবেন। আরও বিবরণের জন্য নিচে অ্যাপেরিয়েন্স কাস্টমাইজ করা সংক্রান্ত বিভাগ দেখুন।
বহুভুজ অটো-কমপ্লিশন
উপরের উদাহরণে পলিগনে পাঁচটি কোঅর্ডিনেট আছে, তবে লক্ষ্য করুন যে প্রথম ও শেষ কোঅর্ডিনেট একই লোকেশন, যা লুপকে সংজ্ঞায়িত করে। তবে, বাস্তবে যেহেতু বহুভুজ বন্ধ এলাকাকে সংজ্ঞায়িত করে, তাই আপনাকে এই শেষ স্থানাঙ্ক সংজ্ঞায়িত করতে হবে না। শেষ স্থানাঙ্ক প্রথমটির থেকে আলাদা হলে, API স্থানাঙ্কের ক্রমের শেষে প্রথম স্থানাঙ্ক যোগ করে পলিগন অটোমেটিক "বন্ধ" করে দেবে।
নিচের দুটি পলিগন একই এবং এদের প্রত্যেকটির জন্য
polygon.getPoints() কল করলে ৪টি পয়েন্টই রিটার্ন করবে।
Kotlin
val polygon1 = map.addPolygon( PolygonOptions() .add( LatLng(0.0, 0.0), LatLng(0.0, 5.0), LatLng(3.0, 5.0), LatLng(0.0, 0.0), ) .strokeColor(Color.RED) .fillColor(Color.BLUE), ) val polygon2 = map.addPolygon( PolygonOptions() .add( LatLng(0.0, 0.0), LatLng(0.0, 5.0), LatLng(3.0, 5.0), ) .strokeColor(Color.RED) .fillColor(Color.BLUE), )
Java
Polygon polygon1 = map.addPolygon( new PolygonOptions() .add( new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0)) .strokeColor(Color.RED) .fillColor(Color.BLUE)); Polygon polygon2 = map.addPolygon( new PolygonOptions() .add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5)) .strokeColor(Color.RED) .fillColor(Color.BLUE));
ফাঁপা বহুভুজ তৈরি করুন
জটিল আকার তৈরি করতে একাধিক পাথকে একটি Polygon অবজেক্টে একত্রিত করা যেতে পারে,
যেমন ফিল করা রিং বা "ডোনাট" (যেখানে বহুভুজাকার
এলাকা বহুভুজের ভিতরে "দ্বীপ" হিসেবে দেখা যায়)। জটিল আকার সবসময় একাধিক, সহজ, পাথের কম্পোজিশন।
একই এলাকায় দুটি পাথ অবশ্যই সংজ্ঞায়িত করতে হবে। দুটি অঞ্চলের মধ্যে যেটি বড় সেটি
ফিল করার জায়গা নির্ধারণ করে এবং এটি কোনও অতিরিক্ত বিকল্প ছাড়াই একটি সাধারণ বহুভুজ।
তারপর, addHole() পদ্ধতিতে দ্বিতীয় পাথ পাস করুন। দ্বিতীয়, ছোট পাথটি বড় পাথটির দ্বারা সম্পূর্ণভাবে ঘেরা থাকলে, এটি এমনভাবে দেখানো হবে যেন পলিগনের একটি অংশ
সরিয়ে দেওয়া হয়েছে। যদি গর্তটি বহুভুজের রূপরেখাকে ছেদ করে,
তাহলে বহুভুজটি কোনও ফিল ছাড়াই রেন্ডার করা হবে।
নিচের স্নিপেটটি একটি ছোট আয়তাকার গর্ত সহ একটি একক আয়তক্ষেত্র তৈরি করবে।
Kotlin
val hole = listOf( LatLng(1.0, 1.0), LatLng(1.0, 2.0), LatLng(2.0, 2.0), LatLng(2.0, 1.0), LatLng(1.0, 1.0), ) val hollowPolygon = map.addPolygon( PolygonOptions() .add( LatLng(0.0, 0.0), LatLng(0.0, 5.0), LatLng(3.0, 5.0), LatLng(3.0, 0.0), LatLng(0.0, 0.0), ) .addHole(hole) .fillColor(Color.BLUE), )
Java
List<LatLng> hole = Arrays.asList( new LatLng(1, 1), new LatLng(1, 2), new LatLng(2, 2), new LatLng(2, 1), new LatLng(1, 1)); Polygon hollowPolygon = map.addPolygon( new PolygonOptions() .add( new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(3, 0), new LatLng(0, 0)) .addHole(hole) .fillColor(Color.BLUE));
নিচে দেখানো ছবির মতো ম্যাপে ফাঁপা পলিগন দেখা যায়:
Polygon ইভেন্ট
ডিফল্ট হিসেবে, বহুভুজে ক্লিক করা যায় না। Polygon.setClickable(boolean) কল করে আপনি
ক্লিক করার সুবিধা চালু বা বন্ধ করতে পারবেন।
ক্লিক করা যায় এমন পলিগনে ক্লিক ইভেন্ট শুনতে
OnPolygonClickListener ব্যবহার করুন। ম্যাপে এই লিসেনার সেট করতে,
GoogleMap.setOnPolygonClickListener(OnPolygonClickListener) কল করুন।
ব্যবহারকারী কোনও পলিগনে ক্লিক করলে, আপনি একটি
onPolygonClick(Polygon) কলব্যাক পাবেন।
সার্কেল
জেনেরিক Polygon ক্লাস ছাড়াও, Maps API-তে Circle অবজেক্টের জন্য নির্দিষ্ট ক্লাস অন্তর্ভুক্ত থাকে, যাতে তাদের কনস্ট্রাকশন সহজ করা যায়।
বৃত্ত আঁকার জন্য আপনাকে নিম্নলিখিত দুটি প্রপার্টি উল্লেখ করতে হবে:
center-এLatLngহিসেবে।radiusমিটার।
তারপর, পৃথিবীর পৃষ্ঠের সমস্ত বিন্দুর সেটকে বৃত্ত হিসেবে সংজ্ঞায়িত করা হয়
যা প্রদত্ত center থেকে radius মিটার দূরে। Maps API-এর ব্যবহার করা
মার্কেটর প্রজেকশন যেভাবে সমতল পৃষ্ঠে গোলক রেন্ডার করে,
তার কারণে নিরক্ষরেখার কাছাকাছি অবস্থিত হলে এটি ম্যাপে প্রায় নিখুঁত বৃত্ত হিসেবে
দেখা যাবে এবং বৃত্তটি নিরক্ষরেখা থেকে দূরে সরে যাওয়ার সাথে সাথে
ক্রমশ বৃত্তাকার নয় (স্ক্রিনে) এমনভাবে দেখা যাবে।
বৃত্ত যোগ করার পরে তার আকার পরিবর্তন করতে, আপনি
Circle.setRadius() বা Circle.setCenter() কল করে নতুন মান দিতে পারেন।
ম্যাপে যোগ করার আগে এবং পরে, উভয় ক্ষেত্রেই আপনি বৃত্তের চেহারা কাস্টমাইজ করতে পারবেন। আরও বিবরণের জন্য নিচে অ্যাপের চেহারা কাস্টমাইজ করা সংক্রান্ত বিভাগটি দেখুন।
নিম্নলিখিত কোড স্নিপেটটি একটি
CircleOptions অবজেক্ট তৈরি করে এবং
GoogleMap.addCircle(CircleOptions) কল করে ম্যাপে একটি বৃত্ত যোগ করে:
Kotlin
// Instantiates a new CircleOptions object and defines the center and radius val circleOptions = CircleOptions() .center(LatLng(37.4, -122.1)) .radius(1000.0) // In meters // Get back the mutable Circle val circle = map.addCircle(circleOptions)
Java
// Instantiates a new CircleOptions object and defines the center and radius CircleOptions circleOptions = new CircleOptions().center(new LatLng(37.4, -122.1)).radius(1000); // In meters // Get back the mutable Circle Circle circle = map.addCircle(circleOptions);
চেনাশোনা ইভেন্ট
ডিফল্ট হিসেবে, বৃত্তে ক্লিক করা যায় না। আপনি CircleOptions.clickable(boolean)-এর সাথে GoogleMap.addCircle() কল করে অথবা Circle.setClickable(boolean) কল করে ক্লিক করার সুবিধা চালু বা বন্ধ করতে পারবেন।
ক্লিক করা যায় এমন বৃত্তে ক্লিক ইভেন্ট শুনতে
OnCircleClickListener ব্যবহার করুন। ম্যাপে এই লিসেনার সেট করতে,
GoogleMap.setOnCircleClickListener(OnCircleClickListener) কল করুন।
ব্যবহারকারী কোনও বৃত্তে ক্লিক করলে, আপনি একটি
onCircleClick(Circle) কলব্যাক পাবেন, যেমনটি নিম্নলিখিত কোড স্যাম্পেলে দেখানো হয়েছে:
Kotlin
val circle = map.addCircle( CircleOptions() .center(LatLng(37.4, -122.1)) .radius(1000.0) .strokeWidth(10f) .strokeColor(Color.GREEN) .fillColor(Color.argb(128, 255, 0, 0)) .clickable(true), ) map.setOnCircleClickListener { // Flip the r, g and b components of the circle's stroke color. val strokeColor = it.strokeColor xor 0x00ffffff it.strokeColor = strokeColor }
Java
Circle circle = map.addCircle( new CircleOptions() .center(new LatLng(37.4, -122.1)) .radius(1000) .strokeWidth(10) .strokeColor(Color.GREEN) .fillColor(Color.argb(128, 255, 0, 0)) .clickable(true)); map.setOnCircleClickListener( new GoogleMap.OnCircleClickListener() { @Override public void onCircleClick(Circle circle) { // Flip the r, g and b components of the circle's stroke color. int strokeColor = circle.getStrokeColor() ^ 0x00ffffff; circle.setStrokeColor(strokeColor); } });
কেমন দেখতে লাগবে তা কাস্টমাইজ করা
আপনি কোনও শেপের চেহারা পরিবর্তন করতে পারেন ম্যাপে যোগ করার আগে (বিকল্প অবজেক্টে পছন্দসই প্রপার্টি নির্দিষ্ট করে) অথবা ম্যাপে যোগ করার পরে। এছাড়াও, সব প্রপার্টির জন্য গেটার এক্সপোজ করা হয় যাতে আপনি সহজেই শেপের বর্তমান অবস্থা অ্যাক্সেস করতে পারেন।
নিম্নলিখিত স্নিপেট মেলবোর্ন থেকে পার্থ পর্যন্ত জিওডেসিক সেগমেন্ট সহ একটি মোটা নীল পলিলাইন যোগ করে। নিচের বিভাগগুলি থেকে এইসব প্রপার্টি সম্পর্কে আরও বিস্তারিতভাবে জানতে পারবেন।
Kotlin
val polyline = map.addPolyline( PolylineOptions() .add(LatLng(-37.81319, 144.96298), LatLng(-31.95285, 115.85734)) .width(25f) .color(Color.BLUE) .geodesic(true), )
Java
Polyline polyline = map.addPolyline( new PolylineOptions() .add( new LatLng(-37.81319, 144.96298), new LatLng(-31.95285, 115.85734)) .width(25) .color(Color.BLUE) .geodesic(true));
ম্যাপটি নিচে দেখানো ছবির মতো দেখাবে:
মনে রাখবেন: এগুলির বেশিরভাগই বর্ণিত যেকোনও আকারের ক্ষেত্রে প্রযোজ্য হলেও, কিছু প্রপার্টি নির্দিষ্ট আকারের ক্ষেত্রে প্রযোজ্য নাও হতে পারে (যেমন, পলিলাইনের কোনও ভরাট করার রঙ থাকতে পারে না কারণ এটির কোনও অভ্যন্তরীণ অংশ নেই)।
স্ট্রোকের রঙ
স্ট্রোকের রঙ হল একটি ৩২-বিট আলফা-লাল-সবুজ-নীল (ARGB) পূর্ণসংখ্যা যা
আকৃতির স্ট্রোকের অস্বচ্ছতা এবং রঙ নির্দিষ্ট করে। *Options.strokeColor() (অথবা পলিলাইনের ক্ষেত্রে
PolylineOptions.color()) কল করে শেপের
বিকল্প অবজেক্টে এই প্রপার্টি সেট করুন। অনির্দিষ্ট থাকলে, ডিফল্ট স্ট্রোকের রঙ কালো (Color.BLACK) হয়।
ম্যাপে আকার যোগ করার পরে, getStrokeColor() (বা পলিলাইনের জন্য getColor()) কল করে স্ট্রোকের রঙ অ্যাক্সেস করা যেতে পারে এবং setStrokeColor() (setColor() for a polyline) কল করে পরিবর্তন করা যেতে পারে।
পূরণ রঙ
ভরাট করার রঙ শুধুমাত্র বহুভুজ ও বৃত্তের ক্ষেত্রে প্রযোজ্য। এটি পলিলাইনের ক্ষেত্রে প্রযোজ্য নয়, কারণ সেগুলির কোনও নির্দিষ্ট ইন্টেরিয়র নেই। কোনও বহুভুজের ক্ষেত্রে, এর গর্তের ভিতরের অঞ্চলগুলি বহুভুজের অভ্যন্তরের অংশ নয় এবং ফিল কালার সেট করা থাকলে রঙ করা হবে না।
ভরাট করার রঙ হল ৩২-বিট আলফা-লাল-সবুজ-নীল (ARGB) পূর্ণসংখ্যা যা
আকারের ভেতরের অংশের অস্বচ্ছতা ও রঙ নির্দিষ্ট করে। *Options.fillColor() কল করে শেপের বিকল্প অবজেক্টে
এই প্রপার্টি সেট করুন। অনির্দিষ্ট থাকলে, ডিফল্ট স্ট্রোকের রঙ স্বচ্ছ (Color.TRANSPARENT) হয়।
ম্যাপে আকার যোগ করার পরে, getFillColor() কল করে ভরাট করার রঙ অ্যাক্সেস করা যেতে পারে এবং setFillColor() কল করে পরিবর্তন করা যেতে পারে।
স্ট্রোকের প্রস্থ
লাইন স্ট্রোকের প্রস্থ, পিক্সেল (px)-এ ফ্লোট হিসেবে। ম্যাপ জুম করা হলে প্রস্থ স্কেল হয় না (অর্থাৎ, সব জুম লেভেলে কোনও আকারের
স্ট্রোকের প্রস্থ একই থাকবে)। *Options.strokeWidth() (বা পলিলাইনের জন্য PolylineOptions.width()) কল করে
শেপের বিকল্প অবজেক্টে এই প্রপার্টি সেট করুন। নির্দিষ্ট করা না থাকলে, ডিফল্ট স্ট্রোকের প্রস্থ ১০ পিক্সেল হয়।
ম্যাপে আকার যোগ করার পরে, getStrokeWidth() (বা পলিলাইনের জন্য getWidth()) কল করে স্ট্রোকের প্রস্থ অ্যাক্সেস করা যেতে পারে এবং setStrokeWidth() (setWidth() for a polyline) কল করে পরিবর্তন করা যেতে পারে।
স্ট্রোক প্যাটার্ন
ডিফল্ট স্ট্রোক প্যাটার্ন হল পলিলাইন এবং পলিগন ও বৃত্তের আউটলাইনের জন্য
একটি সলিড লাইন। আপনি
PatternItem অবজেক্টের কাস্টম স্ট্রোক প্যাটার্ন নির্দিষ্ট করতে পারেন, যেখানে প্রতিটি আইটেম হল একটি ড্যাশ, একটি ডট বা একটি
গ্যাপ।
নিম্নলিখিত নমুনাটি একটি পলিলাইনের প্যাটার্নকে একটি বিন্দুর পুনরাবৃত্ত ক্রম হিসাবে সেট করে, তারপরে ২০ পিক্সেল দৈর্ঘ্যের একটি ফাঁক, ৩০ পিক্সেল দৈর্ঘ্যের একটি ড্যাশ এবং আরেকটি ২০-পিক্সেল ফাঁক থাকে।
Kotlin
val pattern = listOf( Dot(), Gap(20F), Dash(30F), Gap(20F), ) polyline?.pattern = pattern
Java
List<PatternItem> pattern = Arrays.asList(new Dot(), new Gap(20), new Dash(30), new Gap(20)); polyline.setPattern(pattern);
প্যাটার্নটি লাইন বরাবর পুনরাবৃত্তি হয়, যা আকারের জন্য নির্দিষ্ট করা প্রথম ভার্টেক্সে প্রথম প্যাটার্ন আইটেম দিয়ে শুরু হয়।
জয়েন্টের ধরন
পলিলাইন এবং পলিগনের আউটলাইনের জন্য, আপনি ডিফল্ট ফিক্সড মাইটার জয়েন্ট টাইপ পরিবর্তন করতে
JointType বেভেল বা রাউন্ড নির্দিষ্ট করতে পারেন।
নিম্নলিখিত স্যাম্পেলটি একটি পলিলাইনে রাউন্ড জয়েন্ট টাইপ প্রয়োগ করে:
Kotlin
polyline?.jointType = JointType.ROUND
Java
polyline.setJointType(JointType.ROUND);
জয়েন্টের ধরন লাইনের ইন্টার্নাল বাঁককে প্রভাবিত করে। লাইনের স্ট্রোক প্যাটার্নে ড্যাশ থাকলে, ড্যাশ জয়েন্টের উপর দিয়ে গেলে জয়েন্টের ধরনও প্রযোজ্য হয়। জয়েন্টের ধরন ডটকে প্রভাবিত করে না, কারণ সেগুলি সবসময় বৃত্তাকার হয়।
লাইন ক্যাপস
আপনি পলিলাইনের প্রতিটি প্রান্তের জন্য একটি Cap স্টাইল নির্দিষ্ট করতে পারেন। বিকল্পগুলি
হল বাট (ডিফল্ট), বর্গাকার, বৃত্তাকার বা কাস্টম বিটম্যাপ।
PolylineOptions.startCap এবং
PolylineOptions.endCap-এ স্টাইল সেট করুন অথবা
উপযুক্ত গেটার ও সেটার পদ্ধতি ব্যবহার করুন।
নিচের স্নিপেটটি একটি পলিলাইনের শুরুতে একটি রাউন্ড ক্যাপ নির্দিষ্ট করে।
Kotlin
polyline?.startCap = RoundCap()
Java
polyline.setStartCap(new RoundCap());
নিচের স্নিপেট এন্ড ক্যাপের জন্য কাস্টম বিটম্যাপ নির্দিষ্ট করে:
Kotlin
polyline?.endCap = CustomCap(BitmapDescriptorFactory.fromResource(R.drawable.arrow), 16F)
Java
polyline.setEndCap( new CustomCap(BitmapDescriptorFactory.fromResource(R.drawable.arrow), 16));
আপনি কাস্টম বিটম্যাপ ব্যবহার করলে, আপনাকে পিক্সেলে রেফারেন্স স্ট্রোকের প্রস্থ উল্লেখ করতে হবে। API সেই অনুযায়ী বিটম্যাপ স্কেল করে। রেফারেন্স স্ট্রোকের প্রস্থ হল সেই স্ট্রোকের প্রস্থ যা আপনি ক্যাপের জন্য বিটম্যাপ ইমেজ ডিজাইন করার সময় ব্যবহার করেছিলেন, ইমেজের আসল ডাইমেনশনে। ডিফল্ট রেফারেন্স স্ট্রোকের প্রস্থ হল ১০ পিক্সেল। ইঙ্গিত: রেফারেন্স স্ট্রোকের প্রস্থ নির্ধারণ করতে, আপনার বিটম্যাপ ইমেজটি ইমেজ এডিটরে ১০০% জুম করে খুলুন এবং ইমেজের সাপেক্ষে লাইন স্ট্রোকের কাঙ্ক্ষিত প্রস্থ প্লট করুন।
বিটম্যাপ তৈরি করতে
BitmapDescriptorFactory.fromResource()
ব্যবহার করলে, ডেনসিটি-ইন্ডিপেন্ডেন্ট রিসোর্স (nodpi) ব্যবহার করছেন কিনা তা ভাল করে দেখে নিন।
জিওডেসিক সেগমেন্ট
জিওডেসিক সেটিং শুধুমাত্র পলিলাইন ও পলিগনের ক্ষেত্রে প্রযোজ্য। এটি সার্কেলের ক্ষেত্রে প্রযোজ্য নয় কারণ সার্কেলকে সেগমেন্টের সংগ্রহ হিসেবে সংজ্ঞায়িত করা হয় না।
জিওডেসিক সেটিং নির্ধারণ করে যে পলিলাইন/বহুভুজের পরপর ভার্টেক্সের মধ্যে লাইন সেগমেন্ট কীভাবে আঁকা হয়। জিওডেসিক সেগমেন্ট হল সেগুলি যা পৃথিবীর পৃষ্ঠ (একটি গোলক) বরাবর সবচেয়ে ছোট পথ অনুসরণ করে এবং প্রায়শই মার্কেটর প্রজেকশন সহ একটি ম্যাপে বাঁকা রেখা হিসাবে প্রদর্শিত হয়। নন-জিওডেসিক সেগমেন্টগুলি ম্যাপে সরলরেখা হিসেবে আঁকা হয়।
*Options.geodesic() কল করে শেপের বিকল্প অবজেক্টে এই প্রপার্টি সেট করুন, যেখানে true নির্দেশ করে যে সেগমেন্টগুলি জিওডেসিক হিসাবে আঁকা উচিত এবং false নির্দেশ করে যে সেগমেন্টগুলি সরল রেখা হিসাবে আঁকা উচিত।
উল্লেখ করা না থাকলে, ডিফল্ট হল নন-জিওডেসিক সেগমেন্ট (false)।
ম্যাপে আকার যোগ করার পরে, isGeodesic() কল করে জিওডেসিক সেটিং অ্যাক্সেস করা যেতে পারে
এবং setGeodesic() কল করে পরিবর্তন করা যেতে পারে।
Z-ইনডেক্স
z-ইনডেক্স ম্যাপে অন্যান্য ওভারলে (অন্যান্য আকার, গ্রাউন্ড ওভারলে এবং টাইল ওভারলে)-এর সাপেক্ষে এই আকারের স্ট্যাক অর্ডার নির্দিষ্ট করে। কম z-ইনডেক্স সহ ওভারলের উপরে বেশি z-ইনডেক্স সহ ওভারলে আঁকা হয়। একই z-ইনডেক্স সহ দুটি ওভারলে একটি ইচ্ছামত ক্রমে আঁকা হয়।
মনে রাখবেন, মার্কার সবসময় অন্যান্য ওভারলের উপরে আঁকা হয়, অন্যান্য ওভারলের z-ইনডেক্স যাই হোক না কেন।
*Options.zIndex() কল করে শেপের বিকল্প অবজেক্টে এই প্রপার্টি সেট করুন।
নির্দিষ্ট করা না থাকলে, ডিফল্ট z-ইনডেক্স হল 0। ম্যাপে আকার যোগ করার পরে,
getZIndex() কল করে z-ইনডেক্স অ্যাক্সেস করা যেতে পারে
এবং setZIndex() কল করে পরিবর্তন করা যেতে পারে।
দৃশ্যমানতা
দৃশ্যমানতা নির্দিষ্ট করে যে ম্যাপে আকার আঁকা উচিত কিনা, যেখানে
true নির্দেশ করে যে এটি আঁকা উচিত এবং false নির্দেশ করে যে এটি আঁকা উচিত নয়। এটি
আপনাকে ম্যাপে সাময়িকভাবে কোনও আকার না দেখানোর অনুমতি দেয়। ম্যাপ থেকে স্থায়ীভাবে
শেপ সরাতে, সেই শেপে remove() কল করুন।
*Options.visible() কল করে শেপের বিকল্প অবজেক্টে এই প্রপার্টি সেট করুন। উল্লেখ করা না থাকলে, ডিফল্ট দৃশ্যমানতা হল true।
ম্যাপে আকার যোগ করার পরে, isVisible() কল করে দৃশ্যমানতা অ্যাক্সেস করা যেতে পারে এবং setVisible() কল করে পরিবর্তন করা যেতে পারে।
শেপের সাথে ডেটা যুক্ত করুন
আপনি শেপের setTag() পদ্ধতি ব্যবহার করে পলিলাইন, পলিগন বা বৃত্তের সাথে একটি ইচ্ছামতো ডেটা অবজেক্ট স্টোর করতে পারেন
এবং getTag() ব্যবহার করে অবজেক্টটি ফিরিয়ে আনতে পারেন।
যেমন, পলিলাইন সহ ডেটা অবজেক্ট স্টোর করতে Polyline.setTag() কল করুন এবং ডেটা অবজেক্ট ফিরিয়ে আনতে Polyline.getTag() কল করুন।
নিচের কোডটি নির্দিষ্ট পলিলাইনের জন্য একটি ইচ্ছামতো ট্যাগ (A) নির্ধারণ করে:
Kotlin
val polyline = map.addPolyline( PolylineOptions() .clickable(true) .add( LatLng(-35.016, 143.321), LatLng(-34.747, 145.592), LatLng(-34.364, 147.891), LatLng(-33.501, 150.217), LatLng(-32.306, 149.248), LatLng(-32.491, 147.309), ), ) polyline?.tag = "A"
Java
Polyline polyline = map.addPolyline( (new PolylineOptions()) .clickable(true) .add( new LatLng(-35.016, 143.321), new LatLng(-34.747, 145.592), new LatLng(-34.364, 147.891), new LatLng(-33.501, 150.217), new LatLng(-32.306, 149.248), new LatLng(-32.491, 147.309))); polyline.setTag("A");
শেপ সহ ডেটা স্টোর ও রিট্রিভ করার সুবিধা কোন কোন পরিস্থিতিতে পাওয়া যায়, তার কিছু উদাহরণ এখানে দেওয়া হল:
- আপনার অ্যাপে বিভিন্ন ধরনের শেপ থাকতে পারে এবং ব্যবহারকারী সেগুলিতে ক্লিক করলে আপনি সেগুলিকে আলাদাভাবে ট্রিট করতে চান।
- আপনি এমন একটি সিস্টেমের সাথে ইন্টারফেস করতে পারেন যার অনন্য রেকর্ড শনাক্তকারী রয়েছে, যেখানে আকারগুলি সেই সিস্টেমের নির্দিষ্ট রেকর্ডগুলিকে উপস্থাপন করে।
- শেপ ডেটা, শেপের z-ইনডেক্স নির্ধারণ করার জন্য অগ্রাধিকার নির্দেশ করতে পারে।