مصرف و صورت‌حساب
هر درخواست چطور شمرده می‌شود، تعرفه و سهم رایگان ماهانه، کسر از کیف پول، سقف هزینه و گزارش مصرف.
واحد مصرف
هر درخواستی که سرویس واقعا پاسخ داده یک یا چند واحد مصرف دارد: هر کاشی یک واحد، هر جست‌وجو یک واحد، هر ماتریس به تعداد خانه‌هایش. پاسخ از کش هم واحد دارد چون سرویس را گرفته‌اید.
- درخواست رد‌شده (کلید نامعتبر، دامنه غیرمجاز، سقف نرخ) و خطاهای ۴xx و ۵xx هیچ واحدی ندارند.
- فونت، آیکن، افزونه فارسی، کیت توسعه و وضعیت سرویس همیشه رایگان‌اند.
- جدول دقیق واحد هر مسیر نقشه در محدودیت‌ها و هزینه نقشه است.
تعرفه و سهم رایگان
تعرفه‌ها زنده از فهرست قیمت نمایک خوانده می‌شوند. سهم رایگان هر ماه از اول ماه شمسی تازه می‌شود.
| سرویس | تعرفه | رایگان در ماه |
|---|---|---|
کاشی نقشهmaps.tiles | 50 تومان برای هر 1٬000 درخواست | 200 درخواست |
سبک نقشه و TileJSONmaps.style | 500 تومان برای هر 1 درخواست | — |
پیشنهاد خودکارmaps.autocomplete | 50 تومان برای هر 1 درخواست | 50٬000 درخواست |
جستجوmaps.search | 50 تومان برای هر 1 درخواست | 10٬000 درخواست |
تبدیل نشانی به مختصاتmaps.geocode | 100 تومان برای هر 1 درخواست | 10٬000 درخواست |
تبدیل مختصات به نشانیmaps.reverse | 20 تومان برای هر 1 درخواست | 20٬000 درخواست |
مسیریابیmaps.route | 500 تومان برای هر 1٬000 درخواست | 5٬000 درخواست |
ماتریس فاصلهmaps.matrix | 50 تومان برای هر 1٬000 خانه ماتریس | 10٬000 خانه ماتریس |
تصویر ثابت نقشهmaps.static | 300 تومان برای هر 1٬000 درخواست | 5٬000 درخواست |
پیش نمایش ویرایشگر سبکmaps.editor | رایگان | — |
فضای نگهداری پشتیبانbackup.storage | 3٬000 تومان برای هر 747٬520 مگابایت‌ساعت | 747٬520 مگابایت‌ساعت |
دانلود و بازگردانیbackup.egress | 1٬000 تومان برای هر 1٬073٬741٬824 بایت | 5٬368٬709٬120 بایت |
دریافت مستقیم از پایگاه دادهbackup.direct_ingest | رایگان | — |
کیف پول و کسر هزینه
مصرف هر ساعت جمع و پس از کسر سهم رایگان، هزینه‌اش از کیف پول کم می‌شود. محاسبه با دقت میکروتومان انجام و کسری‌های زیر یک تومان به ساعت بعد منتقل می‌شود؛ هیچ مبلغی گرد و گم نمی‌شود. هر کسر در دفتر کیف پول با شرح ساعت و سرویس ثبت می‌شود و ردیف‌های مصرف تغییرناپذیرند.
سقف هزینه
برای هر پروژه سقف هزینه روزانه و ماهانه بگذارید و انتخاب کنید پس از پر شدن، سرویس متوقف شود (SPEND_CAP_REACHED) یا فقط هشدار بگیرید. بالا بردن سقف تایید دوباره هویت می‌خواهد.
توقف و بازگشت سرویس
اگر موجودی کافی نباشد، بدهی ثبت و پس از مهلت کوتاه سرویس متوقف می‌شود (ACCOUNT_SUSPENDED، HTTP 402). با شارژ کیف پول بدهی تسویه و سرویس فورا فعال می‌شود؛ رویدادهای billing.outstanding_created، billing.suspended و billing.unsuspended هم فرستاده می‌شوند. سرور شما وضعیت لحظه‌ای را از GET /v1/billing/summary می‌خواند.
گزارش مصرف
گزارش مصرف در پنل هست و با کلید محرمانه از GET /v1/usage هم در دسترس است. اعداد مصرف رشته‌اند چون ممکن است از بزرگ‌ترین عدد امن جاوااسکریپت بیشتر شوند.
| پارامتر | نوع | لزوم | پیش‌فرض | توضیح |
|---|---|---|---|---|
from | YYYY-MM-DD | لازم | — | روز شروع به تقویم میلادی و ساعت تهران. |
to | YYYY-MM-DD | لازم | — | روز پایان (شامل)؛ ساعتی تا ۷ روز و روزانه تا ۴۰۰ روز. |
granularity | hour | day | لازم | — | دانه‌بندی سری. |
services | csv | اختیاری | — | تا ۱۶ سرویس، مثلا maps.tiles,maps.search. |
keyId | uuid | اختیاری | — | فقط مصرف یک کلید از همین پروژه. |
curl -sS "https://api.namayek.com/v1/usage?from=2026-10-01&to=2026-10-23&granularity=day&services=maps.tiles,maps.search" \ -H "X-Namayek-Key: $NAMAYEK_SECRET_KEY"| فیلد | نوع / مقدار | توضیح |
|---|---|---|
points[] | { t, service, units } | t زمان شروع بازه به ISO؛ units رشته عددی (ممکن است از 2^53 بزرگ‌تر شود). |
totals[] | { service, units } | جمع هر سرویس در بازه. |
freshness.foldedUntil | ISO 8601 | تا این دقیقه کامل شمرده شده است. |
آخرین به‌روزرسانی: