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

machine_translated	machine_translated_rev	toc_priority	toc_title
true	72537a2d52	62	کار با مختصات جغرافیایی

توابع برای کار با مختصات جغرافیایی

نمایش سایت

محاسبه فاصله بین دو نقطه بر روی سطح زمین با استفاده از فرمول دایره بزرگ.

greatCircleDistance(lon1Deg, lat1Deg, lon2Deg, lat2Deg)

پارامترهای ورودی

• 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°].

مقادیر مثبت به طول و عرض جغرافیایی شمال شرق مطابقت, و مقادیر منفی به طول و عرض جغرافیایی جنوبی و طول جغرافیایی غرب مطابقت.

مقدار بازگشتی

فاصله بین دو نقطه بر روی سطح زمین, در متر.

تولید یک استثنا زمانی که مقادیر پارامتر ورودی در خارج از محدوده قرار می گیرند.

مثال

SELECT greatCircleDistance(55.755831, 37.617673, -55.755831, -37.617673)

┌─greatCircleDistance(55.755831, 37.617673, -55.755831, -37.617673)─┐
│                                                14132374.194975413 │
└───────────────────────────────────────────────────────────────────┘

نقلقولهای جدید از این نویسنده

بررسی اینکه نقطه متعلق به حداقل یکی از بیضی. مختصات هندسی در سیستم مختصات دکارتی هستند.

pointInEllipses(x, y, x₀, y₀, a₀, b₀,...,xₙ, yₙ, aₙ, bₙ)

پارامترهای ورودی

• x, y — Coordinates of a point on the plane.
• xᵢ, yᵢ — Coordinates of the center of the i- حذف هفتم .
• aᵢ, bᵢ — Axes of the i- حذف ت در واحد های ایکس, و مختصات.

پارامترهای ورودی باید باشد 2+4⋅n کجا n تعداد بیضی است.

مقادیر بازگشتی

1 اگر نقطه در داخل حداقل یکی از بیضی; 0اگر این طور نیست.

مثال

SELECT pointInEllipses(10., 10., 10., 9.1, 1., 0.9999)

┌─pointInEllipses(10., 10., 10., 9.1, 1., 0.9999)─┐
│                                               1 │
└─────────────────────────────────────────────────┘

نقطه چین

بررسی اینکه نقطه متعلق به چند ضلعی در هواپیما.

pointInPolygon((x, y), [(a, b), (c, d) ...], ...)

مقادیر ورودی

• (x, y) — Coordinates of a point on the plane. Data type — تاپل — A tuple of two numbers.
• [(a, b), (c, d) ...] — Polygon vertices. Data type — & حذف. هر راس است که توسط یک جفت مختصات نشان داده شده است (a, b). راس باید در جهت عقربه های ساعت و یا در خلاف جهت عقربه مشخص شده است. حداقل تعداد راس است 3. چند ضلعی باید ثابت باشد.
• این تابع همچنین از چند ضلعی با سوراخ (برش بخش). در این مورد, اضافه چند ضلعی است که تعریف بخش برش با استفاده از استدلال های اضافی از تابع. تابع چند ضلعی غیر به سادگی متصل را پشتیبانی نمی کند.

مقادیر بازگشتی

1 اگر نقطه در داخل چند ضلعی باشد, 0 اگر این طور نیست. اگر نقطه در مرز چند ضلعی, تابع ممکن است یا بازگشت 0 یا 1.

مثال

SELECT pointInPolygon((3., 3.), [(6, 0), (8, 4), (5, 8), (0, 2)]) AS res

┌─res─┐
│   1 │
└─────┘

کد جغرافیایی

کد طول و عرض جغرافیایی به عنوان یک geohash-رشته مراجعه کنید (http://geohash.org/, https://en.wikipedia.org/wiki/Geohash).

geohashEncode(longitude, latitude, [precision])

مقادیر ورودی

• طول جغرافیایی-طول جغرافیایی بخشی از مختصات شما می خواهید به رمز. شناور در محدوده[-180°, 180°]
• عرض جغرافیایی-عرض جغرافیایی بخشی از مختصات شما می خواهید به رمز. شناور در محدوده [-90°, 90°]
• دقت-اختیاری, طول رشته کد گذاری نتیجه, به طور پیش فرض به 12. عدد صحیح در محدوده [1, 12]. هر مقدار کمتر از 1 یا بیشتر از 12 در سکوت به تبدیل 12.

مقادیر بازگشتی

• عدد و الفبایی String مختصات کد گذاری شده (نسخه اصلاح شده از الفبای باس32 رمزگذاری استفاده شده است).

مثال

SELECT geohashEncode(-5.60302734375, 42.593994140625, 0) AS res

┌─res──────────┐
│ ezs42d000000 │
└──────────────┘

کد جغرافیایی

هر رشته جغرافیایی کد گذاری به طول و عرض جغرافیایی را رمزگشایی می کند.

مقادیر ورودی

• رشته کد گذاری-رشته جغرافیایی کد گذاری.

مقادیر بازگشتی

• (طول جغرافیایی, عرض جغرافیایی) - 2-تاپل از Float64 ارزش طول و عرض جغرافیایی.

مثال

SELECT geohashDecode('ezs42') AS res

┌─res─────────────────────────────┐
│ (-5.60302734375,42.60498046875) │
└─────────────────────────────────┘

جغرافیایی 3

بازگشت H3 شاخص نقطه (lon, lat) با وضوح مشخص شده است.

H3 یک سیستم نمایه سازی جغرافیایی است که سطح زمین به کاشی های شش ضلعی حتی تقسیم شده است. این سیستم سلسله مراتبی است, به عنوان مثال. هر شش گوش در سطح بالا را می توان به هفت حتی اما کوچکتر و به همین ترتیب تقسیم.

این شاخص در درجه اول برای مکان های جفتک انداختن و دیگر دستکاری های جغرافیایی استفاده می شود.

نحو

geoToH3(lon, lat, resolution)

پارامترها

• lon — Longitude. Type: جسم شناور64.
• lat — Latitude. Type: جسم شناور64.
• resolution — Index resolution. Range: [0, 15]. نوع: UInt8.

مقادیر بازگشتی

• عدد شاخص شش گوش.
• 0 در صورت خطا.

نوع: UInt64.

مثال

پرسوجو:

SELECT geoToH3(37.79506683, 55.71290588, 15) as h3Index

نتیجه:

┌────────────h3Index─┐
│ 644325524701193974 │
└────────────────────┘

جعبه جواهر

بازگرداندن مجموعه ای از رشته های جغرافیایی کد گذاری شده از دقت داده شده است که در داخل و تقاطع مرزهای جعبه داده شده قرار می گیرند, اساسا یک شبکه 2د مسطح به مجموعه.

مقادیر ورودی

• طولی-دقیقه طول جغرافیایی, ارزش شناور در محدوده [-180°, 180°]
• عرضی-دقیقه عرض جغرافیایی, ارزش شناور در محدوده [-90°, 90°]
• طولی-حداکثر طول جغرافیایی, ارزش شناور در محدوده [-180°, 180°]
• عرضی-حداکثر عرض جغرافیایی, ارزش شناور در محدوده [-90°, 90°]
• دقت-جغرافیایی دقیق, UInt8 در محدوده [1, 12]

لطفا توجه داشته باشید که تمام پارامترهای هماهنگ باید از همان نوع باشد: هم Float32 یا Float64.

مقادیر بازگشتی

• مجموعه ای از رشته های دقت طولانی از زمینهاش جعبه پوشش منطقه فراهم, شما باید به ترتیب از اقلام تکیه نمی.

لطفا توجه داشته باشید که عملکرد یک استثنا را پرتاب می کند اگر مجموعه ای بیش از 10'000'000 باشد.

مثال

SELECT geohashesInBox(24.48, 40.56, 24.785, 40.81, 4) AS thasos

┌─thasos──────────────────────────────────────┐
│ ['sx1q','sx1r','sx32','sx1w','sx1x','sx38'] │
└─────────────────────────────────────────────┘

هد3گتاسکل

بازگرداندن تعداد سلول پایه از شاخص.

نحو

h3GetBaseCell(index)

پارامترها

• index — Hexagon index number. Type: UInt64.

مقادیر بازگشتی

• شش گوش شماره سلول پایه. نوع: UInt8.

مثال

پرسوجو:

SELECT h3GetBaseCell(612916788725809151) as basecell

نتیجه:

┌─basecell─┐
│       12 │
└──────────┘

ه3حکسرام2

میانگین منطقه شش گوش در متر مربع در وضوح داده شده.

نحو

h3HexAreaM2(resolution)

پارامترها

• resolution — Index resolution. Range: [0, 15]. نوع: UInt8.

مقادیر بازگشتی

• Area in m². Type: جسم شناور64.

مثال

پرسوجو:

SELECT h3HexAreaM2(13) as area

نتیجه:

┌─area─┐
│ 43.9 │
└──────┘

در حال بارگذاری

بازده یا نه فراهم هیندکس همسایه هستند.

نحو

h3IndexesAreNeighbors(index1, index2)

پارامترها

• index1 — Hexagon index number. Type: UInt64.
• index2 — Hexagon index number. Type: UInt64.

مقادیر بازگشتی

• بازگشت 1 اگر شاخص همسایه هستند, 0 وگرنه نوع: UInt8.

مثال

پرسوجو:

SELECT h3IndexesAreNeighbors(617420388351344639, 617420388352655359) AS n

نتیجه:

┌─n─┐
│ 1 │
└───┘

بچه گانه های 3

بازگرداندن مجموعه ای با شاخص کودک از شاخص داده.

نحو

h3ToChildren(index, resolution)

پارامترها

• index — Hexagon index number. Type: UInt64.
• resolution — Index resolution. Range: [0, 15]. نوع: UInt8.

مقادیر بازگشتی

• با شاخص های اچ 3 کودک تنظیم کنید. مجموعه ای از نوع: UInt64.

مثال

پرسوجو:

SELECT h3ToChildren(599405990164561919, 6) AS children

نتیجه:

┌─children───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [603909588852408319,603909588986626047,603909589120843775,603909589255061503,603909589389279231,603909589523496959,603909589657714687] │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

ساعت 3

بازگرداندن پدر و مادر (درشت) شاخص حاوی شاخص داده.

نحو

h3ToParent(index, resolution)

پارامترها

• index — Hexagon index number. Type: UInt64.
• resolution — Index resolution. Range: [0, 15]. نوع: UInt8.

مقادیر بازگشتی

• شاخص اچ 3 پدر و مادر. نوع: UInt64.

مثال

پرسوجو:

SELECT h3ToParent(599405990164561919, 3) as parent

نتیجه:

┌─────────────parent─┐
│ 590398848891879423 │
└────────────────────┘

اچ 3

تبدیل نمایندگی هیندکس از شاخص به نمایندگی رشته.

h3ToString(index)

پارامترها

• index — Hexagon index number. Type: UInt64.

مقادیر بازگشتی

• نمایندگی رشته از شاخص اچ 3. نوع: رشته.

مثال

پرسوجو:

SELECT h3ToString(617420388352917503) as h3_string

نتیجه:

┌─h3_string───────┐
│ 89184926cdbffff │
└─────────────────┘

استراینگتوه3

تبدیل رشته به نمایندگی H3Index (UInt64) نمایندگی.

stringToH3(index_str)

پارامترها

• index_str — String representation of the H3 index. Type: رشته.

مقادیر بازگشتی

• عدد شاخص شش گوش. بازده 0 در خطا. نوع: UInt64.

مثال

پرسوجو:

SELECT stringToH3('89184926cc3ffff') as index

نتیجه:

┌──────────────index─┐
│ 617420388351344639 │
└────────────────────┘

انتقال انرژی 3

بازگرداندن وضوح از شاخص.

نحو

h3GetResolution(index)

پارامترها

• index — Hexagon index number. Type: UInt64.

مقادیر بازگشتی

• وضوح صفحه اول. گستره: [0, 15]. نوع: UInt8.

مثال

پرسوجو:

SELECT h3GetResolution(617420388352917503) as res

نتیجه:

┌─res─┐
│   9 │
└─────┘

مقاله اصلی