‫بسته Geographic در Zync: مجموعهٔ مکانی الهام‌گرفته از PostGIS برای SQL Server

• GitHub: https://github.com/mirshahreza/Zync
• مسیر بستهٔ Geographic: MsSql/Packages/Geographic

• نام و معناشناسی توابع برای کاربران PostGIS آشنا باشد.
• کارهای رایج (ساخت هندسه، روابط مکانی، بافر، سنجش فاصله) ظاهر و احساسی مشابه داشته باشد.
• مهاجرت بین PostgreSQL/PostGIS و SQL Server برای تیم‌های چندسکویی آسان‌تر شود.

• نام‌گذاری ST_: همهٔ کمک‌تابع‌های مکانی با قرارداد ST_ و پیشوند محافظتی Zz ارائه می‌شوند؛ مثل ZzST_Buffer، ZzST_Contains، ZzST_DWithin.
• اولویت با geometry: توابع اصلی ST_* روی نوع geometry کار می‌کنند؛ در جاهایی که دقت ژئودتیک لازم است، توابع کمکیِ جداگانه با ورودی‌های عرض/طول جغرافیایی (lat/lon) و فرمول هاورساین استفاده می‌شوند.
• سازگار با WKT/WKB: سازنده‌ها و توابع I/O، WKT/WKB را می‌پذیرند/برمی‌گردانند تا تست و تبادل داده ساده باشد.
• SRID پیش‌فرض: اگر SRID صراحتاً تعیین نشود، مقدار پیش‌فرض 4326 (WGS 84) در نظر گرفته می‌شود.
• معناشناسی آشنا: نام‌ها و رفتارها آگاهانه با مرجع PostGIS همسو شده‌اند؛ تا جایی که امکانات مکانی SQL Server اجازه می‌دهد.

• سازنده‌های هندسه: ZzST_Point، ZzST_MakePoint، ZzST_MakeLine، ZzST_MakePolygon، ZzST_MakeEnvelope
• توابع ورودی/خروجی: ZzST_AsText، ZzST_AsBinary، ZzST_GeomFromText، ZzST_GeomFromWKB
• دسترسی‌دهنده‌ها: ZzST_X، ZzST_Y، ZzST_GeometryType، ZzST_SRID
• سنجش و گزاره‌ها: ZzST_Distance، ZzST_Length، ZzST_Area، ZzST_Perimeter، ZzST_Contains، ZzST_Within، ZzST_Intersects، ZzST_DWithin
• پردازش هندسی: ZzST_Buffer، ZzST_Centroid، ZzST_Envelope، ZzST_ConvexHull، ZzST_PointOnSurface
• عملیات مجموعه‌ای: ZzST_Union، ZzST_Intersection، ZzST_Difference، ZzST_SymDifference

• ZzIsPointInRadius، ZzGetPointsInRadius، ZzGetBoundingBox، ZzGetNearestPoint
• مبدل‌ها و قالب‌دهنده‌ها: ZzConvertDMSToDecimal، ZzConvertDecimalToDMS، ZzConvertDistance/Area/Speed

• ساخت نقطه و خط (شبیه PostGIS):

-- POINT(lon lat)
SELECT [dbo].[ZzST_AsText](
 [dbo].[ZzST_MakePoint](51.3890, 35.6892, NULL, NULL)
) AS WKT;

-- LINESTRING از دو نقطه
SELECT [dbo].[ZzST_AsText](
 [dbo].[ZzST_MakeLine]('51.3890,35.6892;51.4000,35.7000', 4326)
) AS WKT;

• روابط مکانی و گزاره‌ها:

-- پاکت (BBox) که یک نقطه را دربرگیرد
DECLARE @bbox geometry = [dbo].[ZzST_MakeEnvelope](51.3800, 35.6800, 51.4200, 35.7200, 4326);
DECLARE @pt geometry = [dbo].[ZzST_GeomFromText]('POINT(51.3890 35.6892)', 4326);
SELECT [dbo].[ZzST_Contains](@bbox, @pt) AS ContainsPoint; -- 1 = درست، 0 = نادرست

• فاصله و همسایگی:

-- آیا دو نقطه در شعاع 1000 متر از هم هستند؟
DECLARE @a geometry = [dbo].[ZzST_GeomFromText]('POINT(51.3890 35.6892)', 4326);
DECLARE @b geometry = [dbo].[ZzST_GeomFromText]('POINT(51.4000 35.7000)', 4326);
SELECT [dbo].[ZzST_DWithin](@a, @b, 1000.0) AS IsNearby;

• بافر کردن:

-- ایجاد بافر کوچک پیرامون یک نقطه (~واحد به SRID بستگی دارد)
DECLARE @pt geometry = [dbo].[ZzST_GeomFromText]('POINT(51.3890 35.6892)', 4326);
SELECT [dbo].[ZzST_AsText]([dbo].[ZzST_Buffer](@pt, 0.01)) AS Buffered;

• کمک‌تابع‌های «دوست‌دار اپلیکیشن» با ورودی lat/lon:

-- بررسی قرارگیری یک نقطه (lat/lon) درون شعاع مشخص (KM/MILE/M)
SELECT [dbo].[ZzIsPointInRadius](35.6892, 51.3890, 35.7000, 51.4000, 10, 'KM') AS InRadius;

-- یافتن نقاط درون یک شعاع پیرامون مرکز (Schema نمونه فرضی)
-- SELECT * FROM [dbo].[ZzGetPointsInRadius](
-- @centerLat, @centerLon, @radiusValue, @radiusUnit, @YourPointsTable
-- );

• نام‌گذاری ST_* با پیشوند Zz حفظ شده است: مثلاً ST_Buffer در PostGIS ≈ ZzST_Buffer در این بسته.
• ورودی‌های WKT/WKB از طریق ZzST_GeomFromText و ZzST_GeomFromWKB پشتیبانی می‌شوند.
• مدیریت SRID با ZzST_SRID و ZzST_SetSRID (بدون Transform) انجام می‌شود.
• معادل‌های SQL Server (درونی) ممکن است نام متفاوتی داشته باشند (مثل STBuffer، STDistance)، اما Wrapperها ارگونومی مشابه PostGIS ارائه می‌دهند.

• هنگام ترکیب داده از منابع گوناگون، SRID را صریح تعیین کنید.
• geography در برابر geometry: برای محاسبات ژئودتیک مسافت‌های بلند از geography استفاده کنید؛ برای عملیات صفحه‌ای و اکثر گزاره‌ها geometry کفایت می‌کند.
• تولرانس و واحد: شعاع بافر و فاصله‌ها به سیستم مختصات وابسته‌اند—SRIDهای همسان (مثل WGS 84 برای GPS) را ترجیح دهید.

-- نصب کل بستهٔ Geographic
EXEC [dbo].[Zync] 'i Geographic';

-- یا فقط نصب توابع مکانی
EXEC [dbo].[Zync] 'i Geographic/ZzST_*.sql';

• مخزن Zync: https://github.com/mirshahreza/Zync
• مستندات PostGIS: https://postgis.net/docs/
• انواع مکانی در SQL Server: geometry و geography