預測端點最多可提供 5 天的每日花粉資訊。您可以控制要向使用者顯示的下列資訊：
- 預測天數
- 翻譯欄位的語言代碼
- 回應頁面大小
- 特定區域的植物及其過敏原可能性的詳細資訊
關於預測要求
如要使用預測端點要求每日花粉資訊，請將 HTTP GET 要求傳送至：
https://pollen.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY
在網址中加入參數。要求包含您希望取得輪詢預測結果的位置、預測天數，以及要在回應中加入的花粉資訊。
關於預測回應
回應主體會提供所要求座標的區碼，以及要求的每日預測資訊。您要求資訊的時間超過一天時，如果資訊不符合要求的頁面大小，回應主體中也會包含用來擷取下一頁的權杖。
回應主體也包含三個物件：
DayInfo 提供代表的預測日期，以及 PollenTypeInfo 和 PlantInfo。
PollenTypeInfo 會在要求的座標提供可用的花粉類型 (
GRASS、TREE和WEED)、花粉指數，以及關聯的健康建議。PlantInfo 可在要求的座標提供植物名稱和說明，包括季節性、外觀和交叉反應。
基本參數
要求範例
下列程式碼顯示如何建構 forecast:lookup 要求的基本要求。在這個範例中，您會設定花粉資訊的位置和天數。
curl -X GET "https://pollen.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY&location.longitude=35.32 &location.latitude=32.32 &days=1"
回應範例
上述呼叫會產生下列 JSON 回應。
{
"regionCode": "IL",
"dailyInfo": [
{
"date": {
"year": 2023,
"month": 7,
"day": 11
},
"pollenTypeInfo": [
{
"code": "GRASS",
"displayName": "Grass",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"healthRecommendations": [
"Pollen levels are very low right now. It's a great day to enjoy the outdoors!"
]
},
{
"code": "TREE",
"displayName": "Tree",
"inSeason": false,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"healthRecommendations": [
"Pollen levels are very low right now. It's a great day to enjoy the outdoors!"
]
},
{
"code": "WEED",
"displayName": "Weed",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"healthRecommendations": [
"Pollen levels are very low right now. It's a great day to enjoy the outdoors!"
]
}
],
"plantInfo": [
{
"code": "BIRCH",
"displayName": "Birch",
"inSeason": false,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"plantDescription": {
"type": "TREE",
"family": "Betulaceae (the Birch family)",
"season": "Late winter, spring",
"specialColors": "The bark is usually whitish-gray, silver, or sometimes red.",
"specialShapes": "Birch leaves are often triangular with jagged edges. The bark on most birch trees has horizontal dark streaks that look like scoring. Birch tree bark is also well-known for its paper-like texture and peeling nature.",
"crossReaction": "Alder, Hazel, Hornbeam, Beech, Willow, and Oak pollen. In addition, there may be a higher risk for food allergies like hazelnuts, almonds, peanuts, pears, apples, cherries and carrots.",
"picture": "https://storage.googleapis.com/pollen-pictures/birch_full.jpg",
"pictureCloseup": "https://storage.googleapis.com/pollen-pictures/birch_closeup.jpg"
}
},
{
"code": "OLIVE",
"displayName": "Olive"
},
{
"code": "GRAMINALES",
"displayName": "Grasses",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"plantDescription": {
"type": "GRASS",
"family": "Poaceae",
"season": "Late spring, summer",
"specialColors": "None",
"specialShapes": "The leaves are alternate, long and narrow and the leaf margin is smooth.",
"crossReaction": "Plantain (Plantago) pollen. In addition, there may be a higher risk for food allergies like melons, oranges, tomatoes, peanuts, soy, potato, and other legumes.",
"picture": "https://storage.googleapis.com/pollen-pictures/graminales_full.jpg",
"pictureCloseup": "https://storage.googleapis.com/pollen-pictures/graminales_closeup.jpg"
}
},
{
"code": "RAGWEED",
"displayName": "Ragweed",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 0,
"category": "None",
"indexDescription": "Pollen levels are very low and are not likely to trigger allergic reactions",
"color": {}
},
"plantDescription": {
"type": "WEED",
"family": "Asteraceae (the daisy family)",
"season": "Late summer, fall",
"specialColors": "None",
"specialShapes": "The leaves are alternate or opposite, divided and lobed. The leaf margin is smooth or serrated.",
"crossReaction": "Mugwort and Goldenrod as well as daisies such as Sunflower, Dandelion, and Chamomile.",
"picture": "https://storage.googleapis.com/pollen-pictures/ragweed_full.jpg",
"pictureCloseup": "https://storage.googleapis.com/pollen-pictures/ragweed_closeup.jpg"
}
},
{
"code": "ALDER",
"displayName": "Alder"
},
{
"code": "MUGWORT",
"displayName": "Mugwort",
"inSeason": false,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"plantDescription": {
"type": "WEED",
"family": "Asteraceae (the daisy family)",
"season": "Late summer, fall",
"specialColors": "The leaves are green on the upper side and gray-green on the lower side.",
"specialShapes": "The leaves are alternate, divided and pinnate.",
"crossReaction": "Ragweed and Goldenrod pollen as well as daisies such as Sunflower, Dandelion and Chamomile. In addition, there may be a higher risk for food allergies like mustard, peach, celery and various herbs and spices.",
"picture": "https://storage.googleapis.com/pollen-pictures/mugwort_full.jpg",
"pictureCloseup": "https://storage.googleapis.com/pollen-pictures/mugwort_closeup.jpg"
}
}
]
}
]
}
其他參數
要求範例
下列程式碼顯示如何建構 forecast:lookup 的要求。在這個範例中，您會設定位置、日期和回應的語言，並移除植物說明。
curl -X GET "https://pollen.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY&location.longitude=35.32 &location.latitude=32.32 &days=1 &languageCode=fr &plantsDescription=0"
回應範例
上述呼叫會產生下列 JSON 回應：
{
"regionCode": "IL",
"dailyInfo": [
{
"date": {
"year": 2023,
"month": 7,
"day": 11
},
"pollenTypeInfo": [
{
"code": "GRASS",
"displayName": "Herbacée",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Très faible",
"indexDescription": "Les personnes extrêmement sensibles au pollen sont susceptibles de ressentir des symptômes.",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"healthRecommendations": [
"Les niveaux de pollen sont très faibles actuellement. La journée est idéale pour profiter du grand air !"
]
},
{
"code": "TREE",
"displayName": "Arbre",
"inSeason": false,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Très faible",
"indexDescription": "Les personnes extrêmement sensibles au pollen sont susceptibles de ressentir des symptômes.",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"healthRecommendations": [
"Les niveaux de pollen sont très faibles actuellement. La journée est idéale pour profiter du grand air !"
]
},
{
"code": "WEED",
"displayName": "Herbacées",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Très faible",
"indexDescription": "Les personnes extrêmement sensibles au pollen sont susceptibles de ressentir des symptômes.",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"healthRecommendations": [
"Les niveaux de pollen sont très faibles actuellement. La journée est idéale pour profiter du grand air !"
]
}
],
"plantInfo": [
{
"code": "BIRCH",
"displayName": "Bouleau",
"inSeason": false,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Très faible",
"indexDescription": "Les personnes extrêmement sensibles au pollen sont susceptibles de ressentir des symptômes.",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
}
},
{
"code": "OLIVE",
"displayName": "Olivier"
},
{
"code": "GRAMINALES",
"displayName": "Graminées",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Très faible",
"indexDescription": "Les personnes extrêmement sensibles au pollen sont susceptibles de ressentir des symptômes.",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
}
},
{
"code": "RAGWEED",
"displayName": "Ambroisie",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 0,
"category": "Aucun",
"indexDescription": "Les niveaux de pollen sont très faibles et ont peu de risque de déclencher des réactions allergiques.",
"color": {}
}
},
{
"code": "ALDER",
"displayName": "Aulne"
},
{
"code": "MUGWORT",
"displayName": "Armoise",
"inSeason": false,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Très faible",
"indexDescription": "Les personnes extrêmement sensibles au pollen sont susceptibles de ressentir des symptômes.",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
}
}
]
}
]
}
頁面大小限制
要求範例
下列程式碼顯示如何建構 forecast:lookup 的要求。在本範例中，您將位置、預測天數 (在本例中為 4) 和頁面大小限制設為 1。這項要求只會傳回第一天的預測結果。回應包含 nextPageToken 屬性，您接著會在第二個要求中 (共 4 天) 使用這個屬性。
curl -X GET "https://pollen.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY&location.longitude=35.32 &location.latitude=32.32 &days=4 &pageSize=1"
回應範例
上述呼叫會產生下列 JSON 回應，包括 nextPageToken。您會在第二個要求中使用 nextPageToken，以存取次日的預測結果。
{
"regionCode": "IL",
"dailyInfo": [
{
"date": {
"year": 2023,
"month": 7,
"day": 14
},
"pollenTypeInfo": [
{
"code": "GRASS",
"displayName": "Grass",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 2,
"category": "Low",
"indexDescription": "People with high allergy to pollen are likely to experience symptoms",
"color": {
"red": 0.5176471,
"green": 0.8117647,
"blue": 0.2
}
},
"healthRecommendations": [
"It's a good day for outdoor activities since pollen levels are low.",
"Do you know which plants cause your pollen allergy? Check out the pollen data to be prepared."
]
},
{
"code": "TREE",
"displayName": "Tree",
"inSeason": false,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"healthRecommendations": [
"Pollen levels are very low right now. It's a great day to enjoy the outdoors!"
]
},
{
"code": "WEED",
"displayName": "Weed",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"healthRecommendations": [
"Pollen levels are very low right now. It's a great day to enjoy the outdoors!"
]
}
],
"plantInfo": [
{
"code": "BIRCH",
"displayName": "Birch",
"inSeason": false,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"plantDescription": {
"type": "TREE",
"family": "Betulaceae (the Birch family)",
"season": "Late winter, spring",
"specialColors": "The bark is usually whitish-gray, silver, or sometimes red.",
"specialShapes": "Birch leaves are often triangular with jagged edges. The bark on most birch trees has horizontal dark streaks that look like scoring. Birch tree bark is also well-known for its paper-like texture and peeling nature.",
"crossReaction": "Alder, Hazel, Hornbeam, Beech, Willow, and Oak pollen. In addition, there may be a higher risk for food allergies like hazelnuts, almonds, peanuts, pears, apples, cherries and carrots.",
"picture": "https://storage.googleapis.com/pollen-pictures/birch_full.jpg",
"pictureCloseup": "https://storage.googleapis.com/pollen-pictures/birch_closeup.jpg"
}
},
{
"code": "OLIVE",
"displayName": "Olive"
},
{
"code": "GRAMINALES",
"displayName": "Grasses",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 2,
"category": "Low",
"indexDescription": "People with high allergy to pollen are likely to experience symptoms",
"color": {
"red": 0.5176471,
"green": 0.8117647,
"blue": 0.2
}
},
"plantDescription": {
"type": "GRASS",
"family": "Poaceae",
"season": "Late spring, summer",
"specialColors": "None",
"specialShapes": "The leaves are alternate, long and narrow and the leaf margin is smooth.",
"crossReaction": "Plantain (Plantago) pollen. In addition, there may be a higher risk for food allergies like melons, oranges, tomatoes, peanuts, soy, potato, and other legumes.",
"picture": "https://storage.googleapis.com/pollen-pictures/graminales_full.jpg",
"pictureCloseup": "https://storage.googleapis.com/pollen-pictures/graminales_closeup.jpg"
}
},
{
"code": "RAGWEED",
"displayName": "Ragweed",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 0,
"category": "None",
"indexDescription": "Pollen levels are very low and are not likely to trigger allergic reactions",
"color": {}
},
"plantDescription": {
"type": "WEED",
"family": "Asteraceae (the daisy family)",
"season": "Late summer, fall",
"specialColors": "None",
"specialShapes": "The leaves are alternate or opposite, divided and lobed. The leaf margin is smooth or serrated.",
"crossReaction": "Mugwort and Goldenrod as well as daisies such as Sunflower, Dandelion, and Chamomile.",
"picture": "https://storage.googleapis.com/pollen-pictures/ragweed_full.jpg",
"pictureCloseup": "https://storage.googleapis.com/pollen-pictures/ragweed_closeup.jpg"
}
},
{
"code": "ALDER",
"displayName": "Alder"
},
{
"code": "MUGWORT",
"displayName": "Mugwort",
"inSeason": false,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"plantDescription": {
"type": "WEED",
"family": "Asteraceae (the daisy family)",
"season": "Late summer, fall",
"specialColors": "The leaves are green on the upper side and gray-green on the lower side.",
"specialShapes": "The leaves are alternate, divided and pinnate.",
"crossReaction": "Ragweed and Goldenrod pollen as well as daisies such as Sunflower, Dandelion and Chamomile. In addition, there may be a higher risk for food allergies like mustard, peach, celery and various herbs and spices.",
"picture": "https://storage.googleapis.com/pollen-pictures/mugwort_full.jpg",
"pictureCloseup": "https://storage.googleapis.com/pollen-pictures/mugwort_closeup.jpg"
}
}
]
}
],
"nextPageToken": "CAESdApadHlwZS5nb29nbGVhcGlzLm..."
}
如要存取第 2 頁，請在要求中插入 nextPageToken。回應中包含 nextPageToken，可讓您用來存取第 3 天的預測資料。
curl -X GET "https://pollen.googleapis.com/v1/forecast:lookup?key=YOUR_API_KEY&location.longitude=35.32 &location.latitude=32.32 &days=4 &pageSize=1 &pageToken=CAESdApadHlwZS5nb29nbGVhcGlzLm..."
回應提供了第 2 天的花粉預測資訊：
{
"regionCode": "IL",
"dailyInfo": [
{
"date": {
"year": 2023,
"month": 7,
"day": 15
},
"pollenTypeInfo": [
{
"code": "GRASS",
"displayName": "Grass",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 2,
"category": "Low",
"indexDescription": "People with high allergy to pollen are likely to experience symptoms",
"color": {
"red": 0.5176471,
"green": 0.8117647,
"blue": 0.2
}
},
"healthRecommendations": [
"It's a good day for outdoor activities since pollen levels are low.",
"Do you know which plants cause your pollen allergy? Check out the pollen data to be prepared."
]
},
{
"code": "TREE",
"displayName": "Tree",
"inSeason": false,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"healthRecommendations": [
"Pollen levels are very low right now. It's a great day to enjoy the outdoors!"
]
},
{
"code": "WEED",
"displayName": "Weed",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"healthRecommendations": [
"Pollen levels are very low right now. It's a great day to enjoy the outdoors!"
]
}
],
"plantInfo": [
{
"code": "BIRCH",
"displayName": "Birch",
"inSeason": false,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"plantDescription": {
"type": "TREE",
"family": "Betulaceae (the Birch family)",
"season": "Late winter, spring",
"specialColors": "The bark is usually whitish-gray, silver, or sometimes red.",
"specialShapes": "Birch leaves are often triangular with jagged edges. The bark on most birch trees has horizontal dark streaks that look like scoring. Birch tree bark is also well-known for its paper-like texture and peeling nature.",
"crossReaction": "Alder, Hazel, Hornbeam, Beech, Willow, and Oak pollen. In addition, there may be a higher risk for food allergies like hazelnuts, almonds, peanuts, pears, apples, cherries and carrots.",
"picture": "https://storage.googleapis.com/pollen-pictures/birch_full.jpg",
"pictureCloseup": "https://storage.googleapis.com/pollen-pictures/birch_closeup.jpg"
}
},
{
"code": "OLIVE",
"displayName": "Olive"
},
{
"code": "GRAMINALES",
"displayName": "Grasses",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 2,
"category": "Low",
"indexDescription": "People with high allergy to pollen are likely to experience symptoms",
"color": {
"red": 0.5176471,
"green": 0.8117647,
"blue": 0.2
}
},
"plantDescription": {
"type": "GRASS",
"family": "Poaceae",
"season": "Late spring, summer",
"specialColors": "None",
"specialShapes": "The leaves are alternate, long and narrow and the leaf margin is smooth.",
"crossReaction": "Plantain (Plantago) pollen. In addition, there may be a higher risk for food allergies like melons, oranges, tomatoes, peanuts, soy, potato, and other legumes.",
"picture": "https://storage.googleapis.com/pollen-pictures/graminales_full.jpg",
"pictureCloseup": "https://storage.googleapis.com/pollen-pictures/graminales_closeup.jpg"
}
},
{
"code": "RAGWEED",
"displayName": "Ragweed",
"inSeason": true,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 0,
"category": "None",
"indexDescription": "Pollen levels are very low and are not likely to trigger allergic reactions",
"color": {}
},
"plantDescription": {
"type": "WEED",
"family": "Asteraceae (the daisy family)",
"season": "Late summer, fall",
"specialColors": "None",
"specialShapes": "The leaves are alternate or opposite, divided and lobed. The leaf margin is smooth or serrated.",
"crossReaction": "Mugwort and Goldenrod as well as daisies such as Sunflower, Dandelion, and Chamomile.",
"picture": "https://storage.googleapis.com/pollen-pictures/ragweed_full.jpg",
"pictureCloseup": "https://storage.googleapis.com/pollen-pictures/ragweed_closeup.jpg"
}
},
{
"code": "ALDER",
"displayName": "Alder"
},
{
"code": "MUGWORT",
"displayName": "Mugwort",
"inSeason": false,
"indexInfo": {
"code": "UPI",
"displayName": "Universal Pollen Index",
"value": 1,
"category": "Very Low",
"indexDescription": "People with very high allergy to pollen are likely to experience symptoms",
"color": {
"green": 0.61960787,
"blue": 0.22745098
}
},
"plantDescription": {
"type": "WEED",
"family": "Asteraceae (the daisy family)",
"season": "Late summer, fall",
"specialColors": "The leaves are green on the upper side and gray-green on the lower side.",
"specialShapes": "The leaves are alternate, divided and pinnate.",
"crossReaction": "Ragweed and Goldenrod pollen as well as daisies such as Sunflower, Dandelion and Chamomile. In addition, there may be a higher risk for food allergies like mustard, peach, celery and various herbs and spices.",
"picture": "https://storage.googleapis.com/pollen-pictures/mugwort_full.jpg",
"pictureCloseup": "https://storage.googleapis.com/pollen-pictures/mugwort_closeup.jpg"
}
}
]
}
],
"nextPageToken": "CAISdApadHlwZS5nb29nbGVhcGlzLm..."
}