> ## 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 中上传和准备位置数据

> 学习如何向 MapX 上传 CSV、GeoJSON 和 Excel 文件，包括自动位置列识别、列命名建议和常见导入错误修复。

MapX 支持 **CSV、GeoJSON、Excel、GeoTIFF、Shapefile 和文本文档**（TXT、Markdown、Word 与 PDF）。**CSV、GeoJSON 和 Excel** 是通用领域数据格式——包含可被 MapX 自动识别的属性与位置列。**GeoTIFF 和 Shapefile** 是 GIS 领域专用格式：GeoTIFF 会以栅格影像图层的形式渲染到地图上，Shapefile 会转换为矢量图层（点/线/面）。**文本文档不会成为地图图层**——MapX 会读取它们作为 AI 可分析的素材，例如用于生成报告。上传表格类文件后，MapX 会自动扫描、识别包含位置信息的列，并在几秒内把数据渲染到地图上。

## 支持的文件格式

| 格式 | 扩展名 | 说明 |
| - | - | - |
| **CSV** | `.csv` | 按表头名称自动识别经纬度列。支持地址列，Basic 及以上套餐自动地理编码。 |
| **GeoJSON** | `.geojson`, `.json` | 支持点、线和面几何类型。属性会作为可用于样式和筛选的字段导入。 |
| **Excel** | `.xlsx`, `.xls` | 导入第一个工作表。使用与 CSV 相同的规则自动识别经纬度或地址列，其余工作表忽略。 |
| **GeoTIFF** | `.tif`, `.tiff` | GIS 领域专用。以栅格影像图层的形式上传并展示在地图上。 |
| **Shapefile** | `.shp/.shx/.dbf`（可含 `.prj`、`.cpg` 等），或 `.zip` | GIS 领域专用。选择同前缀的全部文件一起上传，或上传 zip 压缩包；缺少 `.prj` 时按 WGS84 处理。 |
| **文本 / Markdown** | `.txt`, `.md` | 文档。由 AI 读取用于分析与报告，不会作为地图图层。 |
| **Word** | `.docx` | 文档。由 AI 读取用于分析与报告，不会作为地图图层。 |
| **PDF** | `.pdf` | 文档。由 AI 读取用于分析与报告，不会作为地图图层。 |

大型航拍或卫星影像（GeoTIFF）会以流畅、可缩放的栅格图层呈现，并且可以随时调整其配色。

## 上传在后台进行

上传在后台处理，并在上传队列中显示进度——文件转换或导入期间你可以继续工作。上传完成后，MapX 会把地图缩放到新图层。

付费套餐单个文件上限为 **20 GB**。上传会排队执行，因此你可以一次添加多个文件，每个文件按顺序处理。

## 上传 Shapefile

Shapefile 由多个**相同前缀**的文件组成，必须一起上传：

* **必需**：`.shp`（几何）、`.shx`（索引）、`.dbf`（属性）
* **可选**：`.prj`（坐标系）、`.cpg`（字符编码），以及空间/属性索引文件（`.sbn`、`.sbx`、`.qix` 等）

一次框选这些文件即可——MapX 会把它们合并为一条上传项，缺少必需文件时会明确提示。也可以把文件打包成 `.zip` 上传。缺少 `.prj` 时按 WGS84（EPSG:4326）处理；属性编码在存在 `.cpg` 时按其指定读取。几何会重投影到 WGS84，并以普通矢量图层（点/线/面）的形式添加到地图。

## 自动识别的工作原理

上传文件时，MapX 在显示数据前会执行以下步骤：

1. **表头扫描**——读取列名，与内置的常见位置字段名列表比对（见下文[列命名建议](#列命名建议)）。
2. **数值检查**——对候选列采样最多 100 行，确认数值像合法坐标（经度 −180 到 180，纬度 −90 到 90 的十进制度）。
3. **置信度预览**——导入完成前展示识别到的列和少量匹配行样本。你可以确认识别结果，或在需要时手动重新指定列。
4. **地图渲染**——确认后，所有坐标合法的行都会被绘制到地图上。缺失或无效坐标的行会被跳过，并在导入摘要中显示跳过数量。

## 列命名建议

为了最快、最可靠地自动识别，请在文件中使用以下标准列名之一：

**纬度：**

* `lat`
* `latitude`
* `y`
* `y_coord`
* `lat_dd`

**经度：**

* `lng`
* `lon`
* `long`
* `longitude`
* `x`
* `x_coord`
* `lng_dd`

**地址（Basic 及以上自动地理编码）：**

* `address`
* `full_address`
* `street_address`
* `location`

## 处理不规整的数据

<Accordion title="我的经纬度列名不常见">
  如果 MapX 没有自动识别坐标列，你可以在导入预览阶段手动映射。点击 **编辑列映射**，用下拉框指定哪个列是纬度、哪个是经度。自定义映射会保存在项目中——重新上传同一文件时，MapX 会记住映射。

  对于批量或重复上传，把列名改成上面列出的标准名称是最可靠的长期方案。
</Accordion>

<Accordion title="有些行缺少坐标">
  纬度或经度为空、为 `null`、为 `N/A`，或超出合法坐标范围（纬度 −90 到 90，经度 −180 到 180）的行会在导入时自动跳过。导入摘要面板会显示跳过的总行数，并允许你下载问题行的 CSV 以便排查后重新上传。

  缺少坐标不会导致导入失败——MapX 只是绘制能绘制的行，并报告跳过了哪些。
</Accordion>

<Accordion title="我的地址不是坐标">
  MapX 在 **Basic、Pro 和 Business** 套餐上支持基于地址的地理编码（把街道地址转成经纬度）。如果文件包含地址列而不是数字坐标，MapX 会识别它，并在渲染地图前提供自动地理编码选项。

  地理编码使用[列命名建议](#列命名建议)中列出的列名。每次地址查询按一次 AI 提问计入月度额度。免费版用户可以在上传前用 [geocod.io](https://geocod.io) 或 Google Sheets 等免费工具把地址手动转成坐标。
</Accordion>


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