# فرهنگ لغت حمل‌ونقل و داده‌ها.

تعریف‌های ساده برای درک حمل‌ونقل، خدمات محلی و ابزارهای مرتبط با برنامه‌های شما.

Source: https://www.roote.ai/fa/farhang-mobile/
Language: fa
Author: ROOTE

## دوچرخه اجاره‌ای

خدمتی برای کرایه موقت دوچرخه طبق شرایط اپراتور. می‌تواند با ایستگاه یا بدون ایستگاه باشد.

مثال : شما دوچرخه‌ای را پیدا کرده و از خدمات اجاره مربوطه استفاده می‌کنید.

تعمیق در راهنما : [چگونه یک دوچرخه خودپرداز نزدیک خود پیدا کنیم؟](https://www.roote.ai/fa/guides/chera-tavane-find-kardane-docharkhe-az-rooz/)

## حمل‌ونقل اشتراکی

مجموعه‌ای از خدماتی که دسترسی به وسایل نقلیه‌ای را می‌دهند که چندین نفر به نوبت استفاده می‌کنند، نه وسیله‌ای که فقط یک مالک داشته باشد.

مثال : دوچرخه‌ها و اسکوترهای اجاره‌ای در یک شهر.

تعمیق در راهنما : [چگونه یک دوچرخه خودپرداز نزدیک خود پیدا کنیم؟](https://www.roote.ai/fa/guides/chera-tavane-find-kardane-docharkhe-az-rooz/)

## محل قفل دوچرخه

تجهزات ایستگاه که دوچرخه به آن قفل می‌شود. وجودش تضمین نمی‌کند که در زمان مشاهده امکان بازگرداندن دوچرخه باشد.

مثال : جایی برای بازگرداندن دوچرخه باید در دسترس و قابل استفاده باشد.

تعمیق در راهنما : [ایستگاه دوچرخه خالی یا پر: چه کاری انجام دهیم؟](https://www.roote.ai/fa/guides/station-velos-khali-ya-purshode-chi-konim/)

## ایستگاه دوچرخه

مکانی سازمان‌یافته برای گرفتن یا بازگرداندن دوچرخه‌های اشتراکی. مختصات، ظرفیت و در دسترس بودن جنبه‌های مختلف ایستگاه هستند.

مثال : ممکن است ایستگاهی روی نقشه باشد ولی موقتا خالی باشد.

تعمیق در راهنما : [ایستگاه دوچرخه خالی یا پر: چه کاری انجام دهیم؟](https://www.roote.ai/fa/guides/station-velos-khali-ya-purshode-chi-konim/)

## بدون ایستگاه — free-floating

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

مثال : یک اسکوتر باید در منطقه مجاز بازگردانده شود.

تعمیق در راهنما : [دوچرخه ایستگاهی یا بدون ایستگاه: تفاوت‌ها چیست؟](https://www.roote.ai/fa/guides/%D8%AF%D9%88%DA%86%D8%B1%D8%AE%D9%87-%D8%A7%DB%8C%D8%B3%D8%AA%DA%AF%D8%A7%D9%87%DB%8C-%DB%8C%D8%A7-%D8%A8%D8%AF%D9%88%D9%86-%D8%A7%DB%8C%D8%B3%D8%AA%DA%AF%D8%A7%D9%87-%D8%AA%D9%81%D8%A7%D9%88%D8%AA-%D9%87%D8%A7/)

## دسترسی‌پذیری

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

مثال : مشاهده سه دوچرخه در ایستگاه به معنی رزرو سه دوچرخه نیست.

تعمیق در راهنما : [دسترس‌پذیری دوچرخه‌ها به‌صورت لحظه‌ای: چگونه در یک اپلیکیشن نمایش دهیم؟](https://www.roote.ai/fa/guides/dastresan-vazn-dochkheh-be-zamani-vaghei/)

## برداشتن وسیله

شروع استفاده از وسیله نقلیه. وجود دستگاه شمارشگر مثبت کافی نیست اگر سرویس اعلام کند امکان برداشت وجود ندارد.

مثال : دوچرخه‌ها موجودند اما ممکن است ایستگاه اجازه اجاره ندهد.

تعمیق در راهنما : [دسترس‌پذیری دوچرخه‌ها به‌صورت لحظه‌ای: چگونه در یک اپلیکیشن نمایش دهیم؟](https://www.roote.ai/fa/guides/dastresan-vazn-dochkheh-be-zamani-vaghei/)

## بازگرداندن

پایان استفاده از وسیله به‌روش سرویس. شرایط بازگرداندن ممکن است با برداشت متفاوت باشد.

مثال : ایستگاه اجازه برداشت دارد اما جایی برای بازگرداندن ندارد.

تعمیق در راهنما : [ایستگاه دوچرخه خالی یا پر: چه کاری انجام دهیم؟](https://www.roote.ai/fa/guides/station-velos-khali-ya-purshode-chi-konim/)

## دوچرخه برقی

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

مثال : ایستگاه ممکن است دوچرخه‌های معمولی و برقی را جدا کند.

تعمیق در راهنما : [دسترس‌پذیری دوچرخه‌ها به‌صورت لحظه‌ای: چگونه در یک اپلیکیشن نمایش دهیم؟](https://www.roote.ai/fa/guides/dastresan-vazn-dochkheh-be-zamani-vaghei/)

## چندوجهی

استفاده پشت سر هم از چند حالت جابجایی در یک مسیر. هر مرحله زمانبندی، دسترسی و شرایط خود را دارد.

مثال : شما با دوچرخه به تراموا می‌روید و سپس پیاده ادامه می‌دهید.

تعمیق در راهنما : [چگونه دوچرخه و حمل و نقل عمومی را در زندگی روزمره ترکیب کنیم؟](https://www.roote.ai/fa/guides/chegoneh-motabegh-kardan-docharkhe-va-haml-o-naghl-e-ammomi-dar-roozmareh/)

## ایستگاه حمل‌ونقل

مکان توقف یا سوار و پیاده کردن مسافر توسط سرویس حمل‌ونقل. ایستگاه بدون برنامه زمانی لزوما عبورهای بعدی را نشان نمی‌دهد.

مثال : یک ایستگاه اتوبوس بدون زمان حرکت بازگردانده شده است.

تعمیق در راهنما : [چگونه نزدیک‌ترین ایستگاه اتوبوس یا تراموا را پیدا کنیم؟](https://www.roote.ai/fa/guides/chetor-noghtevaraghie-nazdiktarin-ayetbus-ya-tram-ra-peida-konim/)

## سکو

فضا یا نقطه سوار شدن در محل حمل‌ونقل. چند سکوی نزدیک می‌توانند برای جهت‌ها یا سرویس‌های مختلف باشند.

مثال : دو جهت یک خط ممکن است از سکوهای متفاوت استفاده کنند.

تعمیق در راهنما : [چگونه ایستگاه درست اتوبوس و جهت صحیح را پیدا کنیم؟](https://www.roote.ai/fa/guides/%DA%86%DA%AF%D9%88%D9%86%D9%87-%D8%A7%DB%8C%D8%B3%D8%AA%DA%AF%D8%A7%D9%87-%D8%AF%D8%B1%D8%B3%D8%AA-%D8%A7%D8%AA%D9%88%D8%A8%D9%88%D8%B3-%D9%88-%D8%B3%D9%85%D8%AA-%D8%AF%D8%B1%D8%B3%D8%AA-%D8%B1%D8%A7-%D8%A8%DB%8C%D8%A7%D8%A8%DB%8C%D9%85/)

## خط

سرویسی در شبکه حمل‌ونقل با یک یا چند مسیر یا نوع. نام خط به تنهایی جهت صحیح را نشان نمی‌دهد.

مثال : یک خط ممکن است چند ترمینال داشته باشد.

تعمیق در راهنما : [چگونه ایستگاه درست اتوبوس و جهت صحیح را پیدا کنیم؟](https://www.roote.ai/fa/guides/%DA%86%DA%AF%D9%88%D9%86%D9%87-%D8%A7%DB%8C%D8%B3%D8%AA%DA%AF%D8%A7%D9%87-%D8%AF%D8%B1%D8%B3%D8%AA-%D8%A7%D8%AA%D9%88%D8%A8%D9%88%D8%B3-%D9%88-%D8%B3%D9%85%D8%AA-%D8%AF%D8%B1%D8%B3%D8%AA-%D8%B1%D8%A7-%D8%A8%DB%8C%D8%A7%D8%A8%DB%8C%D9%85/)

## سفر

اجرای یک خدمت در مسیر و زمان‌بندی مشخص شده. در GTFS، یک سفر به خط و تقویم خدمات مرتبط است.

مثال : دو حرکت پیاپی در یک خط، دو سفر مجزا هستند.

تعمیق در راهنما : [GTFS، GTFS-RT و GBFS: چه تفاوت‌هایی وجود دارد؟](https://www.roote.ai/fa/guides/gtfs-gtfs-rt-va-gbfs-che-tafavotha/)

## جهت

نشانه‌گیری سمت یا مقصد سرویس. باید با مسیر و مکان سوار شدن تایید شود.

مثال : شما به دنبال تراموای به مقصد خود هستید، نه جهت مخالف.

تعمیق در راهنما : [چگونه ایستگاه درست اتوبوس و جهت صحیح را پیدا کنیم؟](https://www.roote.ai/fa/guides/%DA%86%DA%AF%D9%88%D9%86%D9%87-%D8%A7%DB%8C%D8%B3%D8%AA%DA%AF%D8%A7%D9%87-%D8%AF%D8%B1%D8%B3%D8%AA-%D8%A7%D8%AA%D9%88%D8%A8%D9%88%D8%B3-%D9%88-%D8%B3%D9%85%D8%AA-%D8%AF%D8%B1%D8%B3%D8%AA-%D8%B1%D8%A7-%D8%A8%DB%8C%D8%A7%D8%A8%DB%8C%D9%85/)

## ترمینال

پایان یک مسیر حمل‌ونقلی. خط ممکن است انواع مختلفی با ترمینال‌های متفاوت داشته باشد.

مثال : خدمتی کوتاه‌تر قبل از ترمینال معمول پایان می‌یابد.

تعمیق در راهنما : [چگونه ایستگاه درست اتوبوس و جهت صحیح را پیدا کنیم؟](https://www.roote.ai/fa/guides/%DA%86%DA%AF%D9%88%D9%86%D9%87-%D8%A7%DB%8C%D8%B3%D8%AA%DA%AF%D8%A7%D9%87-%D8%AF%D8%B1%D8%B3%D8%AA-%D8%A7%D8%AA%D9%88%D8%A8%D9%88%D8%B3-%D9%88-%D8%B3%D9%85%D8%AA-%D8%AF%D8%B1%D8%B3%D8%AA-%D8%B1%D8%A7-%D8%A8%DB%8C%D8%A7%D8%A8%DB%8C%D9%85/)

## تعویض خط

تعویض یک سرویس یا حالت حمل‌ونقل در سفر. نزدیکی دو ایستگاه تضمین کننده تعویض موفق نیست.

مثال : باید فاصله بین سکوها و زمان انتظار را در نظر گرفت.

تعمیق در راهنما : [چگونه نقشه اتوبوس، تراموا یا مترو را بخوانیم؟](https://www.roote.ai/fa/guides/%DA%86%DA%AF%D9%88%D9%86%D9%87-%D9%86%D9%82%D8%B4%D9%87-%D8%A7%D8%AA%D9%88%D8%A8%D9%88%D8%B3-%D8%AA%D8%B1%D8%A7%D9%85%D9%88%D8%A7-%DB%8C%D8%A7-%D9%85%D8%AA%D8%B1%D9%88-%D8%B1%D8%A7-%D8%A8%D8%AE%D9%88%D8%A7%D9%86%DB%8C%D9%85/)

## زمان برنامه‌ریزی شده

زمان برنامه‌ریزی شده در برنامه خدمات برای تاریخ و عبور مشخص. لزوما شرایط فعلی وسیله نقلیه را توصیف نمی‌کند.

مثال : حرکتی در ساعت ۸:۱۰ براساس تقویم برنامه‌ریزی شده است.

تعمیق در راهنما : [ساعت‌های اتوبوس: تفاوت بین ساعت‌های تئوریک و زمان واقعی چیست؟](https://www.roote.ai/fa/guides/jadavile-bus-tomareshi-va-waqeigy/)

## زمان تخمینی

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

مثال : عبوری که ۸:۱۰ برنامه‌ریزی شده بود، اکنون ۸:۱۴ تخمین زده شده است.

تعمیق در راهنما : [ساعت‌های اتوبوس: تفاوت بین ساعت‌های تئوریک و زمان واقعی چیست؟](https://www.roote.ai/fa/guides/jadavile-bus-tomareshi-va-waqeigy/)

## حرکت بعدی

عبور یا حرکت آینده بر اساس مکان و سرویس مشخص شده. یافتن ایستگاه به معنای جستجوی حرکت‌های آینده نیست.

مثال : فهرست ایستگاه‌ها و فهرست حرکات دو نتیجه متفاوت است.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## اختلال

رویدادی که سرویس حمل‌ونقل را متاثر می‌کند، مانند توقف یا تغییر مسیر. تاثیرات باید بر اساس محدوده و دوره اعلام شده خوانده شود.

مثال : یک هشدار ممکن است فقط برای خطی در ساعات خاص باشد.

تعمیق در راهنما : [چگونه یک دستیار بسازیم که موقعیت‌های حمل و نقل اطراف یک آدرس را پیدا کند؟](https://www.roote.ai/fa/guides/chek-kardan-ye-dastgahi-ke-mobility-ha-ra-dar-hamkoli-ye-adress-peida-mikonad/)

## تقویم خدمات

اطلاعات درباره روزهای فعال یک سرویس با استثناهای احتمالی. زمان‌بندی باید با این تقویم تفسیر شود.

مثال : عبور برنامه‌ریزی شده در روزهای هفته ممکن است یکشنبه وجود نداشته باشد.

تعمیق در راهنما : [GTFS، GTFS-RT و GBFS: چه تفاوت‌هایی وجود دارد؟](https://www.roote.ai/fa/guides/gtfs-gtfs-rt-va-gbfs-che-tafavotha/)

## خدمات شهری

تجهیز یا خدمتی مفید نزدیک مکان، مانند دستشویی، نقطه آب‌رسانی یا ایستگاه شارژ. ویژگی‌ها ممکن است ناقص باشد.

مثال : نتیجه جستجوی نزدیک خدمات و اطلاعات موجود را توصیف می‌کند.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## دستشویی عمومی

دستشویی برای استفاده عمومی طبق شرایط محل. وجود آن در داده‌ها تضمین‌کننده رایگان بودن یا باز بودن مداوم یا دسترسی نیست.

مثال : قبل از حرکت شرایط ذکر شده را بررسی کنید.

تعمیق در راهنما : [چگونه سرویس بهداشتی عمومی رایگان در اطراف خود پیدا کنیم؟](https://www.roote.ai/fa/guides/chetor-toilettes-omoumi-rojaye-hariraye-khod-ra-peida-konim/)

## دسترس‌پذیری

ویژگی‌هایی که امکان استفاده از مکان یا خدمت را با توجه به نیازهای فرد فراهم می‌کند. نبود داده به معنی دسترس یا غیر دسترس بودن نیست.

مثال : دسترس‌پذیری برای ویلچر ممکن است مشخص یا نامشخص باشد.

تعمیق در راهنما : [دستشویی‌های عمومی قابل دسترس: چه مواردی را باید قبل از رفتن بررسی کرد؟](https://www.roote.ai/fa/guides/toilettes-publiques-accessibles-che-verifyer-avant-de-se-deplacer/)

## دارای محدودیت حرکتی — PMR

شخصی که در جابجایی دچار مشکل است. علامت PMR به تنهایی تمام دسترسی‌ها یا تجهیزات مورد نیاز را معرفی نمی‌کند.

مثال : وجود رمپ تمام موانع را توضیح نمی‌دهد.

تعمیق در راهنما : [دستشویی‌های عمومی قابل دسترس: چه مواردی را باید قبل از رفتن بررسی کرد؟](https://www.roote.ai/fa/guides/toilettes-publiques-accessibles-che-verifyer-avant-de-se-deplacer/)

## ساعات کاری

طی دوره‌هایی که مکان اعلام باز بودن می‌کند. تایید مستقیم عملکرد لحظه‌ای نیست.

مثال : بسته شدن موقتی ممکن است در ساعات عادی نشان داده نشود.

تعمیق در راهنما : [چگونه سرویس بهداشتی عمومی رایگان در اطراف خود پیدا کنیم؟](https://www.roote.ai/fa/guides/chetor-toilettes-omoumi-rojaye-hariraye-khod-ra-peida-konim/)

## آب آشامیدنی

آبی که مناسب مصرف انسان است. نقطه آب یا فواره بدون اطلاعات مشخص نباید به عنوان آب آشامیدنی نشان داده شود.

مثال : باید نوع تجهیز و ویژگی‌هایش تشخیص داده شود.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## ایستگاه شارژ

تجهیز برای شارژ وسیله نقلیه سازگار. یافتن ایستگاه تضمین کننده در دسترس بودن یا سازگاری کانکتور نیست.

مثال : مکان شارژ و وضعیت استفاده‌اش دو اطلاعات متفاوت هستند.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## نوع خدمت

دسته‌ای برای انتخاب یا توصیف خدمات شهری. مقادیر پذیرفته شده وابسته به رابط و طرح آن است.

مثال : API خدمات ROOTE از types=toilets برای دستشویی‌ها استفاده می‌کند.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## مکان‌یابی جغرافیایی

دریافت موقعیت جغرافیایی توسط دستگاه یا برنامه، که وابسته به دسترسی‌ها و دقت موجود است.

مثال : دکمه مکان‌یابی نیاز به اجازه از مرورگر دارد.

تعمیق در راهنما : [چگونه یک نقشه حرکت را در سایت خود ادغام کنیم؟](https://www.roote.ai/fa/guides/cheren-amalakahyeh-naghshe-dar-site/)

## مختصات GPS

مقادیر نشان‌دهنده نقطه جغرافیایی، معمولاً عرض و طول جغرافیایی. ترتیب آنها باید در رابط مشخص شود.

مثال : جستجوی نزدیک دارای دو مختصات مجزا است.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## عرض جغرافیایی

مختصه表示 موقعیت در شمال یا جنوب خط استوا، درجه در مثال‌های ROOTE. مقادیر معتبر از −90 تا 90 است.

مثال : عرض نقطه جستجو در lat ارسال می‌شود.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## طول جغرافیایی

مختصه نمایش موقعیت شرق-غرب نسبت به نصف‌النهار مرجع. مثال‌های ROOTE با درجه بین −180 تا 180 است.

مثال : طول جغرافیایی ممکن است در lon یا مستعار مستند lng ارسال شود.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## رمزگذاری جغرافیایی

جستجویی که آدرس یا عبارت جغرافیایی را به گزینه‌هایی با مختصات تبدیل می‌کند. چند مکان ممکن است به یک ورودی مشابه مرتبط باشند.

مثال : دو شهر خیابانی با نام یکسان دارند.

تعمیق در راهنما : [چگونه یک دستیار بسازیم که موقعیت‌های حمل و نقل اطراف یک آدرس را پیدا کند؟](https://www.roote.ai/fa/guides/chek-kardan-ye-dastgahi-ke-mobility-ha-ra-dar-hamkoli-ye-adress-peida-mikonad/)

## رمزگذاری معکوس جغرافیایی

جستجوی مکان‌ها یا توضیحات از روی مختصات. نتیجه ممکن است محل نزدیک باشد نه یک آدرس دقیق تضمینی.

مثال : نقطه GPS به برچسب خوانا مرتبط می‌شود.

تعمیق در راهنما : [سرور MCP چیست و چه کاربردی دارد؟](https://www.roote.ai/fa/guides/server-mcp-%DA%86%DB%8C%D8%B3%D8%AA-%D9%88-%DA%86%D9%87-%DA%A9%D8%A7%D8%B1%D8%A8%D8%B1%D8%AF%DB%8C-%D8%AF%D8%A7%D8%B1%D8%AF/)

## نقطه علاقه — POI

مکان قابل تشخیص مفید برای جستجو، مانند بنگاه یا تجهیز. POI با یک آدرس پستی ساده متفاوت است.

مثال : نام هتل می‌تواند به عنوان یک موسسه جستجو شود.

تعمیق در راهنما : [چگونه یک دستیار بسازیم که موقعیت‌های حمل و نقل اطراف یک آدرس را پیدا کند؟](https://www.roote.ai/fa/guides/chek-kardan-ye-dastgahi-ke-mobility-ha-ra-dar-hamkoli-ye-adress-peida-mikonad/)

## مبدا جستجو

نقطه‌ای که جستجوی نزدیکی از آن انجام شده و فاصله‌ها محاسبه می‌شود. ممکن است با مرکز نمایش داده شده نقشه متفاوت باشد.

مثال : دوربین حرکت می‌کند ولی جستجو روی بوردو متمرکز است.

تعمیق در راهنما : [چگونه یک نقشه حرکت را در سایت خود ادغام کنیم؟](https://www.roote.ai/fa/guides/cheren-amalakahyeh-naghshe-dar-site/)

## شعاع جستجو

فاصله اطراف مبدأ که جستجو را محدود می‌کند. واحد و حدها وابسته به قرارداد مسیر یا ابزار است.

مثال : radius=600 شعاع ۶۰۰ متر را در مثال REST درخواست می‌کند.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## فاصله جغرافیایی

فاصله میان موقعیت‌ها بر اساس روش سرویس محاسبه می‌شود. لزوماً فاصله مسیر یا زمان پیاده‌روی نیست.

مثال : مکانی نزدیک ممکن است دسترسی‌اش با مسیر دورتری باشد.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## بزرگ‌نمایی نقشه

میزان بزرگنمایی نمایش نقشه. کنترل نمایش است و جایگزین شعاع درخواست API نیست.

مثال : zoom=15 نمای نقشه را نزدیک‌تر می‌کند.

تعمیق در راهنما : [چگونه یک نقشه حرکت را در سایت خود ادغام کنیم؟](https://www.roote.ai/fa/guides/cheren-amalakahyeh-naghshe-dar-site/)

## داده‌های زنده

اطلاعات به‌روز شده برای نمایش وضعیت کنونی یا تخمین. تازگی باید ارزیابی شود؛ زمان واقعی لزوماً فوری یا تضمین شده نیست.

مثال : تخمین عبور با داده‌های جدید به‌روزرسانی می‌شود.

تعمیق در راهنما : [ساعت‌های اتوبوس: تفاوت بین ساعت‌های تئوریک و زمان واقعی چیست؟](https://www.roote.ai/fa/guides/jadavile-bus-tomareshi-va-waqeigy/)

## مشاهده

وضعیت یا رویداد مشاهده شده در زمان مشخص. از رویداد برنامه‌ریزی شده یا تخمینی تمییز داده شود.

مثال : عبور واقعی یک اتوبوس ممکن است با تخمین اعلام شده فرق داشته باشد.

تعمیق در راهنما : [ساعت‌های اتوبوس: تفاوت بین ساعت‌های تئوریک و زمان واقعی چیست؟](https://www.roote.ai/fa/guides/jadavile-bus-tomareshi-va-waqeigy/)

## تازگی داده‌ها

وضیعت به‌روز بودن اطلاعات بر اساس تاریخ‌ها و قرارداد سرویس. زمان مشاهده به تنهایی نشان‌دهنده تازگی نیست.

مثال : زمان ثبت فعلی ممکن است از مشاهده قدیمی‌تر باشد.

تعمیق در راهنما : [دسترس‌پذیری دوچرخه‌ها به‌صورت لحظه‌ای: چگونه در یک اپلیکیشن نمایش دهیم؟](https://www.roote.ai/fa/guides/dastresan-vazn-dochkheh-be-zamani-vaghei/)

## زمان‌نشان

نشانه زمانی مرتبط با داده یا رویداد. مفهوم آن وابسته به نوع فیلد: مشاهده، به‌روزرسانی، دریافت یا انقضا است.

مثال : source_updated_at و received_at مراحل متفاوتی را توصیف می‌کنند.

تعمیق در راهنما : [دسترس‌پذیری دوچرخه‌ها به‌صورت لحظه‌ای: چگونه در یک اپلیکیشن نمایش دهیم؟](https://www.roote.ai/fa/guides/dastresan-vazn-dochkheh-be-zamani-vaghei/)

## داده منسوخ — stale

اطلاعی که بر اساس قرارداد یا سیاست اعتبارگذاری خیلی قدیمی تلقی می‌شود. ممکن است به عنوان تاریخچه نگهداری شود اما تازه نمایش داده نشود.

مثال : رابط اعلام می‌کند دسترسی باید به‌روزرسانی شود.

تعمیق در راهنما : [دسترس‌پذیری دوچرخه‌ها به‌صورت لحظه‌ای: چگونه در یک اپلیکیشن نمایش دهیم؟](https://www.roote.ai/fa/guides/dastresan-vazn-dochkheh-be-zamani-vaghei/)

## مدت زمان اعتبار — TTL

مدت مورد استفاده برای مدیریت اعتبار یا تجدید داده کش شده، بر اساس قرارداد. به تنهایی زمان مشاهده را تضمین نمی‌کند.

مثال : کش منقضی باید طبق سیاست به‌روزرسانی اقدام کند.

تعمیق در راهنما : [دسترس‌پذیری دوچرخه‌ها به‌صورت لحظه‌ای: چگونه در یک اپلیکیشن نمایش دهیم؟](https://www.roote.ai/fa/guides/dastresan-vazn-dochkheh-be-zamani-vaghei/)

## کش

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

مثال : دو درخواست مشابه می‌توانند پاسخ هنوز معتبر را باز استفاده کنند.

تعمیق در راهنما : [دسترس‌پذیری دوچرخه‌ها به‌صورت لحظه‌ای: چگونه در یک اپلیکیشن نمایش دهیم؟](https://www.roote.ai/fa/guides/dastresan-vazn-dochkheh-be-zamani-vaghei/)

## پوشش

محدوده و درجه کامل بودن اطلاعات موجود برای جستجو یا منبع. پوشش ناقص محدودیت در برداشت نتیجه دارد.

مثال : فهرست ممکن است مفید باشد ولی تمام خدمات موجود را نشان ندهد.

تعمیق در راهنما : [نتیجه‌ای نیست یا خطای API: چگونه تفاوت را بفهمیم؟](https://www.roote.ai/fa/guides/no-result-or-api-error-how-to-differentiate/)

## منشاء

اطلاعاتی که منبع داده را مشخص می‌کند و طبق قرارداد چگونگی تولیدش را شرح می‌دهد. کمک به تفسیر دامنه آن می‌کند.

مثال : نتیجه منبع و زمینه جمع‌آوری خود را حفظ می‌کند.

تعمیق در راهنما : [چگونه یک دستیار بسازیم که موقعیت‌های حمل و نقل اطراف یک آدرس را پیدا کند؟](https://www.roote.ai/fa/guides/chek-kardan-ye-dastgahi-ke-mobility-ha-ra-dar-hamkoli-ye-adress-peida-mikonad/)

## ارجاع

ذکر ارائه‌دهنده یا منبع داده. هنگامی که لازم است، تجربه‌ای که نتیجه را استفاده می‌کند باید آن را نمایش دهد.

مثال : ارجاع required=true باید در رابط حفظ شود.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## برنامه زمانی GTFS

قالب استاندارد توصیف برنامه حمل‌ونقل: ایستگاه‌ها، خطوط، سفرها، تقویم‌ها و عبورها. خودکار به‌روزرسانی لحظه‌ای ندارد.

مثال : عبورهای برنامه‌ریزی شده به سفرها و روزهای خدمات مرتبط‌اند.

تعمیق در راهنما : [GTFS، GTFS-RT و GBFS: چه تفاوت‌هایی وجود دارد؟](https://www.roote.ai/fa/guides/gtfs-gtfs-rt-va-gbfs-che-tafavotha/)

## GTFS Realtime — GTFS-RT

قالب استاندارد برای انتقال به‌روزرسانی مسیرها، مکان وسایل نقلیه و هشدارها. دسته‌بندی‌های منتشر شده به تولیدکننده بستگی دارد.

مثال : جریان موقعیت‌ها تضمین تخمین برای همه ایستگاه‌ها نیست.

تعمیق در راهنما : [GTFS، GTFS-RT و GBFS: چه تفاوت‌هایی وجود دارد؟](https://www.roote.ai/fa/guides/gtfs-gtfs-rt-va-gbfs-che-tafavotha/)

## GBFS

قالب استاندارد داده‌های عمومی حمل‌ونقل اشتراکی. بر اساس نسخه و فیدها سیستم‌ها، ایستگاه‌ها، وسایل نقلیه و وضعیتشان شرح داده می‌شود.

مثال : اطلاعات ایستگاه و شمارش دسترس‌ها جداگانه‌اند.

تعمیق در راهنما : [GTFS، GTFS-RT و GBFS: چه تفاوت‌هایی وجود دارد؟](https://www.roote.ai/fa/guides/gtfs-gtfs-rt-va-gbfs-che-tafavotha/)

## مقدار ناشناخته — null

عدم وجود مقدار شناخته شده در قراردادی که null را برای این منظور به کار می‌برد. نباید با صفر، خطا یا عدم وجود جایگزین شود.

مثال : شمارش دوچرخه null به معنی ایستگاه خالی نیست.

تعمیق در راهنما : [نتیجه‌ای نیست یا خطای API: چگونه تفاوت را بفهمیم؟](https://www.roote.ai/fa/guides/no-result-or-api-error-how-to-differentiate/)

## API

رابطی برای برنامه‌ها که قابلیت‌های سرویس دیگر را طبق قراردادی تعریف شده بهره‌برداری می‌کند. ورودی‌ها و پاسخ‌های مورد انتظار را مشخص می‌کند.

مثال : برنامه‌ای با API ROOTE ایستگاه‌ها را جستجو می‌کند.

تعمیق در راهنما : [API یا MCP: کدام را برای ادغام داده‌های حرکت انتخاب کنیم؟](https://www.roote.ai/fa/guides/api-ou-mcp-kodamanzar-data-harakat/)

## API REST

روش رابط HTTP که از منابع و سازوکارهای وب استفاده می‌کند. قرارداد API مسیرها، روش‌ها و واسطه‌ها را تعریف می‌کند.

مثال : درخواستی به مسیر GET تعریف شده ارسال می‌شود.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## اندپوینت — مسیر API

آدرس و عملیاتی که API برای قابلیت خاصی ارائه می‌دهد. مسیرهای متفاوت نتایج متفاوتی دارند.

مثال : /v1/transit/nearby مکان‌های حمل‌ونقل نزدیک را جستجو می‌کند.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## پارامتر پرس‌وجو

مقداری ارسال شده در بخش URL بعد از علامت سوال. نام و قالب آن توسط رابط مشخص می‌شود.

مثال : modes=bus,tram مدهای مختلف را در URL انتخاب می‌کند.

تعمیق در راهنما : [چگونه یک نقشه حرکت را در سایت خود ادغام کنیم؟](https://www.roote.ai/fa/guides/cheren-amalakahyeh-naghshe-dar-site/)

## وضعیت HTTP

کدی که نتیجه درخواست در سطح HTTP را نشان می‌دهد. باید با اعتبارسنجی محتوا و وضعیت کسب‌وکار همراه باشد.

مثال : کد ۲۰۰ ممکن است همراه با خطای کسب‌وکار باشد.

تعمیق در راهنما : [نتیجه‌ای نیست یا خطای API: چگونه تفاوت را بفهمیم؟](https://www.roote.ai/fa/guides/no-result-or-api-error-how-to-differentiate/)

## نتیجه خالی — empty

جستجویی که هیچ موجودیت در محدوده یافته ندارد. به معنی عدم وجود فیزیکی خدمات خارج از اطلاعات نیست.

مثال : هیچ ایستگاهی با فیلترهای داده شده بازنگردانده شد.

تعمیق در راهنما : [نتیجه‌ای نیست یا خطای API: چگونه تفاوت را بفهمیم؟](https://www.roote.ai/fa/guides/no-result-or-api-error-how-to-differentiate/)

## نتیجه جزئی — partial

نتیجه‌ای شامل اطلاعات قابل استفاده اما با محدویت‌ها یا کاستی‌های مشخص. باید هشدارهای مربوط همراه باشد.

مثال : یک منبع پاسخ می‌دهد ولی دیگری در دسترس نیست.

تعمیق در راهنما : [نتیجه‌ای نیست یا خطای API: چگونه تفاوت را بفهمیم؟](https://www.roote.ai/fa/guides/no-result-or-api-error-how-to-differentiate/)

## زمان تمام‌شده — timeout

وقفه در انتظار بیش از مدت مقرر برای عملیات. نشان‌دهنده جستجوی نیمه‌کاره است نه عدم وجود نتیجه.

مثال : اپلیکیشن پیشنهاد تلاش مجدد به جای نمایش لیست خالی می‌دهد.

تعمیق در راهنما : [نتیجه‌ای نیست یا خطای API: چگونه تفاوت را بفهمیم؟](https://www.roote.ai/fa/guides/no-result-or-api-error-how-to-differentiate/)

## محدودیت نرخ — rate limit

محدودیت سرعت درخواست‌ها توسط سرویس. قواعد بازیابی بستگی به قرارداد فعال دارد.

مثال : کد ۴۲۹ درخواست رعایت زمان‌بندی بازیابی را می‌دهد.

تعمیق در راهنما : [نتیجه‌ای نیست یا خطای API: چگونه تفاوت را بفهمیم؟](https://www.roote.ai/fa/guides/no-result-or-api-error-how-to-differentiate/)

## توکن دستیابی Bearer

شناسه دسترسی ارسال شده در هدر Authorization طبق روش تعریف شده. باید در تنظیمات امن نگهداری شود.

مثال : Authorization: Bearer بدون ارسال توکن در URL استفاده می‌شود.

تعمیق در راهنما : [چگونه دستیار هوش مصنوعی را به MCP ROOTE متصل کنیم؟](https://www.roote.ai/fa/guides/%DA%86%DA%AF%D9%88%D9%86%D9%87-%D8%AF%D8%B3%D8%AA%DB%8C%D8%A7%D8%B1-%D9%87%D9%88%D8%B4-%D9%85%D8%B5%D9%86%D9%88%D8%B9%DB%8C-%D8%B1%D8%A7-%D8%A8%D9%87-mcp-roote-%D9%88%D8%B5%D9%84-%DA%A9%D9%86%DB%8C%D9%85/)

## JSON

فرمت متنی ساخت‌یافته شامل شی، آرایه، رشته و عدد. JSON معتبر از نظر نحو ممکن است با طرح API مطابقت نداشته باشد.

مثال : مجموعه stations باید نوع و فیلدهای مورد انتظار را داشته باشد.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## OpenAPI

مشخصه‌ای برای توصیف قرارداد API HTTP در سندی ساخت‌یافته. به بررسی مسیر، پارامتر، پاسخ و طرح‌ها کمک می‌کند.

مثال : قرارداد ROOTE در openapi.json منتشر شده است.

تعمیق در راهنما : [چگونه با یک API ایستگاه‌های حمل‌ونقل نزدیک را جستجو کنیم؟](https://www.roote.ai/fa/guides/chegooneh-dar-jeostojoyi-estgahaye-naghdar-ba-api/)

## تعبیه — نقشه جاسازی شده

وارد کردن تجربه خارجی در صفحه مانند نقشه در iframe. پارامتر و مجوزها زمینه استفاده را تعیین می‌کنند.

مثال : یک iframe ROOTE دوچرخه‌های اطراف بوردو را نمایش می‌دهد.

تعمیق در راهنما : [چگونه یک نقشه حرکت را در سایت خود ادغام کنیم؟](https://www.roote.ai/fa/guides/cheren-amalakahyeh-naghshe-dar-site/)

## Iframe

عنصر HTML بارگیرنده سند در صفحه. در دامنه‌های مختلف صفحه والد نمی‌تواند وضعیت داخلی سند بارگذاری شده را آزاد بخواند.

مثال : تغییر جستجو نیاز به ارتباط مستند شده با والد دارد.

تعمیق در راهنما : [چگونه یک نقشه حرکت را در سایت خود ادغام کنیم؟](https://www.roote.ai/fa/guides/cheren-amalakahyeh-naghshe-dar-site/)

## MCP — پروتکل مدل زمینه

پروتکلی که به برنامه هوش مصنوعی اجازه می‌دهد با سرورهایی که ابزار یا زمینه ارائه می‌دهند ارتباط برقرار کند. به تنهایی کیفیت داده‌ها را تضمین نمی‌کند.

مثال : دستیار ابزارهای جستجوی ROOTE را کشف می‌کند.

تعمیق در راهنما : [سرور MCP چیست و چه کاربردی دارد؟](https://www.roote.ai/fa/guides/server-mcp-%DA%86%DB%8C%D8%B3%D8%AA-%D9%88-%DA%86%D9%87-%DA%A9%D8%A7%D8%B1%D8%A8%D8%B1%D8%AF%DB%8C-%D8%AF%D8%A7%D8%B1%D8%AF/)

## سرور MCP

برنامه‌ای که قابلیت‌ها را طبق MCP ارائه می‌دهد. ابزارهای ارائه شده توسط سرور تعیین کننده فراخوانی‌های ممکن مشتری است.

مثال : tools/list فهرست موجودی را نمایش می‌دهد.

تعمیق در راهنما : [سرور MCP چیست و چه کاربردی دارد؟](https://www.roote.ai/fa/guides/server-mcp-%DA%86%DB%8C%D8%B3%D8%AA-%D9%88-%DA%86%D9%87-%DA%A9%D8%A7%D8%B1%D8%A8%D8%B1%D8%AF%DB%8C-%D8%AF%D8%A7%D8%B1%D8%AF/)

## مشتری MCP

جزئی از برنامه هوش مصنوعی که با سرور MCP ارتباط دارد و تبادلات پروتکل را مدیریت می‌کند.

مثال : مشتری استدلال‌های جستجو را به ROOTE ارسال می‌کند.

تعمیق در راهنما : [سرور MCP چیست و چه کاربردی دارد؟](https://www.roote.ai/fa/guides/server-mcp-%DA%86%DB%8C%D8%B3%D8%AA-%D9%88-%DA%86%D9%87-%DA%A9%D8%A7%D8%B1%D8%A8%D8%B1%D8%AF%DB%8C-%D8%AF%D8%A7%D8%B1%D8%AF/)

## برنامه میزبان MCP

برنامه‌ای که تعامل با کاربر را مدیریت می‌کند و یک یا چند مشتری MCP را میزبانی می‌کند. مسئولیت استفاده نتایج بر عهده آن است.

مثال : برنامه مکالمه شما سرور ROOTE را متصل می‌کند.

تعمیق در راهنما : [سرور MCP چیست و چه کاربردی دارد؟](https://www.roote.ai/fa/guides/server-mcp-%DA%86%DB%8C%D8%B3%D8%AA-%D9%88-%DA%86%D9%87-%DA%A9%D8%A7%D8%B1%D8%A8%D8%B1%D8%AF%DB%8C-%D8%AF%D8%A7%D8%B1%D8%AF/)

## ابزار MCP

قابلیت اجرایی تعریف شده با نام، تابع و طرح ورودی. دستیار باید ورودی‌های مورد قبول این طرح را استفاده کند.

مثال : geocode یک آدرس و transit_nearby مختصات دریافت می‌کند.

تعمیق در راهنما : [چگونه دستیار هوش مصنوعی را به MCP ROOTE متصل کنیم؟](https://www.roote.ai/fa/guides/%DA%86%DA%AF%D9%88%D9%86%D9%87-%D8%AF%D8%B3%D8%AA%DB%8C%D8%A7%D8%B1-%D9%87%D9%88%D8%B4-%D9%85%D8%B5%D9%86%D9%88%D8%B9%DB%8C-%D8%B1%D8%A7-%D8%A8%D9%87-mcp-roote-%D9%88%D8%B5%D9%84-%DA%A9%D9%86%DB%8C%D9%85/)

## HTTP قابل جریان

حمل MCP که ارتباط با سرور از راه دور را از طریق HTTP ممکن می‌کند. پشتیبانی آن باید در مشتری بررسی شود.

مثال : سرور راه دور ROOTE از https://mcp.roote.ai/mcp استفاده می‌کند.

تعمیق در راهنما : [چگونه دستیار هوش مصنوعی را به MCP ROOTE متصل کنیم؟](https://www.roote.ai/fa/guides/%DA%86%DA%AF%D9%88%D9%86%D9%87-%D8%AF%D8%B3%D8%AA%DB%8C%D8%A7%D8%B1-%D9%87%D9%88%D8%B4-%D9%85%D8%B5%D9%86%D9%88%D8%B9%DB%8C-%D8%B1%D8%A7-%D8%A8%D9%87-mcp-roote-%D9%88%D8%B5%D9%84-%DA%A9%D9%86%DB%8C%D9%85/)

## پاسخ مبتنی بر داده — grounding

ساخت پاسخ بر اساس اطلاعات گرفته شده یا داده شده. فیلدهای گمشده و ابهامات باید مشخص باقی بمانند.

مثال : دستیار مکان‌های بازگردانده شده را بدون ساختن ساعات نقل می‌کند.

تعمیق در راهنما : [چگونه یک دستیار بسازیم که موقعیت‌های حمل و نقل اطراف یک آدرس را پیدا کند؟](https://www.roote.ai/fa/guides/chek-kardan-ye-dastgahi-ke-mobility-ha-ra-dar-hamkoli-ye-adress-peida-mikonad/)

## توهم دستیار هوش مصنوعی

تولید اطلاعات بی‌پایه که به عنوان داده واقعی ارائه می‌شود. در حمل‌ونقل ممکن است زمان یا دسترسی ساختگی باشد.

مثال : دستیار زمانی اعلام می‌کند در حالی که ابزار تنها ایستگاه را داده است.

تعمیق در راهنما : [چگونه یک دستیار بسازیم که موقعیت‌های حمل و نقل اطراف یک آدرس را پیدا کند؟](https://www.roote.ai/fa/guides/chek-kardan-ye-dastgahi-ke-mobility-ha-ra-dar-hamkoli-ye-adress-peida-mikonad/)

## تزریق درخواست

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

مثال : دستور مخفی در نام مکان نباید اجرا شود.

تعمیق در راهنما : [چگونه یک دستیار بسازیم که موقعیت‌های حمل و نقل اطراف یک آدرس را پیدا کند؟](https://www.roote.ai/fa/guides/chek-kardan-ye-dastgahi-ke-mobility-ha-ra-dar-hamkoli-ye-adress-peida-mikonad/)

## فقط خواندنی

توانایی مشاهده بدون تغییر توسط ابزار. خواندن دسترسی وسیله دوچرخه را رزرو، آزاد یا کرایه نمی‌کند.

مثال : ابزارهای داده‌ای ROOTE برای مشاهده اطلاعات هستند.

تعمیق در راهنما : [سرور MCP چیست و چه کاربردی دارد؟](https://www.roote.ai/fa/guides/server-mcp-%DA%86%DB%8C%D8%B3%D8%AA-%D9%88-%DA%86%D9%87-%DA%A9%D8%A7%D8%B1%D8%A8%D8%B1%D8%AF%DB%8C-%D8%AF%D8%A7%D8%B1%D8%AF/)