تـوجه!
صفحه‌ای که در حال مشاهده آن هستید، حاوی مستندات
نسخه قدیمی
می‌باشد.
نسخه جدیدی از این سرویس در دسترس توسعه‌دهندگان قرار گرفته است. لطفا با مراجعه به
این صفحه
از نسخه جدید استفاده نمایید.
سرویس Reverse Geocoding
از طریق وب‌سرویس تبدیل نقطه‌ی جغرافیایی به آدرس (Reverse Geocoding API ) به سادگی میتوانید با ارسال طول و عرض جغرافیایی موردنظر، اطلاعاتی نظیر آدرس دقیق، نام محله، منطقه‌ی شهرداری، در طرح ترافیک بودن (تهران) و در طرح زوج و فرد بودن (تهران، مشهد، اصفهان) آن نقطه را دریافت کنید.
پیشنهاد می‌شود جهت آشنایی بیشتر با وب‌سرویس تبدیل پوینت به آدرس پستی مطلب تبدیل موقعیت به آدرس در پلتفرم نقشه نشان را در بلاگ نشان مطالعه کنید.
شیوه‌ی فراخوانی:
GET:
https://api.neshan.org/v2/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,
"addresses": [
{
"formatted": "حجاب، سازمان آب، نزدیک به عبدالله زاده",
"components": [
{
"name": "حجاب",
"type": "primary"
},
{
"name": "سازمان آب",
"type": "secondary"
}
]
}
]
}اجزای این پاسخ بصورت زیر می‌باشند:
- status: در صورت موفقیت‌آمیز بودن اجرای درخواست مقدار OK در آن قرار می‌گیرد.
- formatted_address: آدرس کامل موقعیت مورد نظر شامل استان، شهر، محله و خیابان
- route_name: نام خیابان انتهایی آدرس
- route_type: نوع خیابان انتهایی آدرس
- neighbourhood: نام محله (در صورت وجود)
- city: نام شهر
- state: نام استان
- place: نام مکان عمومی که موقعیت انتخابی در آن قرار گرفته است (در صورت وجود)
- municipality_zone: منطقه شهرداری (در صورت وجود)
- in_traffic_zone: آیا نقطه‌ی موردنظر در طرح ترافیک قرار دارد؟
- in_odd_even_zone: ایا نقطه‌ی موردنظر در طرح زوج و فرد قرار دارد؟
- addresses: آرایه‌ای از آدرس‌های تولیدشده برای موقعیت انتخابی
کلید دسترسی سرویس (api-key)
برای ساخت کلید دسترسی (api-key) مناسب برای این سرویس شما باید در پنل ساخت کلید دسترسی گزینه سرویس ها و سپس تبدیل نقطه به آدرس را انتخاب کنید.
این را هم در نظر داشته باشید برای امنیت بیشتر کلید دسترسی خود و جلو گیری از سواستفاده شدن از آن IP سرور خود را نیز میتوانید در فیلد دامنه/Ip های مجاز وارد کنید.
بازتاب: وب‌سرویس نگاشت نقطه بر نقشه – پلتفرم نقشه نشان