הפעלה של ה-SDK של הנהג
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
לפני שמשתמשים ב-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 extends 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, אפשר לעיין במאמר בנושא ספק GMS לאבטחה.
במאמר יש גם דוגמאות קוד לתיקון ספק האבטחה.
המאמרים הבאים
הכנת הרכב
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\u003cp\u003eBefore utilizing the Driver SDK, ensure the Navigation SDK and Driver SDK are initialized by obtaining a \u003ccode\u003eNavigator\u003c/code\u003e object and creating a \u003ccode\u003eDriverContext\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eDriverContext\u003c/code\u003e requires your Google Cloud Project ID and other identifying information to establish communication with Fleet Engine.\u003c/p\u003e\n"],["\u003cp\u003eInitialize the specific Driver API, such as \u003ccode\u003eRidesharingDriverApi\u003c/code\u003e, using the created \u003ccode\u003eDriverContext\u003c/code\u003e for access to relevant functionalities.\u003c/p\u003e\n"],["\u003cp\u003eObtain the appropriate \u003ccode\u003eVehicleReporter\u003c/code\u003e from the initialized API to enable vehicle tracking and reporting within your application.\u003c/p\u003e\n"],["\u003cp\u003eThe Driver SDK utilizes SSL/TLS for secure communication and may require a \u003ccode\u003eSecurityProvider\u003c/code\u003e patch for older Android API versions.\u003c/p\u003e\n"]]],[],null,["Before using the Driver SDK, you must first initialize\nthe Navigation SDK and Driver SDK following these steps:\n\n1. Obtain a `Navigator` object from the `NavigationApi`.\n\n Java \n\n NavigationApi.getNavigator(\n this, // Activity\n new NavigationApi.NavigatorListener() {\n @Override\n public void onNavigatorReady(Navigator navigator) {\n // Keep a reference to the Navigator (used to configure and start nav)\n this.navigator = navigator;\n }\n }\n );\n\n Kotlin \n\n NavigationApi.getNavigator(\n this, // Activity\n object : NavigatorListener() {\n override fun onNavigatorReady(navigator: Navigator) {\n // Keep a reference to the Navigator (used to configure and start nav)\n this@myActivity.navigator = navigator\n }\n },\n )\n\n2. Create a `DriverContext` object, populating the required fields. To\n initialize the `DriverContext` object, you must enter the **Project ID**\n of your Google Cloud Project as the `providerId`. For information\n on setting up the Google Cloud Project, see\n [Create your Fleet Engine project](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/create-project).\n\n Java \n\n DriverContext driverContext = DriverContext.builder(application)\n .setProviderId(providerId)\n .setVehicleId(vehicleId)\n .setAuthTokenFactory(authTokenFactory)\n .setNavigator(navigator)\n .setRoadSnappedLocationProvider(\n NavigationApi.getRoadSnappedLocationProvider(application))\n .build();\n\n Kotlin \n\n val driverContext =\n DriverContext.builder(application)\n .setProviderId(providerId)\n .setVehicleId(vehicleId)\n .setAuthTokenFactory(authTokenFactory)\n .setNavigator(navigator)\n .setRoadSnappedLocationProvider(NavigationApi.getRoadSnappedLocationProvider(application))\n .build()\n\n3. Use the `DriverContext` object to initialize the `*DriverApi`.\n\n Java \n\n RidesharingDriverApi ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext);\n\n Kotlin \n\n val ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext)\n\n4. Obtain the `RidesharingVehicleReporter` from the API object.\n (`*VehicleReporter` extends `NavigationVehicleReporter`.)\n\n Java \n\n RidesharingVehicleReporter vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter();\n\n Kotlin \n\n val vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter()\n\nNotes on SSL/TLS\n\nInternally, the Driver SDK implementation uses\nSSL/TLS to communicate securely with the Fleet Engine service. Android API\nversions 23 or\nearlier may require a `SecurityProvider` patch to communicate with the\nserver. For more information about working with SSL in Android, see\n[Security GMS Provider](https://developer.android.com/training/articles/security-gms-provider).\nThe article also contains code samples for patching the security provider.\n\nWhat's next\n\n[Get the vehicle ready](/maps/documentation/mobility/driver-sdk/on-demand/android/vehicle-ready)"]]
