سرویس پوشش شبکه موبایل: آنتن ایرانسل و همراه اول در هر نقطه، محدوده و مسیر

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

برای دریافت توکن کیف پول را شارژ کنید و در توکن‌های API توکن بسازید.

۱. پوشش در یک نقطه

curl -G "https://cloud.geotajak.ir/api/geo/coverage/point" \
  --data-urlencode "place=اصفهان" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "summary": "اصفهان: ایرانسل 4G (و 3G)، همراه اول 3G.",
  "has_coverage": true,
  "best_technology": "4G",
  "operators": {
    "irancell": {"name": "ایرانسل", "best": "4G", "covered": ["3G", "4G"],
                 "technologies": {"2G": {"status": "not_covered", "nearest_coverage_km": 1.4},
                                  "4G": {"status": "covered"}}},
    "mci": {"name": "همراه اول", "best": "3G", "covered": ["3G"]}
  }
}

وضعیت هر نسل یکی از این‌هاست:

۲. درصد پوشش یک محدوده

curl -G "https://cloud.geotajak.ir/api/geo/coverage/area" \
  --data-urlencode "place=چابهار" --data-urlencode "radius_km=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

radius_km بین ۰٫۵ تا ۵۰ کیلومتر. برای هر اپراتور درصد سطح دارای پوشش با هر نسل (covered_pct)، بدون پوشش و نامعلوم، و درصد سطحی که با حداقل یک نسل پوشش دارد (any_technology_pct).

۳. پوشش در طول مسیر

curl -G "https://cloud.geotajak.ir/api/geo/coverage/route" \
  --data-urlencode "from_place=اصفهان" --data-urlencode "to_place=شیراز" \
  -H "Authorization: Bearer YOUR_TOKEN"

مبدا و مقصد را با from_place/to_place یا from_lat، from_lon، to_lat، to_lon بدهید (profile: auto خودرو، pedestrian پیاده). سرویس مسیر جاده‌ای را پیدا می‌کند و در فاصله‌های منظم پوشش را می‌سنجد:

• covered_pct: درصد طول مسیر با پوشش هر نسل؛
• gaps: قطعی‌ها با کیلومتر شروع و پایان، طول و مختصات (به ترتیب طولانی‌ترین)؛
• longest_gap_km: طولانی‌ترین قطعی؛ مناسب برنامه‌ریزی ارتباط تیم‌های امداد و ناوگان.

۴. نقشه پوشش

curl -G "https://cloud.geotajak.ir/api/geo/coverage/map" \
  --data-urlencode "bbox=51.5,32.5,51.9,32.8" --data-urlencode "operator=irancell" --data-urlencode "tech=4G" \
  -H "Authorization: Bearer YOUR_TOKEN"

خروجی GeoJSON است و مستقیم روی MapLibre، Leaflet یا OpenLayers نمایش داده می‌شود. bbox به شکل غرب،جنوب،شرق،شمال و حداکثر ۴ درجه مربع؛ operator (irancell، mci) و tech اختیاری‌اند.

منبع داده و محدودیت‌ها

پوشش بر اساس نقشه‌های پیش‌بینی پوشش اپراتورها است (برای همراه اول: سطح سیگنال بهتر از ۱۰۰- دسی‌بل‌میلی‌وات). این نقشه‌ها پیش‌بینی مهندسی هستند و ممکن است در داخل ساختمان، دره‌ها یا هنگام قطعی برق و ازدحام با واقعیت تفاوت داشته باشند. در محدوده‌هایی که داده اپراتور در اختیار نیست، پاسخ «داده موجود نیست» (unknown) است، نه «بدون پوشش».

نمایش آماده در سایت (بدون کدنویسی)

اگر به آدرس همین سرویس ui=true اضافه کنید، به‌جای JSON یک صفحه آماده (نقشه، نمودار و جدول نتیجه) برمی‌گردد که در <iframe> سایت شما قرار می‌گیرد و با رنگ‌های توکن شما ساخته می‌شود. هزینه آن با درخواست معمولی یکی است. جزئیات در راهنمای شروع و نمونه زنده در «آزمایشگاه سرویس» صفحه هر سرویس.

خطاها

---

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