| name | mobility |
| description | 城市移动导航：在路网中移动 agent 到 AOI/POI、搜索周边 POI、用引力模型推荐目的地。必须通过 ask_env 调用 MobilitySpace 工具。 |
Mobility
MobilitySpace 是一个基于真实城市路网的移动仿真环境。所有操作必须通过 ask_env 自然语言指令执行，环境路由器会自动将指令转换为 MobilitySpace 工具调用。
环境概念
AOI
Area of Interest，城市功能区（住宅区、商业区、办公区等）。ID 从 500000000 开始。每个 person 有 home_aoi（家）和 work_aoi（工作地）。
POI
Point of Interest，具体地点（餐厅、咖啡馆、医院、公园等）。ID 从 700000000 开始。每个 POI 属于某个 AOI。
移动状态
| 状态 | 含义 |
|---|
idle | 空闲，可以发起移动 |
moving | 正在沿路网移动中 |
moving 状态下再次调用 move_to 会打断当前移动，除非确实需要改变目的地，否则不应这样做。
位置信息
get_person 返回的 position 包含 aoi_id、poi_id、xy 坐标、lnglat 经纬度、kind（"aoi" 或 "lane"）。
移动模式
| 模式 | 速度 | 典型场景 |
|---|
walking | 1.34 m/s | 短距离（< 1000m） |
driving | 8.0 m/s (~28.8 km/h) | 长距离（≥ 1000m） |
POI 类别
搜索 POI 时可用的类别：
| 一级类别 | 典型二级类别 |
|---|
restaurant | bar, cafe, fast_food, restaurant, pub, food_court |
outdoor_activity | park, playground, garden, beach_resort, fishing |
indoor_entertainment | cinema, fitness_centre, bowling_alley, theatre, bar |
sports_facility | sports_centre, swimming_pool, stadium, ice_rink |
cultural_and_artistic | arts_centre, museum, cinema, nightclub |
education_institution | school, university, library, kindergarten |
medical_care | hospital, clinic, pharmacy, dentist |
financial_service | bank, atm |
public_service | police, post_office, townhall |
transportation_facility | parking, bus_station, fuel |
children_playground | playground, summer_camp |
nature_and_wildlife_observation | nature_reserve, bird_hide |
water_activity | swimming_area, marina |
other_special_purpose | marketplace, place_of_worship |
可传入一级类别（如 restaurant）匹配该类别下所有二级类别，或传入二级类别（如 cafe）精确匹配。
可用工具
所有操作通过 ask_env 调用：
ask_env(instruction="<自然语言指令>", ctx={"id": <your_id>})
get_person（只读，observe）
获取当前状态：位置、状态（idle/moving）、移动目标、附近 POI 概况（按一级类别汇总，含最近 POI 名称和距离）、home_aoi、work_aoi。
ask_env(instruction="<observe>", ctx={"id": <your_id>})
recommend_poi_by_gravity（只读）
用引力模型推荐目的地 POI。综合考虑距离和周边同类 POI 密度，比手动搜索更合理。
参数：person_id、category（POI 类别或 None 不限）、radius（搜索半径，米）、exclude_home_work（是否排除家/工作地的 POI）。
返回推荐 POI 的 id、name、category、distance、aoi_id，以及 recommended_mode（建议出行方式）。
find_nearby_pois（只读）
搜索周边 POI 列表。参数：x, y（搜索中心坐标）、category（类别或 None）、radius（搜索半径，米）。返回 id、name、category、distance、aoi_id。
get_poi（只读）
查询单个 POI 详情。参数：poi_id。返回 id、name、category、position、aoi_id。
move_to（非只读）
发起移动。参数：person_id、aoi_id_or_poi_id（目标 AOI ID 或 POI ID，≥700000000 为 POI）、mode（"walking" 或 "driving"）。
发起后状态变为 moving，后续 step 中自动沿路网移动，到达后自动恢复为 idle。
示例
观察状态
ask_env(instruction="<observe>", ctx={"id": 0})
→ home_aoi=500000007, work_aoi=500000123, status=idle, aoi_id=500000007
去工作地
ask_env(instruction="Move person 0 to AOI 500000123 using driving", ctx={"id": 0})
→ status=moving
搜索餐厅并前往
ask_env(instruction="Use recommend_poi_by_gravity for person 0, category restaurant, radius 1200, excluding home/work AOIs. Then move to the recommended POI.", ctx={"id": 0})
→ 推荐 cafe（800m），walking 前往
回家
ask_env(instruction="Move person 0 to AOI 500000007 using driving", ctx={"id": 0})
约束
- 所有操作通过
ask_env。不能直接调用 move_to、get_person 等函数。
moving 状态下不要再次 move_to。会打断当前移动，除非确实需要改变目的地。
