سرویس تبدیل کدپستی
سرویس تعیین کدپستی، کدپستی را به موقعیت جغرافیایی تبدیل می‌کند. کدپستی به سرویس ارسال می‌شود و سرویس در پاسخ اطلاعات واحد کدپستی درخواستی شامل مختصات جغرافیایی، طبقه، پلاک و واحد آن را در پاسخ برمی‌گرداند.
ساختار کلی سرویس
/parcel/unit?parameters
پارامترهای ورودی
پارامترهای مورد نیاز
| پارامتر | توضیحات |
|---|---|
postcode |
کدپستی درخواستی است. |
پارامترهای اختیاری
پارامترهای اختیاری آپشن‌ها و امکانات مختلف سرویس را ارائه می‌دهند. ارسال آن‌ها جهت استفاده از سرویس اجباری نیست.
| پارامتر | توضیحات | مقدار پیش‌فرض |
|---|---|---|
request_id |
در صورت ست شدن پارامتر فوق، به صورت یکتا در روز می‌توان برای پیگیری استفاده نمود. | به صورت پیش‌فرض، عدم پیگیری در روز است. |
نمونه درخواست
درخواست تبدیل کدپستی به موقعیت جغرافیایی
با ارسال کدپستی درخواستی، اطلاعات مختصات جغرافیایی، طبقه و واحد آن در پاسخ برگردانده می‌شود.
https://api.parsimap.ir/parcel/unit?key=PARSIMAP_ACCESS_TOKEN&postcode=1517974414
نمونه پاسخ
{
"location": {
"lat": 35.757404,
"lng": 51.413531999999996
},
"floor": 3,
"title": "دانشگاه علامه طباطبایی مرکزرشدواحدهای فناوری علوم انسانی",
"unit": "شمالی",
"plate_number": "40",
"tolerance": 0,
"postcode": 1517974414,
"status": "OK"
}
پارامترهای خروجی
| پارامتر | توضیحات |
|---|---|
location |
مختصات جغرافیایی کدپستی درخواستی است. |
floor |
طبقه مربوط به کدپستی درخواستی است. |
title |
عنوان واحد مربوط به کدپستی درخواستی است. |
unit |
واحد مربوط به کدپستی درخواستی است. |
tolerance |
دقت مختصات یافت شده را نشان می‌دهد. تلورانس صفر به معنای دقت بالای مختصات یافت شده است. در تلورانس صفر دقت مختصات یافت شده بهتر از ۳۰ متر است. در صورتیکه مختصات یافت شده دارای خطا باشد، این پارامتر میزان خطا بر حسب متر را نشان می‌دهد. |
postcode |
کدپستی درخواستی است. |
status |
نتیجه درخواست را نشان می‌دهد. برای مثال نتیجه این درخواست OK است که به معنی موفق بودن درخواست است. نتیجه پاسخ به درخواست ارسالی توسط کاربر در قالب جدول زیر ارائه شده است: جدول |