---

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#

ProviderFeaturesNotesAMap (高德)✅ Geocoding, POI Search, Food SearchAPI Key requiredBaidu Maps✅ Geocoding, POI Search, Food SearchAPI Key requiredTencent Maps✅ Geocoding, POI Search, Food SearchAPI 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#

bash

# 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/