python .\skills\routemaster\scripts\main.py --file .\skills\routemaster\test.json

Required Workflow

For natural-language addresses:

Call run({"action": "normalize", "city": "...", "addresses": [...]}).
Do not route unknown addresses.
For uncertain addresses, ask the user to confirm the candidate or use a user-supplied correction.
Build route points only from trusted coordinates.
Call route optimization with those points.

For trusted coordinates:

Call route optimization directly.
Use travel_mode: "driving" unless the user says otherwise.
Use mode: "shortest_distance" unless the user asks for fastest time.
Use require_map_distance: true and route_line_style: "driving" for driving routes.
If the user says they are at a starting location, put that point first and pass start_index: 0.

Never answer a multi-stop route request from reasoning alone. The route order and navigation link must come from this skill's result.

Route Input Example

{
  "points": [
    {"name": "Start", "latitude": 39.909187, "longitude": 116.397463},
    {"name": "Stop", "latitude": 39.924476, "longitude": 116.517742}
  ],
  "start_index": 0,
  "travel_mode": "driving",
  "mode": "shortest_distance",
  "require_map_distance": true,
  "route_line_style": "driving"
}

Route Output

Successful route output includes:

status
route
metrics
report
warnings
navigation_cards

For the user-facing AMap link, use:

navigation_cards.full_route.providers.amap.url

Render it as:

[高德地图导航](URL)

Do not show Baidu links to the user.

Environment

Required for real geocoding, real driving distances, and driving polylines:

AMAP_API_KEY=

Optional:

GEOREFINE_DB_PATH=
ROUTE_OPTIMIZER_CONFIG=

BAIDU_MAP_API_KEY is documented for future use, but the current code does not require it for route output.

Hard Rules

Do not invent coordinates, distances, durations, administrative codes, or road geometry.
Do not optimize natural-language addresses before address normalization.
Do not route unknown addresses.
Do not silently accept uncertain addresses.
Do not present driving output as walking, transit, or e-bike navigation.
Use AMap mobile full-route handoff only when the optimized route has at most 15 intermediate waypoints.
Do not expose API keys in replies, reports, or logs.

routemaster

Routemaster

Entry Point