# F.13\. earthdistance `earthdistance`模塊提供兩個不同的方法計算地球表面上的大圓弧距離。 描述的第一個依賴于`cube`模塊（_必須_在`earthdistance` 可以安裝之前安裝）。第二個基于內建的`point`數據類型， 使用經線和緯線作為坐標。 在這個模塊，假設地球為完美的球形。（如果對你來說太不準確，你可能想查閱 [PostGIS](http://www.postgis.org/)項目。） ## F.13.1\. 基于立方體的地球距離 數據存儲在立方體中，點用3個坐標表示從地球中心到表面的x, y, z的距離。 提供一個在`cube`之上的域`earth`，包含檢查約束， 值必須符合限制條件并且合理的接近地球的實際表面。 地球的半徑從`earth()`函數獲得。以米給出。 可以通過改變模塊使用其他單元來改變這個函數，或者使用你覺得更合適的半徑值。 這個包也應用到了天文數據庫。天文學家可能想要改變`earth()`， 使其返回一個`180/pi()`的半徑，這樣距離可以用角度表示。 提供函數支持經緯度（以角度方式）輸入、輸出、計算兩個點之間大圓弧的距離， 和容易的指定用于索引查詢的邊界框。 提供的函數在[Table F-4](#calibre_link-532)里顯示。 **Table F-4\. 基于立方體的地球距離函數** | 函數 | 返回 | 描述 | | --- | --- | --- | | `earth()` | `float8` | 返回地球的假設半徑。 | | `sec_to_gc(float8)` | `float8` | 將地球表面兩點之間正常的直線（割線）距離轉換為大圓弧的距離。 | | `gc_to_sec(float8)` | `float8` | 將地球表面兩點之間的大圓弧的距離轉換為正常的直線（割線）距離。 | | `ll_to_earth(float8, float8)` | `earth` | 以角度形式返回給定緯度（參數 1）和經度（參數 2）的地球表面點的位置。 | | `latitude(earth)` | `float8` | 以角度形式返回地球表面一個點的緯度。 | | `longitude(earth)` | `float8` | 以角度形式返回地球表面一個點的經度。 | | `earth_distance(earth, earth)` | `float8` | 返回地球表面兩點之間的大圓弧距離。 | | `earth_box(earth, float8)` | `cube` | 返回一個適合于索引搜索的立方體，該立方體在一個給定位置的大圓弧距離里使用點的立方 `@>`操作符。在這個立方體中的某些點可能比指定的大圓弧距離的位置更遠， 所以使用`earth_distance`的第二個檢查應該包含在查詢中。 | ## F.13.2\. 基于點的地球距離 模塊的第二部分依賴于用類型為`point`的值表示地球距離， 這里第一個組成部分用來表示以角度表示的經度，第二個組成部分用來表示以角度表示的緯度。 點被當做是(經度, 緯度)并且反過來不行，因為經度為X軸緯度為Y軸。 提供了一個操作符，在[Table F-5](#calibre_link-533)中顯示。 **Table F-5\. 基于點的地球距離操作符** | 操作符 | 返回 | 描述 | | --- | --- | --- | | `point` `<@>` `point` | `float8` | 給出地球表面兩點之間的法定英里距離。 | 請注意，不像基于`cube`部分的模塊，這里的單元是硬鏈接的： 改變`earth()`函數將不會影響這個操作符的結果。 經度/緯度表示法的一個缺點是：你必須注意靠近兩極和接近+/- 180度經線的邊界條件。 基于`cube`的表示法避免了這些間斷點。