Go go-geom 怎样为多边形添加外环与内环

在地图、配送范围或地理围栏中，一个多边形往往不是“只有一圈点”：外部边界描述覆盖范围，内部的一个或多个环描述孔洞。go-geom 的 Polygon 直接用环的顺序表达这种关系，最关键的规则是：第一个 LinearRing 是外环，后续环是内环。

官方地址：https://pkg.go.dev/github.com/twpayne/go-geom

要添加外环和内环，可以用 SetCoords 一次性传入二维坐标切片，也可以先创建 LinearRing 再按顺序调用 Push。每个环都应首尾闭合，并且所有环使用同一种布局，例如都使用 geom.XY。

先分清 Polygon 中的环顺序

go-geom 把 Polygon 看成一组 LinearRing：索引为 0 的环是外边界，索引从 1 开始的环是内边界，也就是孔洞。这个约定决定了同一组坐标放入不同顺序后，含义会完全不同。

例如，外环可以是一个 4×4 的闭合矩形，内环可以是其中的 2×2 矩形。二维坐标通常写成 [][]geom.Coord：第一层代表环，第二层代表环里的点。每个环都要把第一个点再写到最后，使首尾坐标相同。

用 SetCoords 一次性添加外环和内环

如果外环和孔洞坐标已经完整准备好，SetCoords 是最直观的写法。下面的示例只关注几何对象的组装：先准备两个闭合环，再把它们按外环、内环的顺序传入。

package main

import (
    "fmt"

    geom "github.com/twpayne/go-geom"
)

func main() {
    // 外环必须闭合；最后一个点回到第一个点。
    outer := []geom.Coord{
        {0, 0}, {4, 0}, {4, 4}, {0, 4}, {0, 0},
    }
    // 内环表示孔洞，同样需要首尾闭合。
    hole := []geom.Coord{
        {1, 1}, {3, 1}, {3, 3}, {1, 3}, {1, 1},
    }

    // 第一个环放外边界，后续环放孔洞。
    polygon, err := geom.NewPolygon(geom.XY).SetCoords(
        [][]geom.Coord{outer, hole},
    )
    if err != nil {
        // 构造失败时不要继续读取面积或把对象交给下游。
        fmt.Println("设置 Polygon 坐标失败：", err)
        return
    }

    // 环数量应包含一个外环和一个内环。
    fmt.Printf("rings=%d area=%.1f\n",
        polygon.NumLinearRings(), polygon.Area())
}

这里的 SetCoords 返回对象和 error，因此不要为了省一行代码而忽略错误。NumLinearRings 适合做结构层面的快速检查；Area 则适合确认带孔几何的面积语义。示例中的坐标只是解释数据形状，实际项目还要根据坐标单位和坐标系解释面积。

需要逐步组装时使用 LinearRing 和 Push

当外环和内环来自不同数据源，或程序要按条件追加多个孔洞时，可以先创建空的 Polygon，再逐个创建 LinearRing。Push 的调用顺序仍然重要：外环必须先放入，孔洞随后放入。

func buildPolygon(outer, hole []geom.Coord) (*geom.Polygon, error) {
    // 所有环统一使用 XY，避免把二维坐标和三维布局混在一起。
    outerRing, err := geom.NewLinearRing(geom.XY).SetCoords(outer)
    if err != nil {
        return nil, err
    }
    holeRing, err := geom.NewLinearRing(geom.XY).SetCoords(hole)
    if err != nil {
        return nil, err
    }

    polygon := geom.NewPolygon(geom.XY)
    // 第一次 Push 建立外边界。
    if err := polygon.Push(outerRing); err != nil {
        return nil, err
    }
    // 后续 Push 才表示孔洞。
    if err := polygon.Push(holeRing); err != nil {
        return nil, err
    }
    return polygon, nil
}

逐步 Push 的优势是可以在每次接收数据时立即处理错误，代价是调用方要自己保证顺序和环的完整性。若孔洞数量不固定，可以把每个候选环先转成 LinearRing，再在追加前检查它是否至少有足够的点并且首尾相同。

排查闭合、布局和面积边界

这类问题通常不是 Polygon 类型本身难，而是输入环的契约没有保持一致。可以按下面的顺序排查：

如果只想查看结构，可以先打印 NumLinearRings 和 Coords；如果要交给后续编码器或空间运算，则应在构造阶段就处理错误，不要等到序列化或查询阶段才定位。

小结

Go go-geom 添加外环与内环有两条清晰路径：数据已齐时用 SetCoords([][]geom.Coord{outer, hole})，数据逐步到达时用 LinearRing.SetCoords 后按外环、内环顺序 Push。只要牢记“第一个环是外环、后续环是孔洞”，并保持每个环闭合、布局一致，Polygon 的结构就容易读懂和维护。

go-geom 的 Polygon 能有多个内环吗？

可以。把多个闭合环放在外环之后即可；调用方仍应保证每个环的坐标和布局符合统一约定，并根据业务规则确认这些环确实是孔洞。

为什么不直接把所有坐标拼成一个切片？

因为 Polygon 需要保留环的边界。使用二维切片或逐个 Push 可以让外环与每个内环保持独立，后续读取、序列化和排查时不会丢失层级信息。