গুগল ম্যাপের সাথে গ্রাউন্ডিং জেমিনির উৎপাদক ক্ষমতাগুলিকে গুগল ম্যাপের সমৃদ্ধ, তথ্যবহুল এবং হালনাগাদ তথ্যের সাথে সংযুক্ত করে। এই বৈশিষ্ট্যটি ডেভেলপারদের তাদের অ্যাপ্লিকেশনগুলিতে সহজেই অবস্থান-সচেতন কার্যকারিতা অন্তর্ভুক্ত করতে সক্ষম করে। যখন কোনও ব্যবহারকারীর প্রশ্নের মানচিত্রের ডেটা সম্পর্কিত কোনও প্রসঙ্গ থাকে, তখন জেমিন মডেল ব্যবহারকারীর নির্দিষ্ট অবস্থান বা সাধারণ এলাকার সাথে প্রাসঙ্গিকভাবে তথ্যগতভাবে সঠিক এবং তাজা উত্তর প্রদানের জন্য গুগল ম্যাপকে কাজে লাগায়।
- সঠিক, অবস্থান-সচেতন উত্তর: ভৌগোলিকভাবে নির্দিষ্ট প্রশ্নের জন্য গুগল ম্যাপের বিস্তৃত এবং বর্তমান তথ্য ব্যবহার করুন।
- উন্নত ব্যক্তিগতকরণ: ব্যবহারকারীর প্রদত্ত অবস্থানের উপর ভিত্তি করে সুপারিশ এবং তথ্য অনুকূলিত করুন।
- প্রাসঙ্গিক তথ্য এবং উইজেট: জেনারেট করা কন্টেন্টের পাশাপাশি ইন্টারেক্টিভ গুগল ম্যাপ উইজেট রেন্ডার করার জন্য প্রসঙ্গ টোকেন।
শুরু করুন
এই উদাহরণটি দেখায় যে ব্যবহারকারীর প্রশ্নের সঠিক, অবস্থান-সচেতন প্রতিক্রিয়া প্রদানের জন্য আপনার অ্যাপ্লিকেশনে গ্রাউন্ডিংকে গুগল ম্যাপের সাথে কীভাবে একীভূত করা যায়। প্রম্পটটি ঐচ্ছিক ব্যবহারকারীর অবস্থান সহ স্থানীয় সুপারিশের জন্য জিজ্ঞাসা করে, যা জেমিনি মডেলকে গুগল ম্যাপের ডেটা ব্যবহার করতে সক্ষম করে।
পাইথন
from google import genai
from google.genai import types
client = genai.Client()
prompt = "What are the best Italian restaurants within a 15-minute walk from here?"
response = client.models.generate_content(
model='gemini-2.5-flash-lite',
contents=prompt,
config=types.GenerateContentConfig(
# Turn on grounding with Google Maps
tools=[types.Tool(google_maps=types.GoogleMaps())],
# Optionally provide the relevant location context (this is in Los Angeles)
tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
lat_lng=types.LatLng(
latitude=34.050481, longitude=-118.248526))),
),
)
print("Generated Response:")
print(response.text)
if grounding := response.candidates[0].grounding_metadata:
if grounding.grounding_chunks:
print('-' * 40)
print("Sources:")
for chunk in grounding.grounding_chunks:
print(f'- [{chunk.maps.title}]({chunk.maps.uri})')
জাভাস্ক্রিপ্ট
import { GoogleGenAI } from "@google/gnai";
const ai = new GoogleGenAI({});
async function generateContentWithMapsGrounding() {
const response = await ai.models.generateContent({
model: "gemini-2.5-flash",
contents: "What are the best Italian restaurants within a 15-minute walk from here?",
config: {
// Turn on grounding with Google Maps
tools: [{ googleMaps: {} }],
toolConfig: {
retrievalConfig: {
// Optionally provide the relevant location context (this is in Los Angeles)
latLng: {
latitude: 34.050481,
longitude: -118.248526,
},
},
},
},
});
console.log("Generated Response:");
console.log(response.text);
const grounding = response.candidates[0]?.groundingMetadata;
if (grounding?.groundingChunks) {
console.log("-".repeat(40));
console.log("Sources:");
for (const chunk of grounding.groundingChunks) {
if (chunk.maps) {
console.log(`- [${chunk.maps.title}](${chunk.maps.uri})`);
}
}
}
}
generateContentWithMapsGrounding();
বিশ্রাম
curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent' \
-H 'Content-Type: application/json' \
-H "x-goog-api-key: ${GEMINI_API_KEY}" \
-d '{
"contents": [{
"role": "user",
"parts": [{
"text": "What are the best Italian restaurants within a 15-minute walk from here?"
}]
}],
"tools": [{"googleMaps": {}}],
"toolConfig": {
"retrievalConfig": {
"latLng": {"latitude": 34.050481, "longitude": -118.248526}
}
}
}'
গুগল ম্যাপের মাধ্যমে গ্রাউন্ডিং কীভাবে কাজ করে
গুগল ম্যাপের সাথে গ্রাউন্ডিং, ম্যাপস এপিআইকে গ্রাউন্ডিং সোর্স হিসেবে ব্যবহার করে জেমিনি এপিআইকে গুগল জিও ইকোসিস্টেমের সাথে একীভূত করে। যখন কোনও ব্যবহারকারীর প্রশ্নের ভৌগোলিক প্রেক্ষাপট থাকে, তখন জেমিনি মডেলটি গ্রাউন্ডিং উইথ গুগল ম্যাপস টুলটি ব্যবহার করতে পারে। এরপর মডেলটি প্রদত্ত অবস্থানের সাথে প্রাসঙ্গিক গুগল ম্যাপস ডেটার ভিত্তিতে প্রতিক্রিয়া তৈরি করতে পারে।
প্রক্রিয়াটিতে সাধারণত অন্তর্ভুক্ত থাকে:
- ব্যবহারকারীর প্রশ্ন: একজন ব্যবহারকারী আপনার আবেদনে একটি প্রশ্ন জমা দেবেন, যার মধ্যে ভৌগোলিক প্রেক্ষাপট অন্তর্ভুক্ত থাকবে (যেমন, "আমার কাছাকাছি কফি শপ," "সান ফ্রান্সিসকোতে জাদুঘর")।
- টুল ইনভোকেশন: জেমিনি মডেল, ভৌগোলিক অভিপ্রায় সনাক্ত করে, গ্রাউন্ডিং উইথ গুগল ম্যাপস টুলটি ব্যবহার করে। অবস্থান-সচেতন ফলাফলের জন্য এই টুলটি ঐচ্ছিকভাবে ব্যবহারকারীর
latitude
এবংlongitude
প্রদান করা যেতে পারে। - তথ্য পুনরুদ্ধার: গ্রাউন্ডিং উইথ গুগল ম্যাপস পরিষেবা প্রাসঙ্গিক তথ্যের জন্য গুগল ম্যাপসকে জিজ্ঞাসা করে (যেমন, স্থান, পর্যালোচনা, ছবি, ঠিকানা, খোলার সময়)।
- গ্রাউন্ডেড জেনারেশন: পুনরুদ্ধার করা মানচিত্রের ডেটা জেমিনি মডেলের প্রতিক্রিয়া জানাতে ব্যবহার করা হয়, যা তথ্যগত নির্ভুলতা এবং প্রাসঙ্গিকতা নিশ্চিত করে।
- প্রতিক্রিয়া এবং উইজেট টোকেন: মডেলটি একটি টেক্সট প্রতিক্রিয়া প্রদান করে, যার মধ্যে Google মানচিত্রের উৎসের উদ্ধৃতি অন্তর্ভুক্ত থাকে। ঐচ্ছিকভাবে, API প্রতিক্রিয়াতে একটি
google_maps_widget_context_token
ও থাকতে পারে, যা ডেভেলপারদের ভিজ্যুয়াল ইন্টারঅ্যাকশনের জন্য তাদের অ্যাপ্লিকেশনে একটি প্রাসঙ্গিক Google মানচিত্র উইজেট রেন্ডার করার অনুমতি দেয়।
গুগল ম্যাপের সাথে কেন এবং কখন গ্রাউন্ডিং ব্যবহার করবেন
গুগল ম্যাপের সাথে গ্রাউন্ডিং এমন অ্যাপ্লিকেশনগুলির জন্য আদর্শ যেখানে সঠিক, হালনাগাদ এবং অবস্থান-নির্দিষ্ট তথ্যের প্রয়োজন হয়। এটি বিশ্বব্যাপী ২৫০ মিলিয়নেরও বেশি স্থানের গুগল ম্যাপের বিস্তৃত ডাটাবেস দ্বারা সমর্থিত প্রাসঙ্গিক এবং ব্যক্তিগতকৃত সামগ্রী সরবরাহ করে ব্যবহারকারীর অভিজ্ঞতা উন্নত করে।
আপনার অ্যাপ্লিকেশনের যখন প্রয়োজন হবে তখন আপনার Google Maps-এর সাথে Grounding ব্যবহার করা উচিত:
- ভূ-নির্দিষ্ট প্রশ্নের সম্পূর্ণ এবং নির্ভুল উত্তর প্রদান করুন।
- কথোপকথনমূলক ভ্রমণ পরিকল্পনাকারী এবং স্থানীয় গাইড তৈরি করুন।
- অবস্থান এবং ব্যবহারকারীর পছন্দের উপর ভিত্তি করে রেস্তোরাঁ বা দোকানের মতো আকর্ষণীয় স্থানগুলি সুপারিশ করুন।
- সামাজিক, খুচরা, বা খাদ্য সরবরাহ পরিষেবার জন্য অবস্থান-সচেতন অভিজ্ঞতা তৈরি করুন।
"আমার কাছাকাছি সেরা কফি শপ" খুঁজে বের করা বা দিকনির্দেশনা পাওয়ার মতো, যেখানে নৈকট্য এবং বর্তমান তথ্যগত তথ্য অত্যন্ত গুরুত্বপূর্ণ, সেখানে Google Maps ব্যবহার করা উৎকৃষ্ট।
API পদ্ধতি এবং পরামিতি
generateContent
পদ্ধতির মধ্যে একটি টুল হিসেবে Gemini API এর মাধ্যমে Google Maps-এর সাথে গ্রাউন্ডিং প্রকাশ করা হয়। আপনার অনুরোধের tools
প্যারামিটারে একটি googleMaps
অবজেক্ট অন্তর্ভুক্ত করে আপনি Google Maps-এর সাথে গ্রাউন্ডিং সক্ষম এবং কনফিগার করতে পারেন।
JSON সম্পর্কে
{
"contents": [{
"parts": [
{"text": "Restaurants near Times Square."}
]
}],
"tools": { "googleMaps": {} }
}
googleMaps
টুলটি অতিরিক্তভাবে একটি বুলিয়ান enableWidget
প্যারামিটার গ্রহণ করতে পারে, যা googleMapsWidgetContextToken
ফিল্ডটি প্রতিক্রিয়ায় ফেরত পাঠানো হবে কিনা তা নিয়ন্ত্রণ করতে ব্যবহৃত হয়। এটি একটি প্রাসঙ্গিক স্থান উইজেট প্রদর্শন করতে ব্যবহার করা যেতে পারে।
JSON সম্পর্কে
{
"contents": [{
"parts": [
{"text": "Restaurants near Times Square."}
]
}],
"tools": { "googleMaps": { "enableWidget": true } }
}
অতিরিক্তভাবে, টুলটি toolConfig
হিসাবে প্রাসঙ্গিক অবস্থান পাস করতে সহায়তা করে।
JSON সম্পর্কে
{
"contents": [{
"parts": [
{"text": "Restaurants near here."}
]
}],
"tools": { "googleMaps": {} },
"toolConfig": {
"retrievalConfig": {
"latLng": {
"latitude": 40.758896,
"longitude": -73.985130
}
}
}
}
গ্রাউন্ডিং প্রতিক্রিয়া বোঝা
যখন কোনও প্রতিক্রিয়া সফলভাবে Google Maps ডেটা দিয়ে গ্রাউন্ড করা হয়, তখন প্রতিক্রিয়াটিতে একটি groundingMetadata
ক্ষেত্র অন্তর্ভুক্ত থাকে। এই স্ট্রাকচার্ড ডেটা দাবি যাচাই করার জন্য এবং আপনার অ্যাপ্লিকেশনে একটি সমৃদ্ধ উদ্ধৃতি অভিজ্ঞতা তৈরি করার জন্য, সেইসাথে পরিষেবা ব্যবহারের প্রয়োজনীয়তা পূরণের জন্য অপরিহার্য।
JSON সম্পর্কে
{
"candidates": [
{
"content": {
"parts": [
{
"text": "CanteenM is an American restaurant with..."
}
],
"role": "model"
},
"groundingMetadata": {
"groundingChunks": [
{
"maps": {
"uri": "https://maps.google.com/?cid=13100894621228039586",
"title": "Heaven on 7th Marketplace",
"placeId": "places/ChIJ0-zA1vBZwokRon0fGj-6z7U"
},
// repeated ...
}
],
"groundingSupports": [
{
"segment": {
"startIndex": 0,
"endIndex": 79,
"text": "CanteenM is an American restaurant with a 4.6-star rating and is open 24 hours."
},
"groundingChunkIndices": [0]
},
// repeated ...
],
"webSearchQueries": [
"restaurants near me"
],
"googleMapsWidgetContextToken": "widgetcontent/..."
}
}
]
}
জেমিনি এপিআই groundingMetadata
সহ নিম্নলিখিত তথ্য প্রদান করে:
-
groundingChunks
:maps
উৎস (uri
,placeId
এবংtitle
) ধারণকারী বস্তুর অ্যারে। -
groundingSupports
:groundingChunks
এর উৎসের সাথে মডেল রেসপন্স টেক্সট সংযোগ করার জন্য খণ্ডের অ্যারে। প্রতিটি খণ্ড একটি টেক্সট স্প্যান (startIndex
এবংendIndex
দ্বারা সংজ্ঞায়িত) এক বা একাধিকgroundingChunkIndices
এর সাথে সংযুক্ত করে। এটি ইনলাইন সাইটেশন তৈরির মূল চাবিকাঠি। -
googleMapsWidgetContextToken
: একটি টেক্সট টোকেন যা একটি প্রাসঙ্গিক স্থান উইজেট রেন্ডার করতে ব্যবহার করা যেতে পারে।
টেক্সটে ইনলাইন উদ্ধৃতি কীভাবে রেন্ডার করতে হয় তা দেখানোর জন্য একটি কোড স্নিপেটের জন্য, Google Search ডক্সের সাথে গ্রাউন্ডিং-এর উদাহরণটি দেখুন।
গুগল ম্যাপের প্রাসঙ্গিক উইজেট প্রদর্শন করুন
ফিরে আসা googleMapsWidgetContextToken
ব্যবহার করতে, আপনাকে Google Maps JavaScript API লোড করতে হবে।
ব্যবহারের ক্ষেত্রে
গুগল ম্যাপের সাথে গ্রাউন্ডিং বিভিন্ন অবস্থান-সচেতন ব্যবহারের ক্ষেত্রে সহায়তা করে। নিম্নলিখিত উদাহরণগুলি দেখায় যে কীভাবে বিভিন্ন প্রম্পট এবং প্যারামিটার গুগল ম্যাপের সাথে গ্রাউন্ডিংকে কাজে লাগাতে পারে। গুগল ম্যাপের গ্রাউন্ডেড ফলাফলের তথ্য প্রকৃত অবস্থার থেকে আলাদা হতে পারে।
স্থান-নির্দিষ্ট প্রশ্নগুলি পরিচালনা করা
Google ব্যবহারকারীর পর্যালোচনা এবং অন্যান্য মানচিত্রের ডেটার উপর ভিত্তি করে উত্তর পেতে একটি নির্দিষ্ট স্থান সম্পর্কে বিস্তারিত প্রশ্ন জিজ্ঞাসা করুন।
পাইথন
from google import genai
from google.genai import types
client = genai.Client()
prompt = "Is there a cafe near the corner of 1st and Main that has outdoor seating?"
response = client.models.generate_content(
model='gemini-2.5-flash-lite',
contents=prompt,
config=types.GenerateContentConfig(
# Turn on the Maps tool
tools=[types.Tool(google_maps=types.GoogleMaps())],
# Provide the relevant location context (this is in Los Angeles)
tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
lat_lng=types.LatLng(
latitude=34.050481, longitude=-118.248526))),
),
)
print("Generated Response:")
print(response.text)
if grounding := response.candidates[0].grounding_metadata:
if chunks := grounding.grounding_chunks:
print('-' * 40)
print("Sources:")
for chunk in chunks:
print(f'- [{chunk.maps.title}]({chunk.maps.uri})')
```
জাভাস্ক্রিপ্ট
import { GoogleGenAI } from '@google/genai';
const ai = new GoogleGenAI({});
async function run() {
const prompt = "Is there a cafe near the corner of 1st and Main that has outdoor seating?";
const response = await ai.models.generateContent({
model: 'gemini-2.5-flash',
contents: prompt,
config: {
// Turn on the Maps tool
tools: [{googleMaps: {}}],
// Provide the relevant location context (this is in Los Angeles)
toolConfig: {
retrievalConfig: {
latLng: {
latitude: 34.050481,
longitude: -118.248526
}
}
}
},
});
console.log("Generated Response:");
console.log(response.text);
const chunks = response.candidates[0].groundingMetadata?.groundingChunks;
if (chunks) {
console.log('-'.repeat(40));
console.log("Sources:");
for (const chunk of chunks) {
if (chunk.maps) {
console.log(`- [${chunk.maps.title}](${chunk.maps.uri})`);
}
}
}
}
run();
বিশ্রাম
curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent' \
-H 'Content-Type: application/json' \
-H "x-goog-api-key: ${GEMINI_API_KEY}" \
-d '{
"contents": [{
"role": "user",
"parts": [{
"text": "Is there a cafe near the corner of 1st and Main that has outdoor seating?"
}]
}],
"tools": [{"googleMaps": {}}],
"toolConfig": {
"retrievalConfig": {
"latLng": {"latitude": 34.050481, "longitude": -118.248526}
}
}
}'
অবস্থান-ভিত্তিক ব্যক্তিগতকরণ প্রদান করা হচ্ছে
ব্যবহারকারীর পছন্দ এবং নির্দিষ্ট ভৌগোলিক এলাকার সাথে মানানসই সুপারিশ পান।
পাইথন
from google import genai
from google.genai import types
client = genai.Client()
prompt = "Which family-friendly restaurants near here have the best playground reviews?"
response = client.models.generate_content(
model='gemini-2.5-flash',
contents=prompt,
config=types.GenerateContentConfig(
tools=[types.Tool(google_maps=types.GoogleMaps())],
tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
# Provide the location as context; this is Austin, TX.
lat_lng=types.LatLng(
latitude=30.2672, longitude=-97.7431))),
),
)
print("Generated Response:")
print(response.text)
if grounding := response.candidates[0].grounding_metadata:
if chunks := grounding.grounding_chunks:
print('-' * 40)
print("Sources:")
for chunk in chunks:
print(f'- [{chunk.maps.title}]({chunk.maps.uri})')
জাভাস্ক্রিপ্ট
import { GoogleGenAI } from '@google/genai';
const ai = new GoogleGenAI({});
async function run() {
const prompt = "Which family-friendly restaurants near here have the best playground reviews?";
const response = await ai.models.generateContent({
model: 'gemini-2.5-flash',
contents: prompt,
config: {
tools: [{googleMaps: {}}],
toolConfig: {
retrievalConfig: {
// Provide the location as context; this is Austin, TX.
latLng: {
latitude: 30.2672,
longitude: -97.7431
}
}
}
},
});
console.log("Generated Response:");
console.log(response.text);
const chunks = response.candidates[0].groundingMetadata?.groundingChunks;
if (chunks) {
console.log('-'.repeat(40));
console.log("Sources:");
for (const chunk of chunks) {
if (chunk.maps) {
console.log(`- [${chunk.maps.title}](${chunk.maps.uri})`);
}
}
}
}
run();
বিশ্রাম
curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent' \
-H 'Content-Type: application/json' \
-H "x-goog-api-key: ${GEMINI_API_KEY}" \
-d '{
"contents": [{
"role": "user",
"parts": [{
"text": "Which family-friendly restaurants near here have the best playground reviews?"
}],
}],
"tools": [{"googleMaps": {}}],
"toolConfig": {
"retrievalConfig": {
"latLng": {"latitude": 30.2672, "longitude": -97.7431}
}
}
}'
ভ্রমণ পরিকল্পনায় সহায়তা করা
ভ্রমণের জন্য উপযুক্ত, বিভিন্ন স্থান সম্পর্কে দিকনির্দেশনা এবং তথ্য সহ বহু-দিনের পরিকল্পনা তৈরি করুন।
এই উদাহরণে, Google Maps টুলে উইজেট সক্রিয় করে googleMapsWidgetContextToken
অনুরোধ করা হয়েছে। সক্রিয় করা হলে, ফেরত আসা টোকেনটি Google Maps JavaScript API থেকে <gmp-places-contextual> component
ব্যবহার করে একটি প্রাসঙ্গিক স্থান উইজেট রেন্ডার করতে ব্যবহার করা যেতে পারে।
পাইথন
from google import genai
from google.genai import types
client = genai.Client()
prompt = "Plan a day in San Francisco for me. I want to see the Golden Gate Bridge, visit a museum, and have a nice dinner."
response = client.models.generate_content(
model='gemini-2.5-flash',
contents=prompt,
config=types.GenerateContentConfig(
tools=[types.Tool(google_maps=types.GoogleMaps(enable_widget=True))],
tool_config=types.ToolConfig(retrieval_config=types.RetrievalConfig(
# Provide the location as context, this is in San Francisco.
lat_lng=types.LatLng(
latitude=37.78193, longitude=-122.40476))),
),
)
print("Generated Response:")
print(response.text)
if grounding := response.candidates[0].grounding_metadata:
if grounding.grounding_chunks:
print('-' * 40)
print("Sources:")
for chunk in grounding.grounding_chunks:
print(f'- [{chunk.maps.title}]({chunk.maps.uri})')
if widget_token := grounding.google_maps_widget_context_token:
print('-' * 40)
print(f'<gmp-place-contextual context-token="{widget_token}"></gmp-place-contextual>')
জাভাস্ক্রিপ্ট
import { GoogleGenAI } from '@google/genai';
const ai = new GoogleGenAI({});
async function run() {
const prompt = "Plan a day in San Francisco for me. I want to see the Golden Gate Bridge, visit a museum, and have a nice dinner.";
const response = await ai.models.generateContent({
model: 'gemini-2.5-flash',
contents: prompt,
config: {
tools: [{googleMaps: {enableWidget: true}}],
toolConfig: {
retrievalConfig: {
// Provide the location as context, this is in San Francisco.
latLng: {
latitude: 37.78193,
longitude: -122.40476
}
}
}
},
});
console.log("Generated Response:");
console.log(response.text);
const groundingMetadata = response.candidates[0]?.groundingMetadata;
if (groundingMetadata) {
if (groundingMetadata.groundingChunks) {
console.log('-'.repeat(40));
console.log("Sources:");
for (const chunk of groundingMetadata.groundingChunks) {
if (chunk.maps) {
console.log(`- [${chunk.maps.title}](${chunk.maps.uri})`);
}
}
}
if (groundingMetadata.googleMapsWidgetContextToken) {
console.log('-'.repeat(40));
document.body.insertAdjacentHTML('beforeend', `<gmp-place-contextual context-token="${groundingMetadata.googleMapsWidgetContextToken}`"></gmp-place-contextual>`);
}
}
}
run();
বিশ্রাম
curl -X POST 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent' \
-H 'Content-Type: application/json' \
-H "x-goog-api-key: ${GEMINI_API_KEY}" \
-d '{
"contents": [{
"role": "user",
"parts": [{
"text": "Plan a day in San Francisco for me. I want to see the Golden Gate Bridge, visit a museum, and have a nice dinner."
}]
}],
"tools": [{"googleMaps": {"enableWidget":"true"}}],
"toolConfig": {
"retrievalConfig": {
"latLng": {"latitude": 37.78193, "longitude": -122.40476}
}
}
}'
যখন উইজেটটি রেন্ডার করা হবে, তখন এটি নিচের মতো দেখাবে:
পরিষেবা ব্যবহারের প্রয়োজনীয়তা
এই বিভাগটি Google Maps-এর সাথে গ্রাউন্ডিংয়ের জন্য পরিষেবা ব্যবহারের প্রয়োজনীয়তা বর্ণনা করে।
গুগল ম্যাপস সোর্স ব্যবহার সম্পর্কে ব্যবহারকারীকে অবহিত করুন
প্রতিটি Google Maps Grounded Result এর সাথে, আপনি groundingChunks
এ এমন উৎস পাবেন যা প্রতিটি প্রতিক্রিয়া সমর্থন করে। নিম্নলিখিত মেটাডেটাও ফেরত পাঠানো হয়:
- উৎস uri
- শিরোনাম
- আইডি
Google Maps-এর মাধ্যমে Grounding-এর ফলাফল উপস্থাপন করার সময়, আপনাকে সংশ্লিষ্ট Google Maps উৎসগুলি নির্দিষ্ট করতে হবে এবং আপনার ব্যবহারকারীদের নিম্নলিখিত বিষয়গুলি সম্পর্কে অবহিত করতে হবে:
- গুগল ম্যাপস সোর্সগুলিকে অবশ্যই সেই জেনারেটেড কন্টেন্ট অনুসরণ করতে হবে যা সোর্সগুলি সমর্থন করে। এই জেনারেটেড কন্টেন্টকে গুগল ম্যাপস গ্রাউন্ডেড রেজাল্টও বলা হয়।
- গুগল ম্যাপের উৎসগুলি অবশ্যই এক ব্যবহারকারীর মিথস্ক্রিয়ার মধ্যেই দেখা যাবে।
গুগল ম্যাপের লিঙ্ক সহ গুগল ম্যাপের উৎসগুলি প্রদর্শন করুন
groundingChunks
এবং grounding_chunks.maps.placeAnswerSources.reviewSnippets
এর প্রতিটি উৎসের জন্য, এই প্রয়োজনীয়তাগুলি অনুসরণ করে একটি লিঙ্ক প্রিভিউ তৈরি করতে হবে:
- গুগল ম্যাপের টেক্সট অ্যাট্রিবিউশন নির্দেশিকা অনুসরণ করে প্রতিটি উৎসকে গুগল ম্যাপে অ্যাট্রিবিউট করুন।
- উত্তরে প্রদত্ত উৎসের শিরোনামটি প্রদর্শন করুন।
- প্রতিক্রিয়া থেকে
uri
অথবাgoogleMapsUri
ব্যবহার করে উৎসের লিঙ্ক দিন।
এই ছবিগুলি উৎস এবং Google মানচিত্রের লিঙ্কগুলি প্রদর্শনের জন্য ন্যূনতম প্রয়োজনীয়তাগুলি দেখায়।
আপনি উৎসগুলির দৃশ্যটি আড়াল করতে পারেন।
ঐচ্ছিক: অতিরিক্ত কন্টেন্ট দিয়ে লিঙ্ক প্রিভিউ উন্নত করুন, যেমন:
- গুগল ম্যাপস টেক্সট অ্যাট্রিবিউশনের আগে একটি গুগল ম্যাপস ফেভিকন ঢোকানো হয়।
- উৎস URL (
og:image
) থেকে একটি ছবি।
আমাদের কিছু Google Maps ডেটা প্রদানকারী এবং তাদের লাইসেন্সের শর্তাবলী সম্পর্কে আরও তথ্যের জন্য, Google Maps এবং Google Earth আইনি বিজ্ঞপ্তি দেখুন।
গুগল ম্যাপের টেক্সট অ্যাট্রিবিউশন নির্দেশিকা
যখন আপনি টেক্সটের মাধ্যমে Google Maps-এ উৎসগুলি অ্যাট্রিবিউট করেন, তখন এই নির্দেশিকাগুলি অনুসরণ করুন:
- গুগল ম্যাপের টেক্সট কোনওভাবেই পরিবর্তন করবেন না:
- গুগল ম্যাপের ক্যাপিটালাইজেশন পরিবর্তন করবেন না।
- গুগল ম্যাপকে একাধিক লাইনে মুড়িয়ে রাখবেন না।
- গুগল ম্যাপকে অন্য ভাষায় স্থানীয়করণ করবেন না।
- HTML অ্যাট্রিবিউট translate="no" ব্যবহার করে ব্রাউজারগুলিকে Google Maps অনুবাদ করা থেকে বিরত রাখুন।
- নিম্নলিখিত টেবিলে বর্ণিত পদ্ধতিতে গুগল ম্যাপের টেক্সট স্টাইল করুন:
সম্পত্তি | স্টাইল |
---|---|
Font family | রোবোটো। ফন্ট লোড করা ঐচ্ছিক। |
Fallback font family | আপনার পণ্যে ইতিমধ্যে ব্যবহৃত যেকোনো sans serif বডি ফন্ট অথবা "Sans-Serif" ডিফল্ট সিস্টেম ফন্ট ব্যবহার করার জন্য |
Font style | স্বাভাবিক |
Font weight | ৪০০ |
Font color | সাদা, কালো (#1F1F1F), অথবা ধূসর (#5E5E5E)। পটভূমির বিপরীতে অ্যাক্সেসযোগ্য (4.5:1) বৈসাদৃশ্য বজায় রাখুন। |
Font size |
|
Spacing | স্বাভাবিক |
সিএসএসের উদাহরণ
নিম্নলিখিত CSS সাদা বা হালকা ব্যাকগ্রাউন্ডে উপযুক্ত টাইপোগ্রাফিক স্টাইল এবং রঙ সহ Google Maps রেন্ডার করে।
সিএসএস
@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');
.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}
প্রসঙ্গ টোকেন, স্থান আইডি এবং পর্যালোচনা আইডি
গুগল ম্যাপস ডেটাতে প্রসঙ্গ টোকেন, স্থান আইডি এবং পর্যালোচনা আইডি অন্তর্ভুক্ত থাকে। আপনি নিম্নলিখিত প্রতিক্রিয়া ডেটা ক্যাশে, সঞ্চয় এবং রপ্তানি করতে পারেন:
-
googleMapsWidgetContextToken
-
placeId
-
reviewId
"Google Maps-এর সাথে গ্রাউন্ডিং শর্তাবলী"-এ ক্যাশিংয়ের বিরুদ্ধে বিধিনিষেধ প্রযোজ্য নয়।
নিষিদ্ধ কার্যকলাপ এবং অঞ্চল
নিরাপদ এবং নির্ভরযোগ্য প্ল্যাটফর্ম বজায় রাখার জন্য নির্দিষ্ট কিছু কন্টেন্ট এবং কার্যকলাপের জন্য Google Maps-এর সাথে গ্রাউন্ডিং-এর অতিরিক্ত বিধিনিষেধ রয়েছে। শর্তাবলীতে ব্যবহারের বিধিনিষেধ ছাড়াও, আপনি জরুরি প্রতিক্রিয়া পরিষেবা সহ উচ্চ ঝুঁকিপূর্ণ কার্যকলাপের জন্য Grounding with Google Maps ব্যবহার করবেন না। আপনি আপনার অ্যাপ্লিকেশনটি বিতরণ বা বাজারজাত করবেন না যা নিষিদ্ধ অঞ্চলে Google Maps-এর সাথে গ্রাউন্ডিং অফার করে। বর্তমান নিষিদ্ধ অঞ্চলগুলি হল:
- চীন
- ক্রিমিয়া
- কিউবা
- দোনেৎস্ক গণপ্রজাতন্ত্রী
- ইরান
- লুহানস্ক গণপ্রজাতন্ত্রী
- উত্তর কোরিয়া
- সিরিয়া
- ভিয়েতনাম
এই তালিকাটি সময়ে সময়ে আপডেট করা হতে পারে।
সেরা অনুশীলন
- ব্যবহারকারীর অবস্থান প্রদান করুন: সবচেয়ে প্রাসঙ্গিক এবং ব্যক্তিগতকৃত প্রতিক্রিয়ার জন্য, ব্যবহারকারীর অবস্থান জানা থাকলে সর্বদা আপনার
googleMapsGrounding
কনফিগারেশনেuser_location
(অক্ষাংশ এবং দ্রাঘিমাংশ) অন্তর্ভুক্ত করুন। - গুগল ম্যাপস প্রাসঙ্গিক উইজেট রেন্ডার করুন: প্রাসঙ্গিক উইজেটটি প্রসঙ্গ টোকেন,
googleMapsWidgetContextToken
ব্যবহার করে রেন্ডার করা হয়, যা জেমিনি API প্রতিক্রিয়ায় ফিরে আসে এবং গুগল ম্যাপস থেকে ভিজ্যুয়াল কন্টেন্ট রেন্ডার করতে ব্যবহার করা যেতে পারে। প্রাসঙ্গিক উইজেট সম্পর্কে আরও তথ্যের জন্য, গুগল ডেভেলপার গাইডে গুগল ম্যাপস উইথ গ্রাউন্ডিং উইথ গুগল ম্যাপস উইথ উইজেট দেখুন। - ব্যবহারকারীদের অবহিত করুন: আপনার ব্যবহারকারীদের স্পষ্টভাবে জানান যে গুগল ম্যাপের ডেটা তাদের প্রশ্নের উত্তর দেওয়ার জন্য ব্যবহার করা হচ্ছে, বিশেষ করে যখন টুলটি সক্রিয় থাকে।
- লেটেন্সি পর্যবেক্ষণ করুন: কথোপকথনমূলক অ্যাপ্লিকেশনগুলির জন্য, নিশ্চিত করুন যে গ্রাউন্ডেড রেসপন্সের জন্য P95 লেটেন্সি গ্রহণযোগ্য সীমার মধ্যে থাকে যাতে ব্যবহারকারীর অভিজ্ঞতা মসৃণ হয়।
- প্রয়োজন না হলে টগল অফ করুন: গুগল ম্যাপের সাথে গ্রাউন্ডিং ডিফল্টরূপে বন্ধ থাকে। কর্মক্ষমতা এবং খরচ অপ্টিমাইজ করার জন্য, শুধুমাত্র যখন কোনও কোয়েরির ভৌগোলিক প্রেক্ষাপট স্পষ্ট থাকে তখনই এটি (
"tools": [{"googleMaps": {}}]
) সক্ষম করুন।
সীমাবদ্ধতা
- ভৌগোলিক পরিধি: বর্তমানে, গুগল ম্যাপের সাথে গ্রাউন্ডিং বিশ্বব্যাপী উপলব্ধ
- মডেল সাপোর্ট: শুধুমাত্র নির্দিষ্ট জেমিনি মডেলগুলি গুগল ম্যাপের সাথে গ্রাউন্ডিং সমর্থন করে: জেমিনি 2.5 ফ্ল্যাশ-লাইট, জেমিনি 2.5 প্রো, জেমিনি 2.5 ফ্ল্যাশ, এবং জেমিনি 2.0 ফ্ল্যাশ (কিন্তু 2.0 ফ্ল্যাশ লাইট নয়)।
- মাল্টিমোডাল ইনপুট/আউটপুট: গুগল ম্যাপের সাথে গ্রাউন্ডিং বর্তমানে টেক্সট এবং প্রাসঙ্গিক মানচিত্র উইজেটের বাইরে মাল্টিমোডাল ইনপুট বা আউটপুট সমর্থন করে না।
- ডিফল্ট অবস্থা: গ্রাউন্ডিং উইথ গুগল ম্যাপস টুলটি ডিফল্টরূপে বন্ধ থাকে। আপনার API অনুরোধগুলিতে এটি স্পষ্টভাবে সক্ষম করতে হবে।
মূল্য নির্ধারণ এবং হারের সীমা
গুগল ম্যাপের মাধ্যমে গ্রাউন্ডিং মূল্য নির্ধারণ করা হয় কোয়েরির উপর ভিত্তি করে। বর্তমান হার হল $25 / 1K গ্রাউন্ডেড প্রম্পট । একটি অনুরোধ কেবল তখনই কোটার জন্য গণনা করা হয় যখন একটি প্রম্পট সফলভাবে কমপক্ষে একটি গুগল ম্যাপ গ্রাউন্ডেড ফলাফল (অর্থাৎ, কমপক্ষে একটি গুগল ম্যাপ সোর্স ধারণকারী ফলাফল) ফেরত দেয়। যদি একটি একক অনুরোধ থেকে গুগল ম্যাপে একাধিক প্রশ্ন পাঠানো হয়, তাহলে এটি হার সীমার জন্য একটি অনুরোধ হিসাবে গণনা করা হয়।
বিস্তারিত মূল্য নির্ধারণের তথ্যের জন্য, জেমিনি এপিআই মূল্য নির্ধারণ পৃষ্ঠাটি দেখুন।
সমর্থিত মডেল
আপনি মডেল ওভারভিউ পৃষ্ঠায় তাদের ক্ষমতা খুঁজে পেতে পারেন।
মডেল | গুগল ম্যাপের সাহায্যে গ্রাউন্ডিং |
---|---|
জেমিনি ২.৫ প্রো | ✔️ |
জেমিনি 2.5 ফ্ল্যাশ | ✔️ |
জেমিনি ২.৫ ফ্ল্যাশ-লাইট | ✔️ |
জেমিনি ২.০ ফ্ল্যাশ | ✔️ |
এরপর কি?
- জেমিনি এপিআই কুকবুক-এ গুগল সার্চের মাধ্যমে গ্রাউন্ডিং ব্যবহার করে দেখুন।
- অন্যান্য উপলব্ধ সরঞ্জাম সম্পর্কে জানুন, যেমন ফাংশন কলিং ।
- দায়িত্বশীল AI সেরা অনুশীলন এবং Gemini API এর নিরাপত্তা ফিল্টার সম্পর্কে আরও জানতে, নিরাপত্তা সেটিংস নির্দেশিকা দেখুন।