کجامجا
API نقشه‌ی ایران برای سایت و اپلیکیشن
نقشه‌ی برداری کل ایران با نام‌های فارسی را با چند خط کد در سایت یا اپ خود نمایش دهید؛ میزبانی کامل در داخل ایران.
با API نقشه‌ی کجامجا چه می‌گیرید؟
API نقشه‌ی کجامجا یک نقشه‌ی آماده و کامل از ایران به سایت یا اپلیکیشن شما می‌دهد. نقشه برداری است، یعنی در هر بزرگ‌نمایی واضح می‌ماند، سبک است و می‌توانید رنگ و ظاهرش را با برند خودتان هماهنگ کنید.
نقشه‌ی برداری کل ایران
خیابان‌ها، کوچه‌ها، ساختمان‌ها، مرزها و نام‌های فارسی، از نمای کشور تا سطح کوچه.
لایه‌ی حمل‌ونقل عمومی
خطوط و ایستگاه‌های مترو و اتوبوس و محدوده‌های طرح ترافیک و زوج و فرد.
جزئیات خیابان
فلش خیابان‌های یک‌طرفه، پل‌ها و زیرگذرها با نمایش جدا.
انگلیسی و دوزبانه
نام‌ها به انگلیسی یا فارسی و انگلیسی با هم، به‌صورت افزونه؛ مناسب گردشگری و هتل‌ها.
میزبانی داخل ایران
همه‌ی سرورها در ایران‌اند و نقشه به اینترنت بین‌المللی وابسته نیست.
شمارش منصفانه
هر بار باز شدن نقشه فقط یک درخواست است؛ کاشی‌ها، فونت‌ها و آیکون‌ها شمرده نمی‌شوند.
برای چه کسب‌وکارهایی مناسب است؟
- املاک و آگهی: نمایش موقعیت ملک و جست‌وجوی آگهی روی نقشه.
- فروشگاه‌ها و برندهای چندشعبه‌ای: صفحه‌ی «شعبه‌های ما» و نزدیک‌ترین شعبه.
- تاکسی اینترنتی، پیک و باربری: انتخاب مبدأ و مقصد و نمایش راننده روی نقشه.
- گردشگری، هتل و اقامتگاه: نقشه‌ی دوزبانه برای مسافر خارجی.
- ردیابی ناوگان و سازمان‌ها: نمایش خودروها و محدوده‌ها روی نقشه‌ی داخلی.
شروع در سه قدم
- در کجامجا ثبت‌نام کنید و از پنل من یک کلید API بسازید. می‌توانید کلید را به دامنه‌ی سایت خودتان قفل کنید.
- کتابخانه‌ی متن‌باز MapLibre GL JS را به صفحه اضافه کنید.
- نقشه را با نشانی سبک کجامجا بسازید:
const map = new maplibregl.Map({
container: 'map',
style: 'https://api.kojamoja.ir/style.json',
center: [51.389, 35.6892],
zoom: 11,
transformRequest: (url) => ({ url, headers: { 'x-api-key': 'YOUR_KEY' } }),
})
برای نقشه‌ی انگلیسی /style.json?lang=en و برای دوزبانه /style.json?lang=bi را بگذارید. جزئیات بیشتر در امکانات و مستندات است.
پرسش‌های پرتکرار
آیا API نقشه‌ی کجامجا رایگان است؟
بله، یک پلن رایگان برای شروع و آزمایش دارد و برای مصرف بیشتر پلن‌های ماهانه و سالانه هست. سهمیه و قیمت هر پلن در صفحه‌ی قیمت‌گذاری آمده است.
اگر اینترنت بین‌المللی قطع شود، نقشه کار می‌کند؟
بله. نقشه، فونت‌ها و همه‌ی سرویس‌ها روی سرورهای داخل ایران میزبانی می‌شوند و به هیچ سرویس خارجی وابسته نیستند.
با چه کتابخانه‌ای کار می‌کند؟
با MapLibre GL JS که متن‌باز و رایگان است. در وب، وب‌اپ (PWA) و اپ‌هایی که صفحه‌ی وب را نمایش می‌دهند قابل استفاده است.
می‌توانم نشانگرها و داده‌های خودم را روی نقشه بگذارم؟
بله. نقشه پس‌زمینه است و شما هر نشانگر، خط مسیر یا محدوده‌ای را که بخواهید با همان کتابخانه روی آن می‌کشید.
داده‌ی نقشه از کجاست؟
از OpenStreetMap که به‌طور دوره‌ای به‌روز می‌شود. نام «خلیج فارس» همیشه درست نمایش داده می‌شود.