Method: forecast.lookup

تعرض هذه الميزة معلومات يومية عن حبوب اللقاح في أكثر من 65 بلدًا بدقة تصل إلى 1 كيلومتر.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

معامِلات طلب البحث

المعلمات
location

object (LatLng)

مطلوب. خط الطول وخط العرض اللذَين تبحث من خلال واجهة برمجة التطبيقات عن بيانات توقعات حبوب اللقاح.
days

integer

مطلوب. رقم يشير إلى عدد الأيام المتوقّعة للطلب (الحد الأدنى للقيمة 1 والحد الأقصى للقيمة هو 5).
pageSize

integer

اختياريّ. الحدّ الأقصى لعدد سجلّات المعلومات اليومية المطلوب عرضها في كل صفحة. القيمة التلقائية والحد الأقصى هي 5، ما يشير إلى 5 أيام من البيانات.
pageToken

string

اختياريّ. رمز مميّز للصفحة تم تلقّيه من مكالمة يومية سابقة. ويتم استخدامه لاسترداد الصفحة التالية.

تجدر الإشارة إلى أنّه عند توفير قيمة للرمز المميّز للصفحة، يجب أن تتطابق جميع مَعلمات الطلب الأخرى المتوفّرة مع الاستدعاء السابق الذي وفّر الرمز المميّز للصفحة.
languageCode

string

اختياريّ. تسمح للعميل باختيار لغة الرد. إذا تعذّر توفير بيانات لهذه اللغة، ستستخدم واجهة برمجة التطبيقات أقرب تطابق. تعتمد القيم المسموح بها على معيار IETF BCP-47. القيمة التلقائية هي "en".
plantsDescription

boolean

اختياريّ. يحتوي على معلومات عامة عن النباتات، بما في ذلك تفاصيل عن التغيرات الموسمية وأشكالها وألوانها الخاصة ومعلومات عن التفاعلات المتقاطعة للحساسية وصور النباتات. القيمة التلقائية هي "صحيح".

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "regionCode": string,
  "dailyInfo": [
    {
      object (DayInfo)
    }
  ],
  "nextPageToken": string
}
الحقول
regionCode

string

تمثّل هذه السمة رمز ISO_3166-1 alpha-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].

DayInfo

يحتوي هذا العنصر على معلومات التوقعات اليومية لكل يوم مطلوب.

تمثيل 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)

الاسم الرمزي لنوع حبوب اللقاح على سبيل المثال: "GRASS"
displayName

string

تمثيل مرئي يمكن لشخص عادي قراءته عن اسم نوع حبوب اللقاح مثال: "عشب"
indexInfo

object (IndexInfo)

تحتوي على بيانات المؤشر العالمي لحبوب اللقاح (UPI) لنوع حبوب اللقاح.
healthRecommendations[]

string

قائمة نصية بالتفسيرات المتعلقة بالإحصاءات الصحية المبنية على مستويات حبوب اللقاح الحالية
inSeason

boolean

الإشارة إلى ما إذا كان النبات في موسم أم لا.

PollenType

رمز نوع حبوب اللقاح

عمليات التعداد
POLLEN_TYPE_UNSPECIFIED نوع نبات غير محدَّد
GRASS نوع من حبوب لقاح العشب.
TREE نوع حبوب لقاح الأشجار
WEED نوع حبوب لقاح الأعشاب الضارة

IndexInfo

يحتوي هذا العنصر على بيانات تمثّل قيمة معيّنة لمؤشر حبوب اللقاح وفئته ووصفها.

تمثيل 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.

الفهرس

رمز الفهرس

عمليات التعداد
INDEX_UNSPECIFIED فهرس غير محدد.
UPI المؤشر العالمي لحبوب اللقاح.

اللون

يمثل لونًا في مساحة ألوان RGBA. تم تصميم هذا التمثيل لتبسيط عملية التحويل من وإلى تمثيلات الألوان بلغات مختلفة على مدى الاكتفاء. على سبيل المثال، يمكن تقديم حقول هذا التمثيل بشكل بسيط إلى الدالة الإنشائية java.awt.Color في Java؛ يمكن أيضًا تقديمه بطريقة تافهة لطريقة +colorWithRed:green:blue:alpha في UIColor على نظام iOS؛ ومن خلال القليل من العمل، يمكن تنسيقه بسهولة إلى سلسلة CSS rgba() في JavaScript.

لا تحتوي هذه الصفحة المرجعية على معلومات عن مساحة اللون المطلقة التي يجب استخدامها لتفسير قيمة النموذج اللوني أحمر أخضر أزرق، على سبيل المثال، sRGB وAdobe RGB وDCI-P3 وBT.2020. وبشكل تلقائي، يجب أن تفترض التطبيقات مساحة اللون sRGB.

عندما يلزم تحديد مساواة الألوان، تنطبق عمليات التنفيذ، ما لم يوثق خلاف ذلك، على اعتبار لونين متساويين إذا كانت جميع قيم الأحمر والأخضر والأزرق وألفا تختلف على الأكثر 1e-5.

مثال (Java):

 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;
}
// ...

مثال (JavaScript):

// ...

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).

PlantInfo

يحتوي هذا الكائن على المعلومات اليومية عن نبات معيّن.

تمثيل JSON 
{
  "code": enum (Plant),
  "displayName": string,
  "indexInfo": {
    object (IndexInfo)
  },
  "plantDescription": {
    object (PlantDescription)
  },
  "inSeason": boolean
}
الحقول
code

enum (Plant)

اسم رمز النبات. على سبيل المثال: "COTTONWOOD". يمكن العثور على قائمة بجميع الرموز المتاحة هنا.
displayName

string

تمثّل هذه السمة تمثيلاً لاسم النبات ويمكن لشخص عادي قراءته. مثال: "قطن"
indexInfo

object (IndexInfo)

يحتوي هذا العنصر على بيانات تمثّل قيمة معيّنة لمؤشر حبوب اللقاح وفئته ووصفها.
plantDescription

object (PlantDescription)

يحتوي على معلومات عامة عن النباتات، بما في ذلك تفاصيل عن التغيرات الموسمية وأشكالها وألوانها الخاصة ومعلومات عن التفاعلات المتقاطعة للحساسية وصور النباتات.
inSeason

boolean

ما إذا كان النبات في موسمه أم لا.

نبتة

يسرد النباتات المتاحة ذات التوافر المختلف في جميع المواقع.

عمليات التعداد
PLANT_UNSPECIFIED رمز نبات غير محدَّد.
ALDER يُصنف جار الماء على أنه نوع من أنواع حبوب لقاح الأشجار.
ASH يُصنف الرماد على أنّه نوع من حبوب لقاح الأشجار.
BIRCH تُصنف البتولا على أنها نوع من حبوب اللقاح الشجر.
COTTONWOOD يُصنف خشب القطن على أنه نوع من أنواع حبوب لقاح الأشجار.
ELM يُصنَّف الدردار على أنّه من أنواع حبوب لقاح الشجر.
MAPLE يُصنف القيقب نوعًا من أنواع حبوب لقاح الشجر.
OLIVE يُصنف الزيتون على أنه أحد أنواع حبوب لقاح الأشجار.
JUNIPER يُصنَّف العرعر على أنه نوع من أنواع حبوب لقاح الشجر.
OAK يُصنف البلوط على أنه نوع من أنواع حبوب لقاح الشجر.
PINE يُصنف الصنوبر على أنه نوع من أنواع حبوب لقاح الأشجار.
CYPRESS_PINE يُصنف صنوبر السرو على أنه نوع من أنواع حبوب لقاح السرو.
HAZEL يُصنَّف البندق على أنّه من أنواع حبوب لقاح الأشجار.
GRAMINALES تُصنف الحبوب من نوع حبوب اللقاح العشبية.
RAGWEED تُصنف الرغيد على أنها من أنواع حبوب لقاح الأعشاب الضارة.
MUGWORT يتم تصنيف الشيح الدارج على أنّه من أنواع حبوب لقاح الأعشاب الضارة.

PlantDescription

يحتوي على معلومات عامة عن النباتات، بما في ذلك تفاصيل عن التغيرات الموسمية وأشكالها وألوانها الخاصة ومعلومات عن التفاعلات المتقاطعة للحساسية وصور النباتات.

تمثيل JSON 
{
  "type": enum (PollenType),
  "family": string,
  "season": string,
  "specialColors": string,
  "specialShapes": string,
  "crossReaction": string,
  "picture": string,
  "pictureCloseup": string
}
الحقول
type

enum (PollenType)

نوع حبوب اللقاح النباتي. على سبيل المثال: "GRASS". يمكن العثور على قائمة بجميع الرموز المتاحة هنا.
family

string

تمثيل سهل القراءة لشخص عادي لاسم عائلة النبات مثال: "القبّحة (عائلة البتولا)".
season

string

قائمة نصية بتفسيرات المواسم التي تكون فيها حبوب اللقاح نشطة. مثال: "أواخر فصل الشتاء، أو فصل الربيع".
specialColors

string

وصف نصي للنباتات ألوان الأوراق أو اللحاء أو الزهور أو البذور التي تساعد على تحديد النبات.
specialShapes

string

وصف نصي للنباتات أشكال من الأوراق أو اللحاء أو الزهور أو البذور تساعد في تحديد النبات.
crossReaction

string

وصف نصي لحبوب اللقاح التي تتفاعل مع النباتات مثال: قد تحدث حساسية من حبوب لقاح جار الماء والبندق والشرد والزان والصفصاف والبلوط.
picture

string

رابط إلى صورة النبات.
pictureCloseup

string

رابط إلى صورة مقربة للنبات.