وب سرویس های نقشه: چطور شروع کنم؟
- ۱
اولین قدم ثبتنام و دریافت API KEY برای اپلیکیشنی است که قصد دارید در آن از Map Api نشان استفاده کنید. کافیست در لینک فوق فرم مربوطه را تکمیل کنید تا بلافاصله API KEY را دریافت نمایید.
- ۲
Api Key دریافتی از پنل توسعهدهندگان نشان را به صورتی که در ادامه مشاهده میکنید از طریق کلید Api-Key در header درخواست سرویس بگنجانید.
- ۳
درخواست خود را با توجه به پارامترهایی که مربوط به سرویس موردنظرتان است با متد GET فراخوانی کنید.
- ۴
چنانچه درخواست شما با موفقیت پردازش و پاسخ داده شود، خروجی با فرمت JSON دریافت خواهید کرد و چنانچه به هر دلیل خطایی رخ دهد، کد خطا بصورت HTTP Status Code و نوع آن با فرمت JSON ارسال میگردد. کدهای خطای احتمالی نیز در ادامه به صورت کامل توضیح داده شدهاند.
دسترسی سریع به مستندات وبسرویسهای پلتفرم نشان (Neshan Maps APIs)
Direction APIمسیریابی با در نظر گرفتن ترافیک
مشاهدهDirection API (no traffic)مسیریابی بدون ترافیک
مشاهدهPredictive Routing APIمسیریابی پیشبینی
مشاهدهTypical Routing APIمسیریابی براساس الگوی ترافیک
مشاهدهPedestrian Routing APIمسیریابی عابر پیاده
مشاهدهTSP APIبهینهسازی مسیر چند نقطهای
مشاهدهDistance Matrix APIمحاسبه فاصله و زمان
مشاهدهIsochrone / Isodistance APIمحاسبه محدوده در دسترس
مشاهدهMap matching APIنگاشت نقطه بر نقشه
مشاهدهSearch APIجستجوی مکانها و آدرسها
مشاهدهReverse Geocoding APIتبدیل مختصات به آدرس
مشاهدهGeocoding APIتبدیل آدرس به مختصات
مشاهدهStatic Map APIتولید تصاویر استاتیک نقشه
مشاهدهStatic Map Arc APIتولید تصاویر نقشه همراه با رسم کمان
مشاهدهکدهای خطای برگشتی در کار با سرویسهای پلتفرم نقشه نشان
| HTTP Code | Status | Description |
|---|---|---|
| 400 | INVALID_ARGUMENT | خطا در پارامتر های ورودی |
| 470 | CoordinateParseError | چنانچه مختصات جغرافیایی ارسالی معتبر نباشد رخ خواهد داد. |
| 480 | KeyNotFound | در صورتی که در فراخوانی وبسرویس از یک Api Key نامعتبر استفاده کنید یا Api Key خود را در header ارسال نکنید رخ خواهد داد. |
| 481 | LimitExceeded | در صورتی که تعداد فراخوانی وبسرویسها از میزان مجازی که برای شما تعیین شدهاست عبور کند رخ خواهد داد. |
| 482 | RateExceeded | چنانچه تعداد درخواست وبسرویس در دقیقه از حد مجاز عبور کند رخ خواهد داد. |
| 483 | ApiKeyTypeError | کلید دسترسی استفاده شده با سرویس فراخوانی شده همخوانی ندارد. بایستی از کلید دسترسی مرتبط با سرویس مورد نظر استفاده کنید. |
| 484 | ApiWhiteListError | با توجه به اسکوپ تعریفشده برای این کلید، شما مجاز به استفاده نیستید. |
| 485 | ApiServiceListError | سرویس فراخوانی شده با سرویسهای تعریفشده برای این کلید دسترسی همخوانی ندارد. |
| 500 | GenericError | وقوع خطای ناشناخته |