Method: forecast.lookup

1 কিমি রেজোলিউশন পর্যন্ত 65টিরও বেশি দেশে 5 দিন পর্যন্ত দৈনিক পরাগ তথ্য প্রদান করে।

HTTP অনুরোধ

GET https://pollen.googleapis.com/v1/forecast:lookup

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

ক্যোয়ারী প্যারামিটার

পরামিতি
location

object ( LatLng )

প্রয়োজন। দ্রাঘিমাংশ এবং অক্ষাংশ যেখান থেকে API পরাগ পূর্বাভাসের ডেটা অনুসন্ধান করে৷

days

integer

প্রয়োজন। একটি সংখ্যা যা নির্দেশ করে কতগুলি পূর্বাভাসের দিন অনুরোধ করতে হবে (ন্যূনতম মান 1, সর্বোচ্চ মান 5)।

pageSize

integer

ঐচ্ছিক। প্রতি পৃষ্ঠায় ফেরার জন্য দৈনিক তথ্য রেকর্ডের সর্বোচ্চ সংখ্যা। ডিফল্ট এবং সর্বোচ্চ মান হল 5, 5 দিনের ডেটা নির্দেশ করে৷

pageToken

string

ঐচ্ছিক। আগের দৈনিক কল থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। এটি পরবর্তী পৃষ্ঠা পুনরুদ্ধার করতে ব্যবহৃত হয়।

মনে রাখবেন যে পৃষ্ঠা টোকেনের জন্য একটি মান প্রদান করার সময়, প্রদত্ত অন্যান্য সমস্ত অনুরোধের পরামিতি অবশ্যই পূর্ববর্তী কলের সাথে মেলে যা পৃষ্ঠা টোকেন প্রদান করেছে।

languageCode

string

ঐচ্ছিক। ক্লায়েন্টকে প্রতিক্রিয়ার জন্য ভাষা বেছে নেওয়ার অনুমতি দেয়। যদি সেই ভাষার জন্য ডেটা প্রদান করা না যায়, তাহলে API সবচেয়ে কাছের মিল ব্যবহার করে। অনুমোদিত মান IETF BCP-47 স্ট্যান্ডার্ডের উপর নির্ভর করে। ডিফল্ট মান হল "en"।

plantsDescription

boolean

ঐচ্ছিক। গাছপালা সম্পর্কে সাধারণ তথ্য রয়েছে, যার মধ্যে রয়েছে তাদের ঋতুগত বিবরণ, বিশেষ আকার এবং রঙ, অ্যালার্জির ক্রস-প্রতিক্রিয়া সম্পর্কে তথ্য এবং উদ্ভিদের ফটো। ডিফল্ট মান হল "সত্য"।

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "regionCode": string,
  "dailyInfo": [
    {
      object (DayInfo)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
regionCode

string

অনুরোধে প্রদত্ত অবস্থানের সাথে সংশ্লিষ্ট দেশ/অঞ্চলের ISO_3166-1 আলফা-2 কোড। এই ক্ষেত্রটি প্রতিক্রিয়া থেকে বাদ দেওয়া হতে পারে যদি অনুরোধে দেওয়া অবস্থানটি একটি বিতর্কিত অঞ্চলে থাকে।

dailyInfo[]

object ( DayInfo )

প্রয়োজন। এই বস্তুটিতে অনুরোধ করা প্রতিটি দিনের জন্য দৈনিক পূর্বাভাসের তথ্য রয়েছে।

nextPageToken

string

ঐচ্ছিক। পরবর্তী পৃষ্ঠা পুনরুদ্ধার করার টোকেন।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/cloud-platform

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

LatLng

একটি বস্তু যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া প্রতিনিধিত্ব করে। এটি ডিগ্রী অক্ষাংশ এবং ডিগ্রী দ্রাঘিমাংশের প্রতিনিধিত্ব করার জন্য এক জোড়া দ্বিগুণ হিসাবে প্রকাশ করা হয়। অন্যথায় নির্দিষ্ট করা না থাকলে, এই বস্তুটিকে অবশ্যই WGS84 মান মেনে চলতে হবে। মানগুলি অবশ্যই স্বাভাবিক সীমার মধ্যে থাকতে হবে৷

JSON প্রতিনিধিত্ব
{
  "latitude": number,
  "longitude": number
}
ক্ষেত্র
latitude

number

ডিগ্রী অক্ষাংশ. এটি অবশ্যই [-90.0, +90.0] এর মধ্যে হতে হবে।

longitude

number

ডিগ্রী দ্রাঘিমাংশ. এটি অবশ্যই [-180.0, +180.0] পরিসরে হতে হবে।

দিনের তথ্য

এই বস্তুটিতে অনুরোধ করা প্রতিটি দিনের জন্য দৈনিক পূর্বাভাসের তথ্য রয়েছে।

JSON প্রতিনিধিত্ব
{
  "date": {
    object (Date)
  },
  "pollenTypeInfo": [
    {
      object (PollenTypeInfo)
    }
  ],
  "plantInfo": [
    {
      object (PlantInfo)
    }
  ]
}
ক্ষেত্র
date

object ( Date )

UTC-তে যে তারিখে পরাগ পূর্বাভাসের ডেটা উপস্থাপন করা হয়।

pollenTypeInfo[]

object ( PollenTypeInfo )

এই তালিকায় তিনটি পরাগ প্রকার (GRASS, WEED, TREE) অন্তর্ভুক্ত থাকবে যা অনুরোধে উল্লেখিত অবস্থানকে প্রভাবিত করে।

plantInfo[]

object ( PlantInfo )

এই তালিকায় 15টি পর্যন্ত পরাগ প্রজাতি অন্তর্ভুক্ত থাকবে যা অনুরোধে উল্লেখিত অবস্থানকে প্রভাবিত করে।

তারিখ

একটি সম্পূর্ণ বা আংশিক ক্যালেন্ডার তারিখ প্রতিনিধিত্ব করে, যেমন একটি জন্মদিন। দিনের সময় এবং সময় অঞ্চল হয় অন্য কোথাও নির্দিষ্ট করা হয়েছে বা নগণ্য। তারিখটি গ্রেগরিয়ান ক্যালেন্ডারের সাথে সম্পর্কিত। এটি নিম্নলিখিতগুলির মধ্যে একটি প্রতিনিধিত্ব করতে পারে:

  • একটি সম্পূর্ণ তারিখ, অ-শূন্য বছর, মাস এবং দিনের মান সহ।
  • একটি মাস এবং দিন, একটি শূন্য বছর সহ (উদাহরণস্বরূপ, একটি বার্ষিকী)।
  • একটি শূন্য মাস এবং একটি শূন্য দিন সহ একটি বছর নিজেই।
  • একটি বছর এবং মাস, একটি শূন্য দিন সহ (উদাহরণস্বরূপ, একটি ক্রেডিট কার্ডের মেয়াদ শেষ হওয়ার তারিখ)।

সম্পর্কিত প্রকার:

JSON প্রতিনিধিত্ব
{
  "year": integer,
  "month": integer,
  "day": integer
}
ক্ষেত্র
year

integer

তারিখের বছর। একটি বছর ছাড়া একটি তারিখ নির্দিষ্ট করতে 1 থেকে 9999, বা 0 হতে হবে।

month

integer

এক বছরের মাস। একটি মাস এবং দিন ছাড়া একটি বছর নির্দিষ্ট করতে 1 থেকে 12, বা 0 হতে হবে৷

day

integer

এক মাসের দিন। 1 থেকে 31 পর্যন্ত হতে হবে এবং বছর এবং মাসের জন্য বৈধ হতে হবে, অথবা 0 নিজে থেকে একটি বছর বা একটি বছর এবং মাস উল্লেখ করতে হবে যেখানে দিনটি তাৎপর্যপূর্ণ নয়৷

PollenTypeInfo

এই বস্তুর মধ্যে পরাগ প্রকারের সূচক এবং নির্দিষ্ট পরাগ প্রকারের স্বাস্থ্য সুপারিশ তথ্য রয়েছে।

JSON প্রতিনিধিত্ব
{
  "code": enum (PollenType),
  "displayName": string,
  "indexInfo": {
    object (IndexInfo)
  },
  "healthRecommendations": [
    string
  ],
  "inSeason": boolean
}
ক্ষেত্র
code

enum ( PollenType )

পরাগ প্রকারের কোড নাম। যেমন: "গ্রাস"

displayName

string

পরাগ টাইপ নামের একটি মানুষের পাঠযোগ্য উপস্থাপনা। উদাহরণ: "ঘাস"

indexInfo

object ( IndexInfo )

পরাগের প্রকারের জন্য ইউনিভার্সাল পরাগ সূচক (UPI) ডেটা রয়েছে।

healthRecommendations[]

string

বর্তমান পরাগ স্তরের উপর ভিত্তি করে স্বাস্থ্যের অন্তর্দৃষ্টি সম্পর্কিত ব্যাখ্যাগুলির পাঠ্য তালিকা।

inSeason

boolean

উদ্ভিদটি ঋতুতে আছে কিনা তা নির্দেশ করুন।

পরাগ প্রকার

পরাগ টাইপ কোড

Enums
POLLEN_TYPE_UNSPECIFIED অনির্দিষ্ট উদ্ভিদ প্রকার।
GRASS ঘাস পরাগ টাইপ।
TREE গাছের পরাগ প্রকার।
WEED আগাছা পরাগ প্রকার।

ইনডেক্স ইনফো

এই বস্তুতে নির্দিষ্ট পরাগ সূচক মান, বিভাগ এবং বিবরণ প্রতিনিধিত্বকারী ডেটা রয়েছে।

JSON প্রতিনিধিত্ব
{
  "code": enum (Index),
  "displayName": string,
  "category": string,
  "indexDescription": string,
  "color": {
    object (Color)
  },
  "value": integer
}
ক্ষেত্র
code

enum ( Index )

সূচক এর কোড. এই ক্ষেত্রটি স্পেসের পরিবর্তে স্নেক কেস ব্যবহার করে প্রোগ্রামিং উদ্দেশ্যে সূচকের প্রতিনিধিত্ব করে। উদাহরণ: "UPI"।

displayName

string

সূচক নামের একটি মানুষের পাঠযোগ্য উপস্থাপনা। উদাহরণ: "ইউনিভার্সাল পরাগ সূচক"।

category

string

সূচক সংখ্যাসূচক স্কোর ব্যাখ্যার পাঠ্য শ্রেণিবিন্যাস। সূচকটি ছয়টি বিভাগ নিয়ে গঠিত:

  • 0: "কিছুই নয়"
  • 1: "খুব কম"
  • 2: "নিম্ন"
  • 3: "মধ্যম"
  • 4: "উচ্চ"
  • 5: "খুব উচ্চ
indexDescription

string

বর্তমান সূচক স্তরের পাঠ্য ব্যাখ্যা।

color

object ( Color )

পরাগ সূচক সংখ্যাসূচক স্কোর প্রতিনিধিত্ব করতে ব্যবহৃত রঙ।

value

integer

সূচকের সংখ্যাসূচক স্কোর। সাংখ্যিক পরিসর 0 থেকে 5 এর মধ্যে।

সূচক

সূচক কোড

Enums
INDEX_UNSPECIFIED অনির্দিষ্ট সূচক।
UPI সার্বজনীন পরাগ সূচক।

রঙ

RGBA রঙের জায়গায় একটি রঙের প্রতিনিধিত্ব করে। এই উপস্থাপনাটি কম্প্যাক্টনেসের উপর বিভিন্ন ভাষায় রঙের উপস্থাপনা থেকে এবং রূপান্তরের সরলতার জন্য ডিজাইন করা হয়েছে। উদাহরণস্বরূপ, এই উপস্থাপনার ক্ষেত্রগুলি জাভাতে java.awt.Color এর কন্সট্রাকটরকে তুচ্ছভাবে প্রদান করা যেতে পারে; এটি তুচ্ছভাবে UIColor এর +colorWithRed:green:blue:alpha পদ্ধতিতেও প্রদান করা যেতে পারে iOS এ; এবং, সামান্য পরিশ্রমের মাধ্যমে, এটি সহজেই জাভাস্ক্রিপ্টের একটি CSS rgba() স্ট্রিং-এ ফরম্যাট করা যায়।

এই রেফারেন্স পৃষ্ঠাটিতে সম্পূর্ণ রঙের স্থান সম্পর্কে তথ্য নেই যা RGB মানকে ব্যাখ্যা করতে ব্যবহার করা উচিত—উদাহরণস্বরূপ, sRGB, Adobe RGB, DCI-P3, এবং BT.2020। ডিফল্টরূপে, অ্যাপ্লিকেশনগুলিকে sRGB রঙের স্থান অনুমান করা উচিত।

যখন রঙের সমতার সিদ্ধান্ত নেওয়ার প্রয়োজন হয়, তখন বাস্তবায়নগুলি, যদি না অন্যথায় নথিভুক্ত করা হয়, দুটি রঙকে সমান হিসাবে বিবেচনা করুন যদি তাদের সমস্ত লাল, সবুজ, নীল এবং আলফা মান প্রতিটির মধ্যে সর্বাধিক 1e-5 দ্বারা পৃথক হয়।

উদাহরণ (জাভা):

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

উদাহরণ (iOS / Obj-C):

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

উদাহরণ (জাভাস্ক্রিপ্ট):

// ...

var protoToCssColor = function(rgb_color) {
   var redFrac = rgb_color.red || 0.0;
   var greenFrac = rgb_color.green || 0.0;
   var blueFrac = rgb_color.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgb_color)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgb_color.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
JSON প্রতিনিধিত্ব
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
ক্ষেত্র
red

number

ব্যবধানে একটি মান হিসাবে লাল রঙের পরিমাণ [0, 1]।

green

number

ব্যবধানে একটি মান হিসাবে রঙে সবুজের পরিমাণ [0, 1]।

blue

number

ব্যবধানে একটি মান হিসাবে নীল রঙের পরিমাণ [0, 1]।

alpha

number

এই রঙের ভগ্নাংশ যে পিক্সেল প্রয়োগ করা উচিত. অর্থাৎ, চূড়ান্ত পিক্সেল রঙ সমীকরণ দ্বারা সংজ্ঞায়িত করা হয়:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

এর মানে হল যে 1.0 এর মান একটি কঠিন রঙের সাথে মিলে যায়, যেখানে 0.0 এর মান সম্পূর্ণ স্বচ্ছ রঙের সাথে মিলে যায়। এটি একটি সাধারণ ফ্লোট স্কেলারের পরিবর্তে একটি র‍্যাপার বার্তা ব্যবহার করে যাতে এটি একটি ডিফল্ট মান এবং সেট না থাকা মানটির মধ্যে পার্থক্য করা সম্ভব হয়। যদি বাদ দেওয়া হয়, এই রঙের বস্তুটিকে একটি কঠিন রঙ হিসাবে রেন্ডার করা হয় (যেন আলফা মানটি স্পষ্টভাবে 1.0 এর মান দেওয়া হয়েছে)।

উদ্ভিদ তথ্য

এই বস্তুটিতে নির্দিষ্ট উদ্ভিদের দৈনিক তথ্য রয়েছে।

JSON প্রতিনিধিত্ব
{
  "code": enum (Plant),
  "displayName": string,
  "indexInfo": {
    object (IndexInfo)
  },
  "plantDescription": {
    object (PlantDescription)
  },
  "inSeason": boolean
}
ক্ষেত্র
code

enum ( Plant )

উদ্ভিদ কোড নাম. যেমন: "কটনউড"। সমস্ত উপলব্ধ কোডের একটি তালিকা এখানে পাওয়া যেতে পারে.

displayName

string

উদ্ভিদ নামের একটি মানুষের পাঠযোগ্য উপস্থাপনা। উদাহরণ: "কটনউড"।

indexInfo

object ( IndexInfo )

এই বস্তুতে নির্দিষ্ট পরাগ সূচক মান, বিভাগ এবং বিবরণ প্রতিনিধিত্বকারী ডেটা রয়েছে।

plantDescription

object ( PlantDescription )

গাছপালা সম্পর্কে সাধারণ তথ্য রয়েছে, যার মধ্যে রয়েছে তাদের ঋতুগত বিবরণ, বিশেষ আকার এবং রঙ, অ্যালার্জির ক্রস-প্রতিক্রিয়া সম্পর্কে তথ্য এবং উদ্ভিদের ফটো।

inSeason

boolean

গাছটি ঋতুতে আছে বা নেই তার ইঙ্গিত।

উদ্ভিদ

বিভিন্ন স্থান জুড়ে বিভিন্ন প্রাপ্যতা সহ উপলব্ধ উদ্ভিদের তালিকা করুন।

Enums
PLANT_UNSPECIFIED অনির্দিষ্ট উদ্ভিদ কোড.
ALDER Alder একটি গাছ পরাগ টাইপ হিসাবে শ্রেণীবদ্ধ করা হয়.
ASH ছাই একটি গাছ পরাগ টাইপ হিসাবে শ্রেণীবদ্ধ করা হয়.
BIRCH বার্চ একটি গাছ পরাগ টাইপ হিসাবে শ্রেণীবদ্ধ করা হয়।
COTTONWOOD কটনউড একটি গাছের পরাগ ধরন হিসাবে শ্রেণীবদ্ধ করা হয়।
ELM এলম একটি গাছ পরাগ টাইপ হিসাবে শ্রেণীবদ্ধ করা হয়.
MAPLE ম্যাপেল একটি গাছ পরাগ টাইপ হিসাবে শ্রেণীবদ্ধ করা হয়।
OLIVE জলপাই একটি গাছ পরাগ টাইপ হিসাবে শ্রেণীবদ্ধ করা হয়।
JUNIPER জুনিপার একটি গাছ পরাগ প্রকার হিসাবে শ্রেণীবদ্ধ করা হয়।
OAK ওক একটি গাছ পরাগ টাইপ হিসাবে শ্রেণীবদ্ধ করা হয়।
PINE পাইন একটি গাছ পরাগ টাইপ হিসাবে শ্রেণীবদ্ধ করা হয়।
CYPRESS_PINE সাইপ্রেস পাইন একটি গাছ পরাগ প্রকার হিসাবে শ্রেণীবদ্ধ করা হয়।
HAZEL Hazel একটি গাছ পরাগ টাইপ হিসাবে শ্রেণীবদ্ধ করা হয়.
GRAMINALES Graminales একটি ঘাস পরাগ টাইপ হিসাবে শ্রেণীবদ্ধ করা হয়.
RAGWEED Ragweed একটি আগাছা পরাগ ধরনের হিসাবে শ্রেণীবদ্ধ করা হয়.
MUGWORT Mugwort একটি আগাছা পরাগ ধরনের হিসাবে শ্রেণীবদ্ধ করা হয়.

উদ্ভিদ বর্ণনা

গাছপালা সম্পর্কে সাধারণ তথ্য রয়েছে, যার মধ্যে রয়েছে তাদের ঋতুগত বিবরণ, বিশেষ আকার এবং রঙ, অ্যালার্জির ক্রস-প্রতিক্রিয়া সম্পর্কে তথ্য এবং উদ্ভিদের ফটো।

JSON প্রতিনিধিত্ব
{
  "type": enum (PollenType),
  "family": string,
  "season": string,
  "specialColors": string,
  "specialShapes": string,
  "crossReaction": string,
  "picture": string,
  "pictureCloseup": string
}
ক্ষেত্র
type

enum ( PollenType )

উদ্ভিদের পরাগ প্রকার। যেমন: "গ্রাস"। সমস্ত উপলব্ধ কোডের একটি তালিকা এখানে পাওয়া যেতে পারে.

family

string

উদ্ভিদ পরিবারের নামের একটি মানুষের পাঠযোগ্য উপস্থাপনা। উদাহরণ: "Betulaceae (The Birch family)"।

season

string

ঋতুগুলির ব্যাখ্যার পাঠ্য তালিকা যেখানে পরাগ সক্রিয় থাকে। উদাহরণ: "শেষ শীত, বসন্ত"।

specialColors

string

গাছের পাতা, বাকল, ফুল বা বীজের রঙের টেক্সচুয়াল বর্ণনা যা উদ্ভিদকে শনাক্ত করতে সাহায্য করে।

specialShapes

string

গাছের পাতা, ছাল, ফুল বা বীজের আকারের পাঠ্য বিবরণ যা উদ্ভিদকে সনাক্ত করতে সাহায্য করে।

crossReaction

string

পরাগ ক্রস প্রতিক্রিয়া উদ্ভিদের পাঠ্য বিবরণ। উদাহরণ: অ্যাল্ডার, হ্যাজেল, হর্নবিম, বিচ, উইলো এবং ওক পরাগ।

picture

string

গাছের ছবির লিঙ্ক।

pictureCloseup

string

উদ্ভিদের একটি ক্লোজআপ ছবির লিঙ্ক।