Create app.py

app.py

@@ -0,0 +1,151 @@
+import gradio as gr
+import pandas as pd
+from pytrends.request import TrendReq
+import plotly.express as px
+import plotly.graph_objects as go
+
+DEVELOPER_NAME = "黃千宥、陳奕瑄、汪于捷、李哲弘、洪寓澤"
+
+# 初始化 pytrends
+# hl='zh-TW' -> 繁體中文, tz=480 -> 台灣時區 (GMT+8)
+pytrends = TrendReq(hl='zh-TW', tz=480)
+PLOTLY_TEMPLATE = "plotly_dark"
+def analyze_google_trends(keywords_str: str, timeframe: str):
+    """
+    根據輸入的關鍵字和時間範圍，從 Google Trends 獲取並分析資料。
+
+    Args:
+        keywords_str: 以逗號分隔的關鍵字字串。
+        timeframe: Gradio 選項對應的時間範圍字串。
+
+    Returns:
+        一個包含兩個 Plotly 圖表的元組 (時間趨勢圖, 區域熱度圖)。
+    """
+    if not keywords_str:
+        gr.Warning("請至少輸入一個關鍵字！")
+        # 回傳空的圖表
+        return go.Figure(), go.Figure()
+
+    # 解析關鍵字
+    kw_list = [kw.strip() for kw in keywords_str.split(',')]
+    if len(kw_list) > 5:
+        gr.Warning("為了圖表清晰，最多支援比較 5 個關鍵字。")
+        kw_list = kw_list[:5]
+
+    # 對應 Gradio 選項到 pytrends 的時間格式
+    timeframe_map = {
+        "過去 7 天": 'now 7-d',
+        "過去一個月": 'today 1-m',
+        "過去三個月": 'today 3-m',
+        "過去一年": 'today 12-m',
+    }
+    selected_timeframe = timeframe_map.get(timeframe, 'now 7-d')
+
+    try:
+        # 1. 獲取時間序列資料
+        pytrends.build_payload(kw_list, cat=0, timeframe=selected_timeframe, geo='', gprop='')
+        interest_over_time_df = pytrends.interest_over_time()
+
+        if interest_over_time_df.empty:
+            gr.Warning(f"找不到關於 '{keywords_str}' 的時間趨勢資料。")
+            time_fig = go.Figure()
+        else:
+            interest_over_time_df = interest_over_time_df.drop(columns=['isPartial'], errors='ignore')
+            time_fig = plot_interest_over_time(interest_over_time_df, f"'{', '.join(kw_list)}' 在過去 {timeframe} 的搜尋熱度趨勢")
+
+        # 2. 獲取區域熱度資料
+        # 注意：區域熱度分析不支援多個關鍵字同時比較，因此我們只分析第一個關鍵字
+        first_keyword = kw_list[0]
+        pytrends.build_payload([first_keyword], cat=0, timeframe=selected_timeframe, geo='', gprop='')
+        interest_by_region_df = pytrends.interest_by_region(resolution='COUNTRY', inc_low_vol=True, inc_geo_code=False)
+        
+        if interest_by_region_df.empty:
+            gr.Warning(f"找不到關於 '{first_keyword}' 的區域熱度資料。")
+            region_fig = go.Figure()
+        else:
+            # 只取前 20 名
+            interest_by_region_df = interest_by_region_df.sort_values(by=first_keyword, ascending=False).head(20)
+            region_fig = plot_interest_by_region(interest_by_region_df, f"'{first_keyword}' 在全球的區域熱度 Top 20")
+
+        return time_fig, region_fig
+
+    except Exception as e:
+        gr.Error(f"查詢時發生錯誤: {e}")
+        return go.Figure(), go.Figure()
+
+def plot_interest_over_time(df: pd.DataFrame, title: str):
+    """使用 Plotly 繪製時間趨勢圖。"""
+    fig = px.line(df, x=df.index, y=df.columns, title=title, labels={'value': '相對熱度', 'date': '日期', 'variable': '關鍵字'})
+    fig.update_layout(
+        template=PLOTLY_TEMPLATE,
+        paper_bgcolor='rgba(0,0,0,0)',
+        plot_bgcolor='rgba(0,0,0,0.2)',
+        legend_title_text=''
+    )
+    return fig
+
+def plot_interest_by_region(df: pd.DataFrame, title: str):
+    """使用 Plotly 繪製區域熱度長條圖。"""
+    fig = px.bar(df, x=df.index, y=df.columns[0], title=title, labels={'y': '相對熱度', 'index': '國家/地區'})
+    fig.update_layout(
+        template=PLOTLY_TEMPLATE,
+        paper_bgcolor='rgba(0,0,0,0)',
+        plot_bgcolor='rgba(0,0,0,0.2)'
+    )
+    fig.update_xaxes(categoryorder='total descending')
+    return fig
+
+with gr.Blocks(
+    theme=gr.themes.Soft(
+        primary_hue="blue", 
+        secondary_hue="cyan", 
+        font=["Arial", "sans-serif"]
+    )
+) as app:
+    gr.Markdown(f"""
+    <div style='text-align: center; padding: 20px; color: white;'>
+        <h1 style='font-size: 3em; color: #2563eb;'>📊 Google Trends 趨勢分析儀表板</h1>
+        <p style='font-size: 1.2em; color: #A9A9A9;'>輸入關鍵字，洞察全球搜尋趨勢與市場脈動</p>
+        <p style='font-size: 0.9em; color: #888;'>Designed by: {DEVELOPER_NAME}</p>
+    </div>
+    """)
+
+    with gr.Group():
+        with gr.Row():
+            keywords_input = gr.Textbox(
+                label="🔍 輸入關鍵字",
+                placeholder="例如：Bitcoin, Ethereum, Dogecoin (以逗號分隔)",
+                scale=3
+            )
+            timeframe_input = gr.Radio(
+                ["過去 7 天", "過去一個月", "過去三個月", "過去一年"],
+                label="🗓️ 選擇時間範圍",
+                value="過去 7 天",
+                scale=2
+            )
+        analyze_button = gr.Button("🚀 開始分析", variant="primary")
+
+    with gr.Tabs():
+        with gr.TabItem("📈 時間趨勢比較"):
+            time_series_plot = gr.Plot()
+        with gr.TabItem("🌍 全球區域熱度"):
+            region_plot = gr.Plot()
+            gr.Markdown("<p style='text-align: center; color: #888;'>註：區域熱度分析僅針對您輸入的第一個關鍵字。</p>")
+
+
+    analyze_button.click(
+        fn=analyze_google_trends,
+        inputs=[keywords_input, timeframe_input],
+        outputs=[time_series_plot, region_plot]
+    )
+
+    gr.Examples(
+        examples=[
+            ["Bitcoin, Ethereum", "過去三個月"],
+            ["穩定幣, Coinbase", "過去一年"],
+            ["NVIDIA, AMD, TSMC", "過去一個月"],
+        ],
+        inputs=[keywords_input, timeframe_input]
+    )
+
+app.launch(share=True, debug=False, show_error=True, show_api=False)