Update app.py

app.py

@@ -96,7 +96,7 @@ def get_pollen_data(lat, lon, days=5):
         return f"Unexpected error: {str(e)}"
 
 def format_pollen_data(data):
-    """Format pollen data for display"""
+    """Format pollen data for display in user-friendly terms"""
     if isinstance(data, str):  # Error message
         return data, None
     
@@ -110,7 +110,16 @@ def format_pollen_data(data):
     # Location info if available
     if "regionInfo" in data:
         region = data["regionInfo"]
-        output.append(f"**Location:** {region.get('displayName', 'Unknown')}\n")
+        output.append(f"**📍 Location:** {region.get('displayName', 'Unknown')}\n")
+    
+    # Add explanation of what pollen index means
+    output.append("## 📊 Understanding Your Pollen Forecast\n")
+    output.append("**The Pollen Index** measures pollen concentration in the air:")
+    output.append("- **0-2:** Very Low - Most people won't have symptoms")
+    output.append("- **3-5:** Low - Few people with severe allergies may have mild symptoms") 
+    output.append("- **6-7:** Medium - People with allergies will likely have symptoms")
+    output.append("- **8-9:** High - Most people with allergies will have symptoms")
+    output.append("- **10+:** Very High - Everyone with allergies will have severe symptoms\n")
     
     # Daily pollen data
     daily_data = []
@@ -139,43 +148,80 @@ def format_pollen_data(data):
             date_obj = datetime.now()
             
         formatted_date = date_obj.strftime("%B %d, %Y")
+        day_of_week = date_obj.strftime("%A")
         
-        output.append(f"## 📅 {formatted_date}\n")
+        output.append(f"## 📅 {day_of_week}, {formatted_date}\n")
         
         if "pollenTypeInfo" in day_info:
             pollen_types = day_info["pollenTypeInfo"]
             
             # Create a row for the dataframe
-            row_data = {"Date": formatted_date}
+            row_data = {"Date": f"{day_of_week}, {formatted_date}"}
+            
+            # Calculate overall day severity
+            max_index = 0
+            total_types = 0
             
             for pollen in pollen_types:
                 pollen_type = pollen["code"].replace("_", " ").title()
                 index_info = pollen.get("indexInfo", {})
-                index_value = index_info.get("value", "N/A")
+                index_value = index_info.get("value", 0)
                 category = index_info.get("category", "Unknown")
                 
-                # Add color coding based on category
-                color_map = {
-                    "VERY_LOW": "🟢",
-                    "LOW": "🟡", 
-                    "MEDIUM": "🟠",
-                    "HIGH": "🔴",
-                    "VERY_HIGH": "🟣"
+                if isinstance(index_value, (int, float)) and index_value > max_index:
+                    max_index = index_value
+                total_types += 1
+                
+                # Convert technical terms to user-friendly descriptions
+                severity_map = {
+                    "VERY_LOW": {"emoji": "🟢", "description": "Excellent", "advice": "Great day to be outdoors!"},
+                    "LOW": {"emoji": "🟡", "description": "Good", "advice": "Most people will be fine outdoors"},
+                    "MEDIUM": {"emoji": "🟠", "description": "Moderate", "advice": "Consider taking allergy medication"},
+                    "HIGH": {"emoji": "🔴", "description": "Poor", "advice": "Limit outdoor activities if allergic"},
+                    "VERY_HIGH": {"emoji": "🟣", "description": "Very Poor", "advice": "Stay indoors if possible"}
+                }
+                
+                severity = severity_map.get(category, {"emoji": "⚪", "description": "Unknown", "advice": "Monitor symptoms"})
+                
+                # More specific pollen type descriptions
+                pollen_descriptions = {
+                    "Tree": "🌳 Tree pollen (oak, birch, cedar, etc.)",
+                    "Grass": "🌱 Grass pollen (timothy, bermuda, etc.)", 
+                    "Weed": "🌿 Weed pollen (ragweed, sagebrush, etc.)"
                 }
-                color = color_map.get(category, "⚪")
                 
-                output.append(f"**{pollen_type}:** {color} {category} (Index: {index_value})")
-                row_data[pollen_type] = f"{category} ({index_value})"
+                pollen_desc = pollen_descriptions.get(pollen_type, f"🌸 {pollen_type}")
+                
+                output.append(f"### {pollen_desc}")
+                output.append(f"**Level:** {severity['emoji']} {severity['description']} (Index: {index_value}/10)")
+                output.append(f"**What this means:** {severity['advice']}")
+                
+                row_data[pollen_type] = f"{severity['description']} ({index_value})"
                 
                 # Add plant descriptions if available
                 if "plantDescription" in pollen:
                     plants = pollen["plantDescription"]
                     if "plants" in plants:
                         plant_list = [plant["displayName"] for plant in plants["plants"][:3]]  # Show top 3
-                        output.append(f"  - *Main sources: {', '.join(plant_list)}*")
+                        output.append(f"**Main sources:** {', '.join(plant_list)}")
                 
                 output.append("")
             
+            # Add overall day assessment
+            if max_index > 0:
+                if max_index <= 2:
+                    day_rating = "🟢 **Excellent day** for outdoor activities!"
+                elif max_index <= 5:
+                    day_rating = "🟡 **Good day** - most people will be comfortable outside"
+                elif max_index <= 7:
+                    day_rating = "🟠 **Moderate day** - allergy sufferers should prepare"
+                elif max_index <= 9:
+                    day_rating = "🔴 **Challenging day** - limit outdoor exposure if allergic"
+                else:
+                    day_rating = "🟣 **Very difficult day** - stay indoors if you have allergies"
+                
+                output.append(f"**Overall Assessment:** {day_rating}\n")
+            
             daily_data.append(row_data)
         
         output.append("---\n")
@@ -185,16 +231,28 @@ def format_pollen_data(data):
     if daily_data:
         df = pd.DataFrame(daily_data)
     
-    # Add legend
-    output.append("\n## 📊 Pollen Index Legend")
-    output.append("🟢 Very Low | 🟡 Low | 🟠 Medium | 🔴 High | 🟣 Very High\n")
+    # Add comprehensive advice section
+    output.append("\n## 💡 Practical Tips for Pollen Season")
+    output.append("### 🏠 **Indoor Protection:**")
+    output.append("- Keep windows and doors closed during high pollen days")
+    output.append("- Use air conditioning with clean HEPA filters")
+    output.append("- Consider an air purifier for your bedroom")
+    
+    output.append("\n### 🚶 **When Going Outside:**")
+    output.append("- Check this forecast before planning outdoor activities")
+    output.append("- Wear wraparound sunglasses to protect your eyes")
+    output.append("- Consider wearing a mask during very high pollen days")
+    output.append("- Plan outdoor activities for late evening when pollen counts are lower")
     
-    # Add tips
-    output.append("## 💡 Tips")
-    output.append("- Check pollen levels before outdoor activities")
-    output.append("- Take allergy medications during high pollen days")
-    output.append("- Keep windows closed during peak pollen times")
-    output.append("- Shower and change clothes after being outdoors")
+    output.append("\n### 🚿 **After Being Outdoors:**")
+    output.append("- Shower and change clothes to remove pollen")
+    output.append("- Wash your hair before bed to avoid pollen on your pillow")
+    output.append("- Keep pets indoors or wipe them down after walks")
+    
+    output.append("\n### 💊 **Medication Timing:**")
+    output.append("- Start allergy medications BEFORE symptoms begin")
+    output.append("- Take antihistamines in the evening for next-day protection")
+    output.append("- Consult your doctor about prescription options for severe allergies")
     
     return "\n".join(output), df
 
@@ -217,7 +275,8 @@ with gr.Blocks(title="🌸 Pollen Forecast Map", theme=gr.themes.Soft()) as app:
     gr.HTML("""
     <div style="text-align: center; padding: 20px;">
         <h1>🌸 Pollen Forecast Map</h1>
-        <p>Click on the map to select a location and get detailed pollen forecasts powered by Google Pollen API</p>
+        <p>Get detailed, easy-to-understand pollen forecasts for any location worldwide!</p>
+        <p><strong>💡 How to use:</strong> Search by address, use preset cities, or enter coordinates manually</p>
     </div>
     """)
     
@@ -225,35 +284,56 @@ with gr.Blocks(title="🌸 Pollen Forecast Map", theme=gr.themes.Soft()) as app:
         with gr.Column(scale=1):
             gr.HTML("<h3>📍 Location Selection</h3>")
             
+            # Address search
+            gr.HTML("<h4>🔍 Search by Address</h4>")
+            address_input = gr.Textbox(
+                label="Enter Address or City", 
+                placeholder="e.g., Central Park, New York or Paris, France",
+                info="Enter any address, city, or landmark"
+            )
+            search_btn = gr.Button("🔍 Search Address", variant="primary")
+            
+            gr.HTML("<h4>📐 Or Use Coordinates</h4>")
             # Coordinate inputs
             lat_input = gr.Number(
                 label="Latitude", 
                 value=40.7128, 
                 precision=6,
-                info="Enter latitude or click on map"
+                info="Enter latitude (-90 to 90)"
             )
             lon_input = gr.Number(
                 label="Longitude", 
                 value=-74.0060, 
                 precision=6,
-                info="Enter longitude or click on map"
+                info="Enter longitude (-180 to 180)"
             )
             
-            update_btn = gr.Button("🔄 Update Location", variant="primary")
+            update_btn = gr.Button("🔄 Update Location", variant="secondary")
             
             # Preset locations
-            gr.HTML("<h4>📍 Quick Locations</h4>")
+            gr.HTML("<h4>🏙️ Popular Cities</h4>")
+            with gr.Row():
+                nyc_btn = gr.Button("🗽 New York", size="sm")
+                la_btn = gr.Button("🌴 Los Angeles", size="sm") 
             with gr.Row():
-                nyc_btn = gr.Button("🏙️ NYC", size="sm")
-                la_btn = gr.Button("🌴 LA", size="sm") 
                 chicago_btn = gr.Button("🌬️ Chicago", size="sm")
                 miami_btn = gr.Button("🏖️ Miami", size="sm")
+            with gr.Row():
+                london_btn = gr.Button("🇬🇧 London", size="sm")
+                tokyo_btn = gr.Button("🇯🇵 Tokyo", size="sm")
         
         with gr.Column(scale=2):
             # Map display
             map_html = gr.HTML(
                 value=create_map(),
-                label="Interactive Map"
+                label="📍 Current Location"
+            )
+            
+            # Location info display
+            location_info = gr.Textbox(
+                label="📍 Selected Location",
+                value="New York City, NY, USA",
+                interactive=False
             )
     
     with gr.Row():
@@ -271,19 +351,46 @@ with gr.Blocks(title="🌸 Pollen Forecast Map", theme=gr.themes.Soft()) as app:
             )
     
     # Event handlers
+    def search_address(address):
+        """Search for address and return coordinates"""
+        if not address.strip():
+            return 40.7128, -74.0060, "Please enter an address to search"
+        
+        lat, lon, display_name = geocode_address(address)
+        if lat is not None and lon is not None:
+            return lat, lon, display_name
+        else:
+            return 40.7128, -74.0060, display_name  # display_name contains error message
+    
     def set_nyc():
-        return 40.7128, -74.0060
+        return 40.7128, -74.0060, "New York City, NY, USA"
     
     def set_la():
-        return 34.0522, -118.2437
+        return 34.0522, -118.2437, "Los Angeles, CA, USA"
     
     def set_chicago():
-        return 41.8781, -87.6298
+        return 41.8781, -87.6298, "Chicago, IL, USA"
     
     def set_miami():
-        return 25.7617, -80.1918
+        return 25.7617, -80.1918, "Miami, FL, USA"
+        
+    def set_london():
+        return 51.5074, -0.1278, "London, England, UK"
+        
+    def set_tokyo():
+        return 35.6762, 139.6503, "Tokyo, Japan"
     
     # Button events
+    search_btn.click(
+        fn=search_address,
+        inputs=[address_input],
+        outputs=[lat_input, lon_input, location_info]
+    ).then(
+        fn=update_location,
+        inputs=[lat_input, lon_input],
+        outputs=[map_html, pollen_output, pollen_table]
+    )
+    
     update_btn.click(
         fn=update_location,
         inputs=[lat_input, lon_input],
@@ -292,7 +399,7 @@ with gr.Blocks(title="🌸 Pollen Forecast Map", theme=gr.themes.Soft()) as app:
     
     nyc_btn.click(
         fn=set_nyc,
-        outputs=[lat_input, lon_input]
+        outputs=[lat_input, lon_input, location_info]
     ).then(
         fn=update_location,
         inputs=[lat_input, lon_input],
@@ -301,7 +408,7 @@ with gr.Blocks(title="🌸 Pollen Forecast Map", theme=gr.themes.Soft()) as app:
     
     la_btn.click(
         fn=set_la,
-        outputs=[lat_input, lon_input]
+        outputs=[lat_input, lon_input, location_info]
     ).then(
         fn=update_location,
         inputs=[lat_input, lon_input],
@@ -310,7 +417,7 @@ with gr.Blocks(title="🌸 Pollen Forecast Map", theme=gr.themes.Soft()) as app:
     
     chicago_btn.click(
         fn=set_chicago,
-        outputs=[lat_input, lon_input]
+        outputs=[lat_input, lon_input, location_info]
     ).then(
         fn=update_location,
         inputs=[lat_input, lon_input],
@@ -319,7 +426,25 @@ with gr.Blocks(title="🌸 Pollen Forecast Map", theme=gr.themes.Soft()) as app:
     
     miami_btn.click(
         fn=set_miami,
-        outputs=[lat_input, lon_input]
+        outputs=[lat_input, lon_input, location_info]
+    ).then(
+        fn=update_location,
+        inputs=[lat_input, lon_input],
+        outputs=[map_html, pollen_output, pollen_table]
+    )
+    
+    london_btn.click(
+        fn=set_london,
+        outputs=[lat_input, lon_input, location_info]
+    ).then(
+        fn=update_location,
+        inputs=[lat_input, lon_input],
+        outputs=[map_html, pollen_output, pollen_table]
+    )
+    
+    tokyo_btn.click(
+        fn=set_tokyo,
+        outputs=[lat_input, lon_input, location_info]
     ).then(
         fn=update_location,
         inputs=[lat_input, lon_input],
@@ -341,6 +466,9 @@ with gr.Blocks(title="🌸 Pollen Forecast Map", theme=gr.themes.Soft()) as app:
     
     # Load initial data
     app.load(
+        fn=lambda: (40.7128, -74.0060, "New York City, NY, USA"),
+        outputs=[lat_input, lon_input, location_info]
+    ).then(
         fn=update_location,
         inputs=[lat_input, lon_input],
         outputs=[map_html, pollen_output, pollen_table]