আবহাওয়ার তথ্য দেখুন

lookup_weather টুলটি একটি LLM-কে কোনও লোকেশনের পরিবেশগত অবস্থা: আবহাওয়া, এয়ার কোয়ালিটি এবং পরাগরেণু সংক্রান্ত তথ্য পুনরুদ্ধার করতে দেয়। একটি অনুরোধের মাধ্যমে কোনও জায়গা আইডি, ঠিকানা বা অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেটের জন্য এক, দুই বা তিনটি পরিবেশগত ক্ষমতা কোয়েরি করা যেতে পারে।

শুধুমাত্র আবহাওয়া বা বর্তমান এবং পূর্বাভাসিত এয়ার কোয়ালিটি কোয়েরি করে এমন অনুরোধের জন্য Maps Grounding Essentials SKU-এর অধীনে বিল করা হয়। Pro-তে দৈনিক পরাগ পূর্বাভাস এবং ৩০ দিন পর্যন্ত পুরনো এয়ার কোয়ালিটি সংক্রান্ত তথ্য যোগ করা হয়।

আপনি MCP সার্ভারের মাধ্যমে বা lookupWeather REST পদ্ধতি হিসেবে lookup_weather কল করতে পারবেন। এই পৃষ্ঠায় এনভায়রনমেন্টাল ক্যাপাবিলিটি, অনুরোধের বিকল্প, Pro বিকল্প, রেসপন্স স্ট্রাকচার ও বিলিং সংক্রান্ত নিয়ম বর্ণনা করা হয়েছে। সম্পূর্ণ স্কিমার জন্য, lookup_weather MCP রেফারেন্স এবং lookupWeather REST রেফারেন্স দেখুন।

কেপেবিলিটি ও টাইম হরাইজন

কোন এনভায়রনমেন্টাল ডোমেন ফিরিয়ে দিতে হবে তা বেছে নিতে capabilities অ্যারে ব্যবহার করুন (WEATHER, AIR_QUALITY, POLLEN)। আপনি যখনই weather_options, air_quality_options বা language_code সেট করবেন, তখনই capabilities প্রয়োজন হবে। আপনি যদি capabilities, weather_options, air_quality_options এবং language_code বাদ দেন, তাহলে lookup_weather লিগ্যাসি ওয়েদার মোডে রান করে এবং ফ্ল্যাট টপ-লেভেল ওয়েদার ফিল্ডে ফিরে আসে।

অনুরোধ করা লোকেশনের স্থানীয় টাইম জোন অনুযায়ী সব date ও hour ভ্যালু মূল্যায়ন করা হয়। নিচের সারণীতে প্রতিটি ক্ষমতার জন্য কাজ করে এমন সময়সীমা এবং SKU-এর সংক্ষিপ্ত বিবরণ দেওয়া হল:

ক্ষমতা বর্তমান পরিস্থিতি (date এবং hour বাদ দেওয়া হয়েছে) আগের পরিস্থিতি পূর্বাভাস সংক্রান্ত শর্তাবলী SKU
WEATHER বর্তমান আবহাওয়া গত ২৪ ঘণ্টা পর্যন্ত (date ও hour, দুটিই প্রয়োজন; hour ছাড়া শুধু date কাজ করে না) hour সেট করা থাকলে ২৪০ ঘণ্টা (১০ দিন) পর্যন্ত প্রতি ঘণ্টার পূর্বাভাস, অথবা শুধুমাত্র date সেট করা থাকলে ১০ দিন পর্যন্ত দৈনিক পূর্বাভাস Essentials
AIR_QUALITY প্রতি ঘণ্টার বর্তমান এয়ার কোয়ালিটি date এবং hour সেট করা থাকলে, অতীতে সর্বাধিক ৭২০ ঘণ্টা (৩০ দিন) পর্যন্ত একটি ঘণ্টার জন্য, অথবা শুধুমাত্র date সেট করা থাকলে, আজকের আগে সর্বাধিক ২৯ দিন পর্যন্ত (সর্বাধিক ২৪টি প্রতি ঘণ্টার এন্ট্রি) date এবং hour সেট করা থাকলে, ভবিষ্যতে সর্বাধিক ৯৬ ঘণ্টা (৪ দিন) পর্যন্ত এক ঘণ্টার জন্য, অথবা শুধুমাত্র date সেট করা থাকলে, আজ থেকে শুরু করে তিন দিন পর পর্যন্ত (সর্বাধিক ২৪টি প্রতি ঘণ্টার এন্ট্রি) বর্তমান, আজকের সারাদিন এবং পূর্বাভাসের জন্য প্রয়োজনীয় তথ্য। উত্তরে date-এর জন্য Pro-এর উল্লেখ থাকলে, সেটি আজকের আগে বা অতীতে hour-এর সময় হতে হবে
POLLEN বর্তমান দিনের দৈনিক পরাগ পূর্বাভাস কাজ করে না (INVALID_ARGUMENT সমস্যা দেখায়) আজ থেকে শুরু করে আগামী ৪ দিন পর্যন্ত পরাগের দৈনিক পূর্বাভাস, আজ সহ ৫ দিনের জন্য (পরাগের জন্য hour উপেক্ষা করা হয়) উত্তরে Pro ফিরে এলে

AIR_QUALITY-এর জন্য, ৭২০-ঘণ্টা অতীত থেকে ৯৬-ঘণ্টা পূর্বাভাসের উইন্ডোটি বর্তমান ঘণ্টার সাথে অ্যাঙ্কর করা হয়েছে। সারাদিনের অনুরোধ (hour ছাড়া date) 00:00 থেকে 23:00 স্থানীয় সময় কভার করে এবং অবশ্যই সেই উইন্ডোর মধ্যে ফিট হতে হবে—বাস্তবে আজ থেকে ২৯ দিন আগে থেকে আজ থেকে তিন দিন পর পর্যন্ত।

কোনও অনুরোধে একাধিক ক্ষমতা অন্তর্ভুক্ত থাকলে, প্রতিটি ক্ষমতার টাইম হরাইজন স্বাধীনভাবে মূল্যায়ন করা হয়। অনুরোধ করা date এবং hour যদি অন্তত একটি অনুরোধ করা ক্ষমতার রেঞ্জের মধ্যে থাকে, তাহলে উত্তরে কাজ করে এমন ক্ষমতার কন্টেনার দেখানো হয় এবং যে ক্ষমতার সময়সীমা কাজ করে না তা বাদ দেওয়া হয়। যেমন, ৩০ দিনের মধ্যে কোনও পুরনো তারিখের জন্য AIR_QUALITY এবং POLLEN-এর অনুরোধ করলে airQuality রিটার্ন করে এবং pollen বাদ দেয়। অনুরোধ করা প্রতিটি ক্ষমতার অনুমোদিত রেঞ্জের বাইরে date বা hour থাকলে, INVALID_ARGUMENT অনুরোধটি একটি ত্রুটি দেখায়।

অনুরোধের বিকল্প

ব্যবহারকারীর অনুরোধ এবং টুলের বিবরণের উপর ভিত্তি করে, LLM টুল কল করার সময় এই বিকল্পগুলি সেট করে। আপনার নিজের নির্দেশাবলীর মাধ্যমে মডেল কোন বিকল্প ব্যবহার করবে তা আপনি প্রভাবিত করতে পারবেন; Pro ব্যবহার নিয়ন্ত্রণ করুন দেখুন।

নিম্নলিখিত সারণীতে lookup_weather-এর জন্য অনুরোধের বিকল্পগুলি বর্ণনা করা আছে:

Option বিবরণ
location প্রয়োজনীয়। কোয়েরি করার লোকেশন, address (মানুষের-পঠনযোগ্য ঠিকানা, শহর বা ল্যান্ডমার্কের নাম), place_id বা lat_lng (latitude এবং longitude) হিসেবে উল্লেখ করা হয়েছে।
capabilities ঐচ্ছিক। WEATHER, AIR_QUALITY এবং POLLEN থেকে এক বা একাধিক মান। ডুপ্লিকেট ভ্যালু ডিডুপ্লিকেট করা হয়েছে। weather_options, air_quality_options অথবা language_code সেট করার সময় প্রয়োজন। capabilities এবং সেইসব বিকল্প বাদ দেওয়া হলে, লিগ্যাসি ফ্ল্যাট-ফিল্ড আবহাওয়া সংক্রান্ত উত্তর ফেরত দেয়।
date ঐচ্ছিক। অনুরোধ করা লোকেশনে স্থানীয় সিভিল তারিখ (year, month, day)। বর্তমান পরিস্থিতির জন্য date এবং hour বাদ দিন।
hour ঐচ্ছিক। অনুরোধ করা লোকেশনের স্থানীয় সময় (0 থেকে 23)। date সেট করতে হবে। date ছাড়া hour সেট করলে INVALID_ARGUMENT সমস্যা দেখা দেয়।
language_code ঐচ্ছিক। উত্তরে লোকালাইজ করা টেক্সটের জন্য BCP-47 ভাষা কোড, যেমন en, ja বা fr-CA। ডিফল্ট হিসেবে en সেট করা থাকে।
weather_options.units_system ঐচ্ছিক। আবহাওয়ার ভ্যালুর জন্য ইউনিট সিস্টেম: METRIC (ডিফল্ট; সেলসিয়াস, কিলোমিটার প্রতি ঘণ্টা, মিলিমিটার) অথবা IMPERIAL (ফারেনহাইট, মাইল প্রতি ঘণ্টা, ইঞ্চি)। WEATHER-এর অনুরোধ না করা হলে এড়িয়ে যাওয়া হয়।
air_quality_options.include_pollutant_concentration ঐচ্ছিক। true, airQuality.hourlyResults[].pollutants[]-এ দূষণকারী উপাদানের ঘনত্ব, নির্গমনের উৎস ও স্বাস্থ্যের উপর প্রভাবের পরিমাপ অন্তর্ভুক্ত থাকে। ডিফল্ট হিসেবে false সেট করা থাকে। AIR_QUALITY-এর অনুরোধ না করা হলে এড়িয়ে যাওয়া হয়।
air_quality_options.index_region_code ঐচ্ছিক। দুই-অক্ষরের ISO 3166-1 alpha-2 দেশ বা অঞ্চলের কোড—যেমন, US, FR, বা CN—ইউনিভার্সাল AQI (UAQI)-এর পাশাপাশি স্থানীয় এয়ার কোয়ালিটি সংক্রান্ত ইন্ডেক্স (AQI) স্কেল বেছে নিতে ব্যবহার করা হয়। অনুরোধ করা লোকেশনের অঞ্চল ডিফল্ট হিসেবে সেট করা হয়। AIR_QUALITY-এর অনুরোধ না করা হলে এড়িয়ে যাওয়া হয়।

Pro বিকল্প

দুটি বিকল্প Maps Grounding Pro SKU বেছে নেয়। উত্তরে যেকোনও একটি বিকল্প ফেরত দেওয়া হলে, Pro SKU-এর অধীনে একটি অনুরোধের জন্য বিল করা হয়। মাল্টি-ক্যাপাবিলিটি বিলিং সংক্রান্ত নিয়মের জন্য, বিলিং ও কোটা দেখুন। নিম্নলিখিত সারণীতে Pro বিকল্পের বিবরণ দেওয়া আছে:

Pro বিকল্প কখন ব্যবহার করবেন
capabilities-এ POLLEN ব্যবহারকারী পরাগের মাত্রা, ঋতুভিত্তিক অ্যালার্জি, গাছ, ঘাস বা আগাছার পরাগ বা নির্দিষ্ট অ্যালার্জেনিক উদ্ভিদের প্রজাতি সম্পর্কে জিজ্ঞাসা করেন।
AIR_QUALITY-এ capabilities-এর মধ্যে date-এর সাথে আজকের আগে বা অতীতে hour ব্যবহারকারী লোকেশনের টাইম জোনে গত ৩০ দিনের এয়ার কোয়ালিটি, ধোঁয়া বা দূষণের ইতিহাস সম্পর্কে জিজ্ঞাসা করেছেন।

অন্যান্য সব lookup_weather অনুরোধের জন্য Essentials SKU-এর অধীনে বিল করা হয়, যার মধ্যে এগুলি অন্তর্ভুক্ত:

  • সব WEATHER অনুরোধ (বর্তমান, ২৪-ঘণ্টার ইতিহাস এবং ১০-দিনের প্রতি ঘণ্টা বা দৈনিক পূর্বাভাস)।
  • বর্তমান, আজকের পুরো দিন (hour ছাড়া date আজকের জন্য সেট করা হয়েছে) এবং পূর্বাভাস AIR_QUALITYটি অনুরোধ, যার মধ্যে include_pollutant_concentration-কে true-এ সেট করা বা index_region_code নির্দিষ্ট করার অনুরোধ অন্তর্ভুক্ত।

উদাহরণ

নিম্নলিখিত MCP অনুরোধে টোকিওর বর্তমান আবহাওয়া, এয়ার কোয়ালিটি (দূষণকারীর ঘনত্ব সহ) এবং আজকের পরাগের পূর্বাভাস চাওয়া হয়েছে। যেহেতু capabilities-এ POLLEN অন্তর্ভুক্ত আছে, তাই Pro SKU-এর অধীনে অনুরোধের বিল করা হয়:

{
  "method": "tools/call",
  "params": {
    "name": "lookup_weather",
    "arguments": {
      "location": {"address": "Tokyo, Japan"},
      "capabilities": ["WEATHER", "AIR_QUALITY", "POLLEN"],
      "weather_options": {
        "units_system": "METRIC"
      },
      "air_quality_options": {
        "include_pollutant_concentration": true
      },
      "language_code": "en"
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

নিম্নলিখিত উদাহরণটি lookupWeather REST পদ্ধতিতে একই অনুরোধ পাঠায়:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-d '{
  "location": {"address": "Tokyo, Japan"},
  "capabilities": ["WEATHER", "AIR_QUALITY", "POLLEN"],
  "weatherOptions": {"unitsSystem": "METRIC"},
  "airQualityOptions": {"includePollutantConcentration": true},
  "languageCode": "en"
}' \
"https://mapstools.googleapis.com/v1:lookupWeather"

API_KEY-এর জায়গায় আপনার API key লিখুন।

রেসপন্স

কোনও অনুরোধে capabilities নির্দিষ্ট করা থাকলে, লোকেশন মেটাডেটার পাশাপাশি প্রতিটি অনুরোধ করা ক্ষমতার জন্য উত্তরে ডোমেন-নির্দিষ্ট কন্টেনার পপুলেট করা হয়:

  • returnedLocation: পরিবেশগত ডেটার জন্য সমাধান করা লোকেশন (address, placeId, অথবা latLng, ইনপুট location ধরনের সাথে ম্যাচ করছে)।
  • timeZone: লোকেশনের জন্য সমাধান করা IANA টাইম জোন শনাক্তকারী, যেমন "America/Los_Angeles" বা "Asia/Tokyo"।
  • weather: WEATHER-এর অনুরোধ করা হলে পপুলেট করা হয়:
    • dateTime (বর্তমান ও প্রতি ঘণ্টার কোয়েরির জন্য), UTC টাইমস্ট্যাম্প হিসেবে, অথবা date (দৈনিক পূর্বাভাসের কোয়েরির জন্য)। স্থানীয় সময় দেখাতে, timeZone ফিল্ডের সাথে dateTime কনভার্ট করুন।
    • তাপমাত্রা (temperature, feelsLikeTemperature, heatIndex, অথবা দৈনিক maxTemperature, minTemperature, feelsLikeMaxTemperature, feelsLikeMinTemperature, maxHeatIndex).
    • weatherCondition, precipitation, wind, airPressure, relativeHumidity, uvIndex, thunderstormProbability, cloudCover, এবং দৈনিক sunEvents ও moonEvents। সূর্যোদয়, সূর্যাস্ত, চন্দ্রোদয় ও চন্দ্রাস্তের সময় UTC টাইমস্ট্যাম্পে দেখানো হয়।
    • attribution: অ্যাট্রিবিউশন যা আপনাকে অবশ্যই আবহাওয়ার ডেটার সাথে দেখাতে হবে।
  • airQuality: AIR_QUALITY-এর অনুরোধ করা হলে পপুলেট করা হয়:
    • hourlyResults[]: বর্তমান বা এক ঘণ্টার কোয়েরির জন্য একটি এন্ট্রি বা সম্পূর্ণ স্থানীয় দিন (00:00 থেকে 23:00) কভার করে এমন ২৪টি পর্যন্ত এন্ট্রি থাকে, যখন শুধুমাত্র date সেট করা থাকে। date আজকের তারিখ হলে এবং hour বাদ দেওয়া হলে, এন্ট্রিতে আজকের দিনের আগের ঐতিহাসিক ঘণ্টা, বর্তমান ঘণ্টা এবং বাকি পূর্বাভাস ঘণ্টা একত্রিত করা হয়। প্রতিটি এন্ট্রিতে এগুলি অন্তর্ভুক্ত থাকে:
      • dateTime: লোকেশনের টাইম জোনে স্থানীয় সিভিল তারিখ ও সময় (year, month, day, hours, minutes, seconds এবং utcOffset)।
      • indexes[]: ইউনিভার্সাল AQI এবং উপলভ্য থাকলে স্থানীয় AQI (displayName, value, valueDisplay, category এবং dominantPollutant)।
      • pollutants[]: include_pollutant_concentration-এর মান true হলে displayName, fullName, concentration-এর মান ppb বা µg/m³-এ এবং additionalInfo-এর মান নির্গমন sources ও স্বাস্থ্য effects-এ পপুলেট করা হয়।
      • healthRecommendations: generalPopulation, elderly, lungDiseasePopulation, heartDiseasePopulation, athletes, pregnantWomen এবং children-এর জন্য নির্দেশিকা।
    • attribution: এয়ার কোয়ালিটি ডেটার সাথে আপনাকে অবশ্যই অ্যাট্রিবিউশন দেখাতে হবে।
  • pollen: POLLEN-এর অনুরোধ করা হলে পপুলেট করা হয়:
    • dailyForecast: অনুরোধ করা date-এর জন্য পরাগরেণুর পূর্বাভাস:
      • date: পূর্বাভাসের সিভিল ক্যালেন্ডার তারিখ।
      • categories[]: অ্যালার্জেন সংক্রান্ত বিস্তৃত বিভাগ (Tree, Grass এবং Weed), যার প্রত্যেকটিতে displayName, inSeason, ইউনিভার্সাল পোলেন ইনডেক্স index (0 থেকে 5 স্কেল, category এবং description) এবং healthRecommendations[] আছে।
      • plantSpecies[]: নির্দিষ্ট অ্যালার্জেনিক উদ্ভিদের প্রজাতি (যেমন বার্চ, র‍্যাগউইড বা জাপানি সিডার), যার প্রতিটিতে code, displayName, বোটানিক্যাল family, inSeason, ইউনিভার্সাল পোলেন ইনডেক্স index, সাধারণ ব্লুমিং season এবং crossReactions আছে।
    • attribution: পরাগ সংক্রান্ত ডেটার সাথে আপনাকে অবশ্যই অ্যাট্রিবিউশন দেখাতে হবে।

বিভিন্ন ক্ষমতা জুড়ে আংশিক উপলভ্যতা

কোনও অনুরোধে একাধিক ক্ষমতা অন্তর্ভুক্ত থাকলে, প্রতিটি ক্ষমতা স্বাধীনভাবে মূল্যায়ন করা হয় এবং ফেচ করা হয়। অনুরোধ করা লোকেশনের জন্য কোনও একটি ক্ষমতা উপলভ্য না থাকলে, এর কাজ করার সময়সীমার বাইরে থাকলে অথবা অন্তত অন্য একটি ক্ষমতা কাজ করার সময় সাময়িকভাবে ব্যর্থ হলে, উত্তরে উপলভ্য ক্ষমতার কন্টেনার দেখানো হয় এবং অনুপলভ্য বা ব্যর্থ কন্টেনার বাদ দেওয়া হয়। অনুরোধ করা প্রতিটি ক্ষমতা কাজ না করলে তবেই অনুরোধে সমস্যা দেখা দেয়।

ফিল্ডের সম্পূর্ণ বিবরণ জানতে, lookup_weather রেফারেন্স দেখুন।

বিলিং ও কোটা

প্রতিটি lookup_weather অনুরোধ হল একটি বিলেবল ইভেন্ট, এমনকি যখন capabilities একই কলে দুই বা তিনটি এনভায়রনমেন্টাল ডোমেনের অনুরোধ করে:

  • কোনও অনুরোধের বিল সর্বোচ্চ SKU টিয়ার-এর অধীনে করা হয়, যা সফল হয় এবং উত্তরে ফেরত দেওয়া হয়:
    • উত্তরে pollen বা ঐতিহাসিক airQuality (আজকের আগে কোনও date বা লোকেশনের টাইম জোনে কোনও অতীত hour) থাকলে, অনুরোধের জন্য Maps Grounding Pro SKU-এর অধীনে বিল করা হয়। একটি কলে POLLEN এবং ঐতিহাসিক AIR_QUALITY, দুটির জন্য অনুরোধ করা হলে, সেটি এখনও একটি Pro বিলযোগ্য ইভেন্ট হিসেবে গণনা করা হয়।
    • অন্যথায়, অনুরোধের জন্য Maps Grounding Essentials SKU-এর অধীনে বিল করা হয়।
  • একাধিক ক্ষমতা সংক্রান্ত অনুরোধে যদি কোনও Pro ক্ষমতা বাদ দেওয়া হয়—কারণ এটি লোকেশন, তার সমর্থিত সময়সীমার বাইরে বা ক্ষণস্থায়ীভাবে ব্যর্থ হওয়ার কারণে অনুপলভ্য—এবং উত্তরে শুধুমাত্র Essentials ক্ষমতা ফেরত দেওয়া হয়, তাহলে অনুরোধটি Essentials SKU-এর অধীনে বিল করা হয়।

lookup_weather কোটা হল প্রতিটি প্রোজেক্টের জন্য প্রতি মিনিটে ৩০০টি কোয়েরি, যা দুটি SKU-এর মাধ্যমে শেয়ার করা হয়। মূল্য সংক্রান্ত তথ্যের জন্য, মূল মূল্য সারণী এবং ভারতের মূল্য সারণী দেখুন।