upload_robot_map_v1
Upload robot map data to the GS Robot MCP Server using V1 API for navigation and task execution control.
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
- src/gs_openapi/main.py:174-184 (handler)MCP tool handler function for upload_robot_map_v1, decorated with @mcp.tool() and delegates to GausiumMCP instance.@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)
- Core helper method in GausiumMCP class that performs the actual API call to upload the robot map using GausiumAPIClient.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 )
- API endpoint schema/definition mapping 'upload_map_v1' to the full configuration used by the client, including the tool name.'upload_map_v1': APIEndpoint( name="upload_robot_map_v1", path="map/upload", method=HTTPMethod.POST, version=APIVersion.OPENAPI_V1, description="V1地图上传" ),