maps_distance
Calculate distances between locations using driving, walking, or spherical measurements to determine travel routes and spatial relationships.
Instructions
测量两个经纬度坐标之间的距离,支持驾车、步行以及球面距离测量
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| origins | Yes | ||
| destination | Yes | ||
| type | No | 1 |
Implementation Reference
- amap_mcp_server/server.py:634-665 (handler)The maps_distance tool handler function, registered via @mcp.tool() decorator. It measures distance between origins and destination coordinates using Amap's distance API, supporting types like driving (1), walking (2), or straight-line (0). Returns results with distance and duration.@mcp.tool() def maps_distance(origins: str, destination: str, type: str = "1") -> Dict[str, Any]: """测量两个经纬度坐标之间的距离,支持驾车、步行以及球面距离测量""" try: response = requests.get( "https://restapi.amap.com/v3/distance", params={ "key": AMAP_MAPS_API_KEY, "origins": origins, "destination": destination, "type": type } ) response.raise_for_status() data = response.json() if data["status"] != "1": return {"error": f"Direction Distance failed: {data.get('info') or data.get('infocode')}"} results = [] for result in data["results"]: results.append({ "origin_id": result.get("origin_id"), "dest_id": result.get("dest_id"), "distance": result.get("distance"), "duration": result.get("duration") }) return {"results": results} except requests.exceptions.RequestException as e: return {"error": f"Request failed: {str(e)}"}