سرویس «استعلام کد پستی همراه با مختصات جغرافیایی» در دسته کد پستی فینوتک با وارد کردن کد پستی ۱۰ رقمی، هم اجزای آدرس پستی و هم عرض و طول جغرافیایی آن نقطه را برمیگرداند. تفاوت این نسخه با استعلام کد پستی ساده فقط همین است: مختصات هم در پاسخ میآید تا بتوانید آدرس را روی نقشه بنشانید.
استعلام کد پستی همراه با مختصات جغرافیایی چه مشکلی را حل میکند؟
در عملیات میدانی، آدرس نوشتاری تا وقتی به یک نقطه روی نقشه تبدیل نشود کار را پیش نمیبرد. تیم توزیع برای چیدن مسیر پیک، تخصیص سفارش به نزدیکترین انبار یا تصمیم درباره پوشش یک محدوده، به موقعیت مکانی نیاز دارد؛ اما چیزی که در فرم ثبت میشود یک رشته متن است. جایگزین دستی این کار، جستوجوی آدرس روی نقشه و انتخاب چشمی نقطه توسط اپراتور است که هم کند است، هم برای هر سفارش تکرار میشود و هم خطای انسانی دارد.
این سرویس هر دو لایه را در یک فراخوانی میدهد: ساختار آدرس برای نمایش و ذخیره، و مختصات برای محاسبههای مکانی. با همین خروجی میتوانید تصمیم بگیرید که نشانی در محدوده سرویسدهی شما هست یا نه، سفارش به کدام مرکز توزیع برود، نقطه تحویل روی نقشه به پیک نشان داده شود و فاصله یا محدودهبندی مناطق در سمت خودتان محاسبه شود.
کاربردهای استعلام کد پستی همراه با مختصات جغرافیایی
- مسیردهی و تخصیص سفارش در لجستیک — نقطه تحویل روی نقشه مشخص میشود و سفارش به نزدیکترین انبار یا پیک تخصیص مییابد.
- تعیین محدوده سرویسدهی — کسبوکارهای ارسال سریع و خدمات در محل بررسی میکنند که نشانی کاربر داخل محدوده پوشش هست یا نه.
- نمایش نقطه تحویل در اپلیکیشن — کاربر و پیک هر دو موقعیت را روی نقشه میبینند و نیاز به توضیح تلفنی نشانی کم میشود.
- تحلیل مکانی داده مشتریان — تیم تحلیل، پراکندگی مشتریان و سفارشها را برای انتخاب محل شعبه یا انبار بعدی بررسی میکند.
- کارشناسی و بازدید میدانی — کارشناس بیمه، تیم نصب یا سرویسکار با مختصات به محل هدایت میشود، نه با نشانی آزادنویسیشده.
- راستیآزمایی نشانی در پرونده مشتری — تطبیق مکانی آدرس اعلامشده با محدودههای موردنظر شما در بازبینی پرونده انجام میشود.
مزایای استعلام کد پستی همراه با مختصات جغرافیایی
- آدرس و مختصات در یک فراخوانی — لازم نیست برای رسیدن به موقعیت مکانی، مرحله جداگانهای در جریان کاری خود بسازید.
- حذف انتخاب دستی نقطه روی نقشه — اپراتور و کاربر از جستوجوی چشمی نشانی روی نقشه بینیاز میشوند.
- ورودی آماده برای محاسبات مکانی — عرض و طول جغرافیایی را میتوانید در محاسبه فاصله و محدودهبندی مناطق در سمت خودتان به کار ببرید.
- همان ورودی ساده — فقط یک کد پستی ۱۰ رقمی لازم است و منطق فرم شما تغییری نمیکند.
- مناسب عملیات انبوه — برای فهرستی از کد پستیها میتوانید لایه مکانی داده خود را بسازید و در انبار داده نگه دارید.
چه چیزی از استعلام کد پستی همراه با مختصات جغرافیایی دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار استعلام کد پستی همراه با مختصات جغرافیایی
- ۱. گرفتن توکن — با اسکوپ
ecity:postal-code-inquiry-coordinates:getتوکن Client Credential بگیرید. - ۲. فراخوانی با کد پستی — کد پستی ۱۰ رقمی را همراه یک
trackIdیکتا ارسال کنید. - ۳. جداکردن دو لایه خروجی — اجزای آدرس را برای نمایش و ذخیره، و عرض و طول جغرافیایی را برای نقشه و محاسبه بردارید.
- ۴. اعمال قاعده مکانی — بررسی کنید نقطه در محدوده سرویسدهی شما قرار دارد و سفارش را به مرکز توزیع مناسب بفرستید.
- ۵. ذخیره برای عملیات بعدی — آدرس، مختصات و
trackIdرا در پرونده سفارش یا مشتری نگه دارید تا در مسیردهیهای بعدی دوباره استعلام لازم نشود.
نحوه شروع استعلام کد پستی همراه با مختصات جغرافیایی
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: ecity:postal-code-inquiry-coordinates:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات استعلام کد پستی همراه با مختصات جغرافیایی
- ورودی کد پستی ۱۰ رقمی است؛ ارقام را پیش از ارسال به لاتین تبدیل و کاراکترهای اضافه را حذف کنید.
- مختصات بازگشتی موقعیت متناظر کد پستی است، نه نقطهای که کاربر خودش روی نقشه انتخاب کرده؛ برای تحویل درِ منزل، تایید کاربر را در جریان کاری خود نگه دارید.
- شماره واحد و طبقه در تحویل نهایی اهمیت دارد؛ آن را جدا از مختصات از کاربر بگیرید.
- اگر به مختصات نیازی ندارید، استعلام کد پستی همان اجزای آدرس را بدون لایه مکانی برمیگرداند.
- این سرویس برای تکمیل و مکانیابی آدرس است و رهگیری مرسوله انجام نمیدهد.
- آدرس و موقعیت مکانی، داده شخصی است؛ مدت نگهداری و دسترسی به آن را محدود کنید و
trackIdیکتا برای هر فراخوانی بفرستید.
سوالات متداول استعلام کد پستی همراه با مختصات جغرافیایی
استعلام کد پستی همراه با مختصات جغرافیایی چیست؟
سرویسی است که با دریافت کد پستی ۱۰ رقمی، اطلاعات آدرس پستی را همراه عرض و طول جغرافیایی همان نقطه برمیگرداند.
تفاوت این سرویس با استعلام کد پستی چیست؟
هر دو آدرس متناظر کد پستی را میدهند؛ تفاوت در این است که این سرویس مختصات جغرافیایی را هم برمیگرداند. اگر نقشه، مسیردهی یا محدودهبندی در محصول شما نقش دارد، این نسخه را انتخاب کنید و در غیر این صورت استعلام کد پستی کافی است.
مختصات بازگشتی چه کاربردی دارد؟
میتوانید نقطه را روی نقشه نشان دهید، فاصله و محدوده سرویسدهی را در سمت خودتان محاسبه کنید و سفارش را به مرکز توزیع مناسب تخصیص دهید.
آیا میتوانم با مختصات، آدرس دقیق واحد را پیدا کنم؟
مختصات، موقعیت متناظر کد پستی را نشان میدهد؛ اجزای دقیقتری مانند شماره واحد باید از کاربر گرفته و تایید شود.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی استعلام کد پستی همراه با مختصات جغرافیایی
مشاهده مستندات فنی «استعلام کد پستی همراه با مختصات جغرافیایی» — endpoint، پارامترها، نمونه درخواست و پاسخ.