amap-maps-streamableHTTP

What This Skill Does

The amap-maps-streamableHTTP skill integrates the powerful Amap (AutoNavi) mapping services into your AI agent environment via the OneKey Gateway. It provides a comprehensive suite of location-based services, including geocoding (address to coordinates), reverse geocoding (coordinates to address), multi-modal route planning (driving, walking, bicycling, and public transit), and IP-based geolocation. Additionally, it features a unique utility to generate shareable URIs that open specific行程 (itinerary) points directly in the Amap mobile application, making it an essential bridge between AI decision-making and real-world navigation.

Installation

To begin, ensure you have the necessary environment setup. Run the following command in your terminal to install the dependencies:

pip install ai-agent-marketplace

For enterprise or automated environments, you may also use:

pip install -r requirements.txt

Once installed, authenticate your agent by setting the environment variable DEEPNLP_ONEKEY_ROUTER_ACCESS with your unique OneKey API key. If you are just testing, the system will default to a demo key, though production use requires a personal key from the OneKey Workspace.

Use Cases

• Logistics & Delivery: Calculate optimal driving routes for delivery drivers, accounting for real-time traffic and road constraints.
• Travel Planning: Create multi-stop itinerary plans for tourists, providing transit options between cities and direct map links for mobile guidance.
• Geospatial Analytics: Convert customer databases containing addresses into precise latitude/longitude coordinates for map visualization.
• Asset Tracking: Determine the approximate location of users or servers based on their IP addresses to provide region-specific service updates.

Example Prompts

• "Plan a bike route from 116.397,39.908 to 116.410,39.915 and tell me how many km it is."
• "What is the address for the coordinates 116.404,39.915?"
• "Find a public transit route from Beijing to Tianjin for my upcoming trip tomorrow."

Tips & Limitations

• Coordinates Format: Always use 'longitude,latitude' format. Note that the order is critical; flipping these will result in incorrect mapping data.
• City Context: For cross-city transit planning, specifying both the origin city and destination city is mandatory to ensure the gateway selects the correct regional transit database.
• Data Privacy: This tool interacts with external mapping APIs. Ensure that sensitive location data is handled according to your local privacy policies.
• URI Generation: Use the maps_schema_personal_map tool to generate mobile links for users—do not attempt to summarize the URI, just pass it directly to the end user for the best experience.