一、服务核心能力全景

1. 数据覆盖范围

2. 性能指标

• 端侧响应：<300ms（缓存命中时）
• 数据压缩率：原始数据体积减少 70%
• 功耗控制：单次查询平均耗电 ≤0.2mAh

二、接入全流程指南

1. 环境配置

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

2. 证书配置（同Account Kit）

• 完成应用签名
• 开通Weather Kit服务（AGC控制台）

3. 初始化定位服务

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 };
}

三、天气数据获取实战

1. 实时天气查询

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();
    }
  }
}

2. 七日预报获取

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}℃`);
  });
}

3. 灾害预警订阅

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

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

四、数据模型解析

1. 核心数据结构

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;    // "新月"
}

2. 生活指数类型

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

五、性能优化策略

1. 智能缓存机制

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

2. 按需更新策略

3. 位置缓存优化

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

六、隐私合规要点

1. 透明告知：// privacy.json "dataPermissions": [ { "name": "LOCATION", "usage": "用于获取用户位置提供本地天气服务" } ]
2. 最小化采集：禁止存储用户精确定位（只保留城市级）
3. 用户控制权：提供位置服务开关Toggle({ isOn: this.enableLocation }) .onChange((value) => { setPrivacySetting('location', value); })

七、错误处理大全

八、典型场景实现

1. 智能家居联动

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

2. 出行建议推送

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

九、FAQ解决方案

十、最佳实践总结

1. 数据使用：实时天气：首页展示24小时预报：出行规划生活指数：场景化推荐
2. 体验优化：// 平滑过渡动画 WeatherIcon() .transition({ duration: 500, curve: Curve.Ease })
3. 商用建议：企业认证账号可提升至100万次/日调用付费订阅提供分钟级降水预报