গ্রাউন্ডিং উইথ
- তথ্যগত নির্ভুলতা বৃদ্ধি করুন : গুগলের ২৫ কোটিরও বেশি বাস্তব স্থান ও ব্যবসার ডেটাবেসের উপর ভিত্তি করে প্রতিক্রিয়া তৈরি করে মডেলের বিভ্রম হ্রাস করুন।
- রিয়েল-টাইম তথ্য অ্যাক্সেস করুন : লাইভ ডেটা ব্যবহার করে প্রশ্নের উত্তর দিন, যেমন বর্তমান ব্যবসায়িক সময় এবং ইভি চার্জিং স্টেশনগুলির রিয়েল-টাইম স্ট্যাটাস।
- দৃশ্যমান প্রেক্ষাপট প্রদান করুন : মডেলের অবস্থান-ভিত্তিক দাবির পাশাপাশি সরাসরি ইন্টারেক্টিভ ম্যাপ উইজেট, ছবি এবং স্ট্রিট ভিউ যুক্ত করে ব্যবহারকারীর আস্থা তৈরি করুন।
সমর্থিত মডেল
-
gemini-3.1-pro-preview -
gemini-3-flash-preview -
gemini-3.1-flash-lite -
gemini-2.5-pro -
gemini-2.5-flash -
gemini-2.5-flash-lite
সমর্থিত ভাষা
জেমিনি মডেলগুলির জন্য সমর্থিত ভাষাগুলি দেখুন।
Google Maps দিয়ে মডেলটিকে ভিত্তি দিন।
এই পৃষ্ঠায় প্রদানকারী-নির্দিষ্ট বিষয়বস্তু এবং কোড দেখতে আপনার জেমিনি এপিআই প্রদানকারীর উপর ক্লিক করুন। |
যখন আপনি GenerativeModel ইনস্ট্যান্সটি তৈরি করবেন, তখন মডেলটির প্রতিক্রিয়া তৈরি করার জন্য একটি tool হিসেবে GoogleMaps প্রদান করুন।
সুইফট
import FirebaseAILogic
// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Example: Coordinates for New York City
let latAndLong = CLLocationCoordinate2D(latitude: 40.7128, longitude: -74.0060)
// (Optional) Define a RetrievalConfig to configure the Grounding with Google Maps tool.
// You can optionally provide a location's coordinates and/or a language code
// for more relevant and personalized Google Maps results.
let retrievalConfig = RetrievalConfig(
location: latAndLong,
// Example: Language code for English (US)
languageCode: "en_US"
)
// Wrap the RetrievalConfig inside a ToolConfig.
let toolConfig = ToolConfig(retrievalConfig: retrievalConfig)
// Create a `GenerativeModel` instance with a model that supports your use case.
let model = ai.generativeModel(
modelName: "GEMINI_MODEL_NAME",
// Provide Google Maps as a tool that the model can use to generate its response.
tools: [Tool.googleMaps()],
// Add the configuration for the Grounding with Google Maps tool
// (if this optional config was defined above).
toolConfig: toolConfig
)
let response = try await model.generateContent("restaurants near me?")
print(response.text ?? "No text in response.")
// Make sure to comply with the "Grounding with Google Maps " usage requirements,
// which includes how you meet service usage requirements
Kotlin
// (Optional) Define a RetrievalConfig to configure the Grounding with Google Maps tool.
// You can optionally provide a location's coordinates and/or a language code
// for more relevant and personalized Google Maps results.
val retrievalConfig = RetrievalConfig(
// Example: Coordinates for New York City
latLng = LatLng(latitude = 40.7128, longitude = -74.0060),
// Example: Language code for English (US)
languageCode = "en_US"
)
// Wrap the RetrievalConfig inside a ToolConfig.
val toolConfig = ToolConfig(
retrievalConfig = retrievalConfig
)
// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case.
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).generativeModel(
modelName = "GEMINI_MODEL_NAME",
// Add the configuration for the Grounding with Google Maps tool
// (if this optional config was defined above).
toolConfig = toolConfig,
// Provide Google Maps as a tool that the model can use to generate its response.
tools = listOf(Tool.googleMaps())
)
val response = model.generateContent("restaurants near me?")
print(response.text)
// Make sure to comply with the "Grounding with Google Maps " usage requirements,
// which includes how you meet service usage requirements
Java
// (Optional) Define a ToolConfig to configure the Grounding with Google Maps tool.
// You can optionally provide a location's coordinates and/or a language code
// for more relevant and personalized Google Maps results.
ToolConfig toolConfig = new ToolConfig(
null,
new RetrievalConfig(
// Example: Coordinates for New York City
new LatLng(40.7128, -74.0060),
// Example: Language code for English (US)
"en_US"
)
);
// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
.generativeModel("GEMINI_MODEL_NAME",
null,
null,
// Provide Google Maps as a tool that the model can use to generate its response.
List.of(Tool.googleMaps()),
// Add the configuration for the Grounding with Google Maps tool
// (if this optional config was defined above).
toolConfig);
// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs.
GenerativeModelFutures model = GenerativeModelFutures.from(ai);
ListenableFuture response = model.generateContent("restaurants near me?");
Futures.addCallback(response, new FutureCallback() {
@Override
public void onSuccess(GenerateContentResponse result) {
String resultText = result.getText();
System.out.println(resultText);
}
@Override
public void onFailure(Throwable t) {
t.printStackTrace();
}
}, executor);
// Make sure to comply with the "Grounding with Google Maps " usage requirements,
// which includes how you meet service usage requirements
Web
import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";
// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
// ...
};
// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);
// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });
// (Optional) Define a toolConfig to configure the Grounding with Google Maps tool.
// You can optionally provide a location's coordinates and/or a language code
// for more relevant and personalized Google Maps results.
const toolConfig = {
retrievalConfig: {
// Example: Coordinates for New York City
latLng: {
latitude: 40.7128,
longitude: -74.0060
},
// Example: Language code for English (US)
languageCode: 'en-US'
}
};
// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(
ai,
{
model: "GEMINI_MODEL_NAME",
// Provide Google Maps as a tool that the model can use to generate its response.
// (Optional) Set `enableWidget` to control whether the response contains a `googleMapsWidgetContextToken`.
tools: [ { googleMaps: { enableWidget: true } } ],
// Add the configuration for the Grounding with Google Maps tool
// (if this optional config was defined above).
toolConfig
}
);
const result = await model.generateContent("restaurants near me?");
console.log(result.response.text());
// Make sure to comply with the "Grounding with Google Maps " usage requirements,
// which includes how you meet service usage requirements
Dart
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_ai/firebase_ai.dart';
import 'firebase_options.dart';
// Initialize FirebaseApp.
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
// (Optional) Define a ToolConfig to configure the Grounding with Google Maps tool.
// You can optionally provide a location's coordinates and/or a language code
// for more relevant and personalized Google Maps results.
final toolConfig = ToolConfig(
retrievalConfig: RetrievalConfig(
// Example: Coordinates for New York City
latLng: LatLng(latitude: 40.712728, longitude: -74.006015),
// Example: Language code for English (US)
languageCode: 'en',
),
);
// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case.
final model = FirebaseAI.googleAI().generativeModel(
model: 'GEMINI_MODEL_NAME',
// Provide Google Maps as a tool that the model can use to generate its response.
tools: [
Tool.googleMaps(),
],
// Add the configuration for the Grounding with Google Maps tool
// (if this optional config was defined above).
toolConfig: toolConfig,
);
final response = await model.generateContent([Content.text("restaurants near me?")]);
print(response.text);
// Make sure to comply with the "Grounding with Google Maps " usage requirements,
// which includes how you meet service usage requirements
ঐক্য
using Firebase;
using Firebase.AI;
// Initialize the Gemini Developer API backend service
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());
// Example: Coordinates for New York City
var latLng = new LatLng(40.7128, -74.0060);
// (Optional) Define a RetrievalConfig to configure the Grounding with Google Maps tool.
// You can optionally provide a location's coordinates and/or a language code
// for more relevant and personalized Google Maps results.
var retrievalConfig = new RetrievalConfig(latLng, languageCode: "en");
// Wrap the RetrievalConfig inside a ToolConfig.
var toolConfig = new ToolConfig(retrievalConfig: retrievalConfig);
// Create a `GenerativeModel` instance with a model that supports your use case
var model = ai.GetGenerativeModel(
modelName: "GEMINI_MODEL_NAME",
// Provide Google Maps as a tool that the model can use to generate its response.
tools: new[] { new Tool(new GoogleMaps()) },
// Add the configuration for the Grounding with Google Maps tool
// (if this optional config was defined above).
toolConfig: toolConfig
);
var response = await model.GenerateContentAsync("restaurants near me?");
UnityEngine.Debug.Log(response.Text ?? "No text in response.");
// Make sure to comply with the "Grounding with Google Maps " usage requirements,
// which includes how you meet service usage requirements
কীভাবে একটি মডেল বেছে নিতে হয় তা জানুনআপনার ব্যবহারের ক্ষেত্র এবং অ্যাপের জন্য উপযুক্ত।
আদর্শ ফলাফলের জন্য, ১.০ তাপমাত্রা ব্যবহার করুন (যা সমস্ত জেমিনি ২.৫ এবং পরবর্তী মডেলগুলির জন্য ডিফল্ট)। মডেলের কনফিগারেশনে কীভাবে তাপমাত্রা সেট করতে হয় তা জানুন।
ফলাফল উন্নত করার সেরা উপায় ও পরামর্শ
এই বিভাগে
সাধারণ সর্বোত্তম অনুশীলন
শুধুমাত্র প্রয়োজনের সময় টুলটি সরবরাহ করুন : কর্মক্ষমতা এবং খরচ অপ্টিমাইজ করতে, মডেলটিকে 'গ্রাউন্ডিং উইথ
Google Maps টুলটিতে অ্যাক্সেস কেবল তখনই দিন যখন ব্যবহারের ক্ষেত্রটির একটি স্পষ্ট ভৌগোলিক প্রেক্ষাপট থাকে।ব্যবহারকারীর অবস্থান প্রদান করুন : সবচেয়ে প্রাসঙ্গিক এবং ব্যক্তিগতকৃত প্রতিক্রিয়ার জন্য (এবং যখন ব্যবহারকারীর অবস্থান জানা থাকে), ‘গ্রাউন্ডিং উইথ
Google Maps টুলের কনফিগারেশনে ব্যবহারকারীর অবস্থান (latLngএর মাধ্যমে অক্ষাংশ এবং দ্রাঘিমাংশ ব্যবহার করে) অন্তর্ভুক্ত করুন।ব্যবহারকারীদের অবহিত করুন : আপনার ব্যবহারকারীদের স্পষ্টভাবে জানান যে তাদের জিজ্ঞাসার উত্তর দিতে
Google Maps ডেটা ব্যবহার করা হচ্ছে। ‘গ্রাউন্ডিং উইথGoogle Maps টুলটির জন্য ব্যবহারকারীদের কাছেGoogle Maps থেকে ডেটার উৎস সরবরাহ করা একটি আবশ্যিক পরিষেবা ।(শুধুমাত্র ওয়েব SDK-এর জন্য)
Google Maps কনটেক্সচুয়াল উইজেট রেন্ডার করুন : কনটেক্সচুয়াল উইজেটটি কনটেক্সট টোকেন,googleMapsWidgetContextToken, ব্যবহার করে রেন্ডার করা হয়, যা জেমিনি এপিআই রেসপন্সে ফেরত আসে এবংGoogle Maps থেকে ভিজ্যুয়াল কন্টেন্ট রেন্ডার করতে ব্যবহার করা যায়। কনটেক্সচুয়াল উইজেট সম্পর্কে আরও তথ্যের জন্য,Google Maps ডকুমেন্টেশনে "গ্রাউন্ডিং উইথGoogle Maps উইজেট" দেখুন।
প্রম্পটে স্থানের বৈশিষ্ট্য ব্যবহার করুন
এই বিভাগে স্থানের সেই বৈশিষ্ট্যগুলো তালিকাভুক্ত করা হয়েছে, যেগুলো অবস্থান বর্ণনা করতে এবং ‘গ্রাউন্ডিং উইথ
নমুনা স্থানের বৈশিষ্ট্য
এই তালিকাটি স্থান সম্পর্কিত এমন কিছু বৈশিষ্ট্যের বর্ণানুক্রমিক নমুনা প্রদান করে, যা আপনার মডেল প্রতিক্রিয়া তৈরি করতে ব্যবহার করতে পারে।
- ঠিকানা
- কার্বসাইড পিকআপ
- ডেবিট কার্ড
- দূরত্ব
- বিনামূল্যে পার্কিং লট
- লাইভ সঙ্গীত
- শিশুদের জন্য মেনু
- খোলার সময়
- অর্থপ্রদানের বিকল্প (যেমন নগদ বা ক্রেডিট কার্ড )
- উত্তর দিন
- পোষা প্রাণীবান্ধব
- বিয়ার পরিবেশন করে
- নিরামিষ খাবার পরিবেশন করা হয়
- হুইলচেয়ার প্রবেশযোগ্য
- ওয়াইফাই
প্লেস অ্যানসারস হলো গ্রাউন্ডিং উইথ
স্থান বৈশিষ্ট্য ব্যবহার করে এমন উদাহরণ প্রম্পট।
নিম্নলিখিত উদাহরণগুলিতে বিভিন্ন ধরণের স্থান সম্পর্কিত নির্দেশনায় স্থানের বৈশিষ্ট্য ব্যবহার করা হয়েছে। গ্রাউন্ডিং উইথ
পারিবারিক নৈশভোজের পরিকল্পনা করুন : রেস্তোরাঁটি পরিবারের জন্য উপযুক্ত কিনা এবং সেখানে সুবিধাজনক পরিষেবা দেওয়া হয় কিনা তা যাচাই করুন।
- উদাহরণস্বরূপ প্রশ্ন: "দ্য ইতালিয়ান প্লেস" কি বাচ্চাদের জন্য ভালো, এবং তারা কি টেকআউট পরিষেবা দেয়? তাদের রেটিং কত?
বন্ধুর জন্য প্রবেশগম্যতা যাচাই করুন : স্থানটি নির্দিষ্ট প্রবেশগম্যতার চাহিদা পূরণ করে কিনা তা নির্ধারণ করুন।
- উদাহরণস্বরূপ জিজ্ঞাসা: আমার এমন একটি রেস্তোরাঁ প্রয়োজন যার প্রবেশপথ হুইলচেয়ার ব্যবহারকারীদের জন্য প্রবেশযোগ্য।
গভীর রাতের নাস্তার জন্য একটি জায়গা খুঁজুন : এমন একটি খোলা প্রতিষ্ঠান খুঁজুন যেখানে একটি নির্দিষ্ট সময়ে একটি নির্দিষ্ট খাবার পরিবেশন করা হয়।
- উদাহরণস্বরূপ প্রশ্ন: "বার্গার জয়েন্ট" কি এখন খোলা আছে? ওরা কি রাতের খাবার পরিবেশন করে? শুক্রবারে ওদের খোলার সময়সূচী কী?
ক্লায়েন্টের সাথে কফি খেতে সাক্ষাৎ : সুযোগ-সুবিধা, প্রদত্ত পরিষেবা এবং অর্থ পরিশোধের পদ্ধতির উপর ভিত্তি করে একটি ব্যবসায়িক বৈঠকের জন্য ক্যাফেটির উপযুক্ততা মূল্যায়ন করুন।
- উদাহরণস্বরূপ প্রশ্ন: "ক্যাফে সেন্ট্রাল"-এ কি ওয়াইফাই আছে? তারা কি কফি পরিবেশন করে? তাদের মূল্যস্তর কেমন, এবং তারা কি ক্রেডিট কার্ড গ্রহণ করে?
মনে রাখবেন যে,
Google Maps দিয়ে গ্রাউন্ডিং কীভাবে কাজ করে
যখন আপনি মডেলটিকে GoogleMaps টুলটি প্রদান করেন, তখন মডেলটি স্বয়ংক্রিয়ভাবে তথ্য অনুসন্ধান, প্রক্রিয়াকরণ এবং উদ্ধৃতি দেওয়ার সম্পূর্ণ কার্যপ্রবাহটি পরিচালনা করে।
মডেলটির কার্যপ্রবাহ নিচে দেওয়া হলো:
প্রম্পট গ্রহণ করে : আপনার অ্যাপটি
GoogleMapsটুল সক্রিয় থাকা জেমিনি মডেলে একটি প্রম্পট পাঠায়।প্রম্পট বিশ্লেষণ করে : মডেলটি প্রম্পটটি বিশ্লেষণ করে এবং নির্ধারণ করে যে
Google Maps তার প্রতিক্রিয়া উন্নত করতে পারে কিনা, উদাহরণস্বরূপ, যদি প্রম্পটটিতে ভৌগোলিক প্রসঙ্গ থাকে (যেমন "আমার কাছাকাছি কফি শপ," "সান ফ্রান্সিসকোর জাদুঘর")।টুলটি চালু করে : মডেলটি ভৌগোলিক অভিপ্রায় শনাক্ত করে ‘গ্রাউন্ডিং উইথ
Google Maps টুলটি চালু করে।Google Maps এ অনুসন্ধান পাঠায় : ‘গ্রাউন্ডিং উইথGoogle Maps পরিষেবাটি প্রাসঙ্গিক তথ্যের (যেমন, স্থান, পর্যালোচনা, ছবি, ঠিকানা, খোলার সময়) জন্যGoogle Maps অনুসন্ধান করে।আরও প্রাসঙ্গিক এবং ব্যক্তিগতকৃত
Google Maps ফলাফল পেতে, আপনি ঐচ্ছিকভাবে টুলটির কনফিগে (অথবা সরাসরি প্রম্পটেও) অক্ষাংশ এবং দ্রাঘিমাংশ অন্তর্ভুক্ত করতে পারেন। টুলটি একটি টেক্সচুয়াল সার্চ টুল এবং এটিGoogle Maps সার্চ করার মতোই কাজ করে; অর্থাৎ, স্থানীয় অনুসন্ধানের ("আমার কাছাকাছি") ক্ষেত্রে স্থানাঙ্ক ব্যবহার করা হয়, কিন্তু নির্দিষ্ট বা অস্থানীয় অনুসন্ধানের ক্ষেত্রে সুস্পষ্ট অবস্থান দ্বারা প্রভাবিত হওয়ার সম্ভাবনা কম।Google Maps ফলাফল প্রক্রিয়াকরণ : মডেলটিGoogle Maps ফলাফল প্রক্রিয়াকরণ করে এবং মূল নির্দেশনার একটি প্রতিক্রিয়া তৈরি করে।Google Maps -ভিত্তিক ফলাফল প্রদান করে : মডেলটি একটি চূড়ান্ত, ব্যবহারকারী-বান্ধব প্রতিক্রিয়া প্রদান করে যাGoogle Maps ফলাফলের উপর ভিত্তি করে তৈরি। এই প্রতিক্রিয়ায় অন্তর্ভুক্ত থাকে:- মডেলের টেক্সট উত্তর।
- একটি
groundingMetadataঅবজেক্ট, যাতেGoogle Maps ফলাফল এবং উৎসগুলো রয়েছে। - (শুধুমাত্র ওয়েব এসডিকে-এর জন্য) ঐচ্ছিকভাবে একটি googleMapsWidgetContextToken, যা আপনাকে ভিজ্যুয়াল ইন্টারঅ্যাকশনের জন্য আপনার অ্যাপে একটি প্রাসঙ্গিক
Google Maps উইজেট রেন্ডার করতে দেয়। প্রাসঙ্গিক উইজেট সম্পর্কে আরও তথ্যের জন্য,Google Maps ডকুমেন্টেশনে "গ্রাউন্ডিং উইথGoogle Maps উইজেট" দেখুন।
উল্লেখ্য যে, মডেলে একটি টুল হিসেবে groundingMetadata অবজেক্ট থাকবে না এবং তাই এটি একটি
বাস্তব ফলাফলটি বুঝুন
যদি মডেলটি groundingMetadata অবজেক্ট অন্তর্ভুক্ত থাকে। এই অবজেক্টটিতে এমন কাঠামোগত ডেটা থাকে যা দাবি যাচাই করার জন্য এবং আপনার অ্যাপ্লিকেশনে একটি সমৃদ্ধ উৎস অভিজ্ঞতা তৈরি করার জন্য অপরিহার্য।
groundingMetadata অবজেক্টটিতে নিম্নলিখিত তথ্য থাকে:
-
groundingChunks: অবজেক্টের একটি অ্যারে, যেখানেmapsউৎসগুলো (uri,placeId, এবংtitle) থাকে। -
groundingSupports: মডেল রেসপন্সtextgroundingChunksএর সোর্সগুলোর সাথে সংযুক্ত করার জন্য চাঙ্কগুলোর একটি অ্যারে। প্রতিটি চাঙ্ক একটি টেক্সটsegment(যাstartIndexএবংendIndexদ্বারা সংজ্ঞায়িত) এক বা একাধিকgroundingChunkIndicesএর সাথে লিঙ্ক করে। এই ফিল্ডটি আপনাকে ইনলাইন সোর্স লিঙ্ক তৈরি করতে সাহায্য করে। এই পৃষ্ঠার পরবর্তী অংশে জানুন কীভাবে সার্ভিস ব্যবহারের প্রয়োজনীয়তাগুলো পূরণ করতে হয়। - (শুধুমাত্র ওয়েব এসডিকে-এর জন্য)
googleMapsWidgetContextToken: একটি টেক্সট টোকেন যা একটি প্রাসঙ্গিক প্লেসেস উইজেট রেন্ডার করতে ব্যবহার করা যেতে পারে। এই ফিল্ডটি শুধুমাত্র ওয়েব এসডিকে ব্যবহার করার সময় এবং যদি আপনিenableWidgetপ্যারামিটারটিtrueসেট করে থাকেন, তবেই ফেরত আসে।
এখানে একটি উদাহরণ প্রতিক্রিয়া দেওয়া হল, যাতে একটি groundingMetadata অবজেক্ট অন্তর্ভুক্ত রয়েছে:
{
"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"
}
}
],
"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]
}
],
"googleMapsWidgetContextToken": "widgetcontent/..."
}
}
]
}
পরিষেবা ব্যবহারের প্রয়োজনীয়তা
এই বিভাগে আপনার নির্বাচিত জেমিনি এপিআই প্রদানকারী— জেমিনি ডেভেলপার এপিআই অথবা ভার্টেক্স এআই জেমিনি এপিআই— এর জন্য গ্রাউন্ডিং উইথ
Google Maps ব্যবহারকারীদের উৎস সম্পর্কে অবহিত করুন।
প্রতিটি groundingChunks এ সেই সোর্সগুলো পাবেন যা প্রতিটি রেসপন্সকে সাপোর্ট করে। এছাড়াও নিম্নলিখিত মেটাডেটা ফেরত দেওয়া হয়:
- উৎস ইউআরআই
- শিরোনাম
- আইডি
আপনার অ্যাপে, ‘গ্রাউন্ডিং উইথ
Google Maps সোর্সগুলোকে অবশ্যই সেই সোর্স-সমর্থিত জেনারেটেড কন্টেন্টের ঠিক পরেই থাকতে হবে। এই জেনারেটেড কন্টেন্টকেGoogle Maps গ্রাউন্ডেড রেজাল্ট নামেও উল্লেখ করা হয়।Google Maps উৎসগুলো অবশ্যই একটিমাত্র ব্যবহারকারী ইন্টারঅ্যাকশনের মধ্যেই দেখার যোগ্য হতে হবে।
সুইফট
// ...
// Get the model's response
let text = response.text
// Get the grounding metadata
if let candidate = response.candidates.first,
let groundingMetadata = candidate.groundingMetadata {
// Get sources
let groundingChunks = groundingMetadata.groundingChunks
for chunk in groundingChunks {
if let maps = chunk.maps {
let title = maps.title // for example, "Heaven on 7th Marketplace"
let url = maps.url // for example, "https://maps.google.com/?cid=13100894621228039586"
let placeId = maps.placeId // for example, "places/ChIJ0-zA1vBZwokRon0fGj-6z7U"
// TODO(developer): show source in the UI
}
}
}
Kotlin
// ...
// Get the model's response
val text = response.text
// Get the grounding metadata
val groundingMetadata = response.candidates.firstOrNull()?.groundingMetadata
// Get sources
val groundingChunks = groundingMetadata?.groundingChunks
groundingChunks?.let { chunks ->
for (chunk in chunks) {
val title = chunk.maps?.title // for example, "Heaven on 7th Marketplace"
val uri = chunk.maps?.uri // for example, "https://maps.google.com/?cid=13100894621228039586"
val placeId = chunk.maps?.placeId // for example, "places/ChIJ0-zA1vBZwokRon0fGj-6z7U"
// TODO(developer): show source in the UI
}
}
Java
// ...
Futures.addCallback(response, new FutureCallback() {
@Override
public void onSuccess(GenerateContentResponse result) {
// Get the model's response
String text = result.getText();
// Get the grounding metadata
GroundingMetadata groundingMetadata =
result.getCandidates()[0].getGroundingMetadata();
if (groundingMetadata != null) {
// Get sources
List chunks = groundingMetadata.getGroundingChunks();
if (chunks != null) {
for(GroundingChunk chunk : chunks) {
GoogleMapsGroundingChunk maps = chunk.getMaps();
if (maps != null) {
String title = maps.getTitle(); // for example, "Heaven on 7th Marketplace"
String uri = maps.getUri(); // for example, "https://maps.google.com/?cid=13100894621228039586"
String placeId = maps.getPlaceId(); // for example, "places/ChIJ0-zA1vBZwokRon0fGj-6z7U"
// TODO(developer): show sources in the UI
}
}
}
}
}
@Override
public void onFailure(Throwable t) {
t.printStackTrace();
}
}, executor);
Web
// ...
// Get the model's text response
const text = result.response.text();
// Get the grounding metadata
const groundingMetadata = result.response.candidates?.[0]?.groundingMetadata;
// Get sources
const groundingChunks = groundingMetadata?.groundingChunks;
if (groundingChunks) {
for (const chunk of groundingChunks) {
const title = chunk.maps?.title; // for example, "Heaven on 7th Marketplace"
const uri = chunk.maps?.uri; // for example, "https://maps.google.com/?cid=13100894621228039586"
const placeId = chunk.maps?.placeId; // for example, "places/ChIJ0-zA1vBZwokRon0fGj-6z7U"
// TODO(developer): show sources in the UI
}
}
Dart
// ...
// Get the model's response
final text = response.text;
// Get the grounding metadata
final groundingMetadata = response.candidates.first.groundingMetadata;
// Get sources
final groundingChunks = groundingMetadata?.groundingChunks;
if (groundingChunks != null) {
for (var chunk in groundingChunks) {
final title = chunk.maps?.title; // for example, "Heaven on 7th Marketplace"
final uri = chunk.maps?.uri; // for example, "https://maps.google.com/?cid=13100894621228039586"
final placeId = chunk.maps?.placeId; // for example, "places/ChIJ0-zA1vBZwokRon0fGj-6z7U"
// TODO(developer): show sources in the UI
}
}
ঐক্য
// ...
// Get the model's response
var text = response.Text;
// Get the grounding metadata
var groundingMetadata = response.Candidates.First().GroundingMetadata;
// Get sources
if (groundingMetadata != null) {
foreach(GroundingChunk chunk in groundingMetadata?.GroundingChunks) {
if (chunk.Maps != null) {
var title = chunk.Maps?.Title; // for example, "Heaven on 7th Marketplace"
var uri = chunk.Maps?.Uri; // for example, "https://maps.google.com/?cid=13100894621228039586"
var placeId = chunk.Maps?.PlaceId; // for example, "places/ChIJ0-zA1vBZwokRon0fGj-6z7U"
// TODO(developer): show sources in the UI
}
}
}
Google Maps লিঙ্ক সহ Google Maps উৎসগুলি প্রদর্শন করুন
groundingChunks এর প্রতিটি সোর্সের জন্য, নিম্নলিখিত শর্তাবলী অনুসরণ করে একটি লিঙ্ক প্রিভিউ তৈরি করতে হবে:
-
Google Maps টেক্সট অ্যাট্রিবিউশন নির্দেশিকা অনুসরণ করে প্রতিটি উৎসের কৃতিত্বGoogle Maps কে দিন। - প্রতিক্রিয়ায় প্রদত্ত উৎসের শিরোনামটি প্রদর্শন করুন।
- রেসপন্স থেকে প্রাপ্ত
uriব্যবহার করে সোর্সের সাথে লিঙ্ক করুন।
আপনি উৎসগুলোর দৃশ্য সংকুচিত করতে পারেন।
ঐচ্ছিকভাবে, আপনি অতিরিক্ত বিষয়বস্তু দিয়ে লিঙ্ক প্রিভিউটিকে আরও উন্নত করতে পারেন, যেমন:
-
Google Maps টেক্সট অ্যাট্রিবিউশনের আগে একটিGoogle Maps ফেভিকন যুক্ত করা হয়েছে। - উৎস ইউআরএল (
og:image) থেকে প্রাপ্ত একটি ছবি।
Google Maps টেক্সট অ্যাট্রিবিউশন নির্দেশিকা
লেখার মধ্যে
Google Mapsলেখাটি কোনোভাবেই পরিবর্তন করবেন না:-
Google Mapsলেখাটির বড় হাতের অক্ষরের ব্যবহার পরিবর্তন করবেন না। -
Google Mapsলেখাটি একাধিক লাইনে রাখবেন না। -
Google Mapsলেখাটি অন্য কোনো ভাষায় স্থানীয়করণ করবেন না। - HTML অ্যাট্রিবিউট
translate="no"ব্যবহার করে ব্রাউজারকেGoogle Mapsলেখাটির অনুবাদ করা থেকে বিরত রাখুন।
-
নিম্নলিখিত সারণিতে বর্ণিত পদ্ধতি অনুসারে
Google Mapsটেক্সটটি স্টাইল করুন:সম্পত্তি শৈলী ফন্ট পরিবার রোবোটো। ফন্টটি লোড করা ঐচ্ছিক। ফলব্যাক ফন্ট পরিবার আপনার পণ্যে ইতিমধ্যে ব্যবহৃত যেকোনো স্যান্স সেরিফ বডি ফন্ট অথবা ডিফল্ট সিস্টেম ফন্ট চালু করার জন্য "Sans-Serif" ব্যবহার করুন। ফন্ট শৈলী স্বাভাবিক ফন্টের ওজন ৪০০ ফন্টের রঙ সাদা, কালো (#1F1F1F), অথবা ধূসর (#5E5E5E)। পটভূমির সাথে সুলভ (৪.৫:১) বৈসাদৃশ্য বজায় রাখুন। ফন্টের আকার সর্বনিম্ন ফন্ট সাইজ: ১২sp
সর্বোচ্চ ফন্ট সাইজ: ১৬sp
sp সম্পর্কে জানতে, ম্যাটেরিয়াল ডিজাইন ওয়েবসাইটে ফন্ট সাইজ ইউনিটস দেখুন।ব্যবধান স্বাভাবিক
উদাহরণ CSS
নিম্নলিখিত 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
‘গ্রাউন্ডিং উইথ গুগল ম্যাপস’-এর শর্তাবলীতে থাকা ক্যাশিং-এর উপর নিষেধাজ্ঞা এই ডেটার ক্ষেত্রে প্রযোজ্য নয়।
নিষিদ্ধ কার্যকলাপ এবং অঞ্চল
একটি নিরাপদ এবং নির্ভরযোগ্য প্ল্যাটফর্ম বজায় রাখার জন্য, গ্রাউন্ডিং উইথ
আপনি জরুরি প্রতিক্রিয়া পরিষেবা সহ উচ্চ ঝুঁকিপূর্ণ কার্যকলাপের জন্য
Google Maps সাথে গ্রাউন্ডিং ব্যবহার করবেন না।আপনি কোনো নিষিদ্ধ অঞ্চলে
Google Maps এর গ্রাউন্ডিং পরিষেবা প্রদানকারী আপনার অ্যাপ্লিকেশনটি বিতরণ বা বাজারজাত করবেন না। আরও তথ্যের জন্য, গুগল ম্যাপস প্ল্যাটফর্মের নিষিদ্ধ অঞ্চলসমূহ দেখুন। নিষিদ্ধ অঞ্চলসমূহের তালিকা সময়ে সময়ে হালনাগাদ করা হতে পারে।
Firebase কনসোলে বাস্তব ফলাফল এবং এআই পর্যবেক্ষণ
আপনি যদি Firebase কনসোলে AI মনিটরিং চালু করে থাকেন, তাহলে প্রাপ্ত প্রতিক্রিয়াগুলো Cloud Logging -এ সংরক্ষিত হয়। ডিফল্টরূপে, এই ডেটা ৩০ দিনের জন্য সংরক্ষিত থাকে।
এই ডেটা সংরক্ষণের সময়কাল, অথবা আপনার সেট করা যেকোনো কাস্টম সময়কাল, যেন আপনার নির্দিষ্ট ব্যবহারের ক্ষেত্র এবং আপনার নির্বাচিত Gemini API প্রদানকারী— Gemini Developer API বা Vertex AI Gemini API-এর জন্য প্রযোজ্য যেকোনো অতিরিক্ত কমপ্লায়েন্স প্রয়োজনীয়তার সাথে সম্পূর্ণরূপে সামঞ্জস্যপূর্ণ হয়, তা নিশ্চিত করা আপনার দায়িত্ব (পরিষেবা-নির্দিষ্ট শর্তাবলীর মধ্যে পরিষেবা শর্তাবলী বিভাগটি দেখুন)। এই প্রয়োজনীয়তাগুলো পূরণের জন্য আপনাকে ক্লাউড লগিং-এ ডেটা সংরক্ষণের সময়কাল সমন্বয় করতে হতে পারে।
মূল্য নির্ধারণ এবং হারের সীমা
আপনার নির্বাচিত Gemini API প্রদানকারীর ডকুমেন্টেশন ( Gemini Developer API |Vertex AI Gemini API ) থেকে Grounding with