تـوجه!
صفحه‌ای که در حال مشاهده آن هستید، حاوی مستندات
نسخه قدیمی
می‌باشد.
نسخه جدیدی از این سرویس در دسترس توسعه‌دهندگان قرار گرفته است. لطفا با مراجعه به
این صفحه
از نسخه جدید استفاده نمایید.
وب‌سرویس تبدیل نقطه به آدرس
از طریق وب‌سرویس تبدیل نقطه‌ی جغرافیایی به آدرس به سادگی می‌توانید با ارسال طول و عرض جغرافیایی موردنظر، اطلاعاتی نظیر آدرس دقیق، نام محله، منطقه‌ی شهرداری، در طرح ترافیک بودن (تهران) و در طرح زوج و فرد بودن (تهران، مشهد، اصفهان) آن نقطه را دریافت کنید.
فهرست مطالب این صفحه
شیوه‌ی فراخوانی:
GET:
https://api.neshan.org/v1/reverse?lat=LATITUDE&lng=LONGITUDE
Headers:
Api-Key: YOUR_API_KEYپارامتر های وروردی:
- type: مشخص میکند که مسیریابی مخصوص به خودرو یا موتورسیکلت استفاده شود. مقدار آن میتواند
carبرای مسیریابی خودرو وmotorcycleبرای مسیریابی موتور باشد. - origin: مختصات نقطه شروع مسیریابی، این مختصات باید به صورت
latitude,longitudeباشد که دو عدد با کاما از هم جدا شده‌اند. - destination: مختصات نقطه پایان مسیریابی که قالب آن مانند نقطه شروع است.
- waypoints: این پارامتر اختیاری بوده و برای مشخص کردن نقاط میانی مسیر استفاده می‌شود. فرمت ارسال هر نقطه میانی به صورت
latitude,longitudeمی‌باشد. در صورتی که بیش از یک نقطه میانی دارید با به صورت زیر آن‌ها را با علامت پایت (|) از هم جدا کنید:latitude,longitude|latitude,longitude - avoidTrafficZone: این پارامتر اختیاری بوده و مقادیر آن
trueیاfalseمیتواند باشد. در صورتی که این پارامتر true باشد مسیر از داخل طرح ترافیک عبور نخواهد کرد. همچین در صورتی که مقصد داخل طرح ترافیک باشد هیچ مسیری پیدا نمی‌شود. - avoidOddEvenZone: این پارامتر اختیاری بوده و مقادیر آن
trueیاfalseمیتواند باشد. در صورتی که این پارامتر true باشد مسیر از داخل طرح زوج و فرد عبور نخواهد کرد. همچین در صورتی که مقصد داخل طرح ترافیک باشد هیچ مسیری پیدا نمی‌شود. - alternative: این پارامتر اختیاری بوده و مقادیر آن
trueیاfalseمیتواند باشد. در صورتی که این پارامتر true باشد و مسیرهای جایگزین برای نقاط مشخص شده وجود داشته باشد این مسیرها در پاسخ ارائه خواهند شد. (مقدار پیش فرض این پارامتر false است)
فرمت پاسخ:
{
"neighbourhood": "هلال احمر",
"address": "احمدی سخا، نزدیک به انتظاری",
"municipality_zone": "11",
"in_traffic_zone": false,
"in_odd_even_zone": true
}اجزای این پاسخ بصورت زیر می‌باشند:
- neighbourhood: نام محله (در صورت وجود)
- address: آدرس نقطه‌ی موردنظر
- municipality_zone: منطقه شهرداری
- in_traffic_zone: آیا نقطه‌ی موردنظر در طرح ترافیک قرار دارد؟
- in_odd_even_zone: ایا نقطه‌ی موردنظر در طرح زوج و فرد قرار دارد؟
نمونه کد برای وب سرویس تبدیل نقطه به آدرس :
این نمونه کد ها برای دو زبان PHP و JavaScript طراحی شده اند شما برای استفاده از نمونه کد ها نیاز به دو کلید دسترسی مخصوص سرویس تبدیل نقطه به آدرس و کیت توسعه نقشه وب نشان دارید.
بازتاب: وب‌سرویس تبدیل نقطه به آدرس / Reverse Geocoding – پلتفرم نقشه نشان