سرویس محدوده در دسترس

سرویس محدوده در دسترس (Isochrone / Isodistance )

سرویس محدوده در دسترس، به کمک این سرویس می‌توانید بر حسب محدودیت زمانی و یا محدودیت مسافتی به حداکثر مناطق قابل دسترس از محل مبدا را بدست آورد.

سرویس محدوده در دسترس (Isochrone/Isodistance) پلتفرم نقشه نشان، همراه با سرویس‌های مسیریابی و بهینه‌سازی مسیر، یکی از پرکاربردترین سرویس‌ها برای بهبود کیفیت خدمات و برنامه‌ریزی سفرها است. در این سرویس، با مشخص کردن پارامترهای زمان یا مسافت، می‌توانید به محل‌هایی دسترسی پیدا کنید که در فاصله مشخصی از مرکز تعیین‌شده بر اساس این پارامترها قرار دارند. به کمک چندضلعی که این سرویس ایجاد می‌کند، می‌توانید درک بهتری از محدوده قابل دسترس داشته باشید یا از این خروجی در محاسبات مکانی استفاده کنید.

شاید شما یک سرویس تحویل غذا داشته باشید و بخواهید محدوده سرویس‌دهی پیک‌های رستوران خود را به کاربران نمایش دهید یا بخواهید برای بالا بردن میزان رضایت و مدیریت بهتر هزینه‌ها، ناوگان خودتان را بررسی کنید و ببینید آیا در زمان و فاصله مشخص می‌تواند مرسوله را به مقصد برساند یا خیر. در این‌ شرایط، سرویس محدوده در دسترس می‌تواند به شما کمک کند.

به این ترتیب، فروشگاه‌ها و سوپرمارکت‌های آنلاین، مراکز توزیع، تاکسی‌های اینترنتی، سرویس‌های حمل‌ونقل آنلاین و به‌طور کلی تمام کسب‌وکارهایی با نیاز مشابه، می‌توانند از مخاطبان این سرویس باشند.

شیوه‌ی فراخوانی:
GET:
	https://api.neshan.org/v1/isochrone?parameters
Headers:
	Api-Key: YOUR_API_KEY
پارامتر های وروردی:
پارامترتوضیحاتنوع پارامتر
locationمختصات مرکز به صورت Lat,Lngاجباری
polygonاین پارامتر یکی از دو مقدار true و یا false را می‌تواند داشته باشد، با فعال کردن این پارامتر خروجی تولید شده از نوع polygon خواهد بود و در صورت false بوده خروجی LineString ایجاد خواهد شد، در صورت عدم ارسال این پارامتر پیش فرض آن false در نظر گرفته می‌شود.اختیاری
distanceاین پارامتر یک عدد بر حسب کیلومتر می‌باشد، مشخص کننده حداکثر مسافت قابل قبول برای دستیابی می‌باشدیکی از این دو پارامتر اجباری می‌باشد
timeاین پارامتر یک عدد بر حسب دقیقه می‌باشد و مشخص کننده حداکثر زمان قابل قبول برای دستیابی می‌باشد
denoiseیک عدد بین بازه ۰ تا ۱ است و برای مشخص کردن و کنترل میزان پیچیدگی یا سادگی چند ضلعی ایجادشده، استفاده می‌شود. اگر این عدد ارسال نشود، پیش‌فرض مقدار ۰ در نظر گرفته می‌شود.اختیاری
نمونه یک فراخوانی کامل:
GET:
	https://api.neshan.org/v1/isochrone?location=35.73615577230048%2C51.375986032513595&denoise=&polygons=true&distance=5&time=5
Headers:
	Api-Key: YOUR_SERVICE_API_KEY

درخواست شما به صورت انکد شده بایستی ارسال شود.

 مستندات و کتاب‌خانه ها :
فرمت پاسخ:

پاسخ بازگشت داده شده سرویس به صورت geojson با فیچر های مشخص شده برای دو محدوده زمان و مسافت ارسال شده می‌باشد.

اجزای پاسخ:
Parameters Description
features آرایه نواحی ایجاد شده
properties شیء حاوی مشخصات فیچر تولید شده
metric مشخص کننده پارامتر ایجاد کننده محدوده یکی از دو مقدار distance و یا time
geometry شیء دربردارنده اطلاعات مرتبط با رسم ناحیه ایجادشده.
coordinates آرایه شامل latitude و Longitude های ناحیه ایجاد شده
type نوع ناحیه ایجاد شده دارای یکی از دو مقدار LineString و یا Polygon بر اساس پارامتر ارسالی در رکوئست
type نوع آبجکت مرتبط با geojson، مقدار دهی شده با عبارت Feature
type نوع آبجکت در geojson با مقدار FeatureCollection
isochrone isodistance denoise 0
پولیگان ایجاد شده با denoise = 1
isochrone isodistance denoise 0
پولیگان ایجاد شده با denoise = 0
نمونه فرمت پاسخ:
            {
    "features": [
        {
            "properties": {
                "contour": 1,
                "metric": "distance"
            },
            "geometry": {
                "coordinates": [
                    [
                    [ 51.379986, 35.741408 ],
                    [ 51.378875, 35.742045 ],
                    [ 51.377986, 35.74207 ],
                    [ 51.377882, 35.74126 ],
                    [ 51.374986, 35.741397 ],
                    [ 51.373986, 35.740604 ],
                    [ 51.371532, 35.740156 ],
                    [ 51.370447, 35.739156 ],
                    [ 51.370768, 35.735156 ],
                    [ 51.371762, 35.734156 ],
                    [ 51.371842, 35.7313 ],
                    [ 51.370986, 35.7312 ],
                    [ 51.370986, 35.730649 ],
                    [ 51.372468, 35.729637 ],
                    [ 51.373986, 35.729506 ],
                    [ 51.374986, 35.730805 ],
                    [ 51.375174, 35.730156 ],
                    [ 51.375986, 35.729652 ],
                    [ 51.377977, 35.730147 ],
                    [ 51.378986, 35.729673 ],
                    [ 51.379252, 35.731156 ],
                    [ 51.37827, 35.73144 ],
                    [ 51.378383, 35.732759 ],
                    [ 51.378986, 35.733143 ],
                    [ 51.380187, 35.732954 ],
                    [ 51.380986, 35.73358 ],
                    [ 51.381263, 35.734879 ],
                    [ 51.382071, 35.735156 ],
                    [ 51.381986, 35.736661 ],
                    [ 51.380656, 35.737156 ],
                    [ 51.381488, 35.738156 ],
                    [ 51.380986, 35.740849 ],
                    [ 51.379986, 35.741408 ]
                    ]
                ],
                "type": "Polygon"
            },
            "type": "Feature"
        },
        {
            "properties": {
                "contour": 1,
                "metric": "time"
            },
            "geometry": {
                "coordinates": [
                    [ [ 51.374986, 35.737212 ],
                    [ 51.373986, 35.735875 ],
                    [ 51.374986, 35.735563 ],
                    [ 51.376342, 35.7358 ],
                    [ 51.376445, 35.736615 ],
                    [ 51.374986, 35.737212 ]
                    ]
                ],
                "type": "Polygon"
            },
            "type": "Feature"
        }
    ],
    "type": "FeatureCollection"
}