earthdistance 模块提供两种不同的方法来计算地球表面的大圆距离。第一种方法依赖 cube 模块。第二种方法基于内置的 point 数据类型，使用经度与纬度作为坐标。
在该模块中，地球被假定为一个完美的球体。（如果这个精度对你来说不够，你可以考虑 PostGIS 项目。）
在安装 earthdistance 之前必须先安装 cube 模块（不过你可以使用 CREATE EXTENSION 的 CASCADE 选项在一条命令中同时安装两者）。
强烈建议将 earthdistance 与 cube 安装在同一个模式中，并且该模式从未、将来也不会被授予任何不受信任的用户 CREATE 权限。否则，如果 earthdistance 所在的模式中包含敌意用户定义的对象，就会产生安装期安全隐患。此外，安装后在 earthdistance 的函数中使用时，整个搜索路径应只包含受信任的模式。
数据存储在表示点的立方体中（两个角相同），使用 3 个坐标表示距地心的 x、y、z 距离。模块提供建立在 cube 类型之上的 域 earth，它带有约束检查，确保值满足这些限制，并且与地球实际表面足够接近。
地球半径由 earth() 函数获得，单位为米。只要修改这一个函数，你就可以让模块改用其他单位，或者使用你认为更合适的半径值。
该扩展包同样适用于天文数据库。天文学家可能希望修改 earth() 使其返回 180/pi() 的半径，这样距离就以度为单位。
模块提供的函数支持以经纬度（单位为度）输入与输出、计算两点之间的大圆距离，以及方便地指定可用于索引搜索的边界框。
提供的函数见 Table F.4。
Table F.4. 基于 Cube 的 earthdistance 函数
模块的第二部分依赖将地球位置表示为 point 类型的值，其中第一个分量表示经度（单位为度），第二个分量表示纬度（单位为度）。点被理解为（经度，纬度）的顺序，原因是经度更接近 x 轴的直观概念，纬度更接近 y 轴。
该部分只提供一个操作符，见 Table F.5。
Table F.5. 基于 Point 的 earthdistance 操作符
操作符 描述 |
|---|
计算地球表面两点之间的法定英里距离。 |
请注意，与模块中基于 cube 的部分不同，这里的单位是固定的：修改 earth() 函数不会影响该操作符的结果。
经度/纬度表示法的一个缺点是，你必须小心处理极点附近以及经度接近 +/- 180 度附近的边界情况。基于 cube 的表示方式避免了这些不连续问题。