نظرة عامة على حزمة تطوير البرامج (SDK) الخاصة بالتنقل
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك حزمة Navigation SDK دمج ميزة التنقّل باتّجاهات مفصّلة في "خرائط Google" في تطبيقاتك على الأجهزة الجوّالة. والأهم من ذلك، أنّها توفّر بيانات حول مقطع المسار الحالي والوجهة النهائية، ويتم إرسالها إلى Fleet Engine عندما يبدأ السائق القيادة، وذلك إلى جانب تعديلات الموقع الجغرافي وإحداثيات خطوط الطول والعرض من Driver SDK. ويؤدي ذلك إلى توفير تجربة قيادة متكاملة.
لماذا يجب استخدام حزمة تطوير البرامج للتنقّل؟
تتيح حزمة تطوير البرامج للتنقّل إمكانية الدمج بسهولة مع Fleet Engine للحصول على آخر المعلومات بشأن مسارات السائق. يتيح استخدام حزمة تطوير البرامج (SDK) الخاصة بالتنقل مع حزمة تطوير البرامج (SDK) الخاصة بالسائق إمكانية استخدام تطبيق واحد لإدارة المهام والتنقّل كما يفعل السائقون عند استخدام الإصدار المخصّص للمستهلكين من "خرائط Google"، بدون الحاجة إلى التبديل إلى تطبيق آخر.
الإجراءات التي يمكن تنفيذها باستخدام Navigation SDK
استخدِم حزمة تطوير البرامج Navigation SDK لإرسال ما يلي إلى Fleet Engine.
- تعليمات موثوقة للتنقّل مع اتّجاهات مفصّلة من "خرائط Google"
- طرق مخصّصة استنادًا إلى إحداثيات خطوط العرض/الطول التي توفّرها حزمة تطوير البرامج (SDK) الخاصة بالسائقين
- عناصر الخريطة المخصّصة، مثل العلامات المخصّصة والتراكبات وعناصر واجهة المستخدم، لتسليط الضوء على معلومات التنقّل الرئيسية وتخصيص تجربة التنقّل
طريقة عمل حزمة تطوير البرامج للتنقّل
توفّر حزمة تطوير البرامج (SDK) للتنقّل معلومات حول المسار والوجهة إلى Fleet Engine،
بينما توفّر حزمة تطوير البرامج (SDK) للسائق بثًا من إشعارات التحديث بشأن الموقع الجغرافي وإحداثيات خط الطول وخط العرض والمسافة المتبقية وتقديرات الوقت المتوقع للوصول. يجب إرسال جميع تعديلات بيانات المركبات الأخرى إلى الخلفية الخاصة بالعميل، والتي تنقل البيانات إلى Fleet Engine.
كيفية استخدام حزمة Navigation SDK
تتضمّن الخطوات أدناه سيناريو نموذجيًا لحالة استخدام لدمج حزمة Navigation SDK في تطبيق السائق:
Android
| 1 |
إعداد مشروعك على Google Cloud |
أنشِئ مشروعًا على Google Cloud قبل استخدام حزمة Navigation SDK. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد مشروعك على Google Cloud. |
| 2 |
إضافة حزمة تطوير البرامج للتنقّل إلى مفتاح واجهة برمجة التطبيقات |
مفتاح واجهة برمجة التطبيقات هو معرّف فريد يثبت صحة طلباتك، ويجب ربط مفتاح واحد على الأقل بواجهة برمجة التطبيقات بمشروعك لاستخدام Navigation SDK. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام مفاتيح واجهة برمجة التطبيقات. |
| 3 |
إعداد مشروعك في "استوديو Android" |
أنشئ مشروع Android وادمج فيه حزمة تطوير البرامج للتنقّل. لمزيد من المعلومات، اطّلِع على إعداد مشروعك في "استوديو Android". |
| 4 |
إضافة حزمة تطوير البرامج (SDK) الخاصة ببرنامج التشغيل إلى مشروعك |
ثبِّت حزمة تطوير البرامج (SDK) الخاصة بالسائقين واضبطها لبدء الاستفادة من جميع ميزات Fleet Engine. لمزيد من المعلومات، يُرجى الاطّلاع على الحصول على Driver SDK للرحلات عند الطلب والحصول على Driver SDK للمهام المُجدوَلة. |
iOS
| 1 |
إعداد مشروعك على Google Cloud |
أنشِئ مشروعًا على Google Cloud قبل استخدام حزمة Navigation SDK. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد مشروعك على Google Cloud. |
| 2 |
إضافة حزمة تطوير البرامج للتنقّل إلى مفتاح واجهة برمجة التطبيقات |
مفتاح واجهة برمجة التطبيقات هو معرّف فريد يثبت صحة طلباتك، ويجب ربط مفتاح واحد على الأقل بواجهة برمجة التطبيقات بمشروعك لاستخدام Navigation SDK. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام مفاتيح واجهة برمجة التطبيقات. |
| 3 |
إعداد مشروع Xcode |
أنشئ مشروع Xcode وثبِّت حزمة تطوير البرامج (SDK) الخاصة بخدمة Navigation فيه. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد مشروع Xcode. |
| 4 |
إضافة حزمة تطوير البرامج (SDK) الخاصة ببرنامج التشغيل إلى مشروعك |
ثبِّت حزمة تطوير البرامج (SDK) الخاصة بالسائقين واضبطها لبدء الاستفادة من جميع ميزات Fleet Engine. لمزيد من المعلومات، يُرجى الاطّلاع على الحصول على Driver SDK للرحلات عند الطلب والحصول على Driver SDK للمهام المُجدوَلة. |
للمزيد من المعلومات حول ميزات Navigation SDK، راجِع المستندات الكاملة الخاصة بـ
Android و
iOS.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Navigation SDK enables turn-by-turn navigation within your mobile apps, seamlessly integrating with Google Maps and Fleet Engine for real-time route and location updates.\u003c/p\u003e\n"],["\u003cp\u003eWhen used with the Driver SDK, it provides a comprehensive driving experience within a single app, eliminating the need for drivers to switch between navigation and task management.\u003c/p\u003e\n"],["\u003cp\u003eThe SDK offers customizable routes, map elements, and navigation instructions powered by Google Maps, ensuring a tailored and efficient navigation experience for drivers.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize the Navigation SDK, developers need to set up a Google Cloud project, integrate the SDK into their Android or iOS project, and add the Driver SDK for comprehensive Fleet Engine functionality.\u003c/p\u003e\n"]]],[],null,["The Navigation SDK lets you to integrate Google Maps turn-by-turn navigation\ninto your mobile applications. Crucially, it provides\ncurrent route segment and final destination data, which, along with location\nupdates and latitude/longitude coordinates from the Driver SDK, are sent to the\nFleet Engine when your driver begins driving. This results in a complete driving\nexperience.\n\nWhy use the Navigation SDK?\n\nThe Navigation SDK enables easier integration with Fleet Engine for updates to\nthe driver's routes. Using the Navigation SDK along with the Driver SDK enables\nyour driver can use a single app to manage assignments and navigate as they\nwould using their consumer version of Google Maps, without having to switch to\nanother app.\n\nWhat can you do with the Navigation SDK?\n\nUse the Navigation SDK to communicate the following with Fleet Engine.\n\n- Reliable turn-by-turn navigation instructions powered by Google Maps.\n- Customized routes based on the latitude/longitude coordinates provided by the Driver SDK.\n- Customized map elements, such as custom markers, overlays, and UI elements to highlight key navigation information and to personalize the navigation experience.\n\nHow the Navigation SDK works\n\nThe Navigation SDK provides routing information and destination to Fleet Engine,\nwhile the Driver SDK provides a stream of location updates, latitude/longitude\ncoordinates, remaining distance, and ETAs. All other vehicle data updates must\nbe sent to the customer backend, which relays the data to Fleet Engine.\n\nHow to use the Navigation SDK\n\nThe steps below cover a typical use-case scenario for incorporating the\nNavigation SDK into your driver application: \n\nAndroid\n\n|---|--------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Set up your Google Cloud project** | Create a Google Cloud project before using the Navigation SDK. For more information, see [Set up your Google Cloud project](/maps/documentation/navigation/android-sdk/cloud-setup). |\n| 2 | **Add the Navigation SDK to your API key** | The API key is a unique identifier that authenticates your requests, associate at least one API key with your project to use the Navigation SDK. For more information, see [Using API keys](/maps/documentation/navigation/android-sdk/get-api-key). |\n| 3 | **Set up your Android Studio project** | Create an Android project and integrate the Navigation SDK into it. For more information, see [Set up your Android Studio project](/maps/documentation/navigation/android-sdk/android-studio-setup). |\n| 4 | **Add the Driver SDK to your project** | Install and configure the Driver SDK to start taking advantage of all the Fleet Engine features. For more information, see [Get the Driver SDK for on-demand trips](/maps/documentation/mobility/driver-sdk/on-demand/android/minimum-requirements) and [Get the Driver SDK for scheduled tasks](/maps/documentation/mobility/driver-sdk/scheduled/android/minimum-requirements). |\n\niOS\n\n|---|--------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Set up your Google Cloud project** | Create a Google Cloud project before using the Navigation SDK. For more information, see [Set up your Google Cloud project](/maps/documentation/navigation/ios-sdk/cloud-setup). |\n| 2 | **Add the Navigation SDK to your API key** | The API key is a unique identifier that authenticates your requests, associate at least one API key with your project to use the Navigation SDK. For more information, see [Using API keys](/maps/documentation/navigation/ios-sdk/get-api-key). |\n| 3 | **Set up your Xcode project** | Create an Xcode project and install the Navigation SDK into it. For more information, see [Set up your Xcode project](/maps/documentation/navigation/ios-sdk/xcode-setup). |\n| 4 | **Add the Driver SDK to your project** | Install and configure the Driver SDK to start taking advantage of all the Fleet Engine features. For more information, see [Get the Driver SDK for on-demand trips](/maps/documentation/mobility/driver-sdk/on-demand/ios/minimum-requirements) and [Get the Driver SDK for scheduled tasks](/maps/documentation/mobility/driver-sdk/scheduled/ios/minimum-requirements). |\n\nFor more information about the Navigation SDK features, see the complete\ndocumentation for Navigation SDK for\n[Android](/maps/documentation/navigation/android-sdk) and\n[iOS](/maps/documentation/navigation/ios-sdk)."]]
