> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/getting-started/amap-weather.md).

# Amap weather in China in Duaer

In Duaer: Amap: current weather or the 4-day forecast for a Chinese city. One successful search uses 1 credit.
## What you get

Duaer Amap weather in China returns current weather or the 4-day forecast for a city or district in mainland China. Duaer holds the upstream API key; you only send your Duaer key.

Pick Duaer Data → Amap weather in China in the node creator, or open the [data market](/getting-started/data-market.md). Related: [Amap geocoding in China](/getting-started/amap-geocode.md), [Weather forecast](/getting-started/weather.md).

## When to use it

- Show today in Hangzhou on a dashboard.
- Plan an outdoor event with the 4-day forecast.

## When not to use it

- Weather outside China. Use [Weather forecast](/getting-started/weather.md).
- Hong Kong weather. Use [Hong Kong weather](/getting-started/hk-weather.md).

## Search on the canvas

1. Open the node creator and pick Duaer Data → Amap weather in China.
2. Fill City (such as 330100). Optional: View (forecast).
3. Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

## Call the API

- GET https://api.duaer.com/v1/data/amap-weather?city=330100
- Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

## Call skill

Same text as Copy skill.

```
---
name: duaer-amap-weather
description: >-
  Duaer Amap weather in China. Amap: current weather or the 4-day forecast for a Chinese city.
  One successful search uses 1 Duaer credit.
---

# Duaer Amap weather in China

Duaer Amap weather in China returns current weather or the 4-day forecast for a city or district in mainland China. Duaer holds the upstream API key; you only send your Duaer key.

## When to use

- Show today in Hangzhou on a dashboard.
- Plan an outdoor event with the 4-day forecast.

## When not to use

- Weather outside China. Use https://skills.duaer.com/weather.md.
- Hong Kong weather. Use https://skills.duaer.com/hk-weather.md.

## Call

`GET https://api.duaer.com/v1/data/amap-weather?city=330100`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `city`.

- `city` — Six-digit adcode such as 330100, or a URL-encoded city or district name.
- `view` — Optional. `current` or `forecast`. Default `current`.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/amap-weather?city=330100` — current weather in Hangzhou.
- `GET https://api.duaer.com/v1/data/amap-weather?city=110000&view=forecast` — the 4-day forecast for Beijing.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `province`, `city`, `adcode`, `reportTime` — place and report time.
- `weather`, `temperatureC`, `humidityPct`, `windDirection`, `windPower` — current conditions.
- `date`, `weekday`, `dayWeather`, `nightWeather`, `maxTempC`, `minTempC` — forecast days.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/amap-geocode.md — Duaer Amap geocoding in China
- https://skills.duaer.com/weather.md — Duaer Weather forecast

```
## Questions

### How many credits does a Amap weather in China search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

### How do I enter City in Duaer Amap weather in China?

A six-digit adcode such as 330100 for Hangzhou is most precise. A city or district name also works; Duaer looks up the adcode first.

## Related

- [Amap geocoding in China in Duaer](https://doc.duaer.com/getting-started/amap-geocode.md)
- [Weather forecast in Duaer](https://doc.duaer.com/getting-started/weather.md)