Package google.maps.pollen.v1

אינדקס

אבקנים

הגדרת השירות של ה-API לאבקנים.

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.

אינדקס

קוד אינדקס

טיפוסים בני מנייה (enum)
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

חובה. קו האורך וקו הרוחב שמהם ה-API מחפש נתוני תחזיות של אבקנים.
days

int32

חובה. מספר שמציין כמה ימים חזויים צריך לבקש (ערך מינימלי 1, הערך המקסימלי הוא 5).
page_size

int32

זה שינוי אופציונלי. המספר המקסימלי של רשומות מידע יומיות שצריך להחזיר בכל דף. ברירת המחדל והערך המקסימלי הם 5, שמעידים על נתונים מ-5 ימים.
page_token

string

זה שינוי אופציונלי. אסימון דף שהתקבל משיחה יומית קודמת. הוא משמש לאחזור הדף הבא.

שימו לב שכשמציינים ערך לאסימון הדף, כל הפרמטרים האחרים של הבקשה חייבים להתאים לקריאה הקודמת שסיפקה את אסימון הדף.
language_code

string

זה שינוי אופציונלי. הלקוח יכול לבחור את השפה של התשובה. אם אי אפשר לספק נתונים עבור השפה הזו, ה-API משתמש בהתאמה הקרובה ביותר. הערכים המותרים מסתמכים על תקן IETF BCP-47. ערך ברירת המחדל הוא en.
plants_description

bool

זה שינוי אופציונלי. מכיל מידע כללי על צמחים, כולל פרטים על העונתיות שלהם, צורות וצבעים מיוחדים, מידע על תגובות אלרגיות ותמונות של צמחים. ערך ברירת המחדל הוא 'true'.

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/heatmapTiles/0/0/0]

שדות
map_type

MapType

חובה. הסוג של מפת החום של האבקנים. מגדיר את השילוב של סוג האבקנים והאינדקס שהמפה תייצג באופן גרפי.
zoom

int32

חובה. רמת הזום של המפה. מגדירה את הגודל או הקטן של התוכן שמוצג במפה בתצוגת מפה.

  • רמת זום 0 מציגה את העולם כולו במשבצת אחת.
  • רמת זום 1 מציגה את העולם כולו ב-4 משבצות.
  • רמת זום 2 מציגה את העולם כולו ב-16 משבצות.
  • רמת זום 16 כוללת את כל העולם ב-65,536 משבצות.

ערכים מותרים: 0-16
x

int32

חובה. מגדירה את הנקודה המזרחית-מערבית באריח המבוקש.
y

int32

חובה. מגדירה את הנקודה צפונית-דרום באריח המבוקש.

MapType

הסוג של מפת החום של האבקנים. מגדיר את השילוב של סוג האבקנים והאינדקס שהמפה תייצג באופן גרפי.

טיפוסים בני מנייה (enum)
MAP_TYPE_UNSPECIFIED לא צוין סוג מפה.
TREE_UPI הסוג של מפת החום ייצג מפה גרפית של אינדקס עץ.
GRASS_UPI הסוג של מפת החום ייצג מפה גרפית של מדד דשא.
WEED_UPI הסוג של מפת החום ייצג מפה גרפית של אינדקס עשבים.

צמח

הצגת רשימה של צמחים זמינים עם זמינות שונה במיקומים שונים.

טיפוסים בני מנייה (enum)
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

קוד סוג האבקנים

טיפוסים בני מנייה (enum)
POLLEN_TYPE_UNSPECIFIED סוג הצמח לא צוין.
GRASS סוג אבקני העשבים.
TREE סוג אבקני העצים.
WEED סוג אבקני עשב.

PollenTypeInfo

האובייקט הזה מכיל את האינדקס של סוג האבקנים ומידע על המלצות הבריאות לגבי סוג אבקנים ספציפי.

שדות
code

PollenType

שם הקוד של סוג האבקנים. לדוגמה: "GRASS"
display_name

string

ייצוג קריא לאנשים של שם סוג האבקנים. דוגמה: "דשא"
index_info

IndexInfo

מכיל את נתונים של מדד האבקנים האוניברסלי (UPI) לסוג האבקנים.
health_recommendations[]

string

רשימה טקסטית של הסברים שקשורים לתובנות בריאותיות על סמך רמות האבקנים הנוכחיות.
in_season

bool

ציון אם הצמח בעונה או לא.