name: map-query

description: Map Query Skill - Query nearby food and promotions by address, supports AMap/Baidu/Tencent Maps

metadata:

version: 1.0.0

author: uynewnas

category: location-services

tags: [map, poi, food, location, amap, baidu, tencent]

env:

required:

• name: AMAP_KEY

description: AMap (高德地图) API Key

required: false

• name: BAIDU_MAP_KEY

description: Baidu Maps API Key

required: false

• name: TENCENT_MAP_KEY

description: Tencent Maps API Key

required: false

note: At least one map provider API key must be configured

Map Query Skill

Query nearby restaurants, shops, promotions and other POI information by specific address.

Core Features

• Address Geocoding: Convert detailed address to latitude and longitude coordinates
• Nearby Search: Query POIs (Points of Interest) around specified location
• Multi-map Support: Integrate AMap, Baidu Maps, Tencent Maps APIs
• Food Search: Specialized search for nearby restaurants and food places
• Promotions Search: Query nearby merchant promotions and deals

Supported Map Providers

| Provider | Features | Notes |

|---------|---------|-------|

| AMap (高德) | ✅ Geocoding, POI Search, Food Search | API Key required |

| Baidu Maps | ✅ Geocoding, POI Search, Food Search | API Key required |

| Tencent Maps | ✅ Geocoding, POI Search, Food Search | API Key required |

Main Functions

1. Address Geocoding

• Support detailed addresses: e.g., "No. 47, Shangjiao xx Street, Panyu District, Guangzhou"
• Support city + landmark: e.g., "Beijing Tiananmen"
• Auto-resolve and return coordinates

2. Nearby Search

• Search by type: food, hotel, bank, gas station, etc.
• Filter by distance: 1km, 2km, 5km, etc.
• Sort by rating: prioritize high-rated merchants
• Sort by distance: prioritize nearby merchants

3. Food Search

• Cuisine filter: Sichuan, Cantonese, Japanese, etc.
• Price range: per capita consumption range
• Business hours filter
• User rating filter

4. Promotions Search

• Find nearby merchant deals
• New store opening information
• Limited-time discount activities

Dependencies

• Node.js >= 18
• Map provider API Key (at least one configured)

Quick Start

# Configure API Key
export AMAP_KEY=your_amap_api_key
export BAIDU_MAP_KEY=your_baidu_map_key
export TENCENT_MAP_KEY=your_tencent_map_key

# Search for food near address
node scripts/search.mjs "Sanlitun, Chaoyang District, Beijing" --type food

# Search for promotions
node scripts/search.mjs "Sanlitun, Chaoyang District, Beijing" --type promotion

References

• 12306 Skill: https://github.com/kirorab/12306-skill
• AMap API: https://lbs.amap.com/
• Baidu Maps API: https://lbsyun.baidu.com/
• Tencent Maps API: https://lbs.qq.com/