ClawHub

map-query

Data & APIs

Query nearby restaurants, shops, promotions, and POIs by address using AMap, Baidu, or Tencent Maps with geocoding and filters.

Install

openclaw skills install map-query

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

ProviderFeaturesNotes
AMap (高德)✅ Geocoding, POI Search, Food SearchAPI Key required
Baidu Maps✅ Geocoding, POI Search, Food SearchAPI Key required
Tencent 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

# 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

More in Data & APIs