> ## Documentation Index > Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. > 座標に関するドキュメント # 地理座標を扱う関数
## greatCircleDistance
[大円距離の公式](https://en.wikipedia.org/wiki/Great-circle_distance)を用いて、地球表面上の2点間の距離を計算します。 ```sql theme={null} greatCircleDistance(lon1Deg, lat1Deg, lon2Deg, lat2Deg) ``` **入力パラメータ** * `lon1Deg` — 1 点目の経度 (度単位) 。範囲: `[-180°, 180°]`。 * `lat1Deg` — 1 点目の緯度 (度単位) 。範囲: `[-90°, 90°]`。 * `lon2Deg` — 2 点目の経度 (度単位) 。範囲: `[-180°, 180°]`。 * `lat2Deg` — 2 点目の緯度 (度単位) 。範囲: `[-90°, 90°]`。 正の値は北緯および東経、負の値は南緯および西経に対応します。 **戻り値** 地表上の 2 点間の距離 (メートル単位) 。 入力パラメータの値が範囲外の場合は、例外が生成されます。 **例** ```sql theme={null} SELECT greatCircleDistance(55.755831, 37.617673, -55.755831, -37.617673) AS greatCircleDistance ``` ```text theme={null} ┌─greatCircleDistance─┐ │ 14128352 │ └─────────────────────┘ ```
## geoDistance
`greatCircleDistance` と似ていますが、球面ではなく WGS-84 楕円体上での距離を計算します。これは地球のジオイドをより正確に近似するものです。 パフォーマンスは `greatCircleDistance` と同等で、性能上のデメリットはありません。地球上の距離を計算する場合は、`geoDistance` の使用を推奨します。 技術的な注記: 十分に近い点どうしについては、座標の中点における接平面上の計量を用いた平面近似によって距離を計算します。 ```sql theme={null} geoDistance(lon1Deg, lat1Deg, lon2Deg, lat2Deg) ``` **入力パラメータ** * `lon1Deg` — 1 番目の地点の経度 (度) 。範囲: `[-180°, 180°]`。 * `lat1Deg` — 1 番目の地点の緯度 (度) 。範囲: `[-90°, 90°]`。 * `lon2Deg` — 2 番目の地点の経度 (度) 。範囲: `[-180°, 180°]`。 * `lat2Deg` — 2 番目の地点の緯度 (度) 。範囲: `[-90°, 90°]`。 正の値は北緯および東経、負の値は南緯および西経に対応します。 **戻り値** 地球表面上の 2 地点間の距離 (メートル単位) 。 入力パラメータの値が範囲外の場合、例外が発生します。 **例** ```sql theme={null} SELECT geoDistance(38.8976, -77.0366, 39.9496, -75.1503) AS geoDistance ``` ```text theme={null} ┌─geoDistance─┐ │ 212458.73 │ └─────────────┘ ```
## greatCircleAngle
[大円距離の公式](https://en.wikipedia.org/wiki/Great-circle_distance)を用いて、地球表面上の2点間の中心角を計算します。 ```sql theme={null} greatCircleAngle(lon1Deg, lat1Deg, lon2Deg, lat2Deg) ``` **入力パラメータ** * `lon1Deg` — 1 番目の点の経度 (度) 。 * `lat1Deg` — 1 番目の点の緯度 (度) 。 * `lon2Deg` — 2 番目の点の経度 (度) 。 * `lat2Deg` — 2 番目の点の緯度 (度) 。 **戻り値** 2 点間の中心角 (度) 。 **例** ```sql theme={null} SELECT greatCircleAngle(0, 0, 45, 0) AS arc ``` ```text theme={null} ┌─arc─┐ │ 45 │ └─────┘ ```
## geoToUTM
WGS84 の地理座標 `(longitude, latitude)` を [Universal Transverse Mercator (UTM)](https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system) 座標に変換します。 UTM は 60 個の横メルカトル投影の集合で、それぞれが経度 6° 幅のゾーンをカバーし、地理座標をメートル単位の平面グリッドに写像します。ゾーンは経度に基づいて自動的に選択され、明示的な `zone` が指定されていない限り、ノルウェーおよびスヴァールバルに対する標準的な例外が適用されます。UTM が定義されているのは緯度 `[-80°, 84°]` の範囲のみで、極地では別の UPS システムが使用されます。 ```sql theme={null} geoToUTM(longitude, latitude[, zone]) ``` **引数** * `longitude` — 度単位の経度。範囲: `[-180°, 180°]`。[`Float32`](/docs/ja/reference/data-types/float)/[`Float64`](/docs/ja/reference/data-types/float)。 * `latitude` — 度単位の緯度。範囲: `[-80°, 84°]`。[`Float32`](/docs/ja/reference/data-types/float)/[`Float64`](/docs/ja/reference/data-types/float)。 * `zone` — 任意。自動選択ではなく、この UTM ゾーンへの投影を強制します。範囲: `[1, 60]`。[`(U)Int*`](/docs/ja/reference/data-types/int-uint)。 **戻り値** 名前付きタプル `(easting, northing, zone, band)` を返します。`easting` と `northing` は東距と北距でメートル単位 ([`Float64`](/docs/ja/reference/data-types/float)) 、UTM の `zone` はゾーン番号 ([`UInt8`](/docs/ja/reference/data-types/int-uint)) 、MGRS 緯度の `band` は帯域文字 ([`FixedString(1)`](/docs/ja/reference/data-types/fixedstring)) です。`band` が `'N'` 以降の場合は北半球を示します。 緯度が `[-80°, 84°]` の範囲外、または経度が `[-180°, 180°]` の範囲外の場合、例外を生成します。 **例** ```sql theme={null} SELECT geoToUTM(2.294497, 48.858222) AS utm; -- Eiffel Tower ``` ```text theme={null} (448251.5978370684,5411935.125629659,31,'U') ```
## UTMToGeo
[UTM](https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system) 座標を WGS84 の地理座標 `(longitude, latitude)` に変換します。これは [`geoToUTM`](#geotoutm) の逆変換です。 ```sql theme={null} UTMToGeo(easting, northing, zone, is_north) ``` **引数** * `easting` — 東距 (メートル単位。500000 m の仮東距を含む) 。[`(U)Int*`](/docs/ja/reference/data-types/int-uint)/[`Float*`](/docs/ja/reference/data-types/float)。 * `northing` — 北距 (メートル単位。南半球では 10000000 m の仮北距を含む) 。[`(U)Int*`](/docs/ja/reference/data-types/int-uint)/[`Float*`](/docs/ja/reference/data-types/float)。 * `zone` — UTM ゾーン番号。範囲: `[1, 60]`。[`(U)Int*`](/docs/ja/reference/data-types/int-uint)。 * `is_north` — 半球。北半球は `1`、南半球は `0`。[`(U)Int*`](/docs/ja/reference/data-types/int-uint)。 **戻り値** 度単位の名前付きタプル `(longitude, latitude)`。[`Tuple(Float64, Float64)`](/docs/ja/reference/data-types/tuple)。 **例** ```sql theme={null} SELECT UTMToGeo(448251.6, 5411935.13, 31, 1) AS coord; ``` ```text theme={null} (2.2944970289079203,48.85822204127082) ```
## geoToMGRS
WGS84の地理座標`(longitude, latitude)`を、[Military Grid Reference System (MGRS)](https://en.wikipedia.org/wiki/Military_Grid_Reference_System)文字列にエンコードします。 文字列の形式は`<100km square>`で、たとえば`31UDQ4825111935`です。`precision`引数は、東距と北距のそれぞれに使用する桁数を制御します。`5` (デフォルト) は1 m、`4`は10 m、`3`は100 m、`2`は1 km、`1`は10 km、`0`は100 kmグリッドスクエアのみを表します。MGRSは、緯度が`[-80°, 84°]`の範囲内にある場合にのみ定義されています。 ```sql theme={null} geoToMGRS(longitude, latitude[, precision]) ``` **引数** * `longitude` — 度単位の経度。範囲: `[-180°, 180°]`。[`Float32`](/docs/ja/reference/data-types/float)/[`Float64`](/docs/ja/reference/data-types/float)。 * `latitude` — 度単位の緯度。範囲: `[-80°, 84°]`。[`Float32`](/docs/ja/reference/data-types/float)/[`Float64`](/docs/ja/reference/data-types/float)。 * `precision` — 省略可。東距・北距のそれぞれの桁数。デフォルト: `5`。範囲: `[0, 5]`。[`(U)Int*`](/docs/ja/reference/data-types/int-uint)。 **戻り値** MGRS参照文字列。[`String`](/docs/ja/reference/data-types/string)。 **例** ```sql theme={null} SELECT geoToMGRS(2.294497, 48.858222) AS mgrs, geoToMGRS(2.294497, 48.858222, 3) AS mgrs_100m; ``` ```text theme={null} ┌─mgrs────────────┬─mgrs_100m───┐ │ 31UDQ4825111935 │ 31UDQ482119 │ └─────────────────┴─────────────┘ ```
## MGRSToGeo
[MGRS](https://en.wikipedia.org/wiki/Military_Grid_Reference_System) 文字列を WGS84 の地理座標 `(longitude, latitude)` にデコードします。これは [`geoToMGRS`](#geotomgrs) の逆です。 返される Point は、参照されたグリッド正方形の中心点です。そのため、結果の精度は文字列にエンコードされている精度と一致します。入力中の空白は無視され、文字の大文字と小文字は区別されません。 ```sql theme={null} MGRSToGeo(mgrs) ``` **引数** * `mgrs` — デコードする MGRS 参照文字列。[`String`](/docs/ja/reference/data-types/string)/[`FixedString`](/docs/ja/reference/data-types/fixedstring)。 **戻り値** 度単位の名前付きタプル `(longitude, latitude)` を返します。[`Tuple(Float64, Float64)`](/docs/ja/reference/data-types/tuple)。 **例** ```sql theme={null} SELECT MGRSToGeo('31UDQ4825111935') AS coord; ``` ```text theme={null} (2.294495618908297,48.85822536113692) ```
## pointInEllipses
点が少なくとも1つの楕円内にあるかどうかを判定します。 座標はデカルト座標系の幾何座標です。 ```sql theme={null} pointInEllipses(x, y, x₀, y₀, a₀, b₀,...,xₙ, yₙ, aₙ, bₙ) ``` **入力パラメータ** * `x, y` — 平面上の点の座標。 * `xᵢ, yᵢ` — `i` 番目の楕円の中心の座標。 * `aᵢ, bᵢ` — `i` 番目の楕円の軸を x, y 座標の単位で表したもの。 入力パラメータの数は `2+4⋅n` でなければなりません。ここで、`n` は楕円の数です。 **戻り値** 点が少なくとも 1 つの楕円の内側にある場合は `1`、そうでない場合は `0`。 **例** ```sql theme={null} SELECT pointInEllipses(10., 10., 10., 9.1, 1., 0.9999) ``` ```text theme={null} ┌─pointInEllipses(10., 10., 10., 9.1, 1., 0.9999)─┐ │ 1 │ └─────────────────────────────────────────────────┘ ```
## pointInPolygon
平面上で、その点がポリゴン内にあるかどうかを判定します。 ```sql theme={null} pointInPolygon((x, y), [(a, b), (c, d) ...], ...) ``` **入力値** * `(x, y)` — 平面上の点の座標。データ型 — [Tuple](/docs/ja/reference/data-types/tuple) — 2 つの数値からなるタプル、または [Point](/docs/ja/reference/data-types/geo#point)。 * `[(a, b), (c, d) ...]` — Polygon の頂点。データ型 — [Array](/docs/ja/reference/data-types/array) または [Ring](/docs/ja/reference/data-types/geo#ring)。各頂点は座標の組 `(a, b)` で表されます。頂点は時計回りまたは反時計回りの順序で指定する必要があります。頂点の最小数は 3 です。 * この関数は穴 (切り抜き部分) のある Polygon もサポートします。データ型 — [Polygon](/docs/ja/reference/data-types/geo#polygon)。`Polygon` 全体を第 2 引数として渡すか、外側のリングを最初に渡し、その後に各穴を個別の追加引数として渡します。 * この関数は MultiPolygon もサポートします。データ型 — [MultiPolygon](/docs/ja/reference/data-types/geo#multipolygon)。`MultiPolygon` 全体を第 2 引数として渡すか、各構成 Polygon をそれぞれ個別の引数として列挙します。 * Polygon 引数には、Polygon 形状の値 (`Ring`、`Polygon`、または `MultiPolygon`) を保持する [Geometry](/docs/ja/reference/data-types/geo#geometry) カラムも使用できます。 Polygon 形状の型 ([Ring](/docs/ja/reference/data-types/geo#ring)、[Polygon](/docs/ja/reference/data-types/geo#polygon)、[MultiPolygon](/docs/ja/reference/data-types/geo#multipolygon)、および [Geometry](/docs/ja/reference/data-types/geo#geometry)) は、定数としても通常の (非定数の) テーブルカラムとしても渡すことができます。Polygon が複数の個別の引数 (外側のリングの後に穴が続く場合や、MultiPolygon の複数の Polygon など) に分けて渡される場合、それらの引数はすべて定数でなければなりません。 **戻り値** 点が Polygon の内側にある場合は `1`、そうでない場合は `0` を返します。 点が Polygon の境界上にある場合、この関数は `0` または `1` のいずれかを返すことがあります。 **例** ```sql theme={null} SELECT pointInPolygon((3., 3.), [(6, 0), (8, 4), (5, 8), (0, 2)]) AS res ``` ```text theme={null} ┌─res─┐ │ 1 │ └─────┘ ``` ポリゴンは、テーブルのカラムとして指定する場合も含め、名前付きの幾何データ型を使って指定することもできます。 ```sql theme={null} CREATE TABLE poly (id UInt32, shape Polygon) ENGINE = Memory; INSERT INTO poly VALUES (1, [[(0, 0), (10, 0), (10, 10), (0, 10)], [(4, 4), (6, 4), (6, 6), (4, 6)]]); SELECT id, pointInPolygon((2., 2.), shape) AS res FROM poly; ``` ```text theme={null} ┌─id─┬─res─┐ │ 1 │ 1 │ └────┴─────┘ ``` > **注** > • ジオメトリの検証をスキップするには、`validate_polygons = 0` を設定できます。 > • `pointInPolygon` は、すべてのポリゴンが正しい形式であることを前提としています。入力が自己交差している、リングの順序が誤っている、または辺同士が重なっている場合、結果は信頼できなくなります。特に、点が辺上や頂点上にちょうどある場合や、"内側" と "外側" の区別が定義できない自己交差部分の内部にある場合は、その傾向が顕著です。 > • ポリゴン引数が定数で、点が索引付きのキーカラムで表されている場合 (たとえば、`x, y` が `PRIMARY KEY` の一部である、または `minmax` 索引でカバーされているテーブル上の `pointInPolygon((x, y), constant_polygon)` など) 、ClickHouse は主キーと `minmax` のデータスキップ索引の両方を使って、無関係なグラニュールを刈り込むことができます。