لوگوی سه کلمهسه کلمه

سه کلمه برای کسب‌وکارها

مقصد هر سفارش را با سه کلمه مشخص کنید

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

راهنمای اتصال به API

نشانی پستی، پلاک و توضیحات ورودی را کنار آدرس سه کلمه‌ای نگه دارید.

از یک خانه تا سه کلمه

نمونه تعاملی

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

تهران چند خانه مجاور شمال
انتخاب خانه در نمونه سه کلمه
هر خانه، یک آدرسدر حال آماده‌سازی خانه‌ها…

آدرس خانه انتخاب‌شده

باز کردن نقشه بدون ثبت سفارش

آدرس‌ها از سرویس دریافت می‌شوند؛ این نمونه برای مسیریابی یا ثبت سفارش نیست.

از ثبت مقصد تا تحویل سفارش

از مشتری تا پشتیبانی و تیم ارسال، همه باید بدانند مقصد دقیقاً کجاست.

پیک و حمل‌ونقل

ورودی یا محل تحویل را با مشتری روی نقشه مشخص کنید و سه کلمه آن را همراه نشانی، پلاک و توضیحات ورودی به راننده بدهید. راننده با باز کردن سه کلمه می‌تواند مستقیماً در برنامه‌های مسیریاب (نشان، بلد یا گوگل‌مپ) به ورودی دقیق ساختمان یا محل پارک هدایت شود.

درخواست بررسی این کاربرد

فروشگاه‌های اینترنتی

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

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

هزینه استفاده از API

هزینه ماهانه را پیش از اتصال برآورد کنید

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

برآورد هزینه API

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

نوع تبدیل
۱۰۰٬۰۰۰درخواست / ماه

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

امکان محاسبه آنلاین تا سقف ۱۰۰٬۰۰۰٬۰۰۰ درخواست در ماه وجود دارد.

برآورد ماهانه با تعرفه پلکانی

۹٬۱۰۰٬۰۰۰ تومان / ماه

۱۰۰٬۰۰۰ درخواست در ماه برای تبدیل مختصات به سه کلمه

هزینه با نرخ پله اول، برای مقایسه
۱۰٬۰۰۰٬۰۰۰ تومان
هزینه با تعرفه پلکانی
۹٬۱۰۰٬۰۰۰ تومان

مصرف انتخابی به فرم درخواست منتقل می‌شود؛ ارسال آن پس از تکمیل فرم انجام می‌شود. این مبلغ برآورد است، نه صورتحساب. مالیات و پشتیبانی در پیشنهاد نهایی مشخص می‌شوند. مصرف صفر به معنی دسترسی رایگان به API سازمانی نیست.

جزئیات تعرفه پلکانی

ورود به پله بالاتر، هزینه درخواست‌های قبلی را تغییر نمی‌دهد

بازه مصرف ماهانهنرخ هر ۱٬۰۰۰ درخواستبرآورد این پله
۱ تا ۱۰٬۰۰۰ درخواست۱۰۰٬۰۰۰ تومان۱٬۰۰۰٬۰۰۰ تومان
۱۰٬۰۰۱ تا ۱۰۰٬۰۰۰ درخواست۹۰٬۰۰۰ تومان۸٬۱۰۰٬۰۰۰ تومان
۱۰۰٬۰۰۱ تا ۱٬۰۰۰٬۰۰۰ درخواست۸۰٬۰۰۰ تومان—
۱٬۰۰۰٬۰۰۱ تا ۱۰٬۰۰۰٬۰۰۰ درخواست۶۰٬۰۰۰ تومان—
بیش از ۱۰٬۰۰۰٬۰۰۰ درخواست۵۰٬۰۰۰ تومان—

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

اجرای آزمایشی API

برای بررسی فنی و امتحان کردن سرویس با تعداد مشخصی درخواست.

  • تعیین کاربرد و هدف آزمایش
  • هماهنگی دسترسی و ظرفیت
  • بررسی نتیجه پیش از استفاده گسترده
درخواست اجرای آزمایشی

یکپارچه‌سازی سازمانی

برای استفاده روزمره در سامانه شما، با ظرفیت و پشتیبانی متناسب با نیازتان.

  • برآورد هزینه براساس مصرف
  • تعیین تعهدات پشتیبانی در قرارداد
  • هماهنگی اتصال به سامانه فعلی
استعلام قیمت سازمانی

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

نمونه کاربرد آموزشی

پیش از گسترش، در کار روزمره امتحان کنید

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

اجرای آزمایشی را چطور شروع کنید؟

  1. محدوده کار: یک گروه سفارش، مسیر یا تیم را انتخاب کنید.
  2. مقایسه: نتیجه را با عملکرد فعلی در شرایط مشابه بسنجید.
  3. گام بعد: براساس نتیجه، درباره ادامه یا تغییر روش تصمیم بگیرید.
  • تماس برای پیدا کردن مقصد
  • تحویل موفق در تلاش اول
  • زمان رسیدن به نقطه تحویل

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

اجرای آزمایشی، معرفی محصول یا استعلام قیمت

درخواست همکاری با سه کلمه

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

اطلاعات درخواست همکاری
موضوع درخواست شما
جزئیات بیشتر (اختیاری)

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

ترجیح می‌دهید مستقیم با تیم تجاری گفتگو کنید؟

پاسخگویی شنبه تا چهارشنبه، ۹ تا ۱۸

راهنمای تیم فنی

سه کلمه را به سامانه خود وصل کنید

مختصات را به سه کلمه تبدیل کنید یا با سه کلمه، مختصات را بگیرید. درخواست‌ها را از سرور خود بفرستید تا کلید API در مرورگر قرار نگیرد.

  1. ۱

    کاربرد و میزان مصرف را مشخص کنید

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

  2. ۲

    API را به سرور خود وصل کنید

    درخواست‌ها با HTTP ارسال می‌شوند و پاسخ‌ها JSON هستند. کلید API را روی سرور نگه دارید، نه در مرورگر یا کد اپلیکیشن.

  3. ۳

    آدرس را به سفارش اضافه کنید

    از مشتری بخواهید نقطه را روی نقشه تأیید کند. نشانی پستی و روش فعلی ثبت آدرس را هم برای زمان اختلال سرویس حفظ کنید.

  4. ۴

    ابتدا در مقیاس کوچک امتحان کنید

    کار را با چند سفارش یا یک تیم شروع کنید. پیش از گسترش، نتیجه، هزینه و ظرفیت موردنیاز را بررسی کنید.

نمونه کد و راهنمای خطاهای API
انتخاب نوع تبدیل API

GET /v1/convert/to-3wa

در پارامتر coordinates، ابتدا عرض جغرافیایی و سپس طول جغرافیایی را بنویسید و آن‌ها را با ویرگول جدا کنید.

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

کد درخواست:

curl --get 'https://api.3kalame.ir/v1/convert/to-3wa' \
  --data-urlencode 'coordinates=35.7219,51.3347' \
  --header "X-API-Key: $THREE_KALAME_API_KEY"

نمونه پاسخ JSON

این پاسخ فقط ساختار JSON را نشان می‌دهد. تطابق مختصات و سه کلمه این مثال تأیید نشده است؛ برای دریافت آدرس واقعی، نمونه تعاملی را امتحان کنید.

{
  "success": true,
  "data": {
    "words": "سلام.دریا.باد"
  }
}

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

خواندن مستندات API

برای خطای 400، ورودی را بررسی کنید. در خطاهای 401 / 403، کلید، مجوزها و سهمیه را بررسی کنید. اگر پاسخ 429 / 503 هدر Retry-After دارد، پیش از تلاش دوباره به همان اندازه صبر کنید و تعداد تلاش‌ها را محدود نگه دارید.

شرایط همکاری و پشتیبانی

طرف همکاری شما

شرکت دانش‌بنیان ایده‌پردازان ناظر اول کیفیت

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

امنیت کلید و اطلاعات شما

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

حریم خصوصی
جزئیات تعهدات پشتیبانی (SLA)

میزان دسترس‌پذیری و زمان پاسخ‌گویی در قرارداد هر کسب‌وکار مشخص می‌شود. پشتیبانی شبانه‌روزی یا سطح مشخصی از دسترس‌پذیری، بدون توافق قبلی تضمین نمی‌شود.

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

پرسش‌های متداول

چه تفاوتی با ارسال لوکیشن یا پین نقشه دارد؟

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

آیا API هم مثل ابزار عمومی رایگان است؟

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

آیا آدرس سه کلمه‌ای جای نشانی پستی را می‌گیرد؟

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

اگر نقطه یا سه کلمه اشتباه وارد شود چه می‌شود؟

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

برای درخواست همکاری چه اطلاعاتی لازم است؟

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

با تغییر نسخه سرویس، آدرس‌های قبلی چه می‌شوند؟

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

می‌خواهید کاربرد سه کلمه را برای کسب‌وکارتان بررسی کنید؟

درخواست معرفی محصول

حساب کاربری

خروج از حساب

آیا می‌خواهید از حساب کاربری خارج شوید؟

برای دسترسی دوباره به آدرس‌های ذخیره‌شده، باید مجدداً وارد شوید.