Package google.maps.pollen.v1

الفهرس

لقَاح

تعريف الخدمة لواجهة برمجة تطبيقات Pollen

LookupForecast

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

يعرض التطبيق معلومات عن حبوب اللقاح يوميًا خلال مدة تصل إلى 5 أيام في أكثر من 65 بلدًا، بدقة تصل إلى 1 كلم.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
LookupHeatmapTile

rpc LookupHeatmapTile(LookupHeatmapTileRequest) returns (HttpBody)

تعرض مصفوفة بايت تحتوي على بيانات الصورة المقسّمة بتنسيق PNG.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

الفهرس

رمز الفهرس

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

IndexInfo

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

الحقول
code

Index

هو رمز الفهرس. يمثل هذا الحقل الفهرس لأغراض البرمجة باستخدام حالات الثعبان بدلاً من المسافات. مثال: "UPI".
display_name

string

تمثيل لاسم الفهرس يمكن لشخص عادي قراءته. مثال: "مؤشر حبوب اللقاح العالمي".
category

string

التصنيف النصي لتفسير النتيجة الرقمية للفهرس. يتألف الفهرس من ست فئات:

  • 0: "لا شيء"
  • 1: "منخفض جدًا"
  • 2: "منخفض"
  • 3: "معتدل"
  • 4: "مرتفع"
  • 5: "مرتفع جدًا
index_description

string

شرح نصي لمستوى الفهرس الحالي.
color

Color

اللون المستخدَم لتمثيل النتيجة الرقمية لمؤشر حبوب اللقاح.
value

int32

هي النتيجة الرقمية للفهرس. يتراوح النطاق الرقمي بين 0 و5.

LookupForecastRequest

الحقول
location

LatLng

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

int32

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

int32

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

string

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

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

string

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

bool

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

LookupForecastResponse

الحقول
region_code

string

رمز ISO_3166-1 alpha-2 للبلد/المنطقة المتوافقة مع الموقع الجغرافي المقدَّم في الطلب. قد يتم حذف هذا الحقل من الردّ إذا كان الموقع الجغرافي المقدَّم في الطلب يقع في منطقة متنازع عليها.
daily_info[]

DayInfo

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

string

اختياريّ. الرمز المميز لاسترداد الصفحة التالية.

DayInfo

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

الحقول
date

Date

التاريخ بالتوقيت العالمي المنسّق الذي يتم فيه عرض بيانات توقّعات حبوب اللقاح.
pollen_type_info[]

PollenTypeInfo

تتضمّن هذه القائمة (حتى) ثلاثة أنواع من حبوب اللقاح (العشب والأعشاب الضارة والأشجار) التي تؤثر في الموقع الجغرافي المحدّد في الطلب.
plant_info[]

PlantInfo

ستشمل هذه القائمة (ما يصل إلى) 15 نوعًا من حبوب اللقاح التي تؤثر في الموقع الجغرافي المحدّد في الطلب.

LookupHeatmapTileRequest

طلب مربّع لخريطة التمثيل اللوني تتوافق البنية مع استدعاء GET لخادم المربّعات العادي، أي https://pollen.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y}.

مثال: [https://vollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/0/0/0]

الحقول
map_type

MapType

مطلوبة. نوع خريطة التمثيل اللوني لحبوب اللقاح. تحدِّد هذه السياسة مجموعة أنواع حبوب اللقاح والفهرس الذي ستمثّله الخريطة بشكل بياني.
zoom

int32

مطلوبة. مستوى تكبير/تصغير الخريطة. لتحديد حجم محتوى الخريطة الذي يظهر في عرض الخريطة، سواء كان كبيرًا أو صغيرًا.

  • يمثل مستوى التكبير/التصغير 0 العالم بأكمله في مربّع واحد.
  • مستوى التكبير 1 هو العالم بأكمله في 4 مربّعات.
  • يمثل مستوى التكبير/التصغير 2 العالم بأكمله في 16 مربّعًا.
  • المستوى 16 من Zoom هو العالم بكامله في 65,536 مربّعًا.

القيم المسموح بها: 0-16
x

int32

مطلوبة. تحدّد النقطة الشرقية والغربية في المربّع المطلوب.
y

int32

مطلوبة. لتحديد النقطة بين الشمال والجنوب في المربّع المطلوب.

MapType

نوع خريطة التمثيل اللوني لحبوب اللقاح. تحدِّد هذه السياسة مجموعة أنواع حبوب اللقاح والفهرس الذي ستمثّله الخريطة بشكل بياني.

عمليات التعداد
MAP_TYPE_UNSPECIFIED نوع الخريطة غير محدَّد.
TREE_UPI سيمثل نوع خريطة التمثيل اللوني خريطة رسومية لفهرس الشجرة.
GRASS_UPI سيمثل نوع خريطة التمثيل اللوني خريطة رسومية لفهرس العشب.
WEED_UPI سيمثل نوع خريطة التمثيل اللوني مخططًا بيانيًا لخريطة التمثيل اللوني.

نبتة

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

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

PlantDescription

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

الحقول
type

PollenType

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

string

تمثيل يمكن للإنسان فهم اسم عائلة النبات. على سبيل المثال: "البيتولاي (عائلة البتولا)".
season

string

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

string

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

string

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

string

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

string

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

string

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

PlantInfo

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

الحقول
code

Plant

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

string

تمثيل لاسم النبات يمكن لشخص عادي قراءته. على سبيل المثال: "خشب القطن".
index_info

IndexInfo

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

PlantDescription

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

bool

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

PollenType

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

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

PollenTypeInfo

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

الحقول
code

PollenType

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

string

تمثيل يمكن للإنسان فهم اسم نوع حبوب اللقاح مثال: "عشب"
index_info

IndexInfo

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

string

قائمة تفسيرات نصية، ذات صلة بالإحصاءات الصحية استنادًا إلى مستويات حبوب اللقاح الحالية
in_season

bool

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