سرویس محدوده در دسترس (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
درخواست شما به صورت انکد شده بایستی ارسال شود.
مستندات و کتابخانه ها :
- مستندات گوگل
- ساخت یک پارامتر موفق UrlEncode
- کتابخانه ها و توابع برای زبان ها (جاوا ، جاوااسکریپت , Php)
فرمت پاسخ:
پاسخ بازگشت داده شده سرویس به صورت geojson با فیچر های مشخص شده برای دو محدوده زمان و مسافت ارسال شده میباشد.
اجزای پاسخ:
Parameters | Description | |||
features | آرایه نواحی ایجاد شده | |||
properties | شیء حاوی مشخصات فیچر تولید شده | |||
metric | مشخص کننده پارامتر ایجاد کننده محدوده یکی از دو مقدار distance و یا time | |||
geometry | شیء اطلاعات رسم ناحیه ایجاد شده | |||
coordinates | آرایه شامل latitude و Longitude های ناحیه ایجاد شده | |||
type | نوع ناحیه ایجاد شده دارای یکی از دو مقدار LineString و یا Polygon بر اساس پارامتر ارسالی در رکوئست | |||
type | نوع آبجکت مرتبط با geojson، مقدار دهی شده با عبارت Feature | |||
type | نوع آبجکت در geojson با مقدار FeatureCollection |


نمونه فرمت پاسخ:
{
"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"
}
با فراخوانی این API در صورت وجود اشکال ممکن است، خطاهای زیر در خروجی برای شما ارسال گردند. شناسایی و مدیریت این خطاها میتواند به از بروز خطاهای احتمالی در اپلیکیشن شما جلوگیری کند. این خطاها عبارتند از:
470 : CoordinateParseError
چنانچه مختصات جغرافیایی ارسالی معتبر نباشد رخ خواهد داد.
480 : KeyNotFound
در صورتی که در فراخوانی وبسرویس از یک Api Key نامتعبر استفاده کنید یا Api Key خود را در header ارسال نکنید رخ خواهد داد.
481 : LimitExceeded
در صورتی که تعداد فراخوانی وبسرویسها از میزان مجازی که برای شما تعیین شدهاست عبور کند رخ خواهد داد.
482 : RateExceeded
چنانچه تعداد درخواست وبسرویس در دقیقه از حد مجاز عبور کند رخ خواهد داد.
483 : ApiKeyTypeError
کلید دسترسی استفاده شده با سرویس فراخوانی شده همخوانی ندارد. بایستی از کلید دسترسی مرتبط با سرویس موردنظر استفاده کنید.
484 : ApiWhiteListError
با توجه به اسکوپ تعریفشده برای این کلید، شما مجاز به استفاده نیستید.
485 : ApiServiceListError
سرویس فراخوانی شده با سرویسهای تعریفشده برای این کلید دسترسی همخوانی ندارد.
500 : GenericError
در صورت بروز خطایی غیر از خطاهای بالا این خطا گزارش میشود.