NOMINATIM(1) Generated Python Manual NOMINATIM(1)

nominatim - ابزارهای خط فرمان برای وارد کردن، به‌روزرسانی، مدیریت و پرس‌وجو در پایگاه‌داده Nominatim

nominatim [-h] [--version] {import,freeze,replication,special-phrases,add-data,index,refresh,admin,export,convert,serve,search,reverse,lookup,details,status} ...

ابزارهای خط فرمان برای وارد کردن، به‌روزرسانی، مدیریت و پرس‌وجو در پایگاه‌داده Nominatim.

مقدار 'cli_args' فهرستی از پارامترها برای دستور در حال اجرا است. اگر مشخص نشود، از sys.args استفاده خواهد شد.

مقدار 'environ' دیکشنری متغیرهای محیطی شامل پیکربندی Nominatim است. هنگامی که مقدار آن None باشد، os.environ به ارث برده می‌شود.

نسخه Nominatim را چاپ کرده و خارج می‌شود

ایجاد یک پایگاه‌داده جدید Nominatim از یک فایل OSM.
فقط‌خواندنی کردن پایگاه‌داده.
به‌روزرسانی پایگاه‌داده با استفاده از یک سرویس همانندسازی (replication) برخط.
وارد کردن عبارت‌های ویژه (special phrases).
افزودن داده‌های بیشتر از یک فایل یا یک منبع برخط.
نمایه‌سازی مجدد تمام داده‌های جدید و تغییر‌یافته.
محاسبه مجدد داده‌های کمکیِ استفاده‌شده توسط فرآیند نمایه‌سازی.
تحلیل و نگهداری پایگاه‌داده.
برون‌بری مکان‌ها از پایگاه‌داده در قالب فایل CSV.
تبدیل یک پایگاه‌داده موجود به قالبی دیگر. (آزمایشی)
راه‌اندازی یک وب‌سرور ساده برای ارائه API.
اجرای یک پرس‌وجوی جستجو.
اجرای پرس‌وجوی معکوس (reverse) در API.
اجرای پرس‌وجوی جستجوی مستقیم (lookup) در API.
اجرای پرس‌وجوی جزئیات (details) در API.

کاربرد: nominatim import [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--osm-file FILE]
[--continue {import-from-file,load-data,indexing,db-postprocess}]
[--osm2pgsql-cache SIZE] [--reverse-only]
[--no-partitions] [--no-updates] [--offline]
[--ignore-errors] [--index-noanalyse]
[--prepare-database]

ایجاد یک پایگاه‌داده جدید Nominatim از یک فایل OSM.

این زیردستور یک پایگاه‌داده جدید Nominatim را از پایه با ایجاد یک پایگاه‌داده جدید در Postgresql راه‌اندازی می‌کند. کاربری که این دستور را اجرا می‌کند به دسترسی‌های مدیر ارشد (superuser) در پایگاه‌داده نیاز دارد.

فقط پیام‌های خطا را چاپ می‌کند
افزایش پرگویی خروجی (اطلاعات دقیق‌تر)
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد رشته‌های (threads) پردازشی موازی مورد استفاده

فایل OSM برای واردسازی (برای وارد کردن چند فایل تکرار شود)
ادامه فرآیند واردسازی که متوقف شده بود

اندازه حافظه موقت (cache) مورد استفاده توسط osm2pgsql (به مگابایت)
جدول‌ها و نمایه‌ها برای جستجو ایجاد نشوند
عدم پارتیشن‌بندی نمایه‌های جستجو (سرعت واردسازی قطعه‌های مربوط به یک کشور منفرد را افزایش می‌دهد)
جدول‌هایی که فقط برای به‌روزرسانی پایگاه‌داده در آینده نیاز هستند، نگهداری نشوند
هیچ تلاشی برای بارگیری داده‌های اضافی از اینترنت انجام نمی‌دهد.SH گزینه‌های تخصصی 'nominatim import'
ادامه فرآیند واردسازی حتی در صورت وجود خطا در SQL
عدم اجرای عملیات analyse در حین ایندکس‌گذاری (فقط کاربران حرفه‌ای)
ایجاد پایگاه‌داده بدون وارد کردن داده‌ها

کاربرد: nominatim freeze [-h] [-q] [-v] [--project-dir DIR] [-j NUM]

فقط‌خواندنی کردن پایگاه‌داده.

حدود نیمی از داده‌ها در پایگاه‌داده Nominatim صرفاً برای به‌روز نگه‌داشتن داده‌ها با تغییرات جدید اعمال‌شده در OpenStreetMap نگهداری می‌شوند. این دستور تمام این داده‌ها را حذف (drop) کرده و تنها بخشی را که برای خود فرآیند تبدیل نشانی به مختصات (geocoding) لازم است نگه می‌دارد.

این دستور همان تأثیر گزینه `--no-updates` را در هنگام واردسازی دارد.

تنها چاپ پیام‌های خطا
افزایش جزئیات خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد رشته‌های (threads) موازی مورد استفاده

کاربرد: nominatim replication [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--init] [--no-update-functions]
[--check-for-updates] [--once] [--catch-up]
[--no-index] [--osm2pgsql-cache SIZE]
[--socket-timeout SOCKET_TIMEOUT]

به‌روزرسانی پایگاه‌داده با استفاده از یک سرویس رونوشت‌برداری (replication) برخط.

سرویس replication در OSM یک سرویس برخط است که به‌روزرسانی‌های منظمی (فایل‌های diff مربوط به OSM) را برای کل سیاره یا بخش ارائه‌شده فراهم می‌کند. بنیاد OSMF سرویس اصلی replication برای کل سیاره را در https://planet.osm.org/replication ارائه می‌دهد، اما ارائه‌دهندگان دیگری از برش‌های داده‌های OSM نیز وجود دارند که چنین سرویسی را ارائه می‌کنند.

این زیردستور امکان راه‌اندازی چنین سرویس رونوشت‌برداری و دانلود و واردسازی به‌روزرسانی‌ها در فواصل زمانی منظم را فراهم می‌کند. لازم است '--init' را یک‌بار برای راه‌اندازی فرآیند یا هر زمان که پارامترهای پیکربندی replication را تغییر می‌دهید، فراخوانی کنید. بدون هیچ آرگومانی، این زیردستور وارد یک حلقه شده و به‌طور مداوم به‌روزرسانی‌ها را به محض در دسترس قرار گرفتن اعمال می‌کند. مشخص کردن `--once` فقط دسته بعدی به‌روزرسانی‌ها را بارگیری و اعمال می‌کند.

تنها چاپ پیام‌های خطا
افزایش جزئیات خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد رشته‌های (threads) موازی مورد استفاده

مقداردهی اولیه فرآیند به‌روزرسانی
عدم به‌روزرسانی تابع تریگر (trigger function) برای پشتیبانی از به‌روزرسانی‌های تفاضلی (کاربران حرفه‌ای)

بررسی وجود به‌روزرسانی‌های جدید و خروج
دانلود و اعمال به‌روزرسانی‌ها تنها برای یک‌بار. در صورت عدم تنظیم، به‌روزرسانی‌ها به‌طور پیوسته اعمال می‌شوند
دانلود و اعمال به‌روزرسانی‌ها تا زمانی که داده جدیدی روی سرور در دسترس نباشد
عدم ایندکس‌گذاری داده‌های جدید. فقط همراه با --once قابل استفاده است
اندازه حافظه موقت (cache) مورد استفاده توسط osm2pgsql (به مگابایت)

تنظیم مهلت زمانی (timeout) برای دانلود فایل‌ها

کاربرد: nominatim special-phrases [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--import-from-wiki] [--import-from-csv FILE]
[--no-replace] [--min MIN]

وارد کردن عبارت‌های ویژه.

عبارت‌های ویژه اصطلاحات جستجویی هستند که نوع شیء مورد جستجو را محدود و مشخص می‌کنند. برای مثال، ممکن است بخواهید عبارت 'Hotels in Barcelona' را جستجو کنید. ویکی OSM مجموعه‌ای از عبارت‌های ویژه را به زبان‌های گوناگون دارد که می‌توان با این دستور آن‌ها را وارد کرد.

شما همچنین می‌توانید عبارت‌های خود را در یک فایل CSV ارائه دهید. این فایل باید شامل پنج ستون زیر باشد:
* phrase - عبارت مورد انتظار برای جستجو
* class - کلید برچسب OSM مربوط به نوع شیء
* type - مقدار برچسب OSM مربوط به نوع شیء
* operator - نوع جستجویی که باید انجام شود (یکی از: in، near، name، -)
* plural - این‌که آیا اصطلاح جمع است یا خیر (Y/N)

یک فایل نمونه را می‌توان در سورس‌کد Nominatim در مسیر

فرآیند واردسازی را می‌توان طوری پیکربندی کرد که جفت‌های کلید/مقدار خاصی را نادیده بگیرد. این قابلیت به‌ویژه هنگام وارد کردن عبارت‌ها از ویکی بسیار مفید است. پیکربندی پیش‌فرض برخی برچسب‌های بسیار رایج مانند building=yes را مستثنی می‌کند. این پیکربندی را می‌توان با قرار دادن فایل `phrase-settings.json` با قواعد سفارشی در دایرکتوری پروژه یا با استفاده از گزینه `--config` برای اشاره به یک فایل پیکربندی دیگر، سفارشی‌سازی کرد..SH "آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS)" 'nominatim special-phrases'

تنها چاپ پیام‌های خطا
افزایش جزئیات خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد رشته‌های موازی مورد استفاده

وارد کردن عبارت‌های ویژه از ویکی OSM به پایگاه داده
وارد کردن عبارت‌های ویژه از یک فایل CSV
نگه‌داشتن عبارت‌های قدیمی و تنها افزودن موارد جدید
محدود کردن عبارت‌های ویژه بر اساس حداقل دفعات تکرار

کاربرد: nominatim add-data [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
(--file FILE | --diff FILE | --node ID | --way ID |
--relation ID | --tiger-data DIR) [--use-main-api]
[--osm2pgsql-cache SIZE]
[--socket-timeout SOCKET_TIMEOUT]

افزودن داده‌های اضافی از یک فایل یا یک منبع برخط.

این دستور امکان افزودن یا به‌روزرسانی داده‌های جستجو در پایگاه داده را فراهم می‌کند. داده‌ها می‌توانند از یک فایل OSM بیایند یا اشیای منفرد OSM می‌توانند مستقیماً از OSM API بارگیری شوند. این عملکرد تنها داده‌ها را در پایگاه داده بارگذاری می‌کند. پس از آن، داده‌ها همچنان باید در نمایه جستجو ادغام شوند. برای این کار از دستور `nominatim index` استفاده کنید.

این دستور همچنین می‌تواند برای افزودن داده‌های خارجی غیر OSM به پایگاه داده استفاده شود. در حال حاضر تنها قالب پشتیبانی‌شده، داده‌های شماره پلاک TIGER است. برای اطلاعات بیشتر، مستندات برخط را در https://nominatim.org/release-docs/latest/customize/Tiger ببینید.

تنها چاپ پیام‌های خطا
افزایش جزئیات خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد رشته‌های موازی مورد استفاده

وارد کردن داده‌ها از یک فایل OSM یا یک فایل diff
وارد کردن داده‌ها از یک فایل diff مربوط به OSM (منسوخ‌شده: از --file استفاده کنید)
وارد کردن یک گره تکی از API
وارد کردن یک راه تکی از API
وارد کردن یک رابطه تکی از API
افزودن شماره پلاک‌ها از پایگاه داده سرشماری TIGER ایالات متحده

استفاده از OSM API به‌جای Overpass برای بارگیری اشیاء
اندازه حافظه نهان (کَش) برای استفاده توسط osm2pgsql (به مگابایت)
تنظیم مهلت زمانی برای بارگیری فایل‌ها

کاربرد: nominatim index [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--boundaries-only] [--no-boundaries] [--minrank RANK]
[--maxrank RANK]

نمایه‌سازی مجدد تمام داده‌های جدید و تغییر‌یافته.

نمایه‌سازی فرایند محاسبه نشانی و عبارت‌های جستجو برای مکان‌های موجود در پایگاه داده است. هر بار که داده‌ای افزوده یا تغییر داده می‌شود، نمایه‌سازی باید اجرا گردد. فرایندهای واردسازی و به‌روزرسانی‌های همگام‌سازی به‌طور خودکار نمایه‌سازی را انجام می‌دهند. برای سایر موارد، این عملکرد امکان اجرای دستی نمایه‌سازی را فراهم می‌کند..SH "آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS)" 'nominatim index'

فقط پیام‌های خطا چاپ شوند
افزایش جزئیات خروجی
دایرکتوری پایه‌ی نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد رشته‌های موازی مورد استفاده

فقط مرزهای اداری نمایه‌سازی شوند.
نمایه‌سازی همه‌چیز به‌جز مرزهای اداری.
حداقل/رتبهٔ آغازین
حداکثر/رتبهٔ پایانی

کاربرد: nominatim refresh [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--postcodes] [--word-tokens] [--word-counts]
[--address-levels] [--functions] [--wiki-data]
[--secondary-importance] [--importance] [--ro-access]
[--website] [--data-object OBJECT]
[--data-area OBJECT] [--no-diff-updates]
[--enable-debug-statements] [--force-reimport]

محاسبهٔ مجدد داده‌های کمکی استفاده‌شده در فرآیند نمایه‌سازی.

این زیردستور، داده‌ها و توابع ایستای گوناگون را در پایگاه‌داده به‌روزرسانی می‌کند. این دستور معمولاً پس از تغییر جنبه‌های مختلف پیکربندی باید اجرا شود. مستندات پیکربندی، دستور دقیقی را که باید در چنین حالتی استفاده شود ذکر خواهند کرد.

هشدار: دستور 'update' نباید به‌صورت هم‌زمان با سایر دستورهای به‌روزرسانی مانند 'replication' یا 'add-data' اجرا شود.

فقط پیام‌های خطا چاپ شوند
افزایش جزئیات خروجی
دایرکتوری پایه‌ی نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد رشته‌های موازی مورد استفاده

به‌روزرسانی جدول مرکز ثقل (centroid) کدهای پستی
پاک‌سازی عبارت‌های جستجو
محاسبهٔ بسامد عبارت‌های جستجوی تمام‌کلمه (full-word)
وارد کردن مجدد پیکربندی سطوح نشانی
به‌روزرسانی توابع PL/pgSQL در پایگاه‌داده
به‌روزرسانی مقادیر اهمیت Wikipedia/data
به‌روزرسانی داده‌های رَستری اهمیت ثانویه
محاسبهٔ مجدد اهمیت مکان‌ها (سنگین و زمان‌بر!)
اعطای دسترسی فقط‌خواندنی به کاربر وب برای تمام جدول‌ها
منسوخ شده است (DEPRECATED). این گزینه دیگر هیچ کاربردی ندارد و در نسخه‌های آینده حذف خواهد شد.
علامت‌گذاری شیء OSM مشخص‌شده به‌عنوان نیازمند به‌روزرسانی (قالب: [NWR]<id>)
علامت‌گذاری ناحیهٔ پیرامون شیء OSM مشخص‌شده به‌عنوان نیازمند به‌روزرسانی (قالب: [NWR]<id>)

عدم فعال‌سازی کد انتشار به‌روزرسانی‌ها
فعال‌سازی عبارت‌های هشدار اشکال‌زدایی در توابع.SH آرگومان‌های تازه‌سازی کد پستی 'nominatim refresh'
محاسبه مجدد کدهای پستی از ابتدا به جای به‌روزرسانی

کاربرد: nominatim admin [-h] [-q] [-v] [--project-dir DIR] [-j NUM] (--warm |
--check-database | --migrate | --analyse-indexing |
--collect-os-info | --clean-deleted AGE)
[--search-only] [--reverse-only] [--osm-id OSM_ID |
--place-id PLACE_ID]

تحلیل و نگهداری پایگاه داده.

تنها چاپ پیام‌های خطا
افزایش پرگویی خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد رشته‌های موازی مورد استفاده

گرم‌کردن کَش‌های پایگاه داده برای پرس‌وجوهای جستجو و معکوس
بررسی کامل و عملیاتی بودن پایگاه داده
مهاجرت پایگاه داده به یک نسخه جدید نرم‌افزار
چاپ تحلیل کارایی فرایند نمایه‌سازی
تولید گزارش درباره اطلاعات سیستم میزبان
پاک‌سازی رابطه‌های حذف‌شده

پیش‌گرم‌کردن جدول‌ها تنها برای پرس‌وجوهای جستجو
پیش‌گرم‌کردن جدول‌ها تنها برای پرس‌وجوهای معکوس

تحلیل نمایه‌سازی شیء OSM داده‌شده
تحلیل نمایه‌سازی شیء Nominatim داده‌شده

کاربرد: nominatim export [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--output-type {country,state,county,city,suburb,street,path}]
[--output-format OUTPUT_FORMAT] [--language LANGUAGE]
[--restrict-to-country COUNTRY_CODE]
[--restrict-to-osm-node ID] [--restrict-to-osm-way ID]
[--restrict-to-osm-relation ID]

برون‌ریزی مکان‌ها از پایگاه داده به صورت فایل CSV.

تنها چاپ پیام‌های خطا
افزایش پرگویی خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد رشته‌های موازی مورد استفاده

نوع مکان‌ها برای خروجی (پیش‌فرض: street)
فهرستی از انواع نشانی جداشده با نقطه‌ویرگول (ببینید: --output-type). علاوه بر این پذیرفته می‌شود: placeid,postcode
زبان ترجیحی برای خروجی (در صورت تعیین نشدن، از نام محلی استفاده می‌شود)

تنها برون‌ریزی اشیای داخل کشور
تنها برون‌ریزی فرزندان این گره OSM
تنها برون‌ریزی فرزندان این راه OSM
تنها برون‌ریزی فرزندان این رابطه OSM.SH "دستور (COMMAND)" 'nominatim convert' کاربرد: nominatim convert [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--format {sqlite}] --output OUTPUT [--with-reverse]
[--with-search] [--with-details]

تبدیل یک پایگاه‌داده موجود به قالبی دیگر. (آزمایشی)

تخلیه یک نسخه فقط‌خواندنی از پایگاه‌داده در قالبی متفاوت. در حال حاضر تنها یک پایگاه‌داده SQLite مناسب برای جستجوی معکوس (reverse lookup) می‌تواند ایجاد شود.

قالب پایگاه‌داده خروجی (در حال حاضر باید sqlite باشد)
فایلی که پایگاه‌داده در آن نوشته می‌شود.

تنها چاپ پیام‌های خطا
افزایش جزئیات خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد رشته‌های موازی مورد استفاده

فعال/غیرفعال کردن پشتیبانی از APIهای reverse و lookup (پیش‌فرض: فعال)
فعال/غیرفعال کردن پشتیبانی از APIی search (پیش‌فرض: غیرفعال)
فعال/غیرفعال کردن پشتیبانی از APIی details (پیش‌فرض: فعال)

کاربرد: nominatim serve [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--server SERVER] [--engine {falcon,starlette}]

راه‌اندازی یک وب‌سرور ساده برای ارائه API.

این دستور یک وب‌سرور توکار را برای ارائه وب‌سایت از دایرکتوری جاری پروژه راه‌اندازی می‌کند. این وب‌سرور تنها برای آزمایش و توسعه مناسب است. از آن در محیط‌های عملیاتی استفاده نکنید!

دو پیاده‌سازی مختلف وب‌سرور برای Python موجود است: falcon (پیش‌فرض) و starlette. برای استفاده از این قابلیت، باید مطمئن شوید که بسته‌های مناسب Python و همچنین بسته uvicorn نصب شده باشند.

به‌طور پیش‌فرض، وب‌سرور در این نشانی قابل دسترسی است: http://127.0.0.1:8088

تنها چاپ پیام‌های خطا
افزایش جزئیات خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد رشته‌های موازی مورد استفاده

نشانی‌ای که سرور روی آن گوش فرا می‌دهد.
فریم‌ورک وب‌سرور برای اجرا. (پیش‌فرض: falcon)

کاربرد: nominatim search [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--query QUERY] [--amenity AMENITY] [--street STREET]
[--city CITY] [--county COUNTY] [--state STATE]
[--country COUNTRY] [--postalcode POSTALCODE]
[--format FORMAT] [--addressdetails] [--extratags]
[--entrances] [--namedetails] [--lang LANGS]
[--polygon-output {geojson,kml,svg,text}]
[--polygon-threshold TOLERANCE] [--countrycodes CC,..]
[--exclude_place_ids ID,..] [--limit LIMIT]
[--viewbox X1,Y1,X2,Y2] [--bounded] [--layer LAYER]
[--no-dedupe] [--list-formats]

اجرای یک پرس‌وجوی جستجو.

این دستور دقیقاً مانند فراخوانی نقطه پایانی /search در وب API کار می‌کند. برای جزئیات بیشتر در مورد پارامترهای گوناگون، به مستندات برخط مراجعه کنید: https://nominatim.org/release-docs/latest/api/Search

تنها چاپ پیام‌های خطا
افزایش جزئیات خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد رشته‌های موازی مورد استفاده.SH "آرگومان‌های پرس‌وجو (QUERY ARGUMENTS)" 'nominatim search'
رشته پرس‌وجوی آزاد
پرس‌وجوی ساختاریافته: نام و/یا نوع POI
پرس‌وجوی ساختاریافته: پلاک و خیابان
پرس‌وجوی ساختاریافته: شهر، شهرک یا روستا
پرس‌وجوی ساختاریافته: شهرستان
پرس‌وجوی ساختاریافته: استان یا ایالت
پرس‌وجوی ساختاریافته: کشور
پرس‌وجوی ساختاریافته: کد پستی

قالب نتیجه (برای مشاهده قالب‌های پشتیبانی‌شده از --list-format استفاده کنید)
گنجاندن تفکیک نشانی به اجزای تشکیل‌دهنده
گنجاندن اطلاعات تکمیلی در صورت موجود بودن (مانند پیوند ویکی‌پدیا، ساعات کاری)
گنجاندن فهرستی از گره‌های ورودی برچسب‌گذاری‌شده
گنجاندن فهرستی از نام‌های جایگزین
ترتیب زبان‌های ترجیحی برای نمایش نتایج جستجو
خروجی دادن هندسه نتایج به عنوان GeoJSON، KML، SVG یا WKT
ساده‌سازی هندسه خروجی. این پارامتر میزان تلورانس اختلاف بر حسب درجه است.

محدود کردن نتایج جستجو به یک یا چند کشور
فهرست شناسه‌های اشیای جستجو که باید مستثنی شوند
محدود کردن تعداد نتایج بازگردانده‌شده
محدوده جغرافیایی ترجیحی برای یافتن نتایج جستجو
محدود کردن دقیق و قطعی نتایج به محدوده viewbox
محدود کردن نتایج به یک یا چند لایه (می‌تواند تکرار شود)
عدم حذف موارد تکراری از فهرست نتایج

فهرست کردن قالب‌های خروجی پشتیبانی‌شده و خروج.

کاربرد: nominatim reverse [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--lat LAT] [--lon LON] [--zoom ZOOM] [--layer LAYER]
[--format FORMAT] [--addressdetails] [--extratags]
[--entrances] [--namedetails] [--lang LANGS]
[--polygon-output {geojson,kml,svg,text}]
[--polygon-threshold TOLERANCE] [--list-formats]

اجرای پرس‌وجوی معکوس API.

این دستور دقیقاً مشابه با فراخوانی پایانه /reverse در وب API عمل می‌کند. برای جزئیات بیشتر درباره پارامترهای گوناگون، مستندات برخط را ببینید: https://nominatim.org/release-docs/latest/api/Reverse

تنها چاپ پیام‌های خطا
افزایش جزئیات خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد نخ‌های موازی برای استفاده.SH "آرگومان‌های پرس‌وجو (QUERY ARGUMENTS)" 'nominatim reverse'
عرض جغرافیایی مختصات برای جست‌وجو (در سامانه WGS84)
طول جغرافیایی مختصات برای جست‌وجو (در سامانه WGS84)
سطح جزئیات مورد نیاز برای نشانی
محدود کردن نتایج به یک یا چند لایه (می‌تواند تکرار شود)

قالب نتیجه (برای مشاهده قالب‌های پشتیبانی‌شده از --list-format استفاده کنید)
گنجاندن تفکیک نشانی به اجزای تشکیل‌دهنده
شامل کردن اطلاعات اضافی در صورت موجود بودن (مانند پیوند ویکی‌پدیا، ساعات کاری)
شامل کردن فهرستی از گره‌های ورودی برچسب‌گذاری‌شده
شامل کردن فهرستی از نام‌های جایگزین
ترتیب زبان‌های ترجیحی برای نمایش نتایج جست‌وجو
خروجی هندسه نتایج در قالب GeoJSON، KML، SVG یا WKT
ساده‌سازی هندسه خروجی. این پارامتر، میزان رواداری اختلاف بر حسب درجه است.

نمایش فهرست قالب‌های خروجی پشتیبانی‌شده و خروج.

کاربرد: nominatim lookup [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--id OSMID] [--format FORMAT] [--addressdetails]
[--extratags] [--entrances] [--namedetails]
[--lang LANGS]
[--polygon-output {geojson,kml,svg,text}]
[--polygon-threshold TOLERANCE] [--list-formats]

اجرای پرس‌وجوی جست‌وجو (lookup) در API.

این دستور دقیقاً مانند فراخوانی نقطه پایانی /lookup در وب API عمل می‌کند. برای جزئیات بیشتر درباره پارامترهای مختلف، مستندات برخط را ببینید: https://nominatim.org/release-docs/latest/api/Lookup

تنها چاپ پیام‌های خطا
افزایش پرگویی (میزان جزئیات) خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد ریسمان‌های موازی مورد استفاده

شناسه OSM برای جست‌وجو با قالب <NRW><id> (می‌تواند تکرار شود)

قالب نتیجه (برای مشاهده قالب‌های پشتیبانی‌شده از --list-format استفاده کنید)
گنجاندن تفکیک نشانی به اجزای تشکیل‌دهنده
شامل کردن اطلاعات اضافی در صورت موجود بودن (مانند پیوند ویکی‌پدیا، ساعات کاری)
شامل کردن فهرستی از گره‌های ورودی برچسب‌گذاری‌شده
شامل کردن فهرستی از نام‌های جایگزین
ترتیب زبان‌های ترجیحی برای نمایش نتایج جست‌وجو
خروجی هندسه نتایج در قالب GeoJSON، KML، SVG یا WKT
ساده‌سازی هندسه خروجی. این پارامتر، میزان رواداری اختلاف بر حسب درجه است..SH "گزینه‌های دیگر (OTHER OPTIONS)" 'nominatim lookup'
فهرست کردن قالب‌های خروجی پشتیبانی‌شده و خروج.

usage: nominatim details [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--node NODE] [--way WAY] [--relation RELATION]
[--place_id PLACE_ID] [--class OBJECT_CLASS]
[--format FORMAT] [--addressdetails] [--keywords]
[--linkedplaces] [--entrances] [--hierarchy]
[--group_hierarchy] [--polygon_geojson]
[--lang LANGS] [--list-formats]

اجرای پرس‌وجوی جزئیات API.

این دستور دقیقاً به همان صورتِ فراخوانی نقطه پایانی /details در API وب عمل می‌کند. برای جزئیات بیشتر درباره پارامترهای گوناگون، مستندات برخط را ببینید: https://nominatim.org/release-docs/latest/api/Details

تنها چاپ پیام‌های خطا
افزایش پرگویی خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد نخ‌های موازی برای استفاده

جستجوی گره OSM با شناسه داده‌شده.
جستجوی راه OSM با شناسه داده‌شده.
جستجوی رابطه OSM با شناسه داده‌شده.
شناسه داخلی پایگاه‌داده برای شیء OSM جهت جستجو
نوع کلاس برای ابهام‌زدایی از چند مدخل مربوط به یک شیء یکسان.

قالب نتیجه (برای مشاهده قالب‌های پشتیبانی‌شده از --list-formats استفاده کنید)
شامل تفکیک نشانی به بخش‌های تشکیل‌دهنده آن
شامل فهرستی از کلیدواژه‌های نام و کلیدواژه‌های نشانی
شامل جزئیات مکان‌هایی که به این مکان پیوند دارند
شامل فهرستی از گره‌های ورودی برچسب‌گذاری‌شده
شامل جزئیات مکان‌های پایین‌تر در سلسله‌مراتب نشانی
گروه‌بندی مکان‌ها بر پایه نوع
شامل هندسه نتیجه
ترتیب ترجیحی زبان برای نمایش نتایج جستجو

فهرست کردن قالب‌های خروجی پشتیبانی‌شده و خروج.

usage: nominatim status [-h] [-q] [-v] [--project-dir DIR] [-j NUM]
[--format FORMAT] [--list-formats]

اجرای پرس‌وجوی وضعیت API.

این دستور دقیقاً به همان صورتِ فراخوانی نقطه پایانی /status در API وب عمل می‌کند. برای جزئیات بیشتر درباره پارامترهای گوناگون، مستندات برخط را ببینید: https://nominatim.org/release-docs/latest/api/Status

تنها چاپ پیام‌های خطا
افزایش پرگویی خروجی
دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/)
تعداد نخ‌های موازی برای استفاده.SH "پارامترهای API (API PARAMETERS)" 'nominatim status'
قالب نتیجه (برای مشاهدهٔ قالب‌های پشتیبانی‌شده از --list-formats استفاده کنید)

فهرست کردن قالب‌های خروجی پشتیبانی‌شده و خروج. 

جامعه توسعه‌دهندگان Nominatim
info@nominatim.org

آخرین نسخهٔ Nominatim را می‌توان از نشانی زیر بارگیری کرد: https://nominatim.org

2026-04-19 Nominatim