HTML如何实现天气预报？API数据怎么获取？

星降

发布时间：2025-08-13 09:29:01

527人浏览过

来源于php中文网

原创

html无法直接实现天气预报，必须结合javascript通过api获取数据；2. 实现步骤为：搭建html结构、申请api密钥（如openweathermap）、使用javascript的fetch和async/await发起异步请求；3. 获取json数据后解析并动态更新dom元素内容；4. 通过document.getelementbyid等方法获取页面元素，用textcontent填充温度、湿度等信息；5. 优化体验需添加加载提示、错误处理、用户输入交互、数据格式化和响应式设计。完整流程是“html搭骨架，javascript拿数据并填肉”，最终实现动态天气预报功能。

HTML如何实现天气预报？API数据怎么获取？

HTML本身无法直接实现天气预报，它更像是一个舞台，负责呈现内容。真正让天气动起来、活起来的，是JavaScript。通过JavaScript，我们向外部的天气数据接口（API）发出请求，获取实时的天气信息，再动态地把这些数据展示在HTML页面上。简单来说，就是“HTML搭骨架，JavaScript去拿数据并填肉”。

解决方案

要实现一个简单的HTML天气预报功能，核心步骤是：搭建HTML结构、用JavaScript获取API数据并更新DOM。

首先，你需要一个API密钥。我个人比较常用的是OpenWeatherMap，它提供免费的API额度，对于学习和小型项目来说非常友好。注册后，你就能拿到一个API Key。

立即学习“前端免费学习笔记（深入）”；

接下来，我们构建一个基本的HTML文件：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>简易天气预报</title>
    <style>
        body {
            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
            display: flex;
            justify-content: center;
            align-items: center;
            min-height: 100vh;
            background-color: #f0f2f5;
            margin: 0;
        }
        .weather-container {
            background-color: #fff;
            padding: 30px;
            border-radius: 12px;
            box-shadow: 0 4px 20px rgba(0, 0, 0, 0.1);
            text-align: center;
            width: 300px;
            max-width: 90%;
            transition: all 0.3s ease;
        }
        .weather-container h2 {
            margin-top: 0;
            color: #333;
            font-size: 1.8em;
        }
        .weather-container p {
            color: #666;
            font-size: 1.1em;
            margin: 8px 0;
        }
        .temperature {
            font-size: 3em;
            color: #ff5722;
            font-weight: bold;
            margin-bottom: 15px;
        }
        .description {
            font-style: italic;
            color: #4CAF50;
            margin-bottom: 20px;
        }
        .error-message {
            color: #e53935;
            font-weight: bold;
        }
        .loading {
            color: #2196F3;
        }
    </style>
</head>
<body>
    <div class="weather-container">
        <h2><span id="city-name">加载中...</span>天气</h2>
        <p class="temperature"><span id="temperature">--</span>°C</p>
        <p><span id="description"></span></p>
        <p>湿度: <span id="humidity">--</span>%</p>
        <p>风速: <span id="wind-speed">--</span> m/s</p>
        <p id="error-display" class="error-message"></p>
    </div>

    <script>
        const API_KEY = 'YOUR_OPENWEATHERMAP_API_KEY'; // 替换成你的API Key
        const CITY_NAME = 'Shanghai'; // 你想查询的城市，也可以做成用户输入

        const cityNameElement = document.getElementById('city-name');
        const temperatureElement = document.getElementById('temperature');
        const descriptionElement = document.getElementById('description');
        const humidityElement = document.getElementById('humidity');
        const windSpeedElement = document.getElementById('wind-speed');
        const errorDisplayElement = document.getElementById('error-display');

        async function getWeatherData() {
            cityNameElement.textContent = '加载中...';
            temperatureElement.textContent = '--';
            descriptionElement.textContent = '';
            humidityElement.textContent = '--';
            windSpeedElement.textContent = '--';
            errorDisplayElement.textContent = '';

            try {
                // OpenWeatherMap API URL，单位设置为摄氏度 (units=metric)
                const url = `https://api.openweathermap.org/data/2.5/weather?q=${CITY_NAME}&appid=${API_KEY}&units=metric&lang=zh_cn`;

                const response = await fetch(url);

                if (!response.ok) {
                    // 检查HTTP状态码，处理非200的情况
                    const errorData = await response.json();
                    throw new Error(`无法获取天气数据：${errorData.message || response.statusText}`);
                }

                const data = await response.json();

                cityNameElement.textContent = data.name;
                temperatureElement.textContent = Math.round(data.main.temp);
                descriptionElement.textContent = data.weather[0].description;
                humidityElement.textContent = data.main.humidity;
                windSpeedElement.textContent = data.wind.speed;

            } catch (error) {
                console.error('获取天气数据时发生错误:', error);
                errorDisplayElement.textContent = `抱歉，获取天气失败: ${error.message}`;
                cityNameElement.textContent = '未知';
                temperatureElement.textContent = '--';
                descriptionElement.textContent = '无法获取';
                humidityElement.textContent = '--';
                windSpeedElement.textContent = '--';
            }
        }

        // 页面加载完成后立即获取天气数据
        document.addEventListener('DOMContentLoaded', getWeatherData);

        // 也可以设置定时刷新，例如每5分钟刷新一次
        // setInterval(getWeatherData, 300000); 
    </script>
</body>
</html>

这段代码里，我们用

fetch

API向OpenWeatherMap请求数据，

async/await

让异步操作看起来更像同步，便于理解和调试。获取到JSON数据后，我们解析它，然后把需要的信息（比如温度、描述）填充到HTML对应的元素里。

如何选择和获取天气API数据？

选择合适的天气API，在我看来，主要看几个点：数据准确性、免费额度、文档清晰度、以及它是否支持你需要的特定功能（比如历史数据、未来预测等）。市面上有很多知名的天气API服务商，比如OpenWeatherMap、WeatherAPI.com、AccuWeather Developers、和一些国内的服务商。

获取API数据的第一步，通常是去这些服务商的官方网站注册一个账号。注册成功后，他们会给你一个独一无二的API Key（或称App ID）。这个Key就像你的身份证明，每次你向API请求数据时，都需要带着它，这样服务商才能识别你是谁，并根据你的套餐限制来提供服务。

拿到Key之后，最重要的就是阅读API文档。这步千万不能跳过，我见过太多新手直接拿着Key就开始乱试，结果碰一鼻子灰。文档里会详细说明：

API的请求地址（Endpoint）：你要把请求发到哪里。
请求参数（Parameters）：你需要提供哪些信息，比如城市名、经纬度、单位（摄氏度/华氏度）、语言等。这些参数通常会作为URL的一部分或者请求头的一部分发送。
响应格式（Response Format）：API会返回什么格式的数据，绝大部分都是JSON，少数可能是XML。文档会给出JSON的结构示例，告诉你温度在哪里、湿度在哪里、天气描述在哪里。
认证方式（Authentication）：通常就是把API Key作为URL参数加进去。
调用频率限制（Rate Limits）：免费套餐一般会有每分钟/每天的请求次数限制。超过了就会被拒绝服务。

理解了这些，你就能构造出正确的API请求URL，并知道如何解析返回的数据了。说实话，很多时候一个看似复杂的问题，根源就在于没有仔细看文档。

JavaScript如何处理异步请求并解析JSON数据？

JavaScript在处理网络请求时，天生就是异步的。这意味着当你发起一个请求去获取天气数据时，程序不会停下来傻等数据回来，它会继续执行后面的代码。等数据回来后，它会“通知”你，然后你再处理这些数据。这种模式对于用户体验来说是好事，页面不会因为等待数据而卡死。

摄图AI

摄图网旗下AI视觉创作平台

下载

在现代JavaScript中，处理异步请求主要有两种方式：Promise链和

async/await

语法糖。

Promise链： 这是异步编程的基础。

fetch

函数默认就返回一个Promise。

fetch('你的API请求URL')
    .then(response => {
        // 检查HTTP响应状态码
        if (!response.ok) {
            throw new Error('网络响应不正常');
        }
        // 把响应体解析成JSON格式
        return response.json();
    })
    .then(data => {
        // 数据成功解析后，在这里处理你的天气数据
        console.log(data);
        // 更新HTML元素
    })
    .catch(error => {
        // 捕获请求或解析过程中发生的任何错误
        console.error('获取或解析数据出错:', error);
    });

then()

方法可以链式调用，每个

then

都会处理上一个Promise的成功结果。

catch()

则用来捕获链中任何环节的错误。

async/await

：这是ES2017引入的，它让异步代码看起来和写同步代码一样直观，大大提高了可读性。我个人非常喜欢用它。

async function getWeatherData() {
    try {
        const response = await fetch('你的API请求URL'); // 等待fetch完成

        if (!response.ok) {
            throw new Error('网络响应不正常');
        }

        const data = await response.json(); // 等待JSON解析完成

        console.log(data);
        // 在这里处理你的天气数据，更新HTML元素

    } catch (error) {
        console.error('获取或解析数据出错:', error);
        // 处理错误，比如显示错误信息给用户
    }
}

getWeatherData(); // 调用这个异步函数

async

关键字放在函数前面，表示这个函数内部会有异步操作。

await

关键字只能在

async

函数内部使用，它会暂停当前

async

函数的执行，直到它后面的Promise解决（resolved）为止。一旦Promise解决，

await

会返回解决的值，然后函数继续执行。如果Promise被拒绝（rejected），

await

会抛出一个错误，你可以用

try...catch

来捕获它。

数据解析方面，当

fetch

请求成功并返回响应后，

response.json()

方法会将响应体（通常是JSON格式的字符串）解析成JavaScript对象。这个方法本身也是异步的，所以前面也要加

await

。解析完成后，你就可以像操作普通JavaScript对象一样，通过点语法（

）或方括号语法（

[]

）来访问其中的数据了，比如

data.main.temp

或者

data.weather[0].description

。

如何在HTML页面中动态展示天气数据并优化用户体验？

拿到天气数据后，关键就是把它“活生生”地呈现在用户眼前。这通常涉及到操作HTML的DOM（文档对象模型）。

动态更新DOM： 在HTML中，我们先给需要显示天气信息的元素设置一个唯一的

id

，比如

<span id="temperature"></span>

。然后，在JavaScript中，通过

document.getElementById('temperature')

来获取到这个元素。接着，你可以使用

textContent

或

innerHTML

属性来修改它的内容：

// 假设 data 是你从API获取到的天气数据对象
document.getElementById('temperature').textContent = Math.round(data.main.temp); // 更新温度
document.getElementById('description').textContent = data.weather[0].description; // 更新天气描述

textContent

更安全，因为它只会处理文本内容，不会解析HTML标签。如果你的数据里可能包含HTML（比如富文本），那才考虑用

innerHTML

。

用户体验优化： 一个好的用户体验不仅仅是显示数据那么简单，它还包括：

加载状态提示： 在数据请求过程中，页面不应该看起来像死了一样。可以在数据区域显示“加载中...”或者一个旋转的加载图标（spinner）。当数据成功加载后，移除加载提示；如果加载失败，则显示错误信息。这在上面的代码示例中已经体现了。
错误处理与反馈： 网络问题、API Key失效、城市名输入错误等都可能导致请求失败。捕获这些错误，并以友好的方式告知用户，而不是让页面一片空白或者在控制台报错。比如，显示“抱歉，未能获取天气信息，请稍后再试。”

用户输入与交互： 如果你想让用户查询不同城市的天气，你需要添加一个

<input type="text">

和一个

<button>

。当用户输入城市名并点击按钮时，通过JavaScript获取输入框的值，然后用这个值去构造API请求URL。

<input type="text" id="city-input" placeholder="输入城市名">
<button id="search-button">查询</button>

const cityInput = document.getElementById('city-input');
const searchButton = document.getElementById('search-button');

searchButton.addEventListener('click', () => {
    const newCity = cityInput.value.trim(); // 获取用户输入并去除空白
    if (newCity) {
        CITY_NAME = newCity; // 更新全局的城市变量
        getWeatherData(); // 重新获取天气数据
    } else {
        errorDisplayElement.textContent = '请输入一个城市名。';
    }
});

你还可以监听

keydown

事件，让用户按回车键也能触发查询。

数据格式化： 有时候API返回的温度可能是带小数点的，你可能想取整；日期格式可能需要转换成更易读的中文格式。这些都可以通过JavaScript的内置方法或第三方库来处理。
响应式设计： 确保你的天气预报界面在手机、平板和桌面电脑上都能良好显示。CSS的媒体查询（
```
@media
```
rules）在这里非常有用。