Elasticsearch存GIS数据?GeoPoint怎么建?

别再让坐标“迷路”了：Elasticsearch 存 GIS 数据的正确姿势

上周一位在智慧城市项目组的朋友深夜给我发消息：“Dr. Gis，我往 ES 里塞了几百万条带坐标的传感器数据，结果地图上查不到点，Kibana 还报错 ‘field is not a geo_point’……救命！”——这几乎是每个刚接触 Elasticsearch + GIS 的开发者必踩的第一个坑。今天，我们就把 GeoPoint 彻底讲透，让你从此告别“坐标存进去，地图找不到”的尴尬。

GeoPoint 不是“经纬度字符串”，而是一种空间数据类型

很多初学者以为，只要在 JSON 里写个 "location": "116.4,39.9" 就万事大吉了。错！这就像是把 Excel 表格里的数字存成文本格式——看着像数字，但没法做加减乘除。Elasticsearch 的 GeoPoint 是一种结构化空间数据类型，它需要被明确声明、正确解析，才能支持后续的空间查询（比如“附近5公里有哪些设备？”）。

我在参与某国家级物流监控平台时，初期团队直接用字符串存坐标，上线后“热力图渲染延迟超10秒”。重构为 GeoPoint + 正确 mapping 后，毫秒级响应——这就是数据类型的力量。

三种建法，选对你的“坐标身份证”

GeoPoint 支持三种输入格式，本质都是经纬度，只是“身份证样式”不同：

类比一下：这就像你填快递单，有人喜欢分开写“省市区街道”，有人喜欢写“北京市朝阳区XX路XX号”，还有人直接贴二维码——ES 都认，但提前说清楚格式最重要。

实战：从零创建一个支持空间查询的索引

光说不练假把式。我们用 Kibana Dev Tools 演示完整流程：

1. 第一步：定义 Mapping（相当于给字段办“空间户口”）

   PUT /sensor_locations
   {
     "mappings": {
       "properties": {
         "device_id": { "type": "keyword" },
         "location": { "type": "geo_point" },
         "timestamp": { "type": "date" }
       }
     }
   }
   

2. 第二步：插入一条测试数据（用对象格式最稳妥）

   POST /sensor_locations/_doc/1
   {
     "device_id": "SN-001",
     "location": {
       "lat": 39.9042,
       "lon": 116.4074
     },
     "timestamp": "2024-06-15T10:00:00Z"
   }
   

3. 第三步：执行空间查询（查找天安门广场1公里内的设备）

   GET /sensor_locations/_search
   {
     "query": {
       "geo_distance": {
         "distance": "1km",
         "location": {
           "lat": 39.908,
           "lon": 116.397
         }
       }
     }
   }
   

如果返回了刚才插入的文档，恭喜你——GeoPoint 已成功激活！

避坑指南：三个高频错误与解决方案

• 错误1：忘记定义 mapping，直接插入数据
  后果：ES 自动推断 location 为 text 类型，后续所有 geo 查询报错。
  解法：先 PUT mapping，再 POST 数据。生产环境务必关闭 dynamic mapping。
• 错误2：经纬度顺序搞反（经度在前！）
  现象：点全跑到太平洋或非洲去了。
  解法：死记口诀“先经后纬”（数组和字符串格式），对象格式用 lat/lon 不易错。
• 错误3：坐标超出范围（如纬度输成 91°）
  后果：插入失败，报错 “illegal_argument_exception”。
  解法：入库前校验，纬度 [-90, 90]，经度 [-180, 180]。

进阶思考：GeoPoint 只是起点，后面还有 GeoShape

当你需要存储“多边形区域”（如行政区划、商圈边界）或“线”（如河流、道路）时，GeoPoint 就不够用了——这时该请出它的大哥：geo_shape。不过那是下一篇文章的故事了。

现在轮到你了！你在用 Elasticsearch 处理空间数据时，遇到过哪些奇葩报错？或者对 GeoPoint 还有哪里不理解？在评论区留下你的问题，我会挑三个典型问题，在下期视频里手把手调试给你看！