先用免费评估，
看看真实的城市。

AI 找房助手 · OpenAI 兼容接口

在 app 目录将 .env.agent.example 复制为 .env.agent.local，填写以下三个值，再重启服务：

ATLAS_AI_BASE_URL=服务商提供的兼容接口地址（通常以 /v1 结尾）
ATLAS_AI_MODEL=服务商提供的模型名称
ATLAS_AI_API_KEY=你的服务端密钥

模型需要支持 Chat Completions、流式输出和工具调用。这里的配置只在服务器读取；地图 token 不能用于 AI。不要将密钥放入 VITE_ 变量或聊天消息。

未配置模型时，右侧明确显示「工具体验」，仍可通过按钮验证附近设施、最近地点和真实步行路线。配置后可直接多轮提问，地图和列表随工具结果更新。

对话和地图条件保存在服务器 SQLite；当前浏览器通过匿名会话继续访问。同城可刷新续聊，各城市分别保存。更换浏览器或清除 Cookie 后会开启独立会话。

01 · 注册免费账号

打开 Cesium ion ↗，注册或登录，选择 Community 免费档。账号注册与条款确认由你在官方页面完成。

官方当前列出的 Google 实景三维额度为每月 1,000 次根瓦片请求，Community 还有每月 15 GB 流量等限额，实际使用以账号 Usage 为准。免费档适用于符合条件的评估；正式对外运营前再确认商业集成许可。

查看官方套餐与评估条件 ↗ · 2026-10-08 核对

02 · 启用实景三维数据

在 ion 的 Asset Depot 中找到 Google Photorealistic 3D Tiles，启用或添加到你的资产。确认可以在官方预览里看到实景建筑。

请选择这个带真实建筑纹理的数据集。普通地形和 OSM Buildings 不能达到我们要验证的实景效果。

03 · 创建网站专用 token

在 Access Tokens ↗ 创建名为 rentApartment-local 的 token：

• Scopes：只选 assets:read。当前样本未使用地址搜索，不需要 geocode 权限。
• Selected assets：只允许 Google Photorealistic 3D Tiles。
• Allowed URLs：填写实际预览来源，例如 http://localhost:5174。如果使用 127.0.0.1，单独加上对应来源。上线时再添加部署网址。

这是浏览器使用的只读 token；不选写入、账号资料或 token 管理权限。不要在聊天里粘贴 token。

04 · 填入已准备好的配置文件

打开项目的 rentApartment/app/.env.local，只需在第二行等号后填入 token：

VITE_MAP_PROVIDER=cesium-ion
VITE_CESIUM_ION_ACCESS_TOKEN=你的只读token

保存后，在 app 目录运行：

npm run check:map
npm run dev -- --port 5174

如果开发服务已经运行，先停止旧进程再重启。check:map 只检查本地配置，不发送网络请求，也不会打印 token。

回到城市页面，点击「加载实景 3D」才会请求地图。同一次页面停留中，切换五个城市会复用地图连接；刷新、重试或重新进入可能产生新的请求。

接通后，一起验收五个城市

伦敦、悉尼、新加坡、吉隆坡、香港：逐一检查大学周边是否有真实建筑纹理，拖动、缩放、旋转，再点击房源和大学定位。城市覆盖与清晰度仍需实际检查。

房源、位置和租金仍是演示数据；步行时间、安全和购物便利度需要后续单独核验。