Menu
تـوجه!
صفحه‌ای که در حال مشاهده آن هستید، حاوی مستندات آخرین نسخه سرویس
تبدیل نقطه به آدرس
می‌باشد.
مستندات مرتبط با نسخه قدیمی این سرویس را در
این صفحه
میتوانید مشاهده کنید.
سرویس Reverse Geocoding
از طریق وب‌سرویس تبدیل نقطه‌ی جغرافیایی به آدرس (Reverse Geocoding API ) به سادگی میتوانید با ارسال طول و عرض جغرافیایی موردنظر، اطلاعاتی نظیر آدرس دقیق، نام محله، منطقه‌ی شهرداری، در طرح ترافیک بودن (تهران) و در طرح زوج و فرد بودن (تهران، مشهد، اصفهان) آن نقطه را دریافت کنید.
پیشنهاد می‌شود جهت آشنایی بیشتر با وب‌سرویس تبدیل پوینت به آدرس پستی مطلب تبدیل موقعیت به آدرس در پلتفرم نقشه نشان را در بلاگ نشان مطالعه کنید.
شیوه‌ی فراخوانی:
GET:
https://api.neshan.org/v5/reverse?lat=LATITUDE&lng=LONGITUDE
Headers:
Api-Key: YOUR_API_KEYپارامتر های وروردی:
- lat: عرض جغرافیایی (latitude)
- lng: طول جغرافیایی (longitude)
فرمت پاسخ:
{
"status": "OK",
"formatted_address": "تهران، دکتر فاطمی، حجاب، سازمان آب، بین دائمی و عبداله زاده",
"route_name": "سازمان آب",
"route_type": "secondary",
"neighbourhood": "فاطمي",
"city": "تهران",
"state": "استان تهران",
"place": null,
"municipality_zone": "6",
"in_traffic_zone": "true",
"in_odd_even_zone": "true",
"village": null,
"county": شهرستان تهران,
"district": "بخش مرکزی شهرستان تهران",
}اجزای این پاسخ بصورت زیر می‌باشند:
- status: در صورت موفقیت‌آمیز بودن اجرای درخواست مقدار OK در آن قرار می‌گیرد.
- formatted_address: آدرس کامل موقعیت مورد نظر شامل استان، شهر، محله و خیابان
- route_name: نام خیابان انتهایی آدرس
- route_type: نوع خیابان انتهایی آدرس
- neighbourhood: نام محله (در صورت وجود)
- city: نام شهر
- state: نام استان
- place: نام مکان عمومی که موقعیت انتخابی در آن قرار گرفته است (در صورت وجود)
- municipality_zone: منطقه شهرداری (در صورت وجود)
- in_traffic_zone: آیا نقطه‌ی موردنظر در طرح ترافیک قرار دارد؟
- in_odd_even_zone: ایا نقطه‌ی موردنظر در طرح زوج و فرد قرار دارد؟
- village: نام روستا (در صورت وجود)
- county: نام شهرستان
- district: نام بخش
کلید دسترسی سرویس (api-key)
برای ساخت کلید دسترسی (api-key) مناسب برای این سرویس شما باید در پنل ساخت کلید دسترسی گزینه سرویس ها و سپس تبدیل نقطه به آدرس را انتخاب کنید.
این را هم در نظر داشته باشید برای امنیت بیشتر کلید دسترسی خود و جلو گیری از سواستفاده شدن از آن IP سرور خود را نیز میتوانید در فیلد دامنه/Ip های مجاز وارد کنید.
توجه
جهت حفظ امنیت کلید دسترسی خود بهتر است، کلیه فراخوانی های سرویس های نشان به صورت سرور ساید انجام شود.
مزایای این روش فراخوانی به شرح زیر است.
مزایای این روش فراخوانی به شرح زیر است.
- دیگر نیازی به ارسال کلید دسترسی به صورت کلاینت ساید ندارید و کلید دسترسی شما در معرض سرقت قرار نمیگیرد.
- میتوانید برای کلید خود whitelist تعیین کنید.
- در صورت انتشار ورژن جدید سرویس ها در پلتفرم نشان براحتی امکان بروزرسانی api را خواهید داشت.
