לפני שמשתמשים ב-Driver SDK, צריך קודם להפעיל את Navigation SDK ואת Driver SDK באמצעות השלבים הבאים:
מקבלים אובייקט
Navigatorמ-NavigationApi.Java
NavigationApi.getNavigator( this, // Activity new NavigationApi.NavigatorListener() { @Override public void onNavigatorReady(Navigator navigator) { // Keep a reference to the Navigator (used to configure and start nav) this.navigator = navigator; } } );Kotlin
NavigationApi.getNavigator( this, // Activity object : NavigatorListener() { override fun onNavigatorReady(navigator: Navigator) { // Keep a reference to the Navigator (used to configure and start nav) this@myActivity.navigator = navigator } }, )יוצרים אובייקט
DriverContextוממלאים את שדות החובה. כדי לאתחל את האובייקטDriverContext, צריך להזין את מזהה הפרויקט של פרויקט Google Cloud בתורproviderId. מידע על הגדרת פרויקט ב-Google Cloud זמין במאמר יצירת פרויקט Fleet Engine.Java
DriverContext driverContext = DriverContext.builder(application) .setProviderId(providerId) .setVehicleId(vehicleId) .setAuthTokenFactory(authTokenFactory) .setNavigator(navigator) .setRoadSnappedLocationProvider( NavigationApi.getRoadSnappedLocationProvider(application)) .build();Kotlin
val driverContext = DriverContext.builder(application) .setProviderId(providerId) .setVehicleId(vehicleId) .setAuthTokenFactory(authTokenFactory) .setNavigator(navigator) .setRoadSnappedLocationProvider(NavigationApi.getRoadSnappedLocationProvider(application)) .build()משתמשים באובייקט
DriverContextכדי לאתחל את*DriverApi.Java
RidesharingDriverApi ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext);Kotlin
val ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext)מקבלים את
RidesharingVehicleReporterמאובייקט ה-API. (*VehicleReporterextendsNavigationVehicleReporter.)Java
RidesharingVehicleReporter vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter();Kotlin
val vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter()
הערות לגבי SSL/TLS
באופן פנימי, ההטמעה של Driver SDK משתמשת ב-SSL/TLS כדי לתקשר בצורה מאובטחת עם שירות Fleet Engine. יכול להיות שבגרסאות API של Android 23 ומטה יידרש SecurityProvider תיקון כדי לתקשר עם השרת. למידע נוסף על עבודה עם SSL ב-Android, אפשר לעיין במאמר בנושא ספק GMS לאבטחה.
המאמר מכיל גם דוגמאות קוד לתיקון ספק האבטחה.