默认情况下，Weather API 会以公制单位返回数据。如需使用英制单位请求天气数据，请在请求中指定 unitsSystem 参数。
以下示例请求以英制单位表示的加利福尼亚州山景城的天气数据：
curl -X GET "https://weather.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY&location.latitude=37.4220&location.longitude=-122.0841&unitsSystem=IMPERIAL"
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2025-09-03。"],[],[],null,["# Get current conditions\n\nThe\n[currentConditions](/maps/documentation/weather/reference/rest/v1/currentConditions/lookup)\nendpoint provides information about the current weather conditions at a specific\nlocation. The API returns the following:\n\n- A description of the current [weather\n conditions](/maps/documentation/weather/reference/rest/v1/WeatherCondition#type) with a corresponding [icon](/maps/documentation/weather/weather-condition-icons)\n- Current temperature\n- Apparent (\"feels like\") temperature\n- Dew point\n- Heat index\n- Wind chill\n- Relative humidity\n- UV index\n- Probability, percentage, and [type](/maps/documentation/weather/reference/rest/v1/Precipitation#precipitationtype) of precipitation\n- Probability of thunderstorms\n- Sea level pressure\n- Wind [direction](/maps/documentation/weather/reference/rest/v1/Wind#cardinaldirection), speed, and gust\n- Visibility and cloud cover\n- Historical data for the past 24 hours, including temperature changes, maximum and minimum temperatures, and precipitation amounts\n\nThe APIs Explorer lets you make live requests so that you can get familiar with\nthe API and the API options: \n[Try it!](#try_it)\n\nAbout current conditions requests\n---------------------------------\n\nTo request current conditions, send an HTTP GET request to: \n\n```html\nhttps://weather.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE\n```\n\nInclude the latitude and longitude coordinates of the location in your request\nURL\n[parameters](/maps/documentation/weather/reference/rest/v1/currentConditions/lookup#query-parameters).\n\nCurrent conditions request examples\n-----------------------------------\n\nThe following example requests current conditions information for Mountain View,\nCA: \n\n```bash\ncurl -X GET \"https://weather.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY&location.latitude=37.4220&location.longitude=-122.0841\"\n```\n\nThe response is in the form: \n\n```json\n{\n \"currentTime\": \"2025-01-28T22:04:12.025273178Z\",\n \"timeZone\": {\n \"id\": \"America/Los_Angeles\"\n },\n \"isDaytime\": true,\n \"weatherCondition\": {\n \"iconBaseUri\": \"https://maps.gstatic.com/weather/v1/sunny\",\n \"description\": {\n \"text\": \"Sunny\",\n \"languageCode\": \"en\"\n },\n \"type\": \"CLEAR\"\n },\n \"temperature\": {\n \"degrees\": 13.7,\n \"unit\": \"CELSIUS\"\n },\n \"feelsLikeTemperature\": {\n \"degrees\": 13.1,\n \"unit\": \"CELSIUS\"\n },\n \"dewPoint\": {\n \"degrees\": 1.1,\n \"unit\": \"CELSIUS\"\n },\n \"heatIndex\": {\n \"degrees\": 13.7,\n \"unit\": \"CELSIUS\"\n },\n \"windChill\": {\n \"degrees\": 13.1,\n \"unit\": \"CELSIUS\"\n },\n \"relativeHumidity\": 42,\n \"uvIndex\": 1,\n \"precipitation\": {\n \"probability\": {\n \"percent\": 0,\n \"type\": \"RAIN\"\n },\n \"qpf\": {\n \"quantity\": 0,\n \"unit\": \"MILLIMETERS\"\n }\n },\n \"thunderstormProbability\": 0,\n \"airPressure\": {\n \"meanSeaLevelMillibars\": 1019.16\n },\n \"wind\": {\n \"direction\": {\n \"degrees\": 335,\n \"cardinal\": \"NORTH_NORTHWEST\"\n },\n \"speed\": {\n \"value\": 8,\n \"unit\": \"KILOMETERS_PER_HOUR\"\n },\n \"gust\": {\n \"value\": 18,\n \"unit\": \"KILOMETERS_PER_HOUR\"\n }\n },\n \"visibility\": {\n \"distance\": 16,\n \"unit\": \"KILOMETERS\"\n },\n \"cloudCover\": 0,\n \"currentConditionsHistory\": {\n \"temperatureChange\": {\n \"degrees\": -0.6,\n \"unit\": \"CELSIUS\"\n },\n \"maxTemperature\": {\n \"degrees\": 14.3,\n \"unit\": \"CELSIUS\"\n },\n \"minTemperature\": {\n \"degrees\": 3.7,\n \"unit\": \"CELSIUS\"\n },\n \"qpf\": {\n \"quantity\": 0,\n \"unit\": \"MILLIMETERS\"\n }\n }\n}\n```\n\n### Specify unit system\n\nBy default, the Weather API returns data in the metric system. To request\nweather data using the imperial system, specify the `unitsSystem` parameter in\nyour request.\n\nThe following example requests weather data for Mountain View, CA in imperial\nunits: \n\n```scdoc\ncurl -X GET \"https://weather.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY&location.latitude=37.4220&location.longitude=-122.0841&unitsSystem=IMPERIAL\"\n```\n\nThe response is in the form: \n\n```json\n{\n \"currentTime\": \"2025-01-28T22:13:56.723468335Z\",\n \"timeZone\": {\n \"id\": \"America/Los_Angeles\"\n },\n \"isDaytime\": true,\n \"weatherCondition\": {\n \"iconBaseUri\": \"https://maps.gstatic.com/weather/v1/sunny\",\n \"description\": {\n \"text\": \"Sunny\",\n \"languageCode\": \"en\"\n },\n \"type\": \"CLEAR\"\n },\n \"temperature\": {\n \"degrees\": 56.6,\n \"unit\": \"FAHRENHEIT\"\n },\n \"feelsLikeTemperature\": {\n \"degrees\": 55.7,\n \"unit\": \"FAHRENHEIT\"\n },\n \"dewPoint\": {\n \"degrees\": 33.9,\n \"unit\": \"FAHRENHEIT\"\n },\n \"heatIndex\": {\n \"degrees\": 56.6,\n \"unit\": \"FAHRENHEIT\"\n },\n \"windChill\": {\n \"degrees\": 55.7,\n \"unit\": \"FAHRENHEIT\"\n },\n \"relativeHumidity\": 42,\n \"uvIndex\": 1,\n \"precipitation\": {\n \"probability\": {\n \"percent\": 0,\n \"type\": \"RAIN\"\n },\n \"qpf\": {\n \"quantity\": 0,\n \"unit\": \"INCHES\"\n }\n },\n \"thunderstormProbability\": 0,\n \"airPressure\": {\n \"meanSeaLevelMillibars\": 1019.12\n },\n \"wind\": {\n \"direction\": {\n \"degrees\": 335,\n \"cardinal\": \"NORTH_NORTHWEST\"\n },\n \"speed\": {\n \"value\": 5,\n \"unit\": \"MILES_PER_HOUR\"\n },\n \"gust\": {\n \"value\": 11,\n \"unit\": \"MILES_PER_HOUR\"\n }\n },\n \"visibility\": {\n \"distance\": 10,\n \"unit\": \"MILES\"\n },\n \"cloudCover\": 0,\n \"currentConditionsHistory\": {\n \"temperatureChange\": {\n \"degrees\": -1.2,\n \"unit\": \"FAHRENHEIT\"\n },\n \"maxTemperature\": {\n \"degrees\": 57.8,\n \"unit\": \"FAHRENHEIT\"\n },\n \"minTemperature\": {\n \"degrees\": 38.6,\n \"unit\": \"FAHRENHEIT\"\n },\n \"qpf\": {\n \"quantity\": 0,\n \"unit\": \"INCHES\"\n }\n }\n}\n```\n\nTry it!\n-------\n\nThe APIs Explorer lets you make sample requests so\nthat you can get familiar with the API and the API options.\n\n1. Select the API icon api\n on the right side of the page.\n\n2. Optionally edit the request parameters.\n\n3. Select the **Execute** button. In the dialog, choose the account\n that you want to use to make the request.\n\n4. In the APIs Explorer panel, select the fullscreen icon\n fullscreen to expand the APIs Explorer window."]]
