NOMINATIM(1) Generated Python Manual NOMINATIM(1) نام (NAME) nominatim - ابزارهای خط فرمان برای وارد کردن، به‌روزرسانی، مدیریت و پرس‌وجو در پایگاه‌داده Nominatim خلاصه دستور (SYNOPSIS) nominatim [-h] [--version] {import,freeze,replication,special- phrases,add- data,index,refresh,admin,export,convert,serve,search,reverse,lookup,details,status} ... توضیحات (DESCRIPTION) ابزارهای خط فرمان برای وارد کردن، به‌روزرسانی، مدیریت و پرس‌وجو در پایگاه‌داده Nominatim. مقدار 'cli_args' فهرستی از پارامترها برای دستور در حال اجرا است. اگر مشخص نشود، از sys.args استفاده خواهد شد. مقدار 'environ' دیکشنری متغیرهای محیطی شامل پیکربندی Nominatim است. هنگامی که مقدار آن None باشد، os.environ به ارث برده می‌شود. گزینه‌ها (OPTIONS) --version نسخه Nominatim را چاپ کرده و خارج می‌شود دستورهای موجود (AVAILABLE COMMANDS) nominatim import ایجاد یک پایگاه‌داده جدید Nominatim از یک فایل OSM. nominatim freeze فقط‌خواندنی کردن پایگاه‌داده. nominatim replication به‌روزرسانی پایگاه‌داده با استفاده از یک سرویس همانندسازی (replication) برخط. nominatim special-phrases وارد کردن عبارت‌های ویژه (special phrases). nominatim add-data افزودن داده‌های بیشتر از یک فایل یا یک منبع برخط. nominatim index نمایه‌سازی مجدد تمام داده‌های جدید و تغییر‌یافته. nominatim refresh محاسبه مجدد داده‌های کمکیِ استفاده‌شده توسط فرآیند نمایه‌سازی. nominatim admin تحلیل و نگهداری پایگاه‌داده. nominatim export برون‌بری مکان‌ها از پایگاه‌داده در قالب فایل CSV. nominatim convert تبدیل یک پایگاه‌داده موجود به قالبی دیگر. (آزمایشی) nominatim serve راه‌اندازی یک وب‌سرور ساده برای ارائه API. nominatim search اجرای یک پرس‌وجوی جستجو. nominatim reverse اجرای پرس‌وجوی معکوس (reverse) در API. nominatim lookup اجرای پرس‌وجوی جستجوی مستقیم (lookup) در API. nominatim details اجرای پرس‌وجوی جزئیات (details) در API. nominatim status دستور (COMMAND) 'nominatim import' کاربرد: 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) در پایگاه‌داده نیاز دارد. آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS) 'nominatim import' -q, --quiet فقط پیام‌های خطا را چاپ می‌کند -v, --verbose افزایش پرگویی خروجی (اطلاعات دقیق‌تر) --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد رشته‌های (threads) پردازشی موازی مورد استفاده آرگومان‌های الزامی (REQUIRED ARGUMENTS) 'nominatim import' --osm-file FILE فایل OSM برای واردسازی (برای وارد کردن چند فایل تکرار شود) --continue {import-from-file,load-data,indexing,db-postprocess} ادامه فرآیند واردسازی که متوقف شده بود آرگومان‌های اختیاری (OPTIONAL ARGUMENTS) 'nominatim import' --osm2pgsql-cache SIZE اندازه حافظه موقت (cache) مورد استفاده توسط osm2pgsql (به مگابایت) --reverse-only جدول‌ها و نمایه‌ها برای جستجو ایجاد نشوند --no-partitions عدم پارتیشن‌بندی نمایه‌های جستجو (سرعت واردسازی قطعه‌های مربوط به یک کشور منفرد را افزایش می‌دهد) --no-updates جدول‌هایی که فقط برای به‌روزرسانی پایگاه‌داده در آینده نیاز هستند، نگهداری نشوند --offline هیچ تلاشی برای بارگیری داده‌های اضافی از اینترنت انجام نمی‌دهد.SH گزینه‌های تخصصی 'nominatim import' --ignore-errors ادامه فرآیند واردسازی حتی در صورت وجود خطا در SQL --index-noanalyse عدم اجرای عملیات analyse در حین ایندکس‌گذاری (فقط کاربران حرفه‌ای) --prepare-database ایجاد پایگاه‌داده بدون وارد کردن داده‌ها دستور 'nominatim freeze' کاربرد: nominatim freeze [-h] [-q] [-v] [--project-dir DIR] [-j NUM] فقط‌خواندنی کردن پایگاه‌داده. حدود نیمی از داده‌ها در پایگاه‌داده Nominatim صرفاً برای به‌روز نگه‌داشتن داده‌ها با تغییرات جدید اعمال‌شده در OpenStreetMap نگهداری می‌شوند. این دستور تمام این داده‌ها را حذف (drop) کرده و تنها بخشی را که برای خود فرآیند تبدیل نشانی به مختصات (geocoding) لازم است نگه می‌دارد. این دستور همان تأثیر گزینه `--no-updates` را در هنگام واردسازی دارد. آرگومان‌های پیش‌فرض 'nominatim freeze' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش جزئیات خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد رشته‌های (threads) موازی مورد استفاده دستور 'nominatim replication' کاربرد: 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 replication' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش جزئیات خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد رشته‌های (threads) موازی مورد استفاده آرگومان‌های مقداردهی اولیه 'nominatim replication' --init مقداردهی اولیه فرآیند به‌روزرسانی --no-update-functions عدم به‌روزرسانی تابع تریگر (trigger function) برای پشتیبانی از به‌روزرسانی‌های تفاضلی (کاربران حرفه‌ای) آرگومان‌های به‌روزرسانی 'nominatim replication' --check-for-updates بررسی وجود به‌روزرسانی‌های جدید و خروج --once دانلود و اعمال به‌روزرسانی‌ها تنها برای یک‌بار. در صورت عدم تنظیم، به‌روزرسانی‌ها به‌طور پیوسته اعمال می‌شوند --catch-up دانلود و اعمال به‌روزرسانی‌ها تا زمانی که داده جدیدی روی سرور در دسترس نباشد --no-index عدم ایندکس‌گذاری داده‌های جدید. فقط همراه با --once قابل استفاده است --osm2pgsql-cache SIZE اندازه حافظه موقت (cache) مورد استفاده توسط osm2pgsql (به مگابایت) پارامترهای بارگیری 'nominatim replication' --socket-timeout SOCKET_TIMEOUT تنظیم مهلت زمانی (timeout) برای دانلود فایل‌ها دستور 'nominatim special-phrases' کاربرد: 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' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش جزئیات خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد رشته‌های موازی مورد استفاده آرگومان‌های ورودی (INPUT ARGUMENTS) 'nominatim special-phrases' --import-from-wiki وارد کردن عبارت‌های ویژه از ویکی OSM به پایگاه داده --import-from-csv FILE وارد کردن عبارت‌های ویژه از یک فایل CSV --no-replace نگه‌داشتن عبارت‌های قدیمی و تنها افزودن موارد جدید --min MIN محدود کردن عبارت‌های ویژه بر اساس حداقل دفعات تکرار دستور (COMMAND) 'nominatim add-data' کاربرد: 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 ببینید. آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS) 'nominatim add-data' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش جزئیات خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد رشته‌های موازی مورد استفاده منبع (SOURCE) 'nominatim add-data' --file FILE وارد کردن داده‌ها از یک فایل OSM یا یک فایل diff --diff FILE وارد کردن داده‌ها از یک فایل diff مربوط به OSM (منسوخ‌شده: از --file استفاده کنید) --node ID وارد کردن یک گره تکی از API --way ID وارد کردن یک راه تکی از API --relation ID وارد کردن یک رابطه تکی از API --tiger-data DIR افزودن شماره پلاک‌ها از پایگاه داده سرشماری TIGER ایالات متحده آرگومان‌های اضافی (EXTRA ARGUMENTS) 'nominatim add-data' --use-main-api استفاده از OSM API به‌جای Overpass برای بارگیری اشیاء --osm2pgsql-cache SIZE اندازه حافظه نهان (کَش) برای استفاده توسط osm2pgsql (به مگابایت) --socket-timeout SOCKET_TIMEOUT تنظیم مهلت زمانی برای بارگیری فایل‌ها دستور (COMMAND) 'nominatim index' کاربرد: nominatim index [-h] [-q] [-v] [--project-dir DIR] [-j NUM] [--boundaries-only] [--no-boundaries] [--minrank RANK] [--maxrank RANK] نمایه‌سازی مجدد تمام داده‌های جدید و تغییر‌یافته. نمایه‌سازی فرایند محاسبه نشانی و عبارت‌های جستجو برای مکان‌های موجود در پایگاه داده است. هر بار که داده‌ای افزوده یا تغییر داده می‌شود، نمایه‌سازی باید اجرا گردد. فرایندهای واردسازی و به‌روزرسانی‌های همگام‌سازی به‌طور خودکار نمایه‌سازی را انجام می‌دهند. برای سایر موارد، این عملکرد امکان اجرای دستی نمایه‌سازی را فراهم می‌کند..SH "آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS)" 'nominatim index' -q, --quiet فقط پیام‌های خطا چاپ شوند -v, --verbose افزایش جزئیات خروجی --project-dir DIR دایرکتوری پایه‌ی نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد رشته‌های موازی مورد استفاده آرگومان‌های فیلتر (FILTER ARGUMENTS) 'nominatim index' --boundaries-only فقط مرزهای اداری نمایه‌سازی شوند. --no-boundaries نمایه‌سازی همه‌چیز به‌جز مرزهای اداری. --minrank RANK, -r RANK حداقل/رتبهٔ آغازین --maxrank RANK, -R RANK حداکثر/رتبهٔ پایانی دستور (COMMAND) 'nominatim refresh' کاربرد: 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' اجرا شود. آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS) 'nominatim refresh' -q, --quiet فقط پیام‌های خطا چاپ شوند -v, --verbose افزایش جزئیات خروجی --project-dir DIR دایرکتوری پایه‌ی نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد رشته‌های موازی مورد استفاده آرگومان‌های داده (DATA ARGUMENTS) 'nominatim refresh' --postcodes به‌روزرسانی جدول مرکز ثقل (centroid) کدهای پستی --word-tokens پاک‌سازی عبارت‌های جستجو --word-counts محاسبهٔ بسامد عبارت‌های جستجوی تمام‌کلمه (full-word) --address-levels وارد کردن مجدد پیکربندی سطوح نشانی --functions به‌روزرسانی توابع PL/pgSQL در پایگاه‌داده --wiki-data به‌روزرسانی مقادیر اهمیت Wikipedia/data --secondary-importance به‌روزرسانی داده‌های رَستری اهمیت ثانویه --importance محاسبهٔ مجدد اهمیت مکان‌ها (سنگین و زمان‌بر!) --ro-access اعطای دسترسی فقط‌خواندنی به کاربر وب برای تمام جدول‌ها --website منسوخ شده است (DEPRECATED). این گزینه دیگر هیچ کاربردی ندارد و در نسخه‌های آینده حذف خواهد شد. --data-object OBJECT علامت‌گذاری شیء OSM مشخص‌شده به‌عنوان نیازمند به‌روزرسانی (قالب: [NWR]) --data-area OBJECT علامت‌گذاری ناحیهٔ پیرامون شیء OSM مشخص‌شده به‌عنوان نیازمند به‌روزرسانی (قالب: [NWR]) آرگومان‌های بازنشانی توابع (ARGUMENTS FOR FUNCTION REFRESH) 'nominatim refresh' --no-diff-updates عدم فعال‌سازی کد انتشار به‌روزرسانی‌ها --enable-debug-statements فعال‌سازی عبارت‌های هشدار اشکال‌زدایی در توابع.SH آرگومان‌های تازه‌سازی کد پستی 'nominatim refresh' --force-reimport محاسبه مجدد کدهای پستی از ابتدا به جای به‌روزرسانی دستور 'nominatim admin' کاربرد: 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 admin' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش پرگویی خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد رشته‌های موازی مورد استفاده وظایف مدیریتی 'nominatim admin' --warm گرم‌کردن کَش‌های پایگاه داده برای پرس‌وجوهای جستجو و معکوس --check-database بررسی کامل و عملیاتی بودن پایگاه داده --migrate مهاجرت پایگاه داده به یک نسخه جدید نرم‌افزار --analyse-indexing چاپ تحلیل کارایی فرایند نمایه‌سازی --collect-os-info تولید گزارش درباره اطلاعات سیستم میزبان --clean-deleted AGE پاک‌سازی رابطه‌های حذف‌شده آرگومان‌های گرم‌کردن کَش 'nominatim admin' --search-only پیش‌گرم‌کردن جدول‌ها تنها برای پرس‌وجوهای جستجو --reverse-only پیش‌گرم‌کردن جدول‌ها تنها برای پرس‌وجوهای معکوس آرگومان‌های تحلیل نمایه 'nominatim admin' --osm-id OSM_ID تحلیل نمایه‌سازی شیء OSM داده‌شده --place-id PLACE_ID تحلیل نمایه‌سازی شیء Nominatim داده‌شده دستور 'nominatim export' کاربرد: 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 export' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش پرگویی خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد رشته‌های موازی مورد استفاده آرگومان‌های خروجی 'nominatim export' --output-type {country,state,county,city,suburb,street,path} نوع مکان‌ها برای خروجی (پیش‌فرض: street) --output-format OUTPUT_FORMAT فهرستی از انواع نشانی جداشده با نقطه‌ویرگول (ببینید: --output-type). علاوه بر این پذیرفته می‌شود: placeid,postcode --language LANGUAGE زبان ترجیحی برای خروجی (در صورت تعیین نشدن، از نام محلی استفاده می‌شود) آرگومان‌های پالایش 'nominatim export' --restrict-to-country COUNTRY_CODE تنها برون‌ریزی اشیای داخل کشور --restrict-to-osm-node ID تنها برون‌ریزی فرزندان این گره OSM --restrict-to-osm-way ID تنها برون‌ریزی فرزندان این راه OSM --restrict-to-osm-relation ID تنها برون‌ریزی فرزندان این رابطه 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) می‌تواند ایجاد شود. گزینه‌ها (OPTIONS) 'nominatim convert' --format {sqlite} قالب پایگاه‌داده خروجی (در حال حاضر باید sqlite باشد) --output OUTPUT, -o OUTPUT فایلی که پایگاه‌داده در آن نوشته می‌شود. آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS) 'nominatim convert' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش جزئیات خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد رشته‌های موازی مورد استفاده سوئیچ‌های تعریف ساختار پایگاه‌داده (در حال حاضر بدون اثر) (SWITCHES TO DEFINE DATABASE LAYOUT) 'nominatim convert' --with-reverse, --without-reverse فعال/غیرفعال کردن پشتیبانی از APIهای reverse و lookup (پیش‌فرض: فعال) --with-search, --without-search فعال/غیرفعال کردن پشتیبانی از APIی search (پیش‌فرض: غیرفعال) --with-details, --without-details فعال/غیرفعال کردن پشتیبانی از APIی details (پیش‌فرض: فعال) دستور (COMMAND) 'nominatim serve' کاربرد: 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 آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS) 'nominatim serve' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش جزئیات خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد رشته‌های موازی مورد استفاده آرگومان‌های سرور (SERVER ARGUMENTS) 'nominatim serve' --server SERVER نشانی‌ای که سرور روی آن گوش فرا می‌دهد. --engine {falcon,starlette} فریم‌ورک وب‌سرور برای اجرا. (پیش‌فرض: falcon) دستور (COMMAND) 'nominatim search' کاربرد: 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 آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS) 'nominatim search' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش جزئیات خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد رشته‌های موازی مورد استفاده.SH "آرگومان‌های پرس‌وجو (QUERY ARGUMENTS)" 'nominatim search' --query QUERY رشته پرس‌وجوی آزاد --amenity AMENITY پرس‌وجوی ساختاریافته: نام و/یا نوع POI --street STREET پرس‌وجوی ساختاریافته: پلاک و خیابان --city CITY پرس‌وجوی ساختاریافته: شهر، شهرک یا روستا --county COUNTY پرس‌وجوی ساختاریافته: شهرستان --state STATE پرس‌وجوی ساختاریافته: استان یا ایالت --country COUNTRY پرس‌وجوی ساختاریافته: کشور --postalcode POSTALCODE پرس‌وجوی ساختاریافته: کد پستی قالب‌بندی خروجی (OUTPUT FORMATTING) 'nominatim search' --format FORMAT قالب نتیجه (برای مشاهده قالب‌های پشتیبانی‌شده از --list-format استفاده کنید) --addressdetails گنجاندن تفکیک نشانی به اجزای تشکیل‌دهنده --extratags گنجاندن اطلاعات تکمیلی در صورت موجود بودن (مانند پیوند ویکی‌پدیا، ساعات کاری) --entrances گنجاندن فهرستی از گره‌های ورودی برچسب‌گذاری‌شده --namedetails گنجاندن فهرستی از نام‌های جایگزین --lang LANGS, --accept-language LANGS ترتیب زبان‌های ترجیحی برای نمایش نتایج جستجو --polygon-output {geojson,kml,svg,text} خروجی دادن هندسه نتایج به عنوان GeoJSON، KML، SVG یا WKT --polygon-threshold TOLERANCE ساده‌سازی هندسه خروجی. این پارامتر میزان تلورانس اختلاف بر حسب درجه است. محدودسازی نتایج (RESULT LIMITATION) 'nominatim search' --countrycodes CC,.. محدود کردن نتایج جستجو به یک یا چند کشور --exclude_place_ids ID,.. فهرست شناسه‌های اشیای جستجو که باید مستثنی شوند --limit LIMIT محدود کردن تعداد نتایج بازگردانده‌شده --viewbox X1,Y1,X2,Y2 محدوده جغرافیایی ترجیحی برای یافتن نتایج جستجو --bounded محدود کردن دقیق و قطعی نتایج به محدوده viewbox --layer LAYER محدود کردن نتایج به یک یا چند لایه (می‌تواند تکرار شود) --no-dedupe عدم حذف موارد تکراری از فهرست نتایج سایر گزینه‌ها (OTHER OPTIONS) 'nominatim search' --list-formats فهرست کردن قالب‌های خروجی پشتیبانی‌شده و خروج. دستور (COMMAND) 'nominatim reverse' کاربرد: 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 آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS) 'nominatim reverse' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش جزئیات خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد نخ‌های موازی برای استفاده.SH "آرگومان‌های پرس‌وجو (QUERY ARGUMENTS)" 'nominatim reverse' --lat LAT عرض جغرافیایی مختصات برای جست‌وجو (در سامانه WGS84) --lon LON طول جغرافیایی مختصات برای جست‌وجو (در سامانه WGS84) --zoom ZOOM سطح جزئیات مورد نیاز برای نشانی --layer LAYER محدود کردن نتایج به یک یا چند لایه (می‌تواند تکرار شود) قالب‌بندی خروجی (OUTPUT FORMATTING) 'nominatim reverse' --format FORMAT قالب نتیجه (برای مشاهده قالب‌های پشتیبانی‌شده از --list-format استفاده کنید) --addressdetails گنجاندن تفکیک نشانی به اجزای تشکیل‌دهنده --extratags شامل کردن اطلاعات اضافی در صورت موجود بودن (مانند پیوند ویکی‌پدیا، ساعات کاری) --entrances شامل کردن فهرستی از گره‌های ورودی برچسب‌گذاری‌شده --namedetails شامل کردن فهرستی از نام‌های جایگزین --lang LANGS, --accept-language LANGS ترتیب زبان‌های ترجیحی برای نمایش نتایج جست‌وجو --polygon-output {geojson,kml,svg,text} خروجی هندسه نتایج در قالب GeoJSON، KML، SVG یا WKT --polygon-threshold TOLERANCE ساده‌سازی هندسه خروجی. این پارامتر، میزان رواداری اختلاف بر حسب درجه است. سایر گزینه‌ها (OTHER OPTIONS) 'nominatim reverse' --list-formats نمایش فهرست قالب‌های خروجی پشتیبانی‌شده و خروج. دستور (COMMAND) 'nominatim lookup' کاربرد: 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 آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS) 'nominatim lookup' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش پرگویی (میزان جزئیات) خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد ریسمان‌های موازی مورد استفاده آرگومان‌های پرس‌وجو (QUERY ARGUMENTS) 'nominatim lookup' --id OSMID شناسه OSM برای جست‌وجو با قالب (می‌تواند تکرار شود) قالب‌بندی خروجی (OUTPUT FORMATTING) 'nominatim lookup' --format FORMAT قالب نتیجه (برای مشاهده قالب‌های پشتیبانی‌شده از --list-format استفاده کنید) --addressdetails گنجاندن تفکیک نشانی به اجزای تشکیل‌دهنده --extratags شامل کردن اطلاعات اضافی در صورت موجود بودن (مانند پیوند ویکی‌پدیا، ساعات کاری) --entrances شامل کردن فهرستی از گره‌های ورودی برچسب‌گذاری‌شده --namedetails شامل کردن فهرستی از نام‌های جایگزین --lang LANGS, --accept-language LANGS ترتیب زبان‌های ترجیحی برای نمایش نتایج جست‌وجو --polygon-output {geojson,kml,svg,text} خروجی هندسه نتایج در قالب GeoJSON، KML، SVG یا WKT --polygon-threshold TOLERANCE ساده‌سازی هندسه خروجی. این پارامتر، میزان رواداری اختلاف بر حسب درجه است..SH "گزینه‌های دیگر (OTHER OPTIONS)" 'nominatim lookup' --list-formats فهرست کردن قالب‌های خروجی پشتیبانی‌شده و خروج. دستور (COMMAND) 'nominatim details' 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 آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS) 'nominatim details' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش پرگویی خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد نخ‌های موازی برای استفاده آرگومان‌های پرس‌وجو (QUERY ARGUMENTS) 'nominatim details' --node NODE, -n NODE جستجوی گره OSM با شناسه داده‌شده. --way WAY, -w WAY جستجوی راه OSM با شناسه داده‌شده. --relation RELATION, -r RELATION جستجوی رابطه OSM با شناسه داده‌شده. --place_id PLACE_ID, -p PLACE_ID شناسه داخلی پایگاه‌داده برای شیء OSM جهت جستجو --class OBJECT_CLASS نوع کلاس برای ابهام‌زدایی از چند مدخل مربوط به یک شیء یکسان. آرگومان‌های خروجی (OUTPUT ARGUMENTS) 'nominatim details' --format FORMAT قالب نتیجه (برای مشاهده قالب‌های پشتیبانی‌شده از --list-formats استفاده کنید) --addressdetails شامل تفکیک نشانی به بخش‌های تشکیل‌دهنده آن --keywords شامل فهرستی از کلیدواژه‌های نام و کلیدواژه‌های نشانی --linkedplaces شامل جزئیات مکان‌هایی که به این مکان پیوند دارند --entrances شامل فهرستی از گره‌های ورودی برچسب‌گذاری‌شده --hierarchy شامل جزئیات مکان‌های پایین‌تر در سلسله‌مراتب نشانی --group_hierarchy گروه‌بندی مکان‌ها بر پایه نوع --polygon_geojson شامل هندسه نتیجه --lang LANGS, --accept-language LANGS ترتیب ترجیحی زبان برای نمایش نتایج جستجو گزینه‌های دیگر (OTHER OPTIONS) 'nominatim details' --list-formats فهرست کردن قالب‌های خروجی پشتیبانی‌شده و خروج. دستور (COMMAND) 'nominatim status' 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 آرگومان‌های پیش‌فرض (DEFAULT ARGUMENTS) 'nominatim status' -q, --quiet تنها چاپ پیام‌های خطا -v, --verbose افزایش پرگویی خروجی --project-dir DIR دایرکتوری پایه نصب Nominatim (پیش‌فرض: /var/lib/nominatim/) -j NUM, --threads NUM تعداد نخ‌های موازی برای استفاده.SH "پارامترهای API (API PARAMETERS)" 'nominatim status' --format FORMAT قالب نتیجه (برای مشاهدهٔ قالب‌های پشتیبانی‌شده از --list-formats استفاده کنید) سایر گزینه‌ها (OTHER OPTIONS) 'nominatim status' --list-formats فهرست کردن قالب‌های خروجی پشتیبانی‌شده و خروج. نویسندگان (AUTHORS) جامعه توسعه‌دهندگان Nominatim info@nominatim.org توزیع (DISTRIBUTION) آخرین نسخهٔ Nominatim را می‌توان از نشانی زیر بارگیری کرد: Nominatim 2026-04-19 NOMINATIM(1)