- طلب HTTP
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- LatLng
- DayInfo
- التاريخ
- PollenTypeInfo
- PollenType
- IndexInfo
- الفهرس
- اللون
- PlantInfo
- نبتة
- PlantDescription
- جرِّبه الآن
تعرض هذه الميزة معلومات يومية عن حبوب اللقاح في أكثر من 65 بلدًا بدقة تصل إلى 1 كيلومتر.
طلب HTTP
GET https://pollen.googleapis.com/v1/forecast:lookup
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معامِلات طلب البحث
المَعلمات | |
---|---|
location |
مطلوب. خط الطول وخط العرض اللذَين تبحث من خلال واجهة برمجة التطبيقات عن بيانات توقعات حبوب اللقاح. |
days |
مطلوب. رقم يشير إلى عدد الأيام المتوقَّعة المطلوب طلبها (الحد الأدنى للقيمة 1 والحد الأقصى للقيمة هو 5). |
pageSize |
اختياريّ. الحدّ الأقصى لعدد سجلّات المعلومات اليومية المطلوب عرضها في كل صفحة. القيمة التلقائية والحد الأقصى هي 5، ما يشير إلى 5 أيام من البيانات. |
pageToken |
اختياريّ. رمز مميّز للصفحة تم تلقّيه من مكالمة يومية سابقة. ويتم استخدامه لاسترداد الصفحة التالية. تجدر الإشارة إلى أنّه عند توفير قيمة للرمز المميّز للصفحة، يجب أن تتطابق جميع مَعلمات الطلب الأخرى المتوفّرة مع الاستدعاء السابق الذي وفّر الرمز المميّز للصفحة. |
languageCode |
اختياريّ. تسمح للعميل باختيار لغة الرد. إذا تعذّر توفير بيانات لهذه اللغة، ستستخدم واجهة برمجة التطبيقات أقرب تطابق. تعتمد القيم المسموح بها على معيار IETF BCP-47. القيمة التلقائية هي "en". |
plantsDescription |
اختياريّ. يحتوي على معلومات عامة عن النباتات، بما في ذلك تفاصيل عن التغيرات الموسمية وأشكالها وألوانها الخاصة ومعلومات عن التفاعلات المتقاطعة للحساسية وصور النباتات. القيمة التلقائية هي "صحيح". |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"regionCode": string,
"dailyInfo": [
{
object ( |
الحقول | |
---|---|
regionCode |
تمثّل هذه السمة رمز ISO_3166-1 alpha-2 للبلد أو المنطقة المتوافقَين مع الموقع الجغرافي المقدَّم في الطلب. قد يتم حذف هذا الحقل من الرد إذا كان الموقع الجغرافي المذكور في الطلب يقع في منطقة متنازع عليها. |
dailyInfo[] |
مطلوب. يحتوي هذا العنصر على معلومات التوقعات اليومية لكل يوم مطلوب. |
nextPageToken |
اختياريّ. الرمز المميّز لاسترداد الصفحة التالية. |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
LatLng
كائن يمثّل زوجًا من خط العرض/الطول. ويتم التعبير عن ذلك في صورة زوج من الزوجين لتمثيل درجات الطول والعرض والدرجات. يجب أن يتوافق هذا العنصر مع معيار WGS84 ما لم يُذكر خلاف ذلك. يجب أن تكون القيم ضمن النطاقات التي تمت تسويتها.
تمثيل JSON |
---|
{ "latitude": number, "longitude": number } |
الحقول | |
---|---|
latitude |
خط العرض بالدرجات. يجب أن يكون في النطاق [ -90.0، +90.0]. |
longitude |
خط الطول بالدرجات. يجب أن يكون في النطاق [ -180.0، +180.0]. |
DayInfo
يحتوي هذا العنصر على معلومات التوقعات اليومية لكل يوم مطلوب.
تمثيل JSON |
---|
{ "date": { object ( |
الحقول | |
---|---|
date |
التاريخ الذي يتم فيه تمثيل بيانات توقّعات حبوب اللقاح حسب التوقيت العالمي المنسَّق (UTC) |
pollenTypeInfo[] |
ستشمل هذه القائمة ما يصل إلى ثلاثة أنواع من حبوب اللقاح (GRASS وWEED وTREE) تؤثر في الموقع الجغرافي المحدّد في الطلب. |
plantInfo[] |
ستتضمن هذه القائمة ما يصل إلى 15 نوعًا من حبوب اللقاح التي تؤثر في الموقع الجغرافي المحدد في الطلب. |
التاريخ
يمثل تاريخ تقويم كاملاً أو جزئيًا، مثل عيد الميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. يرتبط التاريخ بالتقويم الميلادي. يمكن أن يمثل ذلك أيًا مما يلي:
- تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
- شهر ويوم، بسنة صفرية (على سبيل المثال، ذكرى سنوية).
- سنة بمفردها، بشهر صفري ويوم صفري.
- سنة وشهر بيوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).
الأنواع ذات الصلة:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
تمثيل JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
الحقول | |
---|---|
year |
السنة من التاريخ. يجب أن تتراوح القيمة من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة. |
month |
شهر من السنة. يجب أن تتراوح القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم. |
day |
يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وأن تكون صالحة للسنة والشهر، أو 0 لتحديد عام في حد ذاته أو تحديد سنة وشهر حيث لا يكون اليوم مهمًا. |
PollenTypeInfo
يحتوي هذا العنصر على مؤشر نوع حبوب اللقاح ومعلومات مقترَحة صحية حول نوع معيّن من حبوب اللقاح.
تمثيل JSON |
---|
{ "code": enum ( |
الحقول | |
---|---|
code |
الاسم الرمزي لنوع حبوب اللقاح على سبيل المثال: "GRASS" |
displayName |
تمثيل مرئي يمكن لشخص عادي قراءته عن اسم نوع حبوب اللقاح مثال: "عشب" |
indexInfo |
تحتوي على بيانات المؤشر العالمي لحبوب اللقاح (UPI) لنوع حبوب اللقاح. |
healthRecommendations[] |
قائمة نصية بالتفسيرات المتعلقة بالإحصاءات الصحية المبنية على مستويات حبوب اللقاح الحالية |
inSeason |
الإشارة إلى ما إذا كان النبات في موسم أم لا. |
PollenType
رمز نوع حبوب اللقاح
عمليات التعداد | |
---|---|
POLLEN_TYPE_UNSPECIFIED |
نوع نبات غير محدَّد |
GRASS |
نوع من حبوب لقاح العشب. |
TREE |
نوع حبوب لقاح الأشجار |
WEED |
نوع حبوب لقاح الأعشاب الضارة |
IndexInfo
يحتوي هذا العنصر على بيانات تمثّل قيمة معيّنة لمؤشر حبوب اللقاح وفئته ووصفها.
تمثيل JSON |
---|
{ "code": enum ( |
الحقول | |
---|---|
code |
رمز الفهرس. يمثل هذا الحقل الفهرس لأغراض البرمجة باستخدام حالات الثعبان بدلاً من المسافات. مثال: "UPI" |
displayName |
تمثيل لاسم الفهرس ويمكن لشخص عادي قراءته مثال: "المؤشر العالمي لحبوب اللقاح" |
category |
التصنيف النصي لتفسير نتيجة الفهرس الرقمي. يتكون الفهرس من ست فئات:
|
indexDescription |
شرح نصي لمستوى الفهرس الحالي |
color |
اللون المستخدم لتمثيل النتيجة الرقمية لمؤشر حبوب اللقاح. |
value |
النتيجة الرقمية للمؤشر. النطاق العددي بين 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 |
مقدار اللون الأحمر في اللون كقيمة في الفاصل [0, 1]. |
green |
مقدار اللون الأخضر في اللون كقيمة في الفاصل [0, 1]. |
blue |
مقدار اللون الأزرق في اللون كقيمة في الفاصل [0, 1]. |
alpha |
الجزء من هذا اللون الذي يجب تطبيقه على البكسل. وهذا يعني أن لون البكسل النهائي يتم تحديده من خلال المعادلة:
وهذا يعني أن القيمة 1.0 تتجاوب مع لون خالص، في حين تتجاوب القيمة 0.0 مع لون شفاف تمامًا. يستخدم ذلك رسالة تضمين بدلاً من عدد قياسي عائم بسيط بحيث يمكن التمييز بين القيمة التلقائية والقيمة التي يتم إلغاء تعيينها. وعند إسقاطها، يتم عرض كائن اللون هذا كلون ثابت (كما لو تم إعطاء قيمة ألفا بوضوح قيمة 1.0). |
PlantInfo
يحتوي هذا الكائن على المعلومات اليومية عن نبات معيّن.
تمثيل JSON |
---|
{ "code": enum ( |
الحقول | |
---|---|
code |
اسم رمز النبات. على سبيل المثال: "COTTONWOOD". يمكن العثور على قائمة بجميع الرموز المتاحة هنا. |
displayName |
تمثّل هذه السمة تمثيلاً لاسم النبات ويمكن لشخص عادي قراءته. مثال: "قطن" |
indexInfo |
يحتوي هذا العنصر على بيانات تمثّل قيمة معيّنة لمؤشر حبوب اللقاح وفئته ووصفها. |
plantDescription |
يحتوي على معلومات عامة عن النباتات، بما في ذلك تفاصيل عن التغيرات الموسمية وأشكالها وألوانها الخاصة ومعلومات عن التفاعلات المتقاطعة للحساسية وصور النباتات. |
inSeason |
ما إذا كان النبات في موسمه أم لا. |
نبتة
يسرد النباتات المتاحة ذات التوافر المختلف في جميع المواقع.
عمليات التعداد | |
---|---|
PLANT_UNSPECIFIED |
رمز نبات غير محدَّد. |
ALDER |
يُصنف جار الماء على أنه نوع من أنواع حبوب لقاح الأشجار. |
ASH |
يُصنف الرماد على أنّه نوع من حبوب لقاح الأشجار. |
BIRCH |
تُصنف البتولا على أنها نوع من حبوب اللقاح الشجر. |
COTTONWOOD |
يُصنف خشب القطن على أنه نوع من أنواع حبوب لقاح الأشجار. |
ELM |
يُصنَّف الدردار على أنّه من أنواع حبوب لقاح الشجر. |
MAPLE |
يُصنف القيقب نوعًا من أنواع حبوب لقاح الشجر. |
OLIVE |
يُصنف الزيتون على أنه أحد أنواع حبوب لقاح الأشجار. |
JUNIPER |
يُصنَّف العرعر على أنه نوع من أنواع حبوب لقاح الشجر. |
OAK |
يُصنف البلوط على أنه نوع من أنواع حبوب لقاح الشجر. |
PINE |
يُصنف الصنوبر على أنه نوع من أنواع حبوب لقاح الأشجار. |
CYPRESS_PINE |
يُصنف صنوبر السرو على أنه نوع من أنواع حبوب لقاح السرو. |
HAZEL |
يُصنَّف البندق على أنّه من أنواع حبوب لقاح الأشجار. |
GRAMINALES |
تُصنف الحبوب من نوع حبوب اللقاح العشبية. |
RAGWEED |
تُصنف الرغيد على أنها من أنواع حبوب لقاح الأعشاب الضارة. |
MUGWORT |
يتم تصنيف الشيح الدارج على أنّه من أنواع حبوب لقاح الأعشاب الضارة. |
PlantDescription
يحتوي على معلومات عامة عن النباتات، بما في ذلك تفاصيل عن التغيرات الموسمية وأشكالها وألوانها الخاصة ومعلومات عن التفاعلات المتقاطعة للحساسية وصور النباتات.
تمثيل JSON |
---|
{
"type": enum ( |
الحقول | |
---|---|
type |
نوع حبوب اللقاح النباتي. على سبيل المثال: "GRASS". يمكن العثور على قائمة بجميع الرموز المتاحة هنا. |
family |
تمثيل سهل القراءة لشخص عادي لاسم عائلة النبات مثال: "القبّحة (عائلة البتولا)". |
season |
قائمة نصية بتفسيرات المواسم التي تكون فيها حبوب اللقاح نشطة. مثال: "أواخر فصل الشتاء، أو فصل الربيع". |
specialColors |
وصف نصي للنباتات ألوان الأوراق أو اللحاء أو الزهور أو البذور التي تساعد على تحديد النبات. |
specialShapes |
وصف نصي للنباتات أشكال أوراق أو لحاء أو زهور أو بذور تساعد في تحديد النبات. |
crossReaction |
وصف نصي لحبوب اللقاح التي تتفاعل مع النباتات مثال: قد تحدث حساسية من حبوب لقاح جار الماء والبندق والشرد والزان والصفصاف والبلوط. |
picture |
رابط إلى صورة النبات. |
pictureCloseup |
رابط إلى صورة مقرّبة للنبات. |