ক্যামেরা আপডেট ফ্যাক্টরি

পাবলিক ফাইনাল ক্লাস CameraUpdateFactory অবজেক্ট প্রসারিত করে

CameraUpdate অবজেক্ট তৈরি করার পদ্ধতি সম্বলিত একটি ক্লাস যা একটি মানচিত্রের ক্যামেরা পরিবর্তন করে। মানচিত্রের ক্যামেরা পরিবর্তন করতে, এই ক্লাসের সাথে তৈরি করা একটি CameraUpdate অবজেক্ট ব্যবহার করে animateCamera(CameraUpdate) , animateCamera(CameraUpdate, GoogleMap.CancelableCallback) অথবা moveCamera(CameraUpdate) এ কল করুন।

উদাহরণস্বরূপ, একটি মানচিত্রে জুম করার জন্য, আপনি নিম্নলিখিত কোডটি ব্যবহার করতে পারেন: 

GoogleMap map = ...;
 map.animateCamera(CameraUpdateFactory.zoomIn());

এই ক্লাস থেকে যেকোন পদ্ধতি ব্যবহার করার আগে, এই ক্লাসটি আরম্ভ করা হয়েছে তা নিশ্চিত করতে আপনাকে অবশ্যই নিম্নলিখিতগুলির মধ্যে একটি করতে হবে:

  • আপনি আপনার অ্যাপ্লিকেশনে যোগ করেছেন এমন একটি MapFragment বা MapView থেকে GoogleMap উপলব্ধ হওয়ার জন্য অপেক্ষা করুন৷ আপনি getMapAsync() কল করে এবং onMapReady(GoogleMap map) কলব্যাকের জন্য অপেক্ষা করে GoogleMap উদাহরণ পেতে পারেন।
  • কল initialize(Context) । যতক্ষণ পর্যন্ত একটি GooglePlayServicesNotAvailableException নিক্ষেপ না করা হয়, এই ক্লাসটি সঠিকভাবে শুরু করা হবে।

বিকাশকারী গাইড

আরও তথ্যের জন্য, ক্যামেরা এবং দেখুন বিকাশকারী নির্দেশিকা পড়ুন।

পাবলিক পদ্ধতির সারাংশ

স্ট্যাটিক ক্যামেরা আপডেট
newCameraPosition ( ক্যামেরা পজিশন ক্যামেরা পজিশন)
একটি CameraUpdate ফেরত দেয় যা ক্যামেরাটিকে একটি নির্দিষ্ট CameraPosition নিয়ে যায়।
স্ট্যাটিক ক্যামেরা আপডেট
newLatLng ( LatLng latLng)
একটি CameraUpdate ফেরত দেয় যা একটি LatLng অবজেক্ট দ্বারা নির্দিষ্ট করা একটি অক্ষাংশ এবং দ্রাঘিমাংশে স্ক্রিনের কেন্দ্রকে নিয়ে যায়।
স্ট্যাটিক ক্যামেরা আপডেট
newLatLngBounds ( LatLngBounds সীমানা, int প্রস্থ, int উচ্চতা, int প্যাডিং)
একটি CameraUpdate প্রদান করে যা ক্যামেরাকে এমনভাবে রূপান্তরিত করে যাতে নির্দিষ্ট অক্ষাংশ/দ্রাঘিমাংশের সীমানাগুলি স্ক্রিনে কেন্দ্রীভূত হয় নির্দিষ্ট মাত্রার একটি বাউন্ডিং বাক্সের মধ্যে সর্বাধিক সম্ভাব্য জুম স্তরে৷
স্ট্যাটিক ক্যামেরা আপডেট
newLatLngBounds ( LatLngBounds বাউন্ড, int প্যাডিং)
একটি CameraUpdate ফেরত দেয় যা ক্যামেরাকে এমনভাবে রূপান্তরিত করে যাতে নির্দিষ্ট অক্ষাংশ/দ্রাঘিমাংশের সীমা সর্বাধিক সম্ভাব্য জুম স্তরে স্ক্রিনে কেন্দ্রীভূত হয়।
স্ট্যাটিক ক্যামেরা আপডেট
newLatLngZoom ( LatLng latLng, ফ্লোট জুম)
একটি CameraUpdate ফেরত দেয় যা একটি LatLng বস্তুর দ্বারা নির্দিষ্ট করা একটি অক্ষাংশ এবং দ্রাঘিমাংশে স্ক্রিনের কেন্দ্রে নিয়ে যায় এবং প্রদত্ত জুম স্তরে চলে যায়৷
স্ট্যাটিক ক্যামেরা আপডেট
scrollBy (float xPixel, float yPixel)
একটি CameraUpdate প্রদান করে যা ক্যামেরাটিকে মানচিত্রের উপর স্ক্রোল করে, x এবং y দিকনির্দেশে নির্দিষ্ট সংখ্যক পিক্সেল দ্বারা দৃশ্যের কেন্দ্র স্থানান্তর করে।
স্ট্যাটিক ক্যামেরা আপডেট
জুমবাই (ফ্লোট পরিমাণ, পয়েন্ট ফোকাস)
একটি CameraUpdate প্রদান করে যা বর্তমান ক্যামেরার ভিউপয়েন্টের জুম লেভেল পরিবর্তন করে।
স্ট্যাটিক ক্যামেরা আপডেট
জুমবাই (ফ্লোট পরিমাণ)
একটি CameraUpdate প্রদান করে যা বর্তমান ক্যামেরার ভিউপয়েন্টের জুম লেভেল পরিবর্তন করে।
স্ট্যাটিক ক্যামেরা আপডেট
প্রসারিত করো ()
একটি CameraUpdate ফেরত দেয় যা ভিউপয়েন্টের উচ্চতাকে পৃথিবীর পৃষ্ঠের কাছাকাছি নিয়ে গিয়ে মানচিত্রে জুম করে।
স্ট্যাটিক ক্যামেরা আপডেট
ছোট করা ()
একটি CameraUpdate ফেরত দেয় যা পৃথিবীর পৃষ্ঠ থেকে ভিউপয়েন্টের উচ্চতাকে আরও দূরে সরিয়ে মানচিত্রে জুম আউট করে।
স্ট্যাটিক ক্যামেরা আপডেট
জুমটু (ফ্লোট জুম)
একটি CameraUpdate ফেরত দেয় যা ক্যামেরা ভিউপয়েন্টকে একটি নির্দিষ্ট জুম স্তরে নিয়ে যায়।

উত্তরাধিকারসূত্রে প্রাপ্ত পদ্ধতির সারাংশ

পাবলিক পদ্ধতি

পাবলিক স্ট্যাটিক ক্যামেরা আপডেট newCameraPosition ( CameraPosition cameraPosition)

একটি CameraUpdate ফেরত দেয় যা ক্যামেরাটিকে একটি নির্দিষ্ট CameraPosition নিয়ে যায়। কার্যত, এটি CameraPosition অবজেক্টের অক্ষাংশ, দ্রাঘিমাংশ, জুম স্তর, বিয়ারিং এবং টিল্ট থেকে একটি রূপান্তর তৈরি করে।

পরামিতি
ক্যামেরা অবস্থান
রিটার্নস
  • রূপান্তর ধারণকারী একটি CameraUpdate .

পাবলিক স্ট্যাটিক ক্যামেরা আপডেট newLatLng ( LatLng latLng)

একটি CameraUpdate ফেরত দেয় যা একটি LatLng অবজেক্ট দ্বারা নির্দিষ্ট করা একটি অক্ষাংশ এবং দ্রাঘিমাংশে স্ক্রিনের কেন্দ্রকে নিয়ে যায়। এটি LatLng বস্তুর উপর ক্যামেরা কেন্দ্রীভূত করে।

পরামিতি
latLng পছন্দসই অক্ষাংশ এবং দ্রাঘিমাংশ ধারণকারী একটি LatLng বস্তু।
রিটার্নস
  • রূপান্তর ধারণকারী একটি CameraUpdate .

পাবলিক স্ট্যাটিক ক্যামেরা আপডেট নতুন ল্যাটএলএনজিবাউন্ডস ( ল্যাটএলএনজি বাউন্ডস, int প্রস্থ, int উচ্চতা, int প্যাডিং)

একটি CameraUpdate প্রদান করে যা ক্যামেরাকে এমনভাবে রূপান্তরিত করে যাতে নির্দিষ্ট অক্ষাংশ/দ্রাঘিমাংশের সীমানাগুলি স্ক্রিনে কেন্দ্রীভূত হয় নির্দিষ্ট মাত্রার একটি বাউন্ডিং বাক্সের মধ্যে সর্বাধিক সম্ভাব্য জুম স্তরে৷ বাউন্ডিং বাক্সের আকার আরও সীমাবদ্ধ করতে আপনি অতিরিক্ত প্যাডিং নির্দিষ্ট করতে পারেন। ফিরে আসা CameraUpdate ভারবহন 0 এবং টিল্ট 0 রয়েছে৷

newLatLngBounds(LatLngBounds, int) এর বিপরীতে, আপনি মানচিত্রের বিন্যাস পর্বের পূর্বে ক্যামেরা পরিবর্তন করতে এই পদ্ধতি দ্বারা ফিরে আসা CameraUpdate ব্যবহার করতে পারেন, কারণ আর্গুমেন্টগুলি বাউন্ডিং বাক্সের পছন্দসই আকার নির্দিষ্ট করে৷

পরামিতি
সীমানা বাউন্ডিং বাক্সে ফিট করা অঞ্চল
প্রস্থ বাউন্ডিং বক্সের প্রস্থ পিক্সেলে (px)
উচ্চতা বাউন্ডিং বাক্সের উচ্চতা পিক্সেলে (px)
প্যাডিং বাউন্ডিং বাক্সের অতিরিক্ত আকারের সীমাবদ্ধতা (px-এ)
রিটার্নস
  • রূপান্তর ধারণকারী একটি CameraUpdate .

পাবলিক স্ট্যাটিক ক্যামেরা আপডেট নতুন ল্যাটএলএনজিবাউন্ডস ( ল্যাটএলএনজিবাউন্ডস , int প্যাডিং)

একটি CameraUpdate ফেরত দেয় যা ক্যামেরাকে এমনভাবে রূপান্তরিত করে যাতে নির্দিষ্ট অক্ষাংশ/দ্রাঘিমাংশের সীমা সর্বাধিক সম্ভাব্য জুম স্তরে স্ক্রিনে কেন্দ্রীভূত হয়। ম্যাপ ভিউ এর প্রান্ত থেকে বাউন্ডিং বক্স ইনসেট করার জন্য আপনি প্যাডিং নির্দিষ্ট করতে পারেন। ফিরে আসা CameraUpdate ভারবহন 0 এবং টিল্ট 0 রয়েছে৷

এই ক্যামেরা আপডেটের সাথে ক্যামেরা পরিবর্তন করবেন না যতক্ষণ না মানচিত্রটি লেআউটের মধ্য দিয়ে যায় (এই পদ্ধতির জন্য উপযুক্ত বাউন্ডিং বক্স এবং জুম স্তর সঠিকভাবে নির্ধারণ করার জন্য, মানচিত্রের একটি আকার থাকতে হবে)। অন্যথায় একটি IllegalStateException নিক্ষেপ করা হবে। মানচিত্র উপলব্ধ হওয়ার জন্য এটি যথেষ্ট নয়; মানচিত্র সম্বলিত দৃশ্যটি অবশ্যই লেআউটের মধ্য দিয়ে গেছে যাতে এর মাত্রা নির্ধারণ করা হয়েছে। যদি আপনি নিশ্চিত হতে না পারেন যে এটি ঘটেছে, তাহলে এর পরিবর্তে newLatLngBounds(LatLngBounds, int, int, int) ব্যবহার করুন এবং ম্যাপটির মাত্রা ম্যানুয়ালি প্রদান করুন।

পরামিতি
সীমানা পর্দায় মাপসই অঞ্চল
প্যাডিং বাউন্ডিং বক্সের প্রান্ত এবং ভিউ প্রান্তগুলির মধ্যে স্থান (px-এ) ছেড়ে দিন৷ এই মানটি বাউন্ডিং বাক্সের চারটি দিকে প্রয়োগ করা হয়।
রিটার্নস
  • রূপান্তর ধারণকারী একটি CameraUpdate .

পাবলিক স্ট্যাটিক ক্যামেরা আপডেট নতুনLatLngZoom ( LatLng latLng, ফ্লোট জুম)

একটি CameraUpdate ফেরত দেয় যা একটি LatLng বস্তুর দ্বারা নির্দিষ্ট করা একটি অক্ষাংশ এবং দ্রাঘিমাংশে স্ক্রিনের কেন্দ্রে নিয়ে যায় এবং প্রদত্ত জুম স্তরে চলে যায়৷

পরামিতি
latLng পছন্দসই অক্ষাংশ এবং দ্রাঘিমাংশ ধারণকারী একটি LatLng বস্তু।
জুম পছন্দসই জুম স্তর, 2.0 থেকে 21.0 এর মধ্যে। এই পরিসরের নীচের মানগুলি 2.0-এ সেট করা হয়েছে এবং এর উপরে মানগুলি 21.0-এ সেট করা হয়েছে৷ জুম ইন করতে মান বাড়ান৷ সব এলাকায় সবচেয়ে বড় জুম স্তরে টাইলস নেই৷
রিটার্নস
  • রূপান্তর ধারণকারী একটি CameraUpdate .

পাবলিক স্ট্যাটিক ক্যামেরাআপডেট স্ক্রলবাই (ফ্লোট এক্সপিক্সেল, ফ্লোট ওয়াইপিক্সেল)

একটি CameraUpdate প্রদান করে যা ক্যামেরাটিকে মানচিত্রের উপর স্ক্রোল করে, x এবং y দিকনির্দেশে নির্দিষ্ট সংখ্যক পিক্সেল দ্বারা দৃশ্যের কেন্দ্র স্থানান্তর করে।

উদাহরণ:

  • xPixel = 5 এবং yPixel = 0 হলে, সিস্টেমটি ক্যামেরাটি সরিয়ে ডানদিকে স্ক্রোল করে যাতে মানচিত্রটি 5 পিক্সেল বামে স্থানান্তরিত হয়েছে বলে মনে হয়।
  • xPixel = 0 এবং yPixel = 5 হলে, সিস্টেমটি ক্যামেরাটি সরিয়ে নিচে স্ক্রোল করে যাতে মানচিত্রটি 5 পিক্সেল উপরের দিকে সরে গেছে বলে মনে হয়।

স্ক্রলিং ক্যামেরার বর্তমান অভিযোজনের সাথে আপেক্ষিক। উদাহরণস্বরূপ, যদি ক্যামেরা 90 ডিগ্রী বহন করে, তাহলে পূর্বদিকে "উপরে" এবং ডানদিকে স্ক্রোল করলে ক্যামেরা দক্ষিণে চলে যাবে।

পরামিতি
xPixel অনুভূমিকভাবে স্ক্রোল করার জন্য পিক্সেলের সংখ্যা। একটি ইতিবাচক মান ক্যামেরাটিকে তার বর্তমান স্থিতিবিন্যাস অনুসারে ডানদিকে নিয়ে যায়। একটি নেতিবাচক মান ক্যামেরাটিকে তার বর্তমান অভিযোজনের সাপেক্ষে বাম দিকে নিয়ে যায়।
yPixel উল্লম্বভাবে স্ক্রোল করার জন্য পিক্সেলের সংখ্যা। একটি ইতিবাচক মান ক্যামেরাটিকে তার বর্তমান অভিযোজনের সাপেক্ষে নিচের দিকে নিয়ে যায়। একটি নেতিবাচক মান ক্যামেরাটিকে উপরের দিকে নিয়ে যায়, তার বর্তমান অভিযোজনের ক্ষেত্রে।
রিটার্নস
  • রূপান্তর ধারণকারী একটি CameraUpdate .

পাবলিক স্ট্যাটিক ক্যামেরা আপডেট জুমবাই (ফ্লোট পরিমাণ, পয়েন্ট ফোকাস)

একটি CameraUpdate প্রদান করে যা বর্তমান ক্যামেরার ভিউপয়েন্টের জুম লেভেল পরিবর্তন করে।

ফোকাস দ্বারা নির্দিষ্ট করা একটি বিন্দু স্থির থাকবে (অর্থাৎ, এটি জুম প্রক্রিয়ার আগে এবং পরে একই ল্যাট/লং এর সাথে মিলে যায়)।

এই পদ্ধতিটি zoomTo(float) থেকে আলাদা যে জুম বর্তমান ক্যামেরার সাথে আপেক্ষিক।

উদাহরণস্বরূপ, যদি LatLng (11.11, 22.22) বর্তমানে স্ক্রিনের অবস্থানে থাকে (23, 45)। একটি জুম পরিমাণ এবং এই LatLng সহ এই পদ্ধতিতে কল করার পরে, এই LatLng এর স্ক্রীন অবস্থানটি এখনও (23, 45) থাকবে।

পরামিতি
পরিমাণ জুম স্তর পরিবর্তন করার পরিমাণ। ইতিবাচক মানগুলি পৃথিবীর পৃষ্ঠের কাছাকাছি জুমিং নির্দেশ করে যখন নেতিবাচক মানগুলি পৃথিবীর পৃষ্ঠ থেকে দূরে জুমিং নির্দেশ করে।
ফোকাস পর্দায় পিক্সেল অবস্থান যা জুম প্রক্রিয়ার পরে স্থির থাকতে হবে। ক্যামেরা সরানোর আগে সেই পিক্সেল অবস্থানে যে ল্যাট/লং ছিল ক্যামেরা সরানোর পরেও একই থাকবে।
রিটার্নস
  • রূপান্তর ধারণকারী একটি CameraUpdate .

পাবলিক স্ট্যাটিক ক্যামেরা আপডেট জুমবাই (ফ্লোট পরিমাণ)

একটি CameraUpdate প্রদান করে যা বর্তমান ক্যামেরার ভিউপয়েন্টের জুম লেভেল পরিবর্তন করে।

এই পদ্ধতিটি zoomTo(float) থেকে আলাদা যে জুম বর্তমান ক্যামেরার সাথে আপেক্ষিক।

পরামিতি
পরিমাণ জুম স্তর পরিবর্তন করার পরিমাণ। ইতিবাচক মানগুলি পৃথিবীর পৃষ্ঠের কাছাকাছি জুমিং নির্দেশ করে যখন নেতিবাচক মানগুলি পৃথিবীর পৃষ্ঠ থেকে দূরে জুমিং নির্দেশ করে।
রিটার্নস
  • রূপান্তর ধারণকারী একটি CameraUpdate .

পাবলিক স্ট্যাটিক ক্যামেরা আপডেট জুমইন ()

একটি CameraUpdate ফেরত দেয় যা ভিউপয়েন্টের উচ্চতাকে পৃথিবীর পৃষ্ঠের কাছাকাছি নিয়ে গিয়ে মানচিত্রে জুম করে। জুম বৃদ্ধি 1.0।

রিটার্নস
  • রূপান্তর ধারণকারী একটি CameraUpdate .

পাবলিক স্ট্যাটিক ক্যামেরা আপডেট জুমআউট ()

একটি CameraUpdate ফেরত দেয় যা পৃথিবীর পৃষ্ঠ থেকে ভিউপয়েন্টের উচ্চতাকে আরও দূরে সরিয়ে মানচিত্রে জুম আউট করে। জুম বৃদ্ধি -1.0.

রিটার্নস
  • রূপান্তর ধারণকারী একটি CameraUpdate .

পাবলিক স্ট্যাটিক ক্যামেরা আপডেট জুমটু (ফ্লোট জুম)

একটি CameraUpdate ফেরত দেয় যা ক্যামেরা ভিউপয়েন্টকে একটি নির্দিষ্ট জুম স্তরে নিয়ে যায়।

পরামিতি
জুম পছন্দসই জুম স্তর, 2.0 থেকে 21.0 এর মধ্যে। এই পরিসরের নীচের মানগুলি 2.0-এ সেট করা হয়েছে এবং এর উপরে মানগুলি 21.0-এ সেট করা হয়েছে৷ জুম ইন করতে মান বাড়ান৷ সব এলাকায় সবচেয়ে বড় জুম স্তরে টাইলস নেই৷