skills.rest
HalseyYang
HalseyYangCOMMUNITY
Explore all skills by this author →
GitHub

tencentmap-map-assistant

Query Tencent Maps APIs for POI search, routing, geocoding, weather, and travel guides.

1|Updated Jul 13, 2026
Search Tags:#weather#geocoding#route planning#poi search#travel guide#tencent maps#gcj-02
One-click install
npx skills add https://github.com/HalseyYang/Skills-HY --skill tencentmap-map-assistant-halseyyang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tencentmap-map-assistant
Source: https://github.com/HalseyYang/Skills-HY/tree/main/%E8%85%BE%E8%AE%AF%E5%9C%B0%E5%9B%BE%E5%8A%A9%E6%89%8B
Command: npx skills add https://github.com/HalseyYang/Skills-HY --skill tencentmap-map-assistant-halseyyang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve? It gives AI agents direct access to Tencent Location Services so users can search places, plan routes, convert addresses and coordinates, check weather, and generate AI travel itineraries without writing API integration code or holding a developer account. ## Core Features & Use Cases - Place & Route Intelligence: Search POIs with ratings, prices, and opening hours; plan driving, walking, cycling, or transit routes; compute distances between points. - Geocoding & Location Utilities: Convert addresses to coordinates and back, translate GPS/WGS-84 coordinates to GCJ-02, resolve IP locations, and query administrative districts. - AI Travel Guides & Map Guides: Generate multi-day itineraries and personal map guides with WeChat mini-program QR codes, plus render trips as interactive HTML maps via Tencent Map JSAPI GL. - Use Case: Ask for a "3-day food tour of Chengdu" and receive a structured itinerary with a scannable QR code that saves the trip to the Tencent Map mini-program on your phone. ## Quick Start Ask the assistant to plan a 5-day Wuhan travel itinerary with a mini-program QR code, and it will install the client, apply for a temporary key if needed, and return the finished guide.

Frequently Asked Questions about tencentmap-map-assistant

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for places with the Tencent Maps API?▼

Use the poi_search method with a keyword and either a city name or a center coordinate. It returns POIs with ratings, average prices, and opening hours, and supports pagination up to 20 results per page.

How do I get a Tencent Location Services API key without a developer account?▼

The skill includes a tempkey flow that verifies a Chinese mainland phone number via SMS and issues a temporary AI-scenario key valid for one year with 5000 requests per day. The scripts send_code.py, create_key.py, and save_config.py handle the whole process.

Does Tencent Maps route planning support walking and transit?▼

Yes, the direction method supports driving, walking, bicycling, and transit modes. Start and end points can be addresses, landmark names, or lat,lng coordinates, and passing a region city name improves disambiguation.

Why are my GPS coordinates offset on Tencent Maps?▼

Tencent Maps uses the GCJ-02 coordinate system, so raw GPS or WGS-84 coordinates appear shifted by tens to hundreds of meters. Convert them first with coord_translate using type=1 before calling regeocoder, poi_nearby, or direction.

What happens when my Tencent Maps API key fails or expires?▼

The client maintains a candidate key pool and automatically rotates to the next available key when one fails. If all keys fail, it raises a TmapError listing each key's failure reason, and the error-codes reference maps each code to a fix.

Can I generate a shareable map guide from a list of places?▼

Yes, generate_map_guide takes a POI list with names, coordinates, and IDs from poi_search, then produces a Tencent Map mini-program guide with a QR code users can scan to view and navigate on their phones.

Related Skills

Explore More Personal & Entrepreneur Skills→
dkyazzentwatwadkyazzentwatwa
86

image-metadata-tool

Extract and manage EXIF metadata from image files.

Community
Intermediate
laik184laik184

travel-assistant

Generate day-by-day travel itineraries with maps, budgets, and multi-format outputs.

Community
Advanced
the-open-agentthe-open-agent
5.5k

weather

Retrieve current weather and forecasts for specified locations via wttr.in.

Official
Basic
wulaosijiwulaosiji
28

amap-navigator

Provide geocoding, routing, and point-of-interest searches via the Amap API.

Community
Intermediate