سرویس جستجوی مستقیم

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

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

• جستجوی ساده: آدرس‌های یک بخشی، دو بخشی و یا حداکثر تا بخش دوم آدرس چند بخشی را جستجو می‌کند. مانند : پردیس سینمایی آزادی، سازمان مدیریت و برنامه‌ریزی استان تهران، خیابان ولیعصر نبش مطهری. در آدرس‌های بیش از دو بخش مانند فاز ۱ شهرک غرب، خ. مهستان، بعد از بن هوافضا، خ. گلستان شمالی، ک. سیصد و چهار غربی، پلاک ۱۲، تنها فاز۱ شهرک غرب، خ. مهستان را جستجو می‌کند.

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

• جستجوی آدرس کامل: آدرس‌یابی پلاک‌دار و جستجوی آدرس‌های متنی دارای چهار جز و یا بیشتر را انجام می‌دهد. مانند: فاز ۱ شهرک غرب، خ. مهستان، بعد از بن هوافضا، خ. گلستان شمالی، ک. سیصد و چهار غربی، پلاک ۱۲. برای جستجوی آدرس کامل در این سرویس، آدرس‌ها باید به صورت تعاملی بر روی نقشه ارسال شوند.

اگر آدرس کامل به سرویس ارسال شود و کاربر جستجوی ساده و یا کوتاه را درخواست کند، جستجو به‌ترتیب تا بخش دوم و سوم آدرس انجام می‌شود.

برای جستجوی آدرس و مکان‌ها نیاز است تا کاربر یکی از تقسیمات کشوری شامل استان، شهرستان، بخش و یا شهری که جستجو باید در آن صورت گیرد را مشخص کند. به یکی از چهار روش‌ زیر می‌توان شهر و یا استان مورد نظر را تعیین کرد:

• ارسال کد مرکز آمار تقسیمات کشوری

• ارسال کد یکتای تقسیمات کشوری در سامانه پارسی‌مپ

• ارسال عنوان متنی تقسیمات کشوری به صورت تکی و یا ترکیبی (به عنوان مثال: شهر نایین و یا استان اصفهان شهر نایین )

• ارسال مختصات جغرافیایی

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

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

get
/geocode/forward?parameters

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

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

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

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

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

درخواست جستجوی ساده

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

https://api.parsimap.ir/geocode/forward?key=PMI_API_TOKEN&search_text=ملاصدرا، بیمارستان بقیه الله اعظم&district=10511133&only_in_district=true&subdivision=false&plate=false&request_id=false&search_precision=simple

نمونه پاسخ

{
  "results": [
    {
      "geo_location": {
        "south_west": {
          "lat": 35.753257,
          "lng": 51.392479
        },
        "north_east": {
          "lat": 35.756538,
          "lng": 51.396522
        },
        "center": {
          "lat": 35.754898,
          "lng": 51.394501
        },
        "title": "بیمارستان بقیه الله الاعظم",
        "category": "Poi"
      },
      "description": "تهران، ملاصدرا، بیمارستان بقیه الله الاعظم"
    }
  ],
  "search_type": "simple",
  "status": "OK"
}

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

درخواست جستجوی آدرس کوتاه

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

https://api.parsimap.ir/geocode/forward?key=PMI_API_TOKEN&search_text=خ. ولیعصر، بعد از بل میرداماد، خ. قبادیان غربی&district=10511133&only_in_district=true&subdivision=false&plate=false&request_id=false&search_precision=short_address

نمونه پاسخ

{
  "results": [
    {
      "geo_location": {
        "south_west": {
          "lat": 35.76228,
          "lng": 51.408073
        },
        "north_east": {
          "lat": 35.765925,
          "lng": 51.412565
        },
        "center": {
          "lat": 35.764102,
          "lng": 51.410319
        },
        "title": "خ. قبادیان غربی",
        "category": "Street"
      },
      "description": "تهران، خ. ولیعصر، بعد از بل میرداماد، خ. قبادیان غربی"
    }
  ],
  "search_type": "short_address",
  "status": "OK"
}

درخواست جستجوی آدرس کامل

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

https://api.parsimap.ir/geocode/forward?key=PMI_API_TOKEN&search_text=شهرآرا، خ ستارخان، بین خ کوثر و خ نیایش، خ افسر، پلاک 5 &district=10511133&only_in_district=true&subdivision=false&plate=true&request_id=false&search_precision=full_address

نمونه پاسخ

{
  "results": [
    {
      "geo_location": {
        "south_west": {
          "lat": 35.714179,
          "lng": 51.366528
        },
        "north_east": {
          "lat": 35.717461,
          "lng": 51.37057
        },
        "center": {
          "lat": 35.71582,
          "lng": 51.368549
        },
        "title": "پلاک 5",
        "category": "Parcel"
      }
    }
  ],
  "search_type": "full-address",
  "status": "OK"
}

درخواست جستجوی آدرس تنها در استان، شهرستان، بخش و یا شهر تعیین شده در ورودی

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

https://api.parsimap.ir/geocode/forward?key=PMI_API_TOKEN&search_text=گرگان م امام&district=10511133&only_in_district=true&subdivision=false&plate=false&request_id=false

نمونه پاسخ

{
  "results": [
    {
      "geo_location": {
        "south_west": {
          "lat": 35.702409,
          "lng": 51.443034
        },
        "north_east": {
          "lat": 35.71763,
          "lng": 51.458273
        },
        "center": {
          "lat": 35.71002,
          "lng": 51.451432
        },
        "title": "محله گرگان",
        "category": "Neighborhood"
      },
      "description": "تهران، محله گرگان"
    },
    {
      "geo_location": {
        "south_west": {
          "lat": 35.698945,
          "lng": 51.437426
        },
        "north_east": {
          "lat": 35.717603,
          "lng": 51.456496
        },
        "center": {
          "lat": 35.708339,
          "lng": 51.446989
        },
        "title": "خ. گرگان",
        "category": "Street"
      },
      "description": "تهران، خ. گرگان"
    },
    {
      "geo_location": {
        "south_west": {
          "lat": 35.71476,
          "lng": 51.453159
        },
        "north_east": {
          "lat": 35.718406,
          "lng": 51.457643
        },
        "center": {
          "lat": 35.716449,
          "lng": 51.455581
        },
        "title": "م. گرگان",
        "category": "Street"
      },
      "description": "تهران، نظام آباد، م. گرگان"
    }
  ],
  "search_type": "simple",
  "status": "OK"
}

درخواست تبدیل آدرس متنی به مختصات به‌ همراه ارائه تقسیمات کشوری

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

https://api.parsimap.ir/geocode/forward?key=PMI_API_TOKEN&search_text=پاساژ آسمان ونک&district=10511133&only_in_district=true&subdivision=true&plate=false&request_id=false

نمونه پاسخ

{
  "results": [
    {
      "geo_location": {
        "south_west": {
          "lat": 35.756365,
          "lng": 51.40624
        },
        "north_east": {
          "lat": 35.76001,
          "lng": 51.410732
        },
        "center": {
          "lat": 35.758187,
          "lng": 51.408486
        },
        "title": "مرکز خرید آسمان ونک",
        "category": "Poi"
      },
      "description": "تهران، مرکز خرید آسمان ونک",
      "subdivision": {
        "id": 10511133,
        "title": "شهر تهران",
        "code": "2301021576",
        "type": "shahr"
      }
    }
  ],
  "search_type": "simple",
  "status": "OK"
}

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