天気クエリスキル

このスキルは、AIエージェントが60s APIを使用して中国の地域の実時天気情報と予報を取得できます。

このスキルを使用する場合

以下の場合にこのスキルを使用してください：

• 現在の天気状況について聞かれた場合
• 天気予報が必要な場合
• 気温、湿度、風速情報が必要な場合
• 空気質の指標をリクエストされた場合
• 屋外活動計画に天気情報が必要な場合

APIエンドポイント

1. リアルタイム天気

URL: https://60s.viki.moe/v2/weather/realtime
Method: GET

2. 天気予報

URL: https://60s.viki.moe/v2/weather/forecast
Method: GET

パラメータ

• query (必須): 中国語の地名
  • 市町村名：「北京」、「上海」、「広州」
  • 地区名：「海淀区」、「浦東新区」

使用方法

リアルタイム天気を取得

import requests

def get_realtime_weather(query):
    url = 'https://60s.viki.moe/v2/weather/realtime'
    response = requests.get(url, params={'query': query})
    return response.json()

# Example
weather = get_realtime_weather('北京')
print(f"☁️ {weather['location']}天気")
print(f"🌡️ 温度：{weather['temperature']}°C")
print(f"💨 風速：{weather['wind']}")
print(f"💧 湿度：{weather['humidity']}")

天気予報を取得

def get_weather_forecast(query):
    url = 'https://60s.viki.moe/v2/weather/forecast'
    response = requests.get(url, params={'query': query})
    return response.json()

# Example
forecast = get_weather_forecast('上海')
for day in forecast['forecast']:
    print(f"{day['date']}: {day['weather']} {day['temp_low']}°C ~ {day['temp_high']}°C")

シンプルなbashの例

# リアルタイム天気
curl "https://60s.viki.moe/v2/weather/realtime?query=北京"

# 天気予報
curl "https://60s.viki.moe/v2/weather/forecast?query=上海"

レスポンス形式

リアルタイム天気レスポンス

{
  "location": "北京",
  "weather": "晴",
  "temperature": "15",
  "humidity": "45%",
  "wind": "東北風3級",
  "air_quality": "良",
  "updated": "2024-01-15 14:00:00"
}

予報レスポンス

{
  "location": "上海",
  "forecast": [
    {
      "date": "2024-01-15",
      "day_of_week": "星期一",
      "weather": "多云",
      "temp_low": "10",
      "temp_high": "18",
      "wind": "東風3-4級"
    },
    ...
  ]
}

インタラクション例

ユーザー：「北京今天天気怎么样？」

エージェントレスポンス:

weather = get_realtime_weather('北京')
response = f"""
☁️ 北京本日の天気

天気状況：{weather['weather']}
🌡️ 気温：{weather['temperature']}°C
💧 湿度：{weather['humidity']}
💨 風力：{weather['wind']}
🌫️ 空気質：{weather['air_quality']}
"""

ユーザー：「上海未来三天天気」

forecast = get_weather_forecast('上海')
response = "📅 上海の天気予報\n\n"
for day in forecast['forecast'][:3]:
    response += f"{day['date']} {day['day_of_week']}\n"
    response += f"  {day['weather']} {day['temp_low']}°C ~ {day['temp_high']}°C\n"
    response += f"  {day['wind']}\n\n"

ユーザー：「深圳会下雨吗？」

weather = get_realtime_weather('深圳')
if '雨' in weather['weather']:
    print("☔ はい、深圳は現在雨が降っています")
    print("傘を持って出かけることをお勧めします！")
else:
    forecast = get_weather_forecast('深圳')
    rain_days = [d for d in forecast['forecast'] if '雨' in d['weather']]
    if rain_days:
        print(f"将来{rain_days[0]['date']}雨が降る可能性があります")
    else:
        print("近期に降雨予報はありません")

ベストプラクティス

1. 地名: 常に地名に中国語の文字を使用してください

2. エラーハンドリング: 結果を表示する前に位置が有効であることを確認してください

3. コンテキスト: 天気状況に基づいて関連するコンテキストを提供してください

   • 雨：傘を持つことを提案
   • 暑い：水分補給を推奨
   • 寒い：暖かい服装をアドバイス
   • 低いAQI：マスク着用を提案

4. キャッシング: 天気データは定期的に更新されますが、短期間キャッシュできます

5. フォールバック: 特定の地区が機能しない場合は、市町村名を試してください

一般的な使用例

1. 天気ベースの推奨事項

def give_weather_advice(location):
    weather = get_realtime_weather(location)
    advice = []
    
    temp = int(weather['temperature'])
    if temp > 30:
        advice.append("🔥 天気が蒸し暑いので、熱中症対策をして水分補給してください")
    elif temp < 5:
        advice.append("🥶 天気が寒いので、防寒に気をつけてください")
    
    if '雨' in weather['weather']:
        advice.append("☔ 傘を忘れずに")
    
    if weather['air_quality'] in ['差', '重度污染']:
        advice.append("😷 空気質が悪いのでマスク着用をお勧めします")
    
    return '\n'.join(advice)

2. 複数都市の天気比較

def compare_weather(cities):
    results = []
    for city in cities:
        weather = get_realtime_weather(city)
        results.append({
            'city': city,
            'temperature': int(weather['temperature']),
            'weather': weather['weather']
        })
    
    # Find hottest and coldest
    hottest = max(results, key=lambda x: x['temperature'])
    coldest = min(results, key=lambda x: x['temperature'])
    
    return f"🌡️ 最も暑い: {hottest['city']} {hottest['temperature']}°C\n" \
           f"❄️ 最も寒い: {coldest['city']} {coldest['temperature']}°C"

3. 旅行天気チェック

def check_travel_weather(destination, days=3):
    forecast = get_weather_forecast(destination)
    suitable_days = []
    
    for day in forecast['forecast'][:days]:
        if '雨' not in day['weather'] and '雪' not in day['weather']:
            suitable_days.append(day['date'])
    
    if suitable_days:
        return f"✅ {destination}での旅行に適した日付：{', '.join(suitable_days)}"
    else:
        return f"⚠️ 今後{days}日間{destination}の天気は旅行に適していません"

トラブルシューティング

問題：位置が見つからない

• 解決策: 地区名の代わりに主要な市町村名を使用してください
• 例：「朝阳区」の代わりに「北京」を使用

問題：予報データがない

• 解決策: 位置名が正しいか確認してください
• 標準的な市町村名を試してください：北京、上海、広州、深圳など

問題：データが古く見える

• 解決策: APIは定期的に更新されますが、天気は急速に変わることがあります
• レスポンスのupdatedタイムスタンプを確認してください

サポートされている位置

天気APIは中国のほとんどの都市と地区をサポートしており、以下が含まれます：

• 省都：北京、上海、広州、深圳、成都、杭州、南京、武漢など
• 主要都市：蘇州、青島、大連、厦門など
• 地区：海淀区、朝阳区、浦東新区など

関連リソース

• 60s API Documentation
• GitHub Repository