SuperAPI AI Directory

tmap-lbs-skills

General & other

View repository

Updated 10-16 08:27

About this skill

Tencent Maps Location Services Skill

Tencent Maps Location Services provides developers with complete map data services, including nearby search, place search, route planning, travel planning, and other functions.

Features

  • Search
    • Supports keyword and POI search functions
    • Supports nearby search based on center point coordinates and radius
  • Planning
    • Travel itinerary planning
    • Route planning (walking, driving, cycling, transit)
  • Data Visualization
    • Map data visualization
    • Trajectory data visualization display

When the user wants to search for an address, place, nearby information (such as food, hotels, attractions, etc.), or plan a route, use this skill.

Trigger Conditions

The user expresses one of the following intentions:

  • Search for a certain type of place or a specific place (e.g., "Where is the Forbidden City", "search hotels", "find gas stations")
  • Search nearby based on a certain location (e.g., "food near Olympic Park", "gas stations near Beijing West Railway Station")
  • dan includes keywords such as "search", "find", "look up", "nearby", "around", "route", "plan", etc.
  • Travel planning (e.g., "help me plan a one-day trip to Beijing", "Hangzhou West Lake sightseeing route")
  • Plan a route (e.g., "how to get from the Forbidden City to Nanluoguxiang", "plan a cycling route")
  • Trajectory visualization (e.g., "help me generate a trajectory map", "upload trajectory data", "GPS trajectory display")

Scenario Determination

After receiving the user's request, first determine which scenario it belongs to:

  • Scenario One: The user searches for aclear category(food, hotels) ora specific place(Tiananmen, West Lake), without specifying "near which location"
  • Scenario Two: The user searches foraround or near a certain locationa certain type of place, and the input contains both elements: "location" and "search category or POI type" (e.g., "food around Xizhimen", "hotels near Beijing South Railway Station", "search for milk tea shops near Asia Financial Building")
  • Scenario Three: Detailed POI search (using Web Service API)
  • Scenario Four: Route planning
  • Scenario Five: Travel planning
  • Scenario Seven: Trajectory visualization (the user provides a trajectory data address and wants to generate a trajectory map)

Scenario One: Clear Keyword Search

Directly search for a category or place, without involving nearby search around a specific location.

📖 For detailed URL format, execution steps, examples and reply templates, please refer to references/scene1-keyword-search.md


Scenario Two: Location-based nearby or around search

The user wants to search foraround or near a certain locationa certain type of place. It is necessary to first obtain the latitude and longitude of the location through the geocoding API, and then assemble the search link with coordinates.

📖 After matching this scenario,must first read references/scene2-nearby-search.md Obtain detailed execution steps, API formats, complete examples, and response templates, and strictly follow the steps in the documentation.


Scenario 3: POI detailed search

Use the Tencent Maps Web Service API to perform POI searches via shell curl, supporting keyword search, city restriction, nearby search, and more.

📖 For the detailed curl request format, parameter descriptions, and response data format, please refer to references/scene3-poi-search.md


Scenario 4: Route planning

Use the Tencent Maps Web Service API to plan routes via shell curl. Supports multiple travel modes such as walking, driving, cycling (bicycle), electric bike, and public transit.

📖 For the detailed curl request format, API endpoints for each travel mode, parameter descriptions, and response data format, please refer to references/scene4-route-planning.md


Scenario 5: Travel planning

The user wants to travel to a certain city and has provided multiple attractions they want to visit. The best itinerary route needs to be planned, with optional recommendations for restaurants, hotels, etc. You need to first obtain the latitude and longitude of each attraction through the geocoding API, and then assemble the travel planning link.

📖 After matching this scenario,you must first read references/scene5-travel-planner.md Obtain detailed execution steps, API formats, complete examples, and response templates, and strictly follow the steps in the documentation.


Scenario 7: Map data visualization

When the user has a set of data containing trajectory coordinates and wants to visualize it on a map in the form of a trajectory map.

Trigger conditions

The user mentions intents such as "trajectory", "trajectory map", "trajectory visualization", "GPS trajectory", "movement trajectory", "driving trajectory", etc., and provides a data address or trajectory data.

📖 After matching this scenario,you must first read references/scene7-trail-map.md Obtain the detailed URL format, execution steps, complete examples, and response templates, and strictly follow the steps in the documentation.



Notes

  • Scenario judgment is key: Distinguish whether the user is "directly searching for something", "searching for something near a certain location", "planning a route", or "travel planning"
  • Keywords should be as concise and accurate as possible, extracting what the user really wants to search for
  • For Chinese keywords in the URL, the browser will automatically handle encoding, so manual encoding is not needed
  • If the API returns status is not 0, it indicates that the request failed, and the user should be prompted to check whether the address is valid
  • The Tencent Maps coordinate format is 纬度,经度(Note: latitude first, longitude second)
  • The default search range for Scenario 2 is 1000 meters; users can adjust it if needed radius parameter
  • The Tencent Maps Web Service API has call frequency limits, so please use it reasonably

Document references (references)

The detailed operation documents for each scenario are stored under the references/ directory:

File Description
references/scene1-keyword-search.md Scenario 1: Explicit keyword search — URL format, execution steps, examples, response templates
references/scene2-nearby-search.md Scenario 2: Nearby search — execution steps, API format, complete examples, response templates
references/scene3-poi-search.md Scenario 3: POI detailed search — curl request format, parameter descriptions, response data format
references/scene4-route-planning.md Scenario 4: Route planning — curl request format, API endpoints, parameter and response data descriptions
references/scene5-travel-planner.md Scenario 5: Travel planning — usage method, feature description
references/scene7-trail-map.md Scenario 7: Trajectory Visualization — URL Format, Execution Steps, Complete Example, Response Template

Related Links