سرویس تطبیق آدرس
سرویس تطبیق آدرس، انطباق بین دو آدرس متنی، آدرس متنی و کد پستی، آدرس متنی و موقعیت جغرافیایی و یا کدپستی و موقعیت جغرافیایی را بررسی می‌کند و نتیجه مقایسه را در پاسخ برمی‌گرداند. این سرویس می‌تواند دو آدرس مجزا از یک موقعیت را یکسان و منطبق برهم تشخیص دهد. مقایسه بین دو آدرس متنی و آدرس با کدپستی تا سطح واحد انجام می‌شود. دو آدرس متنی و یا آدرس و کدپستی به سرویس ارسال می‌شوند و سرویس در پاسخ مقایسه بین خیابان، پلاک و واحد آن‌ها را برمی‌گرداند. مقایسه بین آدرس و موقعیت جغرافیایی تا سطح پلاک انجام می‌گیرد.
قابلیت‌های سرویس
| بررسی انطباق بین دو آدرس متنی دارای پلاک و واحد. |
| بررسی انطباق بین آدرس متنی و کدپستی تا سطح واحد. |
| بررسی انطباق بین آدرس متنی و موقعیت جغرافیایی تا سطح پلاک. |
| بررسی انطباق بین کدپستی و موقعیت جغرافیایی تا سطح پلاک. |
ساختار کلی سرویس
get/parcel/address-comparison?parameters
پارامترهای ورودی
پارامترهای مورد نیاز
| پارامتر | توضیحات |
|---|---|
search_text_1 |
متن آدرس و یا کدپستی اول است. |
search_text_2 |
متن آدرس، کدپستی و یا موقعیت جغرافیایی دومی است. سرویس میزان انطباق بین این پارامتر با search_text_1 را تعیین می‌کند. |
district |
استان، شهرستان، بخش و یا شهری که آدرس‌ها به آن تعلق دارند را مشخص می‌کند. برای تعیین آن می‌توان یکی از چهار روش زیر را استفاده کرد:
|
پارامترهای اختیاری
پارامترهای اختیاری آپشن‌ها و امکانات مختلف سرویس را ارائه می‌دهند. ارسال آن‌ها جهت استفاده از سرویس اجباری نیست.
| پارامتر | توضیحات | مقدار پیش‌فرض |
|---|---|---|
| request_id | در صورت ست شدن پارامتر فوق، به صورت یکتا در روز می‌توان برای پیگیری استفاده نمود. | به صورت پیش‌فرض، عدم پیگیری در روز است. |
نمونه درخواست
درخواست بررسی انطباق بین دو آدرس متنی دارای پلاک و واحد
با ارسال دو آدرس متنی دارای پلاک و واحد و تعیین یکی از تقسیمات کشوری شامل استان، شهرستان، بخش و یا شهرستانی که آدرس‌ها به آن تعلق دارند، انطباق بین آدرس‌ها در پاسخ برگردانده می‌شود.
https://api.parsimap.ir/parcel/address-comparison?key=PMI_API_TOKEN&search_text_1=سعادت اباد خ 23 خ گل پلاک 4 واحد سه غربی&search_text_2=صرافهای جنوبی خ 25 خ گل پ چهار واحد 3 غربی&district=تهران&request_id=false
نمونه پاسخ
{
"same_street": true,
"same_plate": true,
"same_unit": true,
"distance": 0,
"certainty": 100,
"address_comparison_type": "AddressWithAddress",
"status": "OK"
}
پارامترهای خروجی
| پارامتر | توضیحات |
|---|---|
same_street |
انطباق بین خیابان و یا کوچه انتهایی آدرس‌ها را مشخص می‌کند. اگر آدرس‌ها متعلق به یک معبر (خیابان، کوچه و یا بن‌بست) باشند، این پارامتر true را برمی‌گرداند. در صورتیکه آدرس‌ها متعلق به یک خیابان (کوچه و یا بن‌بست) نباشند، این پارامتر false را برمی‌گرداند که به معنای یکسان نبودن و عدم تطبیق دو آدرس است. |
same_plate |
انطباق بین پلاک‌ها در دو آدرس را مشخص می‌کند. درصورتیکه آدرس‌ها مربوط به یک معبر (خیابان، کوچه و یا بن‌بست) و دارای پلاک یکسانی باشند، این پارامتر true را برمی‌گرداند. اگر پلاک دو آدرس فوق یکی نباشد، این پارامتر false را برمی‌گرداند که به معنای عدم تطابق پلاک دو آدرس است. |
same_unit |
انطباق بین واحدها در دو آدرس را بیان می‌کند. اگر آدرس‌ها متعلق به یک معبر(خیابان، کوچه و یا بن‌بست) و پلاک باشند و واحد یکسانی نیز داشته باشند، این پارامتر true را برمی‌گرداند. در صورتیکه واحد دو آدرس یکی نباشد، این پارامتر false را برمی‌گرداند که به معنای عدم تطابق واحد آدرس‌ها است. |
distance |
فاصله بین معبرهای (خیابان، کوچه و یا بن‌بست) دو آدرس بر حسب متر است. اگر آدرس‌ها متعلق به یک معبر باشند، این پارامتر صفر را برمی‌گرداند. درصورتیکه معبر دو آدرس متفاوت باشد، فاصله بین آن‌ها را به متر برمی‌گرداند. |
certainty |
میزان صحت نتیجه تطابق‌سنجی را نشان می‌دهد. برای مثال certainty این درخواست 100 است که به معنی صحت کامل و اطمینان صددرصد نتیجه بدست آمده است. |
address_comparison_type |
نوع تطبیق انجام شده را نشان می‌دهد. در این مثال آدرس متنی با هم مقایسه شده اند و نوع تطبیق AddressWithAddress است. |
status |
نتیجه درخواست را نشان می‌دهد. برای مثال نتیجه این درخواست OK است که به معنی موفق بودن درخواست است. نتیجه پاسخ به درخواست ارسالی توسط کاربر در قالب جدول زیر ارائه شده است: جدول |
درخواست بررسی انطباق بین آدرس و کدپستی
با ارسال آدرس متنی و کدپستی و تعیین یکی از تقسیمات کشوری شامل استان، شهرستان، بخش و یا شهرستانی که آدرس‌ها به آن تعلق دارند، انطباق بین آن‌ها تا سطح واحد در پاسخ برگردانده می‌شود.
https://api.parsimap.ir/parcel/address-comparison?key=PMI_API_TOKEN&search_text_1=صادقیه، خ. ستارخان، بلوار شهدای صادقیه، خ سیار پلاک 125 طبقه 1 واحد 1&district=تهران&search_text_2=1451795171&request_id=false
نمونه پاسخ
{
"same_street": true,
"same_plate": true,
"same_unit": true,
"distance": 0,
"certainty": 100,
"address_comparison_type": "AddressWithPostalcode",
"status":
درخواست بررسی انطباق بین آدرس و موقعیت جغرافیایی
با ارسال آدرس متنی و موقعیت جغرافیایی و تعیین یکی از تقسیمات کشوری شامل استان، شهرستان، بخش و یا شهرستانی که آدرس‌ها به آن تعلق دارند، انطباق بین آن‌ها تا سطح پلاک در پاسخ برگردانده می‌شود.
https://api.parsimap.ir/parcel/address-comparison?key=PMI_API_TOKEN&search_text_1=صادقیه، ابتدای خ. ستارخان، بلوار شهدای صادقیه، خ سیار پلاک 125 طبقه 1 واحد 1&district=تهران&search_text_2=51.338626, 35.721477&request_id=false
نمونه پاسخ
{
"same_street": true,
"same_plate": true,
"same_unit": false,
"distance": 0,
"certainty": 100,
"address_comparison_type": "AddressWithLocaion",
"status": "OK"
}
درخواست بررسی انطباق بین کدپستی و موقعیت جغرافیایی
با ارسال کدپستی و موقعیت جغرافیایی و تعیین یکی از تقسیمات کشوری شامل استان، شهرستان، بخش و یا شهرستانی که آدرس‌ها به آن تعلق دارند، انطباق بین آن‌ها تا سطح پلاک در پاسخ برگردانده می‌شود.
https://api.parsimap.ir/parcel/address-comparison?key=PMI_API_TOKEN&search_text_1=1451795171&district=تهران&search_text_2=51.338626,35.721477&request_id=false
نمونه پاسخ
{
"same_street": true,
"same_plate": true,
"same_unit": false,
"distance": 0,
"certainty": 100,
"address_comparison_type": "PostalcodeWithLocation",
"status": "OK"
}