upload_robot_map_v1
Upload robot map data to the GS Robot MCP Server using the V1 API to enable navigation and task execution for cleaning robots.
Instructions
Uploads a robot map using V1 API.
Args:
map_data: Map data to upload.
Returns:
A dictionary containing the upload result with record_id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| map_data | Yes |
Implementation Reference
- Core implementation of the upload_robot_map_v1 tool: validates input, creates GausiumAPIClient, and calls the 'upload_map_v1' endpoint with map_data as JSON.async def upload_robot_map_v1( self, map_data: Dict[str, Any] ) -> Dict[str, Any]: """ V1地图上传。 Args: map_data: 地图数据 Returns: 上传结果，包含record_id Raises: ValueError: 地图数据为空 httpx.HTTPStatusError: API调用错误 httpx.RequestError: 网络问题 """ if not map_data: raise ValueError("Map data cannot be empty") async with GausiumAPIClient() as client: return await client.call_endpoint( 'upload_map_v1', json_data=map_data )
- src/gs_openapi/main.py:174-184 (registration)MCP tool registration using @mcp.tool() decorator. This is the entry point for the 'upload_robot_map_v1' tool invoked by MCP clients, delegating to GausiumMCP method.@mcp.tool() async def upload_robot_map_v1(map_data: dict): """Uploads a robot map using V1 API. Args: map_data: Map data to upload. Returns: A dictionary containing the upload result with record_id. """ return await mcp.upload_robot_map_v1(map_data=map_data)
- API endpoint schema/configuration for 'upload_map_v1' (named 'upload_robot_map_v1'), defining path, method, version used by GausiumAPIClient.call_endpoint.'upload_map_v1': APIEndpoint( name="upload_robot_map_v1", path="map/upload", method=HTTPMethod.POST, version=APIVersion.OPENAPI_V1, description="V1地图上传" ),