نمای کلی Roads API

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

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

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

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

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

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

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

نحوه عملکرد 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 از یک مسیر را برمی‌گرداند. شامل مختصات طول/عرض جغرافیایی ثبت‌شده از جاده به همراه شناسه مکان‌ها است. جزئیات را در پاسخ‌ها در راهنمای «ثبت جاده‌ها» ببینید.

  • جی‌سون
نزدیکترین جاده‌ها

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

محدودیت‌های سرعت

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

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

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

کتابخانه‌های کلاینت موجود

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

کلاینت جاوا، کلاینت پایتون، کلاینت گو و کلاینت نود.جی‌اس برای سرویس‌های نقشه‌های گوگل، کتابخانه‌های کلاینتی هستند که توسط جامعه پشتیبانی می‌شوند و تحت مجوز آپاچی ۲.۰ متن‌باز می‌باشند. آن‌ها را از گیت‌هاب دانلود کنید، جایی که می‌توانید دستورالعمل‌های نصب و نمونه کد را نیز پیدا کنید.

قدم بعدی چیست؟