نمای کلی Roads API

‫Roads API سرویسی است که درخواست‌های HTTPS را با مختصات طول/عرض جغرافیایی برای یک یا چند نقطه روی نقشه می‌پذیرد. این میانای برنامه‌سازی کاربردی از این نقاط برای پیدا کردن بخش‌های جاده‌ای اطراف استفاده می‌کند و «شناسه مکان» را به‌همراه فراداده‌هایی مثل نزدیک‌ترین بخش جاده‌ای و محدودیت‌های سرعت برمی‌گرداند.

چرا از Roads API استفاده کنید

با Roads API، می‌توانید محدودیت‌های سرعت، زمان‌های تخمینی ورود، یا سایر فراداده‌های جاده را دریافت کنید. با این فراداده‌های جاده، می‌توانید برنامه‌های رانندگی‌تان را با قابلیت‌های زیر بهبود دهید:

  • مختصات طول جغرافیایی/ عرض جغرافیایی را به یک یا چند جاده متصل کنید.
  • نزدیک‌ترین جاده را برای مجموعه‌ای از مختصات پیدا کنید
  • دریافت حد سرعت برای بخش‌های جاده

کارهایی که می‌توانید با Roads API انجام دهید

با Roads API، می‌توانید مختصات GPS را به هندسه جاده نگاشت کنید و حد مجاز سرعت را در بخش‌های جاده تعیین کنید.

  • هم‌ترازی با جاده‌ها این سرویس محتمل‌ترین جاده‌های طی‌شده را براساس مجموعه مختصات GPS ارائه‌شده برمی‌گرداند. می‌توانید حداکثر ۱۰۰ نقطه GPS جمع‌آوری‌شده درطول مسیر را مشخص کنید. درصورت تمایل، می‌توانید از سرویس بخواهید نقاط اضافی را درون‌یابی کند، که منجر به مسیری می‌شود که به‌طور هموار هندسه جاده را دنبال می‌کند.
  • نزدیک‌ترین جاده‌ها این سرویس نزدیک‌ترین بخش جاده را برای نقطه GPS برمی‌گرداند. می‌توانید حداکثر ۱۰۰ نقطه GPS مشخص کنید. نقطه‌هایی که مشخص می‌کنید لازم نیست بخشی از یک مسیر پیوسته باشد.
  • محدودیت‌های سرعت این سرویس محدودیت سرعت اعلام‌شده برای بخشی از جاده را برمی‌گرداند. سرویس «محدودیت سرعت» برای همه مشتریانی که پروانه «ردیابی دارایی» دارند دردسترس است. برای مشتریان طرح Google Maps Platform Premium که به قیمت‌گذاری پرداخت به اندازه استفاده منتقل شده‌اند، این ویژگی فعال باقی می‌ماند.

روش کار Roads API

Roads API از سه نقطه پایانی استفاده می‌کند که مختصات طول/ عرض جغرافیایی یا شناسه‌های مکان را می‌پذیرند تا مسیرهای جاده، بخش‌ها، یا داده‌های محدودیت سرعت را ارائه دهند. مثال زیر درخواستی را برای نزدیک‌ترین جاده‌ها براساس مجموعه‌ای از مختصات طول/عرض جغرافیایی نشان می‌دهد:

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

منابع

جدول زیر منابع دردسترس ازطریق Roads API را به‌همراه داده‌هایی که برمی‌گرداند خلاصه می‌کند.

منابع داده‌ها داده‌های برگردانده‌شده قالب برگشتی
هم‌ترازی با جاده‌ها

آرایه‌ای از حداکثر ۱۰۰ نقطه GPS را از یک مسیر برمی‌گرداند. شامل مختصات طول/ عرض جغرافیایی منطبق بر جاده به‌همراه شناسه‌های مکان است. جزئیات را در پاسخ‌ها در راهنمای هم‌ترازی با جاده‌ها ببینید.

  • (قالب) JSON
نزدیک‌ترین جاده‌ها

آرایه‌ای از حداکثر ۱۰۰ مختصات طول/عرض جغرافیایی مستقل به‌همراه شناسه‌های مکان برای نزدیک‌ترین جاده به هر نقطه مشخص‌شده. امتیازها نباید پیوسته باشند. جزئیات را در پاسخ‌ها در راهنمای نزدیک‌ترین جاده‌ها ببینید.

حد سرعت

آرایه‌ای از حداکثر ۱۰۰ عنصر فراداده جاده. این‌ها حاوی حد سرعت و شناسه مکان هستند و واحد آن‌ها کیلومتر در ساعت یا مایل در ساعت است. جزئیات را در پاسخ‌ها در راهنمای محدوده سرعت ببینید.

نحوه استفاده از Roads API

۱ امتحان کردن نسخه نمایشی هم‌ترازی با جاده‌ها روی نسخه نمایشی کلیک کنید تا قطعه‌ای ایجاد کنید و ببینید که چگونه نقطه پایانی هم‌ترازی با جاده‌ها داده‌های هموار ارائه می‌دهد. به نسخه نمایشی در راهنمای هم‌ترازی با جاده‌ها مراجعه کنید. به کلید میانای API نیاز ندارید.
۲ راه‌اندازی کردن با راه‌اندازی پروژه Google Cloud شروع کنید و دستورالعمل‌های راه‌اندازی را که در ادامه می‌آید تکمیل کنید و سپس نحوه استفاده از کلید میانای برنامه‌سازی کاربردی را یاد بگیرید.
3 امتحان کردن درخواست هم‌ترازی با جاده‌ها از یکی از نمونه‌های هم‌ترازی با جاده‌ها استفاده کنید و نمونه‌ای را که با مورد استفاده شما مرتبط است امتحان کنید.
۴ دریافت محدودیت‌های سرعت برای مسیر جاده بااستفاده از همان داده‌های مسیری که برای درخواست هم‌ترازی با جاده‌ها ارائه کردید، یک پُرسمان محدودیت سرعت صادر کنید. نمونه درخواست بااستفاده از مسیر را ببینید.
‫۵ با نحوه پردازش مسیرهای طولانی آشنا شوید بخش‌های مربوط به پردازش مسیرهای طولانی را در راهنمای مفاهیم پیشرفته دنبال کنید.
‫۶ داده‌های جاده را در برنامه خودتان ادغام کنید! برای شروع ساختن عملکرد داده‌های جاده در برنامه خودتان، نمونه کد دقیق را از نسخه نمایشی جاده چسبیده ببینید.

کتابخانه‌های کارخواه دردسترس

این میانای برنامه‌سازی کاربردی را به زبان انتخابی‌تان ازطریق یکی از کتابخانه‌های کارخواه زیر فراخوانی کنید:

«کارخواه Java»، «کارخواه Python»، «کارخواه Go»، و «کارخواه Node.js» برای «سرویس‌های Google Maps» کتابخانه‌های کارخواه با پشتیبانی انجمن هستند که تحت پروانه Apache 2.0 به‌صورت متن‌باز ارائه شده‌اند. آن‌ها را از GitHub بارگیری کنید، در آنجا می‌توانید دستورالعمل‌های نصب و کد نمونه را نیز پیدا کنید.

قدم بعدی چیست