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

سرویس محدوده در دسترس (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 یک عدد بین بازه 0 تا 1 می‌باشد و به منظور کنترل حد آستانه ساده سازی محدوده مشخص شده استفاده می‌شود، در صورت عدم ارسال پیش فرض 0 در نظر گرفته می‌شود. اختیاری
نمونه یک فراخوانی کامل:
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"
}