سرویس آدرس‌یابی معکوس

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

قابلیت‌های سرویس

ساختار کلی سرویس

get
/geocode/reverse?parameters

پارامترهای ورودی

پارامترهای مورد نیاز

پارامترهای اختیاری

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

نمونه درخواست

درخواست تبدیل موقعیت جغرافیایی به آدرس نوشتاری

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

https://api.parsimap.ir/geocode/reverse?key=PMI_API_TOKEN&location=51.43401,35.82256&local_address=false&approx_address=false&subdivision=false&plate=false&request_id=false

نمونه پاسخ

{
  "address": "نیاوران، گلاب دره، خ. زبردست شمابی، خ. شکیبایی، ک. پناهی",
  "subdivision_prefix": "تهران",
  "status": "OK"
}

پارامترهای خروجی

درخواست آدرس محلی

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

https://api.parsimap.ir/geocode/reverse?key=PMI_API_TOKEN&location=51.43401,35.82256&local_address=true&approx_address=false&subdivision=false&plate=false&request_id=false

نمونه پاسخ

{
  "address": "نیاوران، گلاب دره، خ. زبردست شمابی، خ. شکیبایی، ک. پناهی",
  "subdivision_prefix": "تهران",
  "local_address": "خ. زبردست شمابی، خ. شکیبایی، ابتدای ک. پناهی",
  "status": "OK"
}

پارامترهای خروجی

درخواست آدرس تقریبی

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

https://api.parsimap.ir/geocode/reverse?key=PMI_API_TOKEN&location=51.43401,35.82256&local_address=false&approx_address=true&subdivision=false&plate=false&request_id=false

نمونه پاسخ

{
  "address": "نیاوران، گلاب دره، خ. زبردست شمابی، خ. شکیبایی، ک. پناهی",
  "subdivision_prefix": "تهران",
  "approximate_address": "نیاوران، گلاب دره، خ. زبردست شمابی",
  "status": "OK"
}

پارامترهای خروجی

درخواست تعیین محدوده‌

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

https://api.parsimap.ir/geocode/reverse?key=PMI_API_TOKEN&location=51.43401,35.82256&local_address=false&approx_address=false&subdivision=false&geofence_types=9101,9100&plate=false&request_id=false

نمونه پاسخ

{
  "address": "نیاوران، گلاب دره، خ. زبردست شمابی، خ. شکیبایی، ک. پناهی",
  "subdivision_prefix": "تهران",
  "geofences": [
    {
      "id": 43100100000021,
      "title": "گلاب دره",
      "type": "9101"
    },
    {
      "id": 32100100000001,
      "title": "شهرداری منطقه یک",
      "type": "9100"
    }
  ],
  "status": "OK"
}

پارامترهای خروجی

درخواست تقسیمات کشوری

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

https://api.parsimap.ir/geocode/reverse?key=PMI_API_TOKEN&location=51.43401,35.82256&local_address=true&approx_address=true&subdivision=true&plate=false&request_id=false

نمونه پاسخ

{
  "address": "نیاوران، گلاب دره، خ. زبردست شمابی، خ. شکیبایی، ک. پناهی",
  "subdivision_prefix": "تهران",
  "local_address": "خ. زبردست شمابی، خ. شکیبایی، ابتدای ک. پناهی",
  "approximate_address": "نیاوران، گلاب دره، خ. زبردست شمابی",
   "subdivisions": {
    "ostan": {
      "id": 1001,
      "title": "تهران",
      "code": "23",
      "type": "ostan"
    },
    "shahrestan": {
      "id": 100108,
      "title": "شمیرانات",
      "code": "2304",
      "type": "shahrestan"
    },
    "bakhsh": {
      "id": 10410167,
      "title": "رودبارقصران",
      "code": "230401",
      "type": "bakhsh"
    },
    "shahr": {
      "id": 10511133,
      "title": "تهران",
      "code": "2301021576",
      "type": "shahr"
    }
  },
  "status": "OK"
}

پارامترهای خروجی