.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDALLOCATIONINFO" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdallocationinfo \- ابزار پرس‌وجوی رستر.
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdallocationinfo [\-\-help] [\-\-long\-usage] [\-\-help\-general]
                        [\-xml] [\-lifonly] [\-valonly] [\-E] [\-field_sep <sep>]
                        [\-ignore_extra_input] [\-b <band>]...
                        [\-overview <overview_level>]
                        [\-r nearest|bilinear|cubic|cubicspline]
                        [[\-l_srs <srs_def>]|[\-geoloc]|[\-wgs84]]
                        [\-oo <NAME>=<VALUE>]...
                        <srcfile> <x> <y>
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار \fBgdallocationinfo\fP سازوکاری برای پرس‌وجوی اطلاعات یک پیکسل با توجه به موقعیت مکانی آن در یکی از دستگاه‌های مختصات گوناگون فراهم می‌کند. گزینه‌های متعددی برای گزارش‌دهی ارائه شده است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
معادل در رابط خط فرمان جدید \(dqgdal\(dq:
.sp
دستور \fI\%gdal raster pixel\-info\fP\& را ببینید.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help
نمایش این پیام راهنما و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
نمایش یک پیام کاربرد کوتاه برای گزینه‌های خط فرمان عمومی GDAL و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-xml
گزارش خروجی برای پردازش بعدی آسان، با فرمت XML قالب‌بندی می‌شود.
(\fI\%مثال ۲\fP).
.UNINDENT
.INDENT 0.0
.TP
.B \-lifonly
تنها خروجی، نام فایل‌های حاصل از درخواست LocationInfo در پایگاه داده خواهد بود (یعنی برای شناسایی فایل تحت تأثیر در VRT).
.UNINDENT
.INDENT 0.0
.TP
.B \-valonly
تنها خروجی، مقادیر پیکسل برای پیکسل انتخاب‌شده در هر یک از باندهای انتخاب‌شده خواهد بود. به‌طور پیش‌فرض، مقدار هر باند در یک خط جداگانه ارائه می‌شود، مگر اینکه \fI\%\-field_sep\fP مشخص شده باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-b <band>
انتخاب یک باند برای پرس‌وجو. چندین باند را می‌توان فهرست کرد. به‌طور پیش‌فرض تمام باندها پرس‌وجو می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-r {nearest|bilinear|cubic|cubicspline}
در نسخه 3.10 اضافه شد.

.sp
انتخاب یک الگوریتم نمونه‌برداری. مقدار پیش‌فرض \fBnearest\fP است.
.sp
روش‌های موجود عبارتند از:
.sp
\fBnearest\fP نزدیک‌ترین همسایه را اعمال می‌کند.
.sp
\fBbilinear\fP هسته پیچش دوخطی (bilinear) را اعمال می‌کند.
.sp
\fBcubic\fP هسته پیچش مکعبی (cubic) را اعمال می‌کند.
.sp
\fBcubicspline\fP هسته پیچش B\-Spline را اعمال می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-overview <overview_level>
پرس‌وجوی نمای کلی (overview) شماره (overview_level) (سطح overview_level=1 نخستین نمای کلی است)، به جای باند اصلی. توجه داشته باشید که موقعیت x,y (اگر دستگاه مختصات pixel/line باشد) همچنان باید نسبت به باند اصلی ارائه شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-l_srs <srs_def>
دستگاه مختصات موقعیت ورودی x, y.
.UNINDENT
.INDENT 0.0
.TP
.B \-geoloc
نشان می‌دهد نقاط ورودی x,y در دستگاه ارجاع مکانی تصویر هستند.
.UNINDENT
.INDENT 0.0
.TP
.B \-wgs84
نشان می‌دهد نقاط ورودی x,y بر حسب طول و عرض جغرافیایی WGS84 هستند.
.UNINDENT
.INDENT 0.0
.TP
.B \-oo <NAME>=<VALUE>
گزینه باز کردن مجموعه داده (مختص فرمت)
.UNINDENT
.INDENT 0.0
.TP
.B \-ignore_extra_input
در نسخه 3.9 اضافه شد.

.sp
تنظیم این پرچم به منظور جلوگیری از الحاق محتوای غیرعددی اضافی در انتهای خطوط ورودی به خطوط خروجی در حالت \-valonly (مستلزم تعریف \fI\%\-field_sep\fP نیز می‌باشد)، یا به عنوان یک فیلد اختصاصی در حالت‌های پیش‌فرض یا \fI\%\-xml\fP.
.UNINDENT
.INDENT 0.0
.TP
.B \-E
در نسخه 3.9 اضافه شد.

.sp
فعال کردن حالت بازتاب (Echo)، که در آن مختصات ورودی به ابتدای خطوط خروجی در حالت \fI\%\-valonly\fP افزوده می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-field_sep <sep>
در نسخه 3.9 اضافه شد.

.sp
تعریف جداکننده فیلد که در حالت \fI\%\-valonly\fP برای جداسازی مقادیر مختلف به کار می‌رود.
مقدار پیش‌فرض آن نویسه خط جدید است؛ بدین معنی که هنگام پرس‌وجوی یک رستر با چند باند، خروجی شامل یک مقدار در هر خط خواهد بود، که در صورت ارائه چندین نقطه ممکن است تشخیص این که کدام مقدار به کدام مجموعه نقاط ورودی x,y تعلق دارد را دشوار کند. تعریف جداکننده فیلد همچنین مورد نیاز است
.UNINDENT
.INDENT 0.0
.TP
.B <srcfile>
نام منبع داده رستر GDAL مبدأ.
.UNINDENT
.INDENT 0.0
.TP
.B <x>
موقعیت X پیکسل هدف. به‌طور پیش‌فرض دستگاه مختصات pixel/line است مگر این که \-l_srs، \-wgs84 یا \-geoloc ارائه شده باشد.
.UNINDENT
.INDENT 0.0
.TP
.B <y>
موقعیت Y پیکسل هدف. به‌طور پیش‌فرض دستگاه مختصات pixel/line است مگر این که \-l_srs، \-wgs84 یا \-geoloc ارائه شده باشد.
.UNINDENT
.sp
این ابزار به منظور ارائه اطلاعات متنوعی درباره یک پیکسل طراحی شده است. در حال حاضر موارد زیر را گزارش می‌دهد:
.INDENT 0.0
.IP \(bu 2
موقعیت مکانی پیکسل در فضای pixel/line (پیکسل/سطر).
.IP \(bu 2
نتیجه یک پرس‌وجوی فراداده‌ای LocationInfo روی منبع داده. این ویژگی برای فایل‌های VRT پیاده‌سازی شده است که فایل(های) مورد استفاده برای برآورده کردن درخواست‌ها برای آن پیکسل را گزارش می‌دهند، و همچنین توسط درایور \fI\%MBTiles\fP ارائه می‌شود.
.IP \(bu 2
مقدار رستر آن پیکسل برای همه یا زیرمجموعه‌ای از باندها.
.IP \(bu 2
مقدار مقیاس‌بندی‌نشده (unscaled) پیکسل در صورتی که یک Scale و/یا Offset روی باند اعمال شود.
.UNINDENT
.sp
پیکسل انتخاب‌شده از طریق مختصات x/y در خط فرمان درخواست می‌شود، یا از stdin خوانده می‌شود. هنگام خواندن مختصات از stdin می‌توان بیش از یک جفت مختصات را ارائه داد. به‌طور پیش‌فرض، مختصات صحیح pixel/line مورد انتظار است. با این حال، با استفاده از سوئیچ‌های \fI\%\-geoloc\fP، \fI\%\-wgs84\fP یا \fI\%\-l_srs\fP می‌توان موقعیت را در دستگاه‌های مختصات دیگر مشخص کرد.
.sp
گزارش پیش‌فرض در قالب متنی خوانا برای انسان است. در عوض، امکان درخواست خروجی xml با سوئیچ \-xml وجود دارد.
.sp
به منظور اسکریپت‌نویسی، سوئیچ‌های \-valonly و \-lifonly برای محدود کردن خروجی به مقادیر واقعی پیکسل، یا فایل‌های LocationInfo شناسایی‌شده برای پیکسل ارائه شده‌اند.
.sp
پیش‌بینی می‌شود که قابلیت‌های گزارش‌دهی بیشتری در آینده به gdallocationinfo اضافه شود.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: گزارش درباره پیکسل (256,256) روی فایل utm.tif
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdallocationinfo utm.tif 256 256
Report:
Location: (256P,256L)
Band 1:
    Value: 115
.EE
.UNINDENT
.UNINDENT
.SS مثال ۲: پرس‌وجوی یک فایل VRT با ارائه موقعیت در WGS84 و دریافت نتیجه در قالب XML
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdallocationinfo \-xml \-wgs84 utm.vrt \-117.5 33.75
<Report pixel=\(dq217\(dq line=\(dq282\(dq>
    <BandReport band=\(dq1\(dq>
        <LocationInfo>
        <File>utm.tif</File>
        </LocationInfo>
        <Value>16</Value>
    </BandReport>
</Report>
.EE
.UNINDENT
.UNINDENT
.SS مثال ۳: خواندن موقعیت‌ها از stdin
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ cat coordinates.txt
443020 3748359
441197 3749005
443852 3747743

$ cat coordinates.txt | gdallocationinfo \-geoloc utmsmall.tif
Report:
  Location: (38P,49L)
  Band 1:
    Value: 214
Report:
  Location: (7P,38L)
  Band 1:
    Value: 107
Report:
  Location: (52P,59L)
  Band 1:
    Value: 148

$ cat coordinates.txt | gdallocationinfo \-geoloc \-valonly \-E \-field_sep , utmsmall.tif
443020,3748359,214
441197,3749005,107
443852,3747743,148
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Frank Warmerdam <warmerdam@pobox.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.