---
title: "解析坐标发现 Z 值但 ignore_z_value 未设置 – 如何解决此 Elasticsearch 异常"
date: 2026-01-21
lastmod: 2026-01-21
description: "在解析地理点位时遇到 Z 值但 ignore_z_value 设置未启用的 Elasticsearch 异常及解决方法。"
tags: ["坐标解析", "地理点位", "ignore_z_value 配置"]
summary: " 版本： 7.11-7.15
 简要来说，当 Elasticsearch 在解析地理点位时在坐标中遇到 Z 值，但 “ignore_z_value” 设置未启用时，就会发生此错误。该设置允许 Elasticsearch 忽略坐标中表示海拔的 Z 值。要解决此问题，如果不需要 Z 值，可以从坐标中移除它，或者可以在映射中将 “ignore_z_value” 设置为 true，以允许 Elasticsearch 忽略这些值。
日志上下文 #  日志 “Exception parsing coordinates: found Z value [{}] but [ignore_z_value]” 的类名是 GeoPoint.java。我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入了解上下文的人参考：
return builder.latlon(lat, lon); } public static double assertZValue(final boolean ignoreZValue, double zValue) { if (ignoreZValue == false) { throw new ElasticsearchParseException("Exception parsing coordinates: found Z value [{}] but [ignore_z_value] " + "parameter is [{}]", zValue, ignoreZValue); } return zValue; } } "
---




> **版本：** 7.11-7.15


简要来说，当 Elasticsearch 在解析地理点位时在坐标中遇到 Z 值，但 “ignore_z_value” 设置未启用时，就会发生此错误。该设置允许 Elasticsearch 忽略坐标中表示海拔的 Z 值。要解决此问题，如果不需要 Z 值，可以从坐标中移除它，或者可以在映射中将 “ignore_z_value” 设置为 true，以允许 Elasticsearch 忽略这些值。

日志上下文
-----------

日志 “Exception parsing coordinates: found Z value [{}] but [ignore\_z\_value]” 的类名是 [GeoPoint.java](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/)。我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入了解上下文的人参考：

```java
return builder.latlon(lat, lon);
 }  public static double assertZValue(final boolean ignoreZValue, double zValue) {
 if (ignoreZValue == false) {
 throw new ElasticsearchParseException("Exception parsing coordinates: found Z value [{}] but [ignore_z_value] "
 + "parameter is [{}]", zValue, ignoreZValue);
 }
 return zValue;
 }
}
```