可用于实时查询城市天气、管理城市列表及切换天气视图。支持多城市增删、本地数据持久化和下拉刷新,集成高德地图天气 API 提供精准气象数据,具备友好的加载与异常处理交互。【此简介由AI生成】
Access rate limit exceeded. Please log in to continue.
城市天气展示 App
一款基于 React Native 开发的跨平台天气应用,支持城市天气实时查询、城市增删、温度/天气视图切换、本地数据持久化及下拉刷新功能,集成高德地图天气 API 提供精准天气数据。
功能特性
- 实时天气查询:获取目标城市的温度、天气状况、风向、风力、湿度等核心气象数据,并展示数据更新时间
- 多城市管理:支持预设城市列表,可手动添加新城市(支持拼音/汉字匹配),也可删除已添加城市(保留至少1个城市)
- 视图切换:提供「温度优先」和「天气优先」两种展示视图,按需切换查看重点信息
- 本地持久化:通过 AsyncStorage 将城市列表缓存到本地,应用重启后无需重新添加城市
- 下拉刷新:支持下拉刷新当前城市的最新天气数据,保证数据时效性
- 加载与异常处理:包含加载状态提示、网络错误提示、城市不存在提示等友好交互
- 城市匹配提示:输入城市名称时,实时匹配并提示可用城市,提升添加效率
技术栈
- 前端框架:React Native
- 状态管理:React Hooks(useState、useEffect、useCallback)
- 网络请求:Axios
- 本地存储:@react-native-async-storage/async-storage
- UI 组件:React Native 原生组件(View、Text、FlatList、TouchableOpacity 等)
- 接口服务:高德地图天气 API(v3 版本)
前置准备
1. 环境配置
确保已搭建完整的 React Native 开发环境,包含:
- Node.js(建议 14.x 及以上版本)
- Android Studio / Xcode(对应安卓/iOS 开发环境)
- React Native CLI 或 Expo CLI
2. 高德 API Key 获取
该应用依赖高德地图天气 API,需提前获取有效 API Key:
- 访问 高德开放平台 注册并登录账号
- 进入「控制台」-「应用管理」,创建新应用并添加「天气 API」服务
- 复制应用对应的 API Key(需确保 API Key 已启用天气服务权限)
3. 依赖安装
将项目克隆/下载后,执行以下命令安装依赖:
# 安装 npm 依赖
npm install
# 若使用 yarn
yarn install
# 安卓端额外同步依赖
cd android && ./gradlew clean && cd ..
配置说明
- 打开项目根目录下的主文件(包含上述代码的文件)
- 找到
AMAP_API_KEY常量,替换为你自己获取的高德 API Key:// 替换为你的高德 API Key const AMAP_API_KEY = '你的高德API Key'; - 预设城市可通过
CITY_PINYIN_MAP常量修改,支持添加/删除拼音与城市名的映射关系
运行方式
安卓端
# 启动安卓模拟器或连接真机(开启 USB 调试)
npx react-native run-android
`
使用指南
- 查看天气:应用启动后自动加载本地缓存的城市列表,默认展示第一个城市的天气数据
- 切换城市:在「已添加城市」列表中,点击目标城市即可切换并查看对应天气
- 添加城市:在输入框中输入城市汉字(如
北京),点击「添加城市」即可完成添加(已存在城市会给出提示) - 切换视图:在天气卡片中,「温度」/「天气」会自动切换不同展示视图
- 刷新天气:下拉天气展示区域,可刷新当前城市的最新天气数据
- 删除城市:在城市列表项右侧点击「×」按钮,二次确认后即可删除对应城市(当前查看城市和最后一个城市无法删除)
注意事项
- 确保 API Key 有效且已开启天气服务权限,否则无法获取天气数据
- 网络异常时,应用会给出明确提示,请检查网络连接后重试
- 仅支持
CITY_PINYIN_MAP中预设的城市及可匹配的城市添加,非预设城市可能无法获取天气数据 - 本地存储依赖 AsyncStorage,卸载应用后缓存的城市列表会丢失
界面说明
- 头部区域:展示应用名称「城市天气助手」
- 天气卡片区域:核心区域,展示城市名称、数据更新时间、温度/天气信息及附属气象数据
- 城市添加区域:包含输入框和添加按钮,支持城市输入与匹配提示
- 城市列表区域:以两列网格形式展示已添加城市,支持城市切换与删除操作
常见问题
- 无法获取天气数据:
- 检查 API Key 是否正确且有效
- 检查网络连接是否正常
- 确认输入的城市名称是否在支持范围内
- 城市添加失败:
- 确认输入的城市拼音/汉字是否正确
- 确认该城市未已添加到列表中
- 检查网络连接是否正常
- 无法删除城市:
- 当前城市无法删除,需先切换到其他城市
- 应用至少保留1个城市,最后一个城市无法删除
Introduction
可用于实时查询城市天气、管理城市列表及切换天气视图。支持多城市增删、本地数据持久化和下拉刷新,集成高德地图天气 API 提供精准气象数据,具备友好的加载与异常处理交互。【此简介由AI生成】
Customize your domain