মানচিত্র গ্রাউন্ডিং উইজেট

এই পণ্য বা বৈশিষ্ট্যটি পরীক্ষামূলক (প্রি-GA)। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।

প্রাসঙ্গিক উইজেট হল একটি Google Maps প্রাক-GA অফার যা একটি ভিজ্যুয়াল ধারক যা অন্যান্য Google মানচিত্র সামগ্রীকে সমর্থন বা পরিপূরক করতে ব্যবহৃত হয়। Google মানচিত্র প্রাসঙ্গিক উইজেট আপনাকে একটি কথোপকথনমূলক LLM-চালিত চ্যাট অভিজ্ঞতা তৈরি করতে আপনার অ্যাপ্লিকেশনগুলিতে Google মানচিত্রের সাথে গ্রাউন্ডিং সংহত করতে দেয়৷ প্রাসঙ্গিক উইজেটটি প্রসঙ্গ টোকেন, googleMapsWidgetContextToken ব্যবহার করে রেন্ডার করা হয়, যা Vertex AI API প্রতিক্রিয়াতে ফেরত দেওয়া হয় এবং ভিজ্যুয়াল সামগ্রী রেন্ডার করতে ব্যবহার করা যেতে পারে।

প্রাসঙ্গিক উইজেট আপনার দৃশ্যের উপর নির্ভর করে বিভিন্ন ফাংশন পরিবেশন করে:

• এটি এমন পরিস্থিতিতে সাবজেক্টিভ ইউজার-জেনারেটেড কন্টেন্ট (UGC) প্রদর্শন করে যেখানে উত্তর তৈরির জন্য Google Maps প্রম্পটিং ব্যবহার করা হয়।
• যখন Vertex AI শুধুমাত্র একটি টেক্সট রেসপন্স জেনারেট করে তখন এটি ম্যাপ ভিজ্যুয়ালাইজেশন এবং ডেটা দিয়ে ফলাফল সমৃদ্ধ করতে সাহায্য করে।

প্রাসঙ্গিক উইজেট কিভাবে কাজ করে

প্রাসঙ্গিক উইজেট একটি googleMapsWidgetContextToken আকারে Vertex AI-তে Google Maps-এর সাথে গ্রাউন্ডিং থেকে একটি প্রতিক্রিয়া প্রদর্শন করে। প্রাসঙ্গিক উইজেট রেন্ডার করতে এবং প্রতিক্রিয়া প্রদর্শন করতে এই টোকেনটি ব্যবহার করুন। আরও জানুন ঘটনার প্রবাহ নিম্নরূপ:

1. Google Maps-এর সাথে ভিত্তি করে একটি প্রশ্ন সহ Vertex AI API-কে কল করুন।
2. Vertex AI একটি googleMapsWidgetContextToken প্রদান করে।
3. টোকেন ব্যবহার করে প্রাসঙ্গিক উইজেট রেন্ডার করুন।
4. প্রাসঙ্গিক উইজেট Vertex AI থেকে প্রতিক্রিয়া প্রদর্শন করে।

নিম্নলিখিত উদাহরণ দেখায় যে ভার্টেক্স এআই API থেকে প্রত্যাবর্তন করার সময় একটি প্রসঙ্গ টোকেন কেমন দেখায়।

"googleMapsWidgetContextToken": "widgetcontent/AcBXPQdpWQWbap9H-OH8sEKmOXxmEKAYvff0tvthhneMQC3VrqWCjpnPBl4-Id98FGiA_S_t8aeAeJj0T6JkWFX56Bil8oBSR0W8JH3C_RSYLbTjxKdpxc9yNn6JcZTtolIRZon9xi6WpNGuSyjcIxWu2S0hwpasNOpUlWrG1RxVCB4WD1fsz_pwR236mG36lMxevXTQ_JnfdYNuQwQ4Lc3vn...<snip>...
Ts5VJE_b3IC5eE_6wez0nh61r7foTUZpP7BXMwxR-7Wyfcj6x1v6mIWsFGr1o0p_HSAMNqWPg-aFVnkPLhAkOR6MaNZOfezTva-gxHlu7z_haFvYxcUE1qfNVQ",

Google মানচিত্র প্রাসঙ্গিক উইজেট রেন্ডার করুন

Google মানচিত্র প্রাসঙ্গিক উইজেট রেন্ডার করতে এবং ব্যবহার করতে, উইজেটটি প্রদর্শন করে এমন পৃষ্ঠায় মানচিত্র জাভাস্ক্রিপ্ট API-এর আলফা সংস্করণ ব্যবহার করুন। আরও তথ্যের জন্য, মানচিত্র জাভাস্ক্রিপ্ট API লোড দেখুন। আপনাকে অবশ্যই API কী ব্যবহার করতে হবে যা Google Maps JavaScript API লোড করতে সক্ষম করা হয়েছিল৷ places লাইব্রেরি লোড করা হয়েছে তা যাচাই করুন।

নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে কিভাবে Google Maps প্রাসঙ্গিক উইজেট রেন্ডার করতে হয়। কাস্টম এইচটিএমএল বা জাভাস্ক্রিপ্ট ব্যবহার করে একটি প্রাসঙ্গিক উইজেট তৈরি করুন।

কাস্টম HTML উপাদান ব্যবহার করুন

নিম্নোক্ত বিভাগে বর্ণনা করা হয়েছে কিভাবে কাস্টম HTML উপাদান ব্যবহার করে Google মানচিত্র প্রাসঙ্গিক উইজেট রেন্ডার করা যায়। পৃষ্ঠায় gmp-place-contextual উপাদান যোগ করে একটি প্রাসঙ্গিক উইজেট তৈরি করুন।

1. পৃষ্ঠায় gmp-place-contextual উপাদান যোগ করুন:

   <gmp-place-contextual id="widget"></gmp-place-contextual>

2. Google Maps-এর সাথে গ্রাউন্ডেড যে কোনও প্রতিক্রিয়াতে, একটি সংশ্লিষ্ট googleMapsWidgetContextToken আছে যা প্রাসঙ্গিক উইজেট রেন্ডার করতে ব্যবহার করা যেতে পারে। নিম্নলিখিত ফাংশন দেখায় কিভাবে প্রসঙ্গ টোকেন আপডেট করতে হয়:

   let widget = document.querySelector('#widget'); // a div that contains the widget
   widget.contextToken = contextToken;

3. ঐচ্ছিক: তালিকা বিন্যাস নির্দিষ্ট করুন. বৈধ মান নিম্নলিখিত অন্তর্ভুক্ত:
   • কমপ্যাক্ট লেআউট: <gmp-place-contextual-list-config layout="compact">
   • উল্লম্ব বিন্যাস: <gmp-place-contextual-list-config layout="vertical">

   নিম্নোক্ত উদাহরণ দেখায় কিভাবে তালিকা বিন্যাসকে কম্প্যাক্টে পরিবর্তন করতে হয়:

   <gmp-place-contextual id="widget">
     <gmp-place-contextual-list-config layout="compact">
     </gmp-place-contextual-list-config>
   </gmp-place-contextual>

4. ঐচ্ছিক: মানচিত্র মোড পরিবর্তন করুন। বৈধ মান নিম্নলিখিত অন্তর্ভুক্ত:
   • 2D রোডম্যাপ মানচিত্র: <gmp-place-contextual-map-config map-mode="roadmap">
   • 3D হাইব্রিড মানচিত্র: <gmp-place-contextual-map-config map-mode="hybrid">
   • কোনো মানচিত্র নেই: <gmp-place-contextual-map-config map-mode="none">
নিম্নলিখিত উদাহরণ দেখায় কিভাবে একটি 2D মানচিত্রে মানচিত্র মোড পরিবর্তন করতে হয়:

<gmp-place-contextual id="widget">
  <gmp-place-contextual-map-config map-mode="roadmap">
  </gmp-place-contextual-map-config>
</gmp-place-contextual>

জাভাস্ক্রিপ্ট ব্যবহার করুন

নিচের অংশে বর্ণনা করা হয়েছে কিভাবে প্রোগ্রাম্যাটিকভাবে একটি PlaceContextualElement তৈরি করে এবং DOM-এ যুক্ত করে Google Maps প্রাসঙ্গিক উইজেট রেন্ডার করা যায়।

1. একটি প্রাসঙ্গিক উইজেট তৈরি করুন।

   let widget = document.querySelector('#widget');  // a div that contains the widget
   
   async function createWidget(contextToken) {
     await google.maps.importLibrary('places');
     const placeContextualElement = new
         google.maps.places.PlaceContextualElement({ contextToken }); // contextToken can be empty at initialization.
     widget.appendChild(placeContextualElement);
   }

2. Google Maps-এর সাথে গ্রাউন্ডেড যে কোনও প্রতিক্রিয়াতে, একটি সংশ্লিষ্ট googleMapsWidgetContextToken আছে যা প্রাসঙ্গিক উইজেট রেন্ডার করতে ব্যবহৃত হয়। নিম্নলিখিত ফাংশন দেখায় কিভাবে প্রসঙ্গ টোকেন আপডেট করতে হয়:

   widget.contextToken = contextToken;

3. ঐচ্ছিক: তালিকা বিন্যাস নির্দিষ্ট করুন. বৈধ মান নিম্নলিখিত অন্তর্ভুক্ত:
   • কমপ্যাক্ট লেআউট: google.maps.places.PlaceContextualListLayout.COMPACT
   • উল্লম্ব বিন্যাস: google.maps.places.PlaceContextualListLayout.VERTICAL

নিম্নোক্ত উদাহরণ দেখায় কিভাবে তালিকা বিন্যাসকে কম্প্যাক্টে পরিবর্তন করতে হয়:

const widgetConfig = new google.maps.places.PlaceContextualListConfigElement({
  layout: google.maps.places.PlaceContextualListLayout.COMPACT
});
widget.appendChild(widgetConfig);

4. ঐচ্ছিক: মানচিত্র মোড পরিবর্তন করুন। বৈধ মান নিম্নলিখিত অন্তর্ভুক্ত:
   • 2D রোডম্যাপ মানচিত্র: google.maps.places.PlaceContextualListMapMode.ROADMAP
   • 3D হাইব্রিড মানচিত্র: google.maps.places.PlaceContextualListMapMode.HYBRID
   • কোনো মানচিত্র নেই: google.maps.places.PlaceContextualListMapMode.NONE

নিম্নলিখিত উদাহরণ দেখায় কিভাবে একটি 2D মানচিত্রে মানচিত্র মোড পরিবর্তন করতে হয়:

const widgetConfig = new google.maps.places.PlaceContextualListConfigElement({
  mapMode: google.maps.places.PlaceContextualListMapMode.ROADMAP
});
widget.appendChild(widgetConfig);

নিষিদ্ধ অঞ্চল

Google মানচিত্র একটি নিরাপদ এবং নির্ভরযোগ্য প্ল্যাটফর্ম বজায় রাখার জন্য নির্দিষ্ট বিষয়বস্তু এবং কার্যকলাপ সীমাবদ্ধ করে। নিষিদ্ধ অঞ্চলগুলির একটি তালিকার জন্য, Google মানচিত্র প্ল্যাটফর্ম নিষিদ্ধ অঞ্চলগুলি দেখুন৷