> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapxagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MapX 故障排查：上传、AI 对话和导出问题

> 修复常见 MapX 问题，包括数据上传错误、AI 对话问题、渲染变慢、位置识别失败和导出错误。

大多数 MapX 问题都可以通过对数据或提示词做小幅调整快速解决。本页介绍用户最常遇到的问题以及最快的修复方式。

<AccordionGroup>
  <Accordion title="数据上传问题">
    **我的 CSV 上传不了**

    * 检查文件大小。Free 套餐有 **50MB 上传限制**——如果文件超限，考虑升级到 Basic（30GB）或 Pro（50GB）。
    * 确保文件是有效的 **UTF-8 编码 CSV**。包含特殊字符或非常用编码的文件可能导致上传失败。
    * 如果文件是用 Excel 创建的，尝试重新保存：**文件 → 另存为**，格式选择 **CSV UTF-8（逗号分隔）**。

    ***

    **MapX 找不到我的经纬度列**

    * 把坐标列重命名为可识别的名称：`lat`、`lng`、`latitude` 或 `longitude`。
    * 或者使用上传后出现的**手动列映射对话框**，告诉 MapX 哪些列包含坐标。

    ***

    **地图上缺少一些行**

    * 坐标为**空或无效**的行会在渲染时自动跳过。
    * 打开源文件，检查坐标列中是否有空单元格、占位文本（如 `N/A`、`null`）或非数值内容。
    * 合法的纬度范围是 **-90 到 90**，经度范围是 **-180 到 180**。
  </Accordion>

  <Accordion title="分析 / AI 对话问题">
    **我的分析提示词不起作用**

    * 尝试让提示词更具体。包含**列名**、**带单位的距离**，以及清晰描述你想看到的内容。
    * ❌ 模糊：`显示聚类`
    * ✅ 具体：`显示地铁站 500 米内的门店，按 monthly_revenue 着色`

    ***

    **我达到了提问限额**

    * 提问限额在账单日重置，账单日显示在**账户设置**中。
    * 想立即继续，升级套餐——Basic 每月 300 次提问，Pro 500 次，Business 1000 次。你可以随时在账户设置中升级。

    ***

    **分析结果看起来不对**

    * 用 AI 对话中的后续提示词细化结果。例如：
      * `改用公里而不是英里`
      * `排除河以南的点`
      * `改用 population_2023 列重新计算`
    * MapX 会保持对话上下文，你可以迭代修正结果，无需重新开始。
  </Accordion>

  <Accordion title="地图渲染问题">
    **地图加载慢或加载不出来**

    * 先尝试**刷新页面**——大多数临时渲染问题都能解决。
    * 对于非常大的数据集（50 万+ 点），考虑在运行分析前**筛选到特定区域或时间范围**，降低渲染负载。

    ***

    **上传后我的地图是空白的**

    * 确认坐标值合法：纬度必须在 **-90 到 90** 之间，经度在 **-180 到 180** 之间。
    * 检查是否不小心**把经度和纬度列弄反了**——列名不规范时这是常见问题。

    ***

    **底图不显示**

    * 底图瓦片从 CDN 加载，需要有效的网络连接。检查网络连接并尝试刷新。
    * 如果在企业网络内，确认防火墙或代理没有拦截瓦片请求。
  </Accordion>

  <Accordion title="导出 / 分享问题">
    **我的 PNG 导出有水印**

    * 水印应用于 **Free 套餐**的导出。升级到 **Basic 或更高**即可移除所有 PNG 和报告导出的水印。

    ***

    **我的分享链接打不开**

    * 检查项目是否已在项目设置中设为**公开**——私有项目要求查看者完成身份验证。
    * 在 Pro 及以上套餐，你可以向有 MapX 账号的特定用户分享**私有项目链接**。确认接收者在打开链接前已登录。

    ***

    **报告导出缺少内容**

    * 确保触发导出前分析已**完全完成**。仍在处理或返回错误的分析可能生成不完整的报告。
    * 等 AI 对话回复结束，再重新导出报告。
  </Accordion>
</AccordionGroup>

## 还需要帮助？

如果按以上步骤操作后仍有问题，我们的团队很乐意帮忙。发邮件到 [sales@mapxagent.com](mailto:sales@mapxagent.com)，或使用应用右下角的**应用内聊天支持按钮**，直接从你的 MapX 项目中联系支持人员。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.