Method: lookupWeather

কোনও লোকেশনের আবহাওয়ার পরিস্থিতি সম্পর্কে সার্চ করুন।

HTTP অনুরোধ

POST https://mapstools.googleapis.com/v1alpha:lookupWeather

URL-এ gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়।

অনুরোধের বডি

অনুরোধের প্রধান অংশে নিম্নলিখিত স্ট্রাকচার সহ ডেটা থাকে:

JSON উপস্থাপনা
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
ফিল্ড
unitsSystem

enum (UnitsSystem)

ঐচ্ছিক। ফেরত পাঠানো আবহাওয়ার পরিস্থিতির জন্য ব্যবহার করার ইউনিট সিস্টেম। উল্লেখ করা না থাকলে, আবহাওয়ার অবস্থা মেট্রিক সিস্টেমে দেখানো হবে (ডিফল্ট = METRIC)।

location

object (Location)

প্রয়োজনীয়। যে লোকেশনের আবহাওয়ার পরিস্থিতি জানতে চান।

capabilities[]

enum (Capability)

ঐচ্ছিক। উত্তরে অন্তর্ভুক্ত করার জন্য পরিবেশগত ক্ষমতা।

date

object (Date)

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

hour

integer

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

languageCode

string

ঐচ্ছিক। উত্তরে লোকালাইজ করা টেক্সটের জন্য BCP-47 ভাষা কোড (যেমন, "en", "ja", "fr-CA")। উল্লেখ করা না থাকলে "en" হল ডিফল্ট।

weatherOptions

object (WeatherOptions)

ঐচ্ছিক। আবহাওয়া সংক্রান্ত অনুরোধের জন্য নির্দিষ্ট বিকল্প। weatherOptions.units_system, টপ-লেভেল unitsSystem (ট্যাগ ৪)-এর সাথে কাজ করে যাতে আগে থেকে থাকা কলারের জন্য ব্যাকওয়ার্ড কম্প্যাটিবিলিটি বজায় রাখা যায়; দুটিই যদি পরস্পরবিরোধী ইউনিট সিস্টেম উল্লেখ করে, তাহলে INVALID_ARGUMENT রিটার্ন করে। capabilities-এ WEATHER-এর অনুরোধ না করা হলে এড়িয়ে যাওয়া হয়।

airQualityOptions

object (AirQualityOptions)

ঐচ্ছিক। এয়ার কোয়ালিটি সংক্রান্ত অনুরোধের জন্য নির্দিষ্ট বিকল্প। capabilities-এ AIR_QUALITY-এর অনুরোধ না করা হলে এড়িয়ে যাওয়া হয়।

প্রতিক্রিয়ার বডি

সফল হলে, প্রতিক্রিয়ার বডিতে একটি LookupWeatherResponse-এর ইন্সট্যান্স থাকে।

অনুমোদনের স্কোপ

এটির জন্য নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/maps-platform.mapstools