چرا از 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 را از یک مسیر برمیگرداند. شامل مختصات طول/ عرض جغرافیایی منطبق بر جاده بههمراه شناسههای مکان است. جزئیات را در پاسخها در راهنمای همترازی با جادهها ببینید. |
|
| نزدیکترین جادهها |
آرایهای از حداکثر ۱۰۰ مختصات طول/عرض جغرافیایی مستقل بههمراه شناسههای مکان برای نزدیکترین جاده به هر نقطه مشخصشده. امتیازها نباید پیوسته باشند. جزئیات را در پاسخها در راهنمای نزدیکترین جادهها ببینید. |
|
| حد سرعت |
آرایهای از حداکثر ۱۰۰ عنصر فراداده جاده. اینها حاوی حد سرعت و شناسه مکان هستند و واحد آنها کیلومتر در ساعت یا مایل در ساعت است. جزئیات را در پاسخها در راهنمای محدوده سرعت ببینید. |
نحوه استفاده از Roads API
| ۱ | امتحان کردن نسخه نمایشی همترازی با جادهها | روی نسخه نمایشی کلیک کنید تا قطعهای ایجاد کنید و ببینید که چگونه نقطه پایانی همترازی با جادهها دادههای هموار ارائه میدهد. به نسخه نمایشی در راهنمای همترازی با جادهها مراجعه کنید. به کلید میانای API نیاز ندارید. |
| ۲ | راهاندازی کردن | با راهاندازی پروژه Google Cloud شروع کنید و دستورالعملهای راهاندازی را که در ادامه میآید تکمیل کنید و سپس نحوه استفاده از کلید میانای برنامهسازی کاربردی را یاد بگیرید. |
| 3 | امتحان کردن درخواست همترازی با جادهها | از یکی از نمونههای همترازی با جادهها استفاده کنید و نمونهای را که با مورد استفاده شما مرتبط است امتحان کنید. |
| ۴ | دریافت محدودیتهای سرعت برای مسیر جاده | بااستفاده از همان دادههای مسیری که برای درخواست همترازی با جادهها ارائه کردید، یک پُرسمان محدودیت سرعت صادر کنید. نمونه درخواست بااستفاده از مسیر را ببینید. |
| ۵ | با نحوه پردازش مسیرهای طولانی آشنا شوید | بخشهای مربوط به پردازش مسیرهای طولانی را در راهنمای مفاهیم پیشرفته دنبال کنید. |
| ۶ | دادههای جاده را در برنامه خودتان ادغام کنید! | برای شروع ساختن عملکرد دادههای جاده در برنامه خودتان، نمونه کد دقیق را از نسخه نمایشی جاده چسبیده ببینید. |
کتابخانههای کارخواه دردسترس
این میانای برنامهسازی کاربردی را به زبان انتخابیتان ازطریق یکی از کتابخانههای کارخواه زیر فراخوانی کنید:
- Java Client for Google Maps Services
- Python Client for Google Maps Services
- Go Client for Google Maps Services
- Node.js Client for Google Maps Services
«کارخواه Java»، «کارخواه Python»، «کارخواه Go»، و «کارخواه Node.js» برای «سرویسهای Google Maps» کتابخانههای کارخواه با پشتیبانی انجمن هستند که تحت پروانه Apache 2.0 بهصورت متنباز ارائه شدهاند. آنها را از GitHub بارگیری کنید، در آنجا میتوانید دستورالعملهای نصب و کد نمونه را نیز پیدا کنید.
قدم بعدی چیست
- امتحان کردن Roads API: به Roads Inspector بروید
- با نحوه درخواست دادن به Roads API آشنا شوید: به سرویس موردنظرتان بروید:
- آشنایی با مفاهیم پیشرفته: به مفاهیم پیشرفته بروید
- روالهای مطلوب را دنبال کنید: به روالهای مطلوب سرویسهای وب بروید