Go go-shp Point与PointZ类型有什么区别

我在用 go-shp 处理点要素时，最容易混淆的不是坐标顺序，而是把二维点和带高程的点当成了同一种记录。结论先说：shp.Point 只有 X、Y；shp.PointZ 有 X、Y、Z、M。如果写入 Shapefile，还要让数据结构与 shp.POINT 或 shp.POINTZ 形状类型保持一致。

官方地址：https://pkg.go.dev/github.com/jonas-p/go-shp

可以把 Point 理解为平面位置，把 PointZ 理解为“平面位置 + 第三维坐标 + 一个测量值”。Z 通常表示高程或其他第三维数值，M 是沿路线、里程或业务尺度使用的测量值；它们不是同一个字段，也不会因为调用 BBox 就被自动纳入二维范围。

先看 Point 与 PointZ 的字段差异

go-shp 文档中，Point 定义为两个 float64 字段：

type Point struct {
    X, Y float64
}

PointZ 则定义了四个 float64 字段，其中 X、Y 是平面位置，Z 是第三维坐标，M 是测量值：

type PointZ struct {
    X float64
    Y float64
    Z float64
    M float64
}

因此，二者的区别不是“PointZ 只是 Point 多了一个可选参数”。在Go类型层面，它们就是两个不同的结构体；在Shapefile层面，它们还对应不同的形状类型。代码里如果只有经纬度或平面坐标，使用 Point 更直接；如果记录必须保留高程，或者还要保留沿线测量值，就应该明确使用 PointZ。

POINT 与 POINTZ 必须和数据结构配对

官方文档列出了 POINT 和 POINTZ 两个形状类型常量，数值分别是 1 和 11。创建写入器时选择的形状类型，应该与后续写入的对象语义一致：

package main

import (
    "log"

    shp "github.com/jonas-p/go-shp"
)

func write2DPoint() {
    // POINT 只承载 X、Y；适合没有第三维数据的点记录。
    writer, err := shp.Create("points.shp", shp.POINT)
    if err != nil {
        log.Fatal(err)
    }
    defer writer.Close()

    point := shp.Point{X: 116.39, Y: 39.90}
    // Writer.Write 接受 Shape；Point 的 BBox 方法使它满足该接口。
    if row := writer.Write(&point); row 

上面两个函数的重点是“创建时的形状类型”和“写入时的结构体”成对出现。不要只把 Point 改成 PointZ，却仍然用 shp.POINT 创建文件；同样，也不要为了使用 POINTZ 给所有二维点凭空填一个没有业务含义的 Z 或 M。

BBox 看的是平面范围，不是全部字段

Point.BBox() 返回点位置本身形成的零面积包围盒。PointZ.BBox() 的文档也明确说明，包围盒使用的是点的 X、Y 坐标。也就是说，同一个 X、Y 下，即使两个 PointZ 的 Z 或 M 不同，它们的二维 BBox 仍然相同。

package main

import (
    "fmt"

    shp "github.com/jonas-p/go-shp"
)

func printBounds() {
    // 两个点的 X、Y 相同，只改变 Z 与 M，观察二维边界的职责。
    a := shp.PointZ{X: 10, Y: 20, Z: 5, M: 100}
    b := shp.PointZ{X: 10, Y: 20, Z: 80, M: 900}

    // BBox 只用于平面范围；不要用它判断 Z 或 M 是否相等。
    fmt.Println(a.BBox() == b.BBox())
}

这个例子表达的是API契约：BBox 适合参与二维索引、范围合并和文件级平面边界计算，但不能替代对 Z、M 字段的业务检查。若业务需要判断海拔、路线里程或其他第三维信息，应该直接读取具体结构体字段。

读取 Shape 时不要只看接口名

读取器的 Shape() 返回一个编号和一个 Shape 接口。接口本身只表达“这是一个可作为形状处理的对象”，并不会把 Point 和 PointZ 合并成同一套字段。读取到记录后，应根据实际类型做分支：

func describeShape(shape shp.Shape) string {
    switch point := shape.(type) {
    case *shp.Point:
        // 二维记录没有可读取的 Z、M，直接使用 X、Y。
        return fmt.Sprintf("2D x=%v y=%v", point.X, point.Y)
    case *shp.PointZ:
        // 三维记录必须显式读取 Z、M，避免丢掉额外信息。
        return fmt.Sprintf("3D x=%v y=%v z=%v m=%v", point.X, point.Y, point.Z, point.M)
    default:
        // 其他形状类型不能按点结构体解释。
        return "非点形状"
    }
}

这里的代码片段假设调用方已经导入 fmt 和 go-shp。实际循环仍然要处理 Open、Next、Err 和 Close；示例只突出类型分支，不把读取流程混入比较结论。

按数据契约选择类型

可以用三句话做最后判断：数据没有第三维时用 Point；数据要保留第三维或测量值时用 PointZ；写入时让 Create 的形状类型与结构体匹配。这样既不会把二维文件误当成三维文件，也不会为了“看起来更完整”给没有来源的字段填入虚假数值。

常见问题

PointZ 的 M 一定是时间吗？

不一定。M 是测量值，常见用法包括路线里程、线性参考值或业务自定义尺度。使用前要在项目文档中约定单位和含义。

PointZ 的 BBox 会包含 Z 吗？

不会。go-shp 的 BBox 是二维包围盒，依据 X、Y 计算；需要三维范围时要自行维护 Z 的最小值和最大值。

二维点可以直接写到 POINTZ 文件吗？

不建议这样混用。POINTZ 的记录契约包含 Z、M，应该创建并写入 PointZ，并明确缺失值的业务规则；不要把普通二维点依赖于隐式补值。

读取时只调用 BBox 是否够了？

如果业务只做二维空间范围处理，BBox 可能够用；如果还要保留高程或测量值，就必须按 PointZ 具体类型读取字段。

小结：Point 和 PointZ 的核心差异是字段与文件形状契约，而不是简单的坐标数量变化。先确认数据是否拥有真实的 Z/M，再让结构体、Create 类型和读取分支保持一致。