HarmonyOS 天气服务（Weather Kit）服务能力、接入流程、最佳实践及问题解决方案：

// module.json5
"dependencies": {
  "@ohos.weather": "1.0.0"
},
"requestPermissions": [
  {
    "name": "ohos.permission.LOCATION",
    "reason": "获取精准位置提供本地化天气服务"
  }
]

import geoLocationManager from '@ohos.geoLocationManager';

// 获取位置权限
const requestLocation = async () => {
  const atManager = abilityAccessCtrl.createAtManager();
  await atManager.requestPermissionsFromUser(
    getContext(this), 
    ['ohos.permission.LOCATION']
  );
  
  // 获取当前位置
  const location = await geoLocationManager.getCurrentLocation({
    priority: geoLocationManager.LocationRequestPriority.FIRST_FIX
  });
  return { lat: location.latitude, lon: location.longitude };
}

import weather from '@ohos.weather';

const getCurrentWeather = async () => {
  const weatherService = weather.getWeatherService();
  const config: weather.WeatherConfig = {
    geo: await requestLocation(),  // 获取位置
    lang: 'zh',                    // 中文结果
    unit: 'metric'                 // 公制单位
  };
  
  try {
    const current = await weatherService.queryCurrentWeather(config);
    console.log(`温度: ${current.temperature}℃`);
    console.log(`天气: ${current.weatherDesc}`);
  } catch (error) {
    if (error.code === 1001) { // 网络错误
      showOfflineWeather();
    }
  }
}

const getWeeklyForecast = async () => {
  const forecast = await weatherService.queryWeatherForecast({
    days: 7,  // 获取7天预报
    hourly: false
  });
  
  forecast.daily.forEach(day => {
    console.log(`${day.date}: ${day.minTemp}~${day.maxTemp}℃`);
  });
}

// 注册预警监听
weatherService.on('severeWeatherAlert', (alert) => {
  promptAction.showToast({
    message: `[${alert.type}] ${alert.description}`,
    duration: 10000  // 延长显示时间
  });
});

// 启动预警服务
weatherService.startAlertMonitoring();

interface CurrentWeather {
  temperature: number;  // 温度(℃)
  humidity: number;     // 湿度(%)
  windSpeed: number;    // 风速(km/h)
  weatherDesc: string;  // "晴"/"多云"
  updateTime: string;   // 最后更新时间
}

interface DailyForecast {
  date: string;         // yyyy-MM-dd
  maxTemp: number;
  minTemp: number;
  sunrise: string;      // "06:12"
  moonPhase: string;    // "新月"
}

enum LifeIndexType {
  ULTRAVIOLET = 1,     // 紫外线
  DRESSING,            // 穿衣
  CAR_WASHING,         // 洗车
  SPORTS,              // 运动
  AIR_POLLUTION        // 空气污染
}

// 使用CACHE策略（默认2小时）
const result = await weatherService.queryCurrentWeather({
  strategy: weather.StrategyType.STRATEGY_CACHE_FIRST
});

// 存储常用位置（减少定位调用）
AppStorage.setOrCreate('lastLocation', location);

// 温度>30℃自动开空调
weatherService.on('weatherUpdate', (data) => {
  if (data.temperature > 30) {
    smartHomeControl.sendCommand('AC_ON');
  }
});

// 降雨概率>60%推送带伞提醒
if (forecast.precipitationProb > 60) {
  pushAgent.sendMessage({
    title: '出行提示',
    content: '今日降雨概率高，建议携带雨具'
  });
}