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.

Maps
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
citystringNoSearch 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.—
langstringNoLanguage setting. See [Language](https://dev.qweather.com/en/docs/resource/language/) for behavior, configuration, and data availability—
typeenum (scenic | TSTA)YesChoose the POI type: `scenic` for scenic spots or `TSTA` for tide stations.—
numberintegerNoNumber of the results in response, from 1 to 20, 10 is the default.10
locationstringYesThe 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-Key
Request 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
JSONPartial content
{
  "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.