در حال بارگذاری

پرش به مطلب اصلی

وب سرویس های نقشه: چطور شروع کنم؟

  1. ۱

    اولین قدم ثبت‌نام و دریافت API KEY برای اپلیکیشنی است که قصد دارید در آن از Map Api نشان استفاده کنید. کافیست در لینک فوق فرم مربوطه را تکمیل کنید تا بلافاصله API KEY را دریافت نمایید.

  2. ۲

    Api Key دریافتی از پنل توسعه‌دهندگان نشان را به صورتی که در ادامه مشاهده می‌کنید از طریق کلید Api-Key در header درخواست سرویس بگنجانید.

  3. ۳

    درخواست خود را با توجه به پارامترهایی که مربوط به سرویس موردنظرتان است با متد GET فراخوانی کنید.

  4. ۴

    چنانچه درخواست شما با موفقیت پردازش و پاسخ داده شود، خروجی با فرمت JSON دریافت خواهید کرد و چنانچه به هر دلیل خطایی رخ دهد، کد خطا بصورت HTTP Status Code و نوع آن با فرمت JSON ارسال می‌گردد. کدهای خطای احتمالی نیز در ادامه به صورت کامل توضیح داده شده‌اند.

دسترسی سریع به مستندات وب‌سرویس‌های پلتفرم نشان (Neshan Maps APIs)

سرویس مسیریابی (Routing API) برای خودرو و موتورسیکلت

مشاهده

سرویس جستجوی نام معابر، مکان‌ها و نام‌های قدیمی (Search API)

مشاهده

سرویس مسیریابی فروشنده دوره گرد Traveling Salesman Problem)TSP API)

مشاهده

سرویس تبدیل موقعیت به آدرس (Reverse Geocoding API)

مشاهده

سرویس تبدیل آدرس به موقعیت (Geocoding API)

مشاهده

سرویس ماتریس فاصله (Distance Matrix API)

مشاهده

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

مشاهده

سرویس نقشه استاتیک (Static Map)

مشاهده

نقشه استاتیک با رسم کمان از مبدا به مقصد (Static Map Arc)

مشاهده

سرویس نگاشت نقطه بر نقشه (Map Matching API)

مشاهده

کدهای خطای برگشتی در کار با سرویس‌های پلتفرم نقشه نشان

HTTP CodeStatusDescription
404NOT_FOUNDکد پستی با این مشخصات یافت نشده است
400INVALID_ARGUMENTخطا در پارامتر های ورودی
470CoordinateParseErrorچنانچه مختصات جغرافیایی ارسالی معتبر نباشد رخ خواهد داد.
480KeyNotFoundدر صورتی که در فراخوانی وب‌سرویس از یک Api Key نامعتبر استفاده کنید یا Api Key خود را در header ارسال نکنید رخ خواهد داد.
481LimitExceededدر صورتی که تعداد فراخوانی وب‌سرویس‌ها از میزان مجازی که برای شما تعیین شده‌است عبور کند رخ خواهد داد.
482RateExceededچنانچه تعداد درخواست وب‌سرویس در دقیقه از حد مجاز عبور کند رخ خواهد داد.
483ApiKeyTypeErrorکلید دسترسی استفاده شده با سرویس فراخوانی شده همخوانی ندارد. بایستی از کلید دسترسی مرتبط با سرویس مورد نظر استفاده کنید.
484ApiWhiteListErrorبا توجه به اسکوپ تعریف‌شده برای این کلید، شما مجاز به استفاده نیستید.
485ApiServiceListErrorسرویس فراخوانی شده با سرویس‌های تعریف‌شده برای این کلید دسترسی همخوانی ندارد.
500GenericErrorوقوع خطای ناشناخته