سرویس تعیین موقعیت پارسل با کدپستی
سرویس تعیین موقعیت پارسل، کدپستی را به موقعیت جغرافیایی پارسل تبدیل می‌کند. این سرویس موقعیت پارسل را در سه سطح دقت مختلف شامل دقت بالا (high)، دقت متوسط (medium) و دقت کم (low) تعیین می‌کند. کدپستی و سطح دقت موردنظر به سرویس ارسال می‌شود و سرویس در پاسخ موقعیت پارسل را براساس دقتی درخواستی برمی‌گرداند. براساس سطح دقت درخواستی، سرویس تعیین موقعیت پارسل دارای سه امکان زیر است:
- تعیین موقعیت پارسل با دقت بالا: سرویس موقعیت پارسل درخواستی را در سطح معبر و با دقتی بهتر از ۲۰۰ متر تعیین می‌کند.
- تعیین موقعیت پارسل با دقتی بالاتر از ۴۰۰ متر: سرویس موقعیت پارسل درخواستی را با دقتی بهتر از ۴۰۰ متر تعیین می‌کند.
- تعیین موقعیت تقریبی پارسل: سرویس موقعیت پارسل درخواستی را در سطح محله تعیین می‌کند.
قابلیت‌های سرویس
| تبدیل کدپستی به موقعیت جغرافیایی با دقتی بهتر از ۲۰۰ متر(در سطح معبر). |
| تبدیل کدپستی به موقعیت جغرافیایی با دقت بهتر از ۴۰۰ متر. |
| تعیین موقعیت تقریبی پارسل (درسطح محله). |
ساختار کلی سرویس
get/parcel/location?parameters
پارامترهای ورودی
پارامترهای مورد نیاز
| پارامتر | توضیحات |
|---|---|
postcode |
کدپستی درخواستی است. |
precision |
سطح دقت درخواستی را مشخص می‌کند. دارای سه سطح دقت medium، high و low است. درصورت درخواست تعیین موقعیت پارسل با دقت بالا و در سطح معبر، مقدار این پارامتر را باید high قرار دهید. برای تعیین موقعیت پارسل با دقتی بهتر از ۴۰۰ متر، مقدار این پارامتر باید medium و برای تعیین موقعیت تقریبی و در سطح محله، مقدار این پارامتر باید low ارسال شود. |
پارامترهای اختیاری
پارامترهای اختیاری آپشن‌ها و امکانات مختلف سرویس را ارائه می‌دهند. ارسال آن‌ها جهت استفاده از سرویس اجباری نیست.
| پارامتر | توضیحات | مقدار پیش‌فرض |
|---|---|---|
request_id |
در صورت ست شدن پارامتر فوق، به صورت یکتا در روز می‌توان برای پیگیری استفاده نمود. | به صورت پیش‌فرض، عدم پیگیری در روز است. |
نمونه درخواست
درخواست تعیین موقعیت پارسل با دقت بالا
با ارسال کدپستی و تعیین سطح دقت high، موقعیت جغرافیایی کدپستی درخواستی در سطح معبر تعیین می‌شود.
https://api.parsimap.ir/parcel/location?key=PMI_API_TOKEN&postcode=1313834481&precision=high&request_id=false
نمونه پاسخ
{
"location": {
"lat": 35.697433,
"lng": 51.387838
},
"address": "خ. جمهوری اسلامی، نرسیده به خ. جمالزاده جنوبی، خ. نوفلاح",
"precision": "high",
"status": "OK"
}
پارامترهای خروجی
| پارامتر | توضیحات |
|---|---|
location |
مختصات جغرافیایی یافت شده است. |
address |
آدرس پارسل یافت شده است. در صورتیکه در پاسخ دقت medium و یا low برگردانده شود، تنها محله پارسل یافت شده را نمایش می‌دهد. |
precision |
سطح دقت موقعیت یافت شده است. دقت نتیجه یافت شده می‌تواند پایین‌تر از سطح دقت درخواستی باشد. |
status |
نتیجه درخواست را نشان می‌دهد. برای مثال نتیجه این درخواست OK است که به معنی موفق بودن درخواست است. نتیجه پاسخ به درخواست ارسالی توسط کاربر در قالب جدول زیر ارائه شده است: جدول |
درخواست تعیین موقعیت پارسل با دقت بهتر از ۴۰۰ متر
با ارسال کدپستی و تعیین سطح دقت medium، موقعیت جغرافیایی کدپستی درخواستی با دقت بهتر از ۴۰۰ متر تعیین می‌شود.
https://api.parsimap.ir/parcel/location?key=PMI_API_TOKEN&postcode=1416633663&precision=medium&request_id=false
نمونه پاسخ
{
"location": {
"lat": 35.706257,
"lng": 51.398235
},
"address": "دانشگاه تهران",
"precision": "medium",
"status": "OK"
}
درخواست تعیین موقعیت تقریبی پارسل
با ارسال کدپستی و تعیین سطح دقت low، موقعیت تقریبی کدپستی درخواستی در سطح محله تعیین می‌شود.
https://api.parsimap.ir/parcel/location?key=PMI_API_TOKEN&postcode=1451783971&precision=low&request_id=false
نمونه پاسخ
{
"location": {
"lat": 35.719272,
"lng": 51.342884
},
"address": "صادقیه",
"precision": "low",
"status": "OK"
}