ClickHouse/docs/tr/sql-reference/functions/geo.md

511 lines
14 KiB
Markdown
Raw Normal View History

2020-04-15 13:56:49 +00:00
---
machine_translated: true
machine_translated_rev: e8cd92bba3269f47787db090899f7c242adf7818
toc_priority: 62
toc_title: "Co\u011Frafi koordinatlar ile \xE7al\u0131\u015Fma"
---
# Coğrafi Koordinatlarla çalışmak için Fonksiyonlar {#functions-for-working-with-geographical-coordinates}
2020-04-15 13:56:49 +00:00
## greatCircleDistance {#greatcircledistance}
Dünya yüzeyindeki iki nokta arasındaki mesafeyi kullanarak hesaplayın [büyük daire formülü](https://en.wikipedia.org/wiki/Great-circle_distance).
``` sql
greatCircleDistance(lon1Deg, lat1Deg, lon2Deg, lat2Deg)
```
**Giriş parametreleri**
- `lon1Deg` — Longitude of the first point in degrees. Range: `[-180°, 180°]`.
- `lat1Deg` — Latitude of the first point in degrees. Range: `[-90°, 90°]`.
- `lon2Deg` — Longitude of the second point in degrees. Range: `[-180°, 180°]`.
- `lat2Deg` — Latitude of the second point in degrees. Range: `[-90°, 90°]`.
Pozitif değerler Kuzey enlemi ve Doğu boylamına karşılık gelir ve negatif değerler Güney enlemi ve Batı boylamına karşılık gelir.
**Döndürülen değer**
Dünya yüzeyindeki iki nokta arasındaki mesafe, metre cinsinden.
Girdi parametre değerleri aralığın dışına düştüğünde bir özel durum oluşturur.
**Örnek**
``` sql
SELECT greatCircleDistance(55.755831, 37.617673, -55.755831, -37.617673)
```
``` text
┌─greatCircleDistance(55.755831, 37.617673, -55.755831, -37.617673)─┐
│ 14132374.194975413 │
└───────────────────────────────────────────────────────────────────┘
```
## pointİnEllipses {#pointinellipses}
Noktanın elipslerden en az birine ait olup olmadığını kontrol eder.
Koordinatlar kartezyen koordinat sisteminde geometriktir.
``` sql
pointInEllipses(x, y, x₀, y₀, a₀, b₀,...,xₙ, yₙ, aₙ, bₙ)
```
**Giriş parametreleri**
- `x, y` — Coordinates of a point on the plane.
- `xᵢ, yᵢ` — Coordinates of the center of the `i`-inci üç nokta.
- `aᵢ, bᵢ` — Axes of the `i`- x, y koordinatları birimlerinde üç nokta.
Giriş parametreleri olmalıdır `2+4⋅n`, nere `n` elips sayısıdır.
**Döndürülen değerler**
`1` nokta elipslerden en az birinin içindeyse; `0`hayır değil.
**Örnek**
``` sql
SELECT pointInEllipses(10., 10., 10., 9.1, 1., 0.9999)
```
``` text
┌─pointInEllipses(10., 10., 10., 9.1, 1., 0.9999)─┐
│ 1 │
└─────────────────────────────────────────────────┘
```
## pointİnPolygon {#pointinpolygon}
Noktanın düzlemdeki poligona ait olup olmadığını kontrol eder.
``` sql
pointInPolygon((x, y), [(a, b), (c, d) ...], ...)
```
**Giriş değerleri**
- `(x, y)` — Coordinates of a point on the plane. Data type — [Demet](../../sql-reference/data-types/tuple.md) — A tuple of two numbers.
- `[(a, b), (c, d) ...]` — Polygon vertices. Data type — [Dizi](../../sql-reference/data-types/array.md). Her köşe bir çift koordinat ile temsil edilir `(a, b)`. Köşeler saat yönünde veya saat yönünün tersine sırayla belirtilmelidir. Minimum köşe sayısı 3tür. Çokgen sabit olmalıdır.
2020-04-15 13:56:49 +00:00
- Fonksiyon ayrıca delikli çokgenleri de destekler (bölümleri keser). Bu durumda, işlevin ek argümanlarını kullanarak kesilen bölümleri tanımlayan çokgenler ekleyin. İşlev, basit olmayan bağlı çokgenleri desteklemez.
**Döndürülen değerler**
`1` nokta çokgenin içinde ise, `0` hayır değil.
Nokta çokgen sınırında ise, işlev 0 veya 1 döndürebilir.
**Örnek**
``` sql
SELECT pointInPolygon((3., 3.), [(6, 0), (8, 4), (5, 8), (0, 2)]) AS res
```
``` text
┌─res─┐
│ 1 │
└─────┘
```
## geohashEncode {#geohashencode}
Enlem ve boylamı bir geohash-string olarak kodlar, Lütfen bakınız (http://geohash.org/, https://en.wikipedia.org/wiki/Geohash).
``` sql
geohashEncode(longitude, latitude, [precision])
```
**Giriş değerleri**
- boylam-kodlamak istediğiniz koordinatın boylam kısmı. Aralık floatingta yüz floatingen`[-180°, 180°]`
- latitude-kodlamak istediğiniz koordinatın enlem kısmı. Aralık floatingta yüz floatingen `[-90°, 90°]`
- hassas-isteğe bağlı, elde edilen kodlanmış dizenin uzunluğu, varsayılan olarak `12`. Aralıktaki tamsayı `[1, 12]`. Herhangi bir değer daha az `1` veya daha büyük `12` sessizce dönüştürülür `12`.
**Döndürülen değerler**
- alfanümerik `String` kodlanmış koordinat (base32-kodlama alfabesinin değiştirilmiş versiyonu kullanılır).
**Örnek**
``` sql
SELECT geohashEncode(-5.60302734375, 42.593994140625, 0) AS res
```
``` text
┌─res──────────┐
│ ezs42d000000 │
└──────────────┘
```
## geohashDecode {#geohashdecode}
Herhangi bir geohash kodlu dizeyi boylam ve enlem olarak çözer.
**Giriş değerleri**
- kodlanmış dize-geohash kodlanmış dize.
**Döndürülen değerler**
- (boylam, enlem) - 2-tuple `Float64` boylam ve enlem değerleri.
**Örnek**
``` sql
SELECT geohashDecode('ezs42') AS res
```
``` text
┌─res─────────────────────────────┐
│ (-5.60302734375,42.60498046875) │
└─────────────────────────────────┘
```
## geoToH3 {#geotoh3}
Dönüşler [H3](https://uber.github.io/h3/#/documentation/overview/introduction) nokta Endeksi `(lon, lat)` belirtilen çözünürlük ile.
[H3](https://uber.github.io/h3/#/documentation/overview/introduction) Dünya yüzeyinin altıgen fayanslara bile bölündüğü coğrafi bir indeksleme sistemidir. Bu sistem hiyerarşiktir, örn. üst seviyedeki her altıgen yedi hatta daha küçük olanlara bölünebilir.
Bu endeks öncelikle kovalama yerleri ve diğer coğrafi manipülasyonlar için kullanılır.
**Sözdizimi**
``` sql
geoToH3(lon, lat, resolution)
```
**Parametre**
- `lon` — Longitude. Type: [Float64](../../sql-reference/data-types/float.md).
- `lat` — Latitude. Type: [Float64](../../sql-reference/data-types/float.md).
- `resolution` — Index resolution. Range: `[0, 15]`. Tür: [Uİnt8](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Döndürülen değerler**
- Altıgen dizin numarası.
- Hata durumunda 0.
Tür: `UInt64`.
**Örnek**
Sorgu:
``` sql
SELECT geoToH3(37.79506683, 55.71290588, 15) as h3Index
```
Sonuç:
``` text
┌────────────h3Index─┐
│ 644325524701193974 │
└────────────────────┘
```
## geohashesİnBox {#geohashesinbox}
Verilen kutunun içine giren ve verilen kutunun sınırlarını kesişen, temel olarak diziye düzleştirilmiş bir 2D ızgarası olan bir dizi geohash kodlu dizeler dizisi döndürür.
**Giriş değerleri**
- longitude\_min - min boylam, aralıkta kayan değer `[-180°, 180°]`
- latitude\_min - min enlem, aralıkta kayan değer `[-90°, 90°]`
- longitude\_max-maksimum boylam, aralıkta kayan değer `[-180°, 180°]`
- latitude\_max-maksimum enlem, aralıkta kayan değer `[-90°, 90°]`
- hassas-geohash hassas, `UInt8` Aralık inta `[1, 12]`
Lütfen tüm koordinat parametrelerinin aynı tipte olması gerektiğini unutmayın: `Float32` veya `Float64`.
**Döndürülen değerler**
- verilen alanı kapsayan geohash kutularının hassas uzun dizeleri dizisi, öğelerin sırasına güvenmemelisiniz.
- \[\]- eğer boş dizi *dakika* değerleri *enlem* ve *Boylam* karşılık gelenden daha az değil *maksimum* değerler.
Ortaya çıkan dizi 10000 000 ürün uzunluğundaysa, işlevin bir istisna atacağını lütfen unutmayın.
2020-04-15 13:56:49 +00:00
**Örnek**
``` sql
SELECT geohashesInBox(24.48, 40.56, 24.785, 40.81, 4) AS thasos
```
``` text
┌─thasos──────────────────────────────────────┐
│ ['sx1q','sx1r','sx32','sx1w','sx1x','sx38'] │
└─────────────────────────────────────────────┘
```
## h3GetBaseCell {#h3getbasecell}
Dizin temel hücre numarasını döndürür.
**Sözdizimi**
``` sql
h3GetBaseCell(index)
```
**Parametre**
- `index` — Hexagon index number. Type: [Uİnt64](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Döndürülen değerler**
- Altıgen baz hücre numarası. Tür: [Uİnt8](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Örnek**
Sorgu:
``` sql
SELECT h3GetBaseCell(612916788725809151) as basecell
```
Sonuç:
``` text
┌─basecell─┐
│ 12 │
└──────────┘
```
## h3HexAreaM2 {#h3hexaream2}
Verilen çözünürlükte metrekare ortalama altıgen alan.
**Sözdizimi**
``` sql
h3HexAreaM2(resolution)
```
**Parametre**
- `resolution` — Index resolution. Range: `[0, 15]`. Tür: [Uİnt8](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Döndürülen değerler**
- Area in m². Type: [Float64](../../sql-reference/data-types/float.md).
2020-04-15 13:56:49 +00:00
**Örnek**
Sorgu:
``` sql
SELECT h3HexAreaM2(13) as area
```
Sonuç:
``` text
┌─area─┐
│ 43.9 │
└──────┘
```
## h3İndexesAreNeighbors {#h3indexesareneighbors}
Sağlanan H3indexlerin komşu olup olmadığını döndürür.
**Sözdizimi**
``` sql
h3IndexesAreNeighbors(index1, index2)
```
**Parametre**
- `index1` — Hexagon index number. Type: [Uİnt64](../../sql-reference/data-types/int-uint.md).
- `index2` — Hexagon index number. Type: [Uİnt64](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Döndürülen değerler**
- Dönüşler `1` dizinler komşu ise, `0` başka. Tür: [Uİnt8](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Örnek**
Sorgu:
``` sql
SELECT h3IndexesAreNeighbors(617420388351344639, 617420388352655359) AS n
```
Sonuç:
``` text
┌─n─┐
│ 1 │
└───┘
```
## h3ToChildren {#h3tochildren}
Verilen dizinin alt dizinlerini içeren bir dizi döndürür.
**Sözdizimi**
``` sql
h3ToChildren(index, resolution)
```
**Parametre**
- `index` — Hexagon index number. Type: [Uİnt64](../../sql-reference/data-types/int-uint.md).
- `resolution` — Index resolution. Range: `[0, 15]`. Tür: [Uİnt8](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Döndürülen değerler**
- Alt H3 dizinleri ile dizi. Dizi türü: [Uİnt64](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Örnek**
Sorgu:
``` sql
SELECT h3ToChildren(599405990164561919, 6) AS children
```
Sonuç:
``` text
┌─children───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [603909588852408319,603909588986626047,603909589120843775,603909589255061503,603909589389279231,603909589523496959,603909589657714687] │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
```
## h3ToParent {#h3toparent}
Verilen dizini içeren üst (kaba) dizini döndürür.
**Sözdizimi**
``` sql
h3ToParent(index, resolution)
```
**Parametre**
- `index` — Hexagon index number. Type: [Uİnt64](../../sql-reference/data-types/int-uint.md).
- `resolution` — Index resolution. Range: `[0, 15]`. Tür: [Uİnt8](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Döndürülen değerler**
- Ana H3 Endeksi. Tür: [Uİnt64](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Örnek**
Sorgu:
``` sql
SELECT h3ToParent(599405990164561919, 3) as parent
```
Sonuç:
``` text
┌─────────────parent─┐
│ 590398848891879423 │
└────────────────────┘
```
## h3ToString {#h3tostring}
Dizinin H3ındex gösterimini dize gösterimine dönüştürür.
``` sql
h3ToString(index)
```
**Parametre**
- `index` — Hexagon index number. Type: [Uİnt64](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Döndürülen değerler**
- H3 dizininin dize gösterimi. Tür: [Dize](../../sql-reference/data-types/string.md).
2020-04-15 13:56:49 +00:00
**Örnek**
Sorgu:
``` sql
SELECT h3ToString(617420388352917503) as h3_string
```
Sonuç:
``` text
┌─h3_string───────┐
│ 89184926cdbffff │
└─────────────────┘
```
## stringToH3 {#stringtoh3}
Dize gösterimini H3ındex (Uİnt64) gösterimine dönüştürür.
``` sql
stringToH3(index_str)
```
**Parametre**
- `index_str` — String representation of the H3 index. Type: [Dize](../../sql-reference/data-types/string.md).
2020-04-15 13:56:49 +00:00
**Döndürülen değerler**
- Altıgen dizin numarası. Hata 0 döndürür. Tür: [Uİnt64](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Örnek**
Sorgu:
``` sql
SELECT stringToH3('89184926cc3ffff') as index
```
Sonuç:
``` text
┌──────────────index─┐
│ 617420388351344639 │
└────────────────────┘
```
## h3GetResolution {#h3getresolution}
Dizin çözünürlüğünü döndürür.
**Sözdizimi**
``` sql
h3GetResolution(index)
```
**Parametre**
- `index` — Hexagon index number. Type: [Uİnt64](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Döndürülen değerler**
- Dizin çözünürlüğü. Aralık: `[0, 15]`. Tür: [Uİnt8](../../sql-reference/data-types/int-uint.md).
2020-04-15 13:56:49 +00:00
**Örnek**
Sorgu:
``` sql
SELECT h3GetResolution(617420388352917503) as res
```
Sonuç:
``` text
┌─res─┐
│ 9 │
└─────┘
```
[Orijinal makale](https://clickhouse.tech/docs/en/query_language/functions/geo/) <!--hide-->