QWeather Geo POI Lookup
1 credits/call
ae_qweather_geo_poi_lookup
Find points of interest like scenic spots or tide stations to retrieve their specific location IDs.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
city | string | No | Search for POI within a given city. The city name can be text or the city's LocationID. The city name is an exact match. It is recommended to use LocaitonID. If the text cannot be matched, the data returned will be empty. | — |
lang | string | No | Language setting. See [Language](https://dev.qweather.com/en/docs/resource/language/) for behavior, configuration, and data availability | — |
type | enum (scenic | TSTA) | Yes | Choose the POI type: `scenic` for scenic spots or `TSTA` for tide stations. | — |
number | integer | No | Number of the results in response, from 1 to 20, 10 is the default. | 10 |
location | string | Yes | The location to be queried, support location name, [LocationID](https://dev.qweather.com/en/docs/resource/glossary/#locationid) or comma-separated [longitude and latitude](https://dev.qweather.com/en/docs/resource/glossary/#coordinate) (decimal, up to 2 decimal places), LocationID can be obtained by [GeoAPI](https://dev.qweather.com/en/docs/api/geoapi/). Example: `location=beijing` or `location=101010100` or `location=116.41,39.92` | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_qweather_geo_poi_lookup' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"location": "116.41,39.92",
"number": 10,
"type": "scenic"
}
}'Response exampleresponse.json
{
"code": "200",
"poi": [
{
"adm1": "北京",
"adm2": "北京",
"country": "中国",
"id": "10101010005A",
"name": "南锣鼓巷",
"type": "scenic"
}
],
"refer": {
"license": [
"QWeather Developers License"
],
"sources": [
"QWeather"
]
}
}This example shows part of the response. Copied content is valid JSON.
