نمای کلی Roads API

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

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

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

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

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

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

  • Snap to Roads این سرویس محتمل ترین جاده های پیموده شده را بر اساس مجموعه مختصات GPS ارائه شده برمی گرداند. شما می توانید تا 100 نقطه GPS جمع آوری شده در طول یک مسیر را مشخص کنید. به صورت اختیاری، می‌توانید درخواست کنید که سرویس نقاط اضافی را درون‌یابی کند و در نتیجه مسیری ایجاد شود که به آرامی هندسه جاده را دنبال کند.
  • نزدیکترین جاده ها این سرویس نزدیکترین بخش جاده را برای یک نقطه GPS برمی گرداند. شما می توانید تا 100 نقطه GPS را مشخص کنید. لازم نیست نقاطی که مشخص می کنید بخشی از یک مسیر پیوسته باشند.
  • محدودیت سرعت این سرویس محدودیت سرعت اعلام شده را برای یک بخش جاده برمی گرداند. سرویس محدودیت سرعت برای همه مشتریان دارای مجوز ردیابی دارایی در دسترس است. برای مشتریان پلتفرم Google Maps Premium Plan که به قیمت‌های پرداختی روی آورده‌اند، این ویژگی فعال باقی می‌ماند.

نحوه عملکرد 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 را به همراه داده هایی که برمی گرداند خلاصه می کند.

منابع داده داده ها برگردانده شد فرمت بازگشت
ضربه محکم و ناگهانی به جاده ها

آرایه ای تا 100 نقطه GPS را از یک مسیر برمی گرداند. شامل مختصات طول جغرافیایی/طول جغرافیایی به همراه شناسه مکان است. جزئیات را در پاسخ ها در راهنمای Snap to roads مشاهده کنید.

  • JSON
نزدیکترین جاده ها

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

محدودیت سرعت

آرایه ای از حداکثر 100 عنصر ابرداده جاده. این شامل محدودیت‌های سرعت و شناسه‌های مکان، با واحدهای KPH یا MPH است. جزئیات را در Responses در راهنمای محدودیت سرعت مشاهده کنید.

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

1 دموی Snap to Roads را امتحان کنید روی دمو کلیک کنید تا یک مسیر ایجاد کنید و ببینید که چگونه نقطه پایانی Snap to Roads داده های صافی را ارائه می دهد. نسخه نمایشی را در راهنمای Snap to roads ببینید. شما نیازی به کلید API ندارید.
2 راه اندازی شود با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی را تکمیل کنید و سپس نحوه استفاده از کلید API خود را بیاموزید.
3 درخواست فوری به جاده ها را امتحان کنید از یکی از نمونه‌های snap to roads استفاده کنید و یکی از موارد مربوط به مورد استفاده خود را امتحان کنید.
4 محدودیت سرعت برای مسیر جاده خود دریافت کنید با استفاده از همان داده‌های مسیری که برای درخواست snap به جاده‌ها ارائه کردید، یک درخواست محدودیت سرعت صادر کنید. به مثال درخواست با استفاده از یک مسیر مراجعه کنید .
5 یاد بگیرید که چگونه مسیرهای طولانی را پردازش کنید بخش‌های پردازش مسیرهای طولانی را در راهنمای مفاهیم پیشرفته دنبال کنید.
6 داده های جاده را در برنامه خود بگنجانید! برای شروع ساختن عملکرد داده‌های جاده‌ای در برنامه خود، نمونه کد دقیق را از نسخه ی نمایشی گرفته شده در جاده ببینید.

کتابخانه های مشتری موجود

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

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

بعدش چی