Package google.maps.pollen.v1

الفهرس

لقَاح

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

LookupForecast

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

تعرض هذه الميزة معلومات يومية عن حبوب اللقاح في أكثر من 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

التاريخ الذي يتم فيه تمثيل بيانات توقّعات حبوب اللقاح حسب التوقيت العالمي المنسَّق (UTC)
pollen_type_info[]

PollenTypeInfo

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

PlantInfo

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

LookupHeatmapTileRequest

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

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

الحقول
map_type

MapType

مطلوب. نوع خريطة التمثيل اللوني لحبوب اللقاح. تحدد مجموعة حبوب اللقاح والفهرس التي ستمثلها الخريطة بيانيًا.
zoom

int32

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

  • يشير مستوى التكبير/التصغير 0 إلى العالم أجمع في مربع واحد.
  • المستوى الأول من التكبير أو التصغير هو العالم بأسره من خلال 4 مربّعات.
  • استمتِع بالمستوى الثاني من التكبير أو التصغير عبر 16 مربّعًا.
  • استمتِع بالمستوى 16 من التكبير أو التصغير عبر 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

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