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

رابط برنامه‌نویسی کاربردی انتخاب جاده‌ها (Roads Selection API) یکی از اجزای اصلی محصول « بینش‌های مدیریت جاده‌ها» (Roads Management Insights) است.

از API انتخاب جاده‌ها (Roads Selection API) برای عضویت در مسیرهایی که می‌خواهید داده‌های جاده‌ای آنها را جمع‌آوری کنید، استفاده کنید. پس از عضویت در یک مسیر مشخص، API به صورت دوره‌ای اطلاعات مسیر را در یک جدول Big Query یا یک اشتراک Pub/Sub برای تجزیه و تحلیل و نظارت بازیابی و منتشر می‌کند.

نحوه عملکرد API انتخاب جاده‌ها

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

همچنین می‌توانید جزئیات هر یک از مسیرهای ثبت‌شده خود را بازیابی و به‌روزرسانی کنید و در صورت نیاز، جمع‌آوری داده‌ها از هر مسیری را متوقف کنید. این عملیات را می‌توان روی مسیرهای منفرد یا به‌صورت دسته‌ای انجام داد.

منابع API

جدول زیر منابع اصلی و نقاط پایانی موجود از طریق API انتخاب جاده‌ها و اهداف آنها را خلاصه می‌کند.

نقطه پایانی API	توضیحات	قالب
create	علاقه شما را به داده‌های پیوسته جاده برای مسیری که توسط مبدا، مقصد و نقاط مسیر میانی اختیاری تعریف شده است، ثبت می‌کند.	جی‌سون
batchCreate	با ارائه مبدأ، مقصد و نقاط مسیر میانی برای هر مسیر، چندین مسیر را برای جمع‌آوری داده‌ها ثبت می‌کند.	جی‌سون
get	با ارائه selectedRouteId جزئیات مربوط به یک مسیر قبلاً ایجاد شده را بازیابی می‌کند.	جی‌سون
list	لیستی از تمام مسیرهایی که ایجاد کرده‌اید را بازیابی می‌کند.	جی‌سون
patch	جزئیات مسیری که قبلاً ایجاد شده است را با ارائه selectedRouteId آن به‌روزرسانی می‌کند.	جی‌سون
batchUpdate	جزئیات چندین مسیر را به طور همزمان به‌روزرسانی می‌کند.	جی‌سون
delete	با ارائه selectedRouteId جمع‌آوری داده‌ها برای یک مسیر خاص را متوقف می‌کند.	جی‌سون
batchDelete	جمع‌آوری داده‌ها برای چندین مسیر به طور همزمان را متوقف می‌کند.	جی‌سون