وب‌سرویس تبدیل نقطه به آدرس / Reverse Geocoding نگارش 1.0.0

وب‌سرویس تبدیل نقطه به آدرس

از طریق وب‌سرویس تبدیل نقطه‌ی جغرافیایی به آدرس به سادگی می‌توانید با ارسال طول و عرض جغرافیایی موردنظر، اطلاعاتی نظیر آدرس دقیق، نام محله، منطقه‌ی شهرداری، در طرح ترافیک بودن (تهران) و در طرح زوج و فرد بودن (تهران، مشهد، اصفهان) آن نقطه را دریافت کنید.

شیوه‌ی فراخوانی:
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: ایا نقطه‌ی موردنظر در طرح زوج و فرد قرار دارد؟