לפני שמשתמשים ב-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. (*VehicleReporter
הוא תת-ממשק שלNavigationVehicleReporter
).Java
RidesharingVehicleReporter vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter();
Kotlin
val vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter()
הערות לגבי SSL/TLS
מבפנים, ההטמעה של Driver SDK משתמשת ב-SSL/TLS כדי לתקשר בצורה מאובטחת עם שירות Fleet Engine. יכול להיות שבגרסאות Android API 23 ואילך יהיה צורך בתיקון SecurityProvider
כדי לתקשר עם השרת. למידע נוסף על עבודה עם SSL ב-Android, ראו Security GMS Provider.
המאמר מכיל גם דוגמאות קוד לתיקון של ספק האבטחה.