نظرة عامة على حزمة تطوير البرامج (SDK) الخاصة بالتنقل
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك حزمة تطوير البرامج (SDK) الخاصة بخدمة Navigation دمج تجربة التنقّل باتّجاهات مفصّلة في "خرائط Google" بسلاسة مباشرةً في تطبيقاتك على الأجهزة الجوّالة. توفّر حزمة تطوير البرامج (SDK) إمكانية تخصيص واجهة المستخدم بما يتناسب مع شكل العلامة التجارية ومظهرها، بالإضافة إلى إعدادات متقدّمة للمسارات.
يساعدك توفير تجارب تنقّل قابلة للتخصيص داخل التطبيق في تعزيز الكفاءة التشغيلية وتحسين تفاعل المستخدمين والحصول على إحصاءات قيّمة مستندة إلى البيانات.
لماذا يجب استخدام حزمة تطوير البرامج للتنقّل؟
يتيح لك دمج ميزة التنقّل في تطبيقك تقديم تجربة أفضل للمستخدمين، مع تطبيق علامتك التجارية الخاصة والاستفادة من بيانات الرحلات:
يمكنك التحكّم في التجربة المتكاملة وزيادة التفاعل من خلال إبقاء المستخدمين داخل تطبيقك أثناء التنقّل، ما يغني عن التبديل بين التطبيقات.
يمكنك تخصيص تجربة التنقّل لتتطابق مع مظهر علامتك التجارية وأسلوبها
باستخدام عناصر واجهة مستخدم قابلة للتخصيص.
يمكنك تحسين تجربة المسار من خلال إدارة إعدادات التوجيه المفضّلة والوجهات ونقاط المرور.
استخدام بيانات الموقع الجغرافي والأحداث من توجيه الرحلات لأغراض التحليلات والتحسينات والتواصل مع العملاء والمراقبة في الوقت الفعلي
الإجراءات التي يمكن تنفيذها باستخدام Navigation SDK
تتيح لك حزمة تطوير البرامج للتنقّل إنشاء تجربة تنقّل شاملة داخل التطبيق:
يمكنك تزويد المستخدمين بتجربة تنقّل سلسة وموثوقة من خلال الاتّجاهات المفصّلة التي توفّرها "خرائط Google".
توفير وسائل نقل مختلفة، بما في ذلك القيادة والمشي وركوب الدراجات والمركبات ذات العجلتين
يمكنك تنفيذ علامات ومربّعات حوار وعناصر واجهة مستخدم مخصّصة لتسليط الضوء على معلومات التنقّل الرئيسية وتخصيص تجربة التنقّل لتتطابق مع علامتك التجارية.
يمكنك الوصول إلى بيانات الرحلات لتحليل المؤشرات وتحديد الجوانب التي يمكن تحسينها وتحسين العمليات.
طريقة عمل حزمة تطوير البرامج للتنقّل
يمكنك استخدام حزمة Navigation SDK لدمج كل من الخرائط وميزات التنقّل في تطبيقك. المكوّنان الرئيسيان لحزمة Navigation SDK هما:
طبقة الخريطة: ابدأ بطبقة خريطة، بما في ذلك عرض الخريطة وتصميمها وعناصر التحكّم في واجهة المستخدم والكاميرا وسلوك التفاعل. تتضمّن حزمة تطوير البرامج للتنقّل وظائف الخرائط من حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google"، ولا يمكن للتطبيقات التي تتضمّن حزمة تطوير البرامج للتنقّل أن تتضمّن حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google". إذا كان تطبيقك يستخدم حزمة تطوير البرامج للخرائط، عليك إزالتها لاستخدام حزمة تطوير البرامج للتنقّل. ومع ذلك، فإنّ واجهة برمجة التطبيقات للخرائط متطابقة تقريبًا في حزمة Navigation SDK، لذا لن تحتاج عادةً إلى تعديل عملية التنفيذ، باستثناء إزالة حزمة Maps SDK. للحصول على معلومات حول الاختلافات بين واجهة برمجة التطبيقات للخرائط ووظائف حزمة تطوير البرامج (SDK) الخاصة بـ "خرائط Google" وحزمة تطوير البرامج (SDK) الخاصة بـ "التنقّل"، يُرجى الاطّلاع على صفحة نظرة عامة في قسم "المراجع".
تجربة التنقّل: أضِف تجربة التنقّل باستخدام، والتي تتضمّن تراكب التنقّل المفصّل وبطاقات الاتّجاهات وعناصر إضافية في واجهة المستخدم. يمكنك استخدام تجربة التنقّل من Google أو إنشاء تجربة تنقّل مخصّصة.
كيفية استخدام حزمة Navigation SDK
تتضمّن الخطوات أدناه سيناريو حالة استخدام نموذجية لاستخدام Navigation SDK:
1
إعداد حسابك
أنشئ مشروعًا على Google Cloud، وأضِف حزمة تطوير البرامج (SDK) الخاصة بخدمة Navigation إلى مفتاح واجهة برمجة التطبيقات، وأعِدّ مشروعك على Android Studio. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد مشروعك.
يمكنك تخصيص تجربة التنقّل والمظهر المرئي من خلال تعديل عناصر التحكّم وعناصر واجهة المستخدم المضمّنة التي تظهر على الخريطة. لمزيد من المعلومات، يُرجى الاطّلاع على تعديل واجهة مستخدم التنقّل.
4
ضبط تفاصيل التوجيه
تعديل إعدادات التوجيه المفضّلة وإدارة نقاط الطريق لمزيد من المعلومات، يُرجى الاطّلاع على تجربة المسار.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Navigation SDK enables integrating Google Maps turn-by-turn navigation directly into your mobile apps, offering UI customization and advanced route configuration.\u003c/p\u003e\n"],["\u003cp\u003eIt enhances user engagement by providing a seamless in-app navigation experience, eliminating the need to switch between apps.\u003c/p\u003e\n"],["\u003cp\u003eBusinesses can leverage the SDK to personalize the navigation experience with custom branding, optimize routes, and gain valuable data-driven insights from trip data.\u003c/p\u003e\n"],["\u003cp\u003eThe Navigation SDK replaces the Maps SDK for both map layer and navigation features within your app, providing a comprehensive solution for in-app navigation.\u003c/p\u003e\n"],["\u003cp\u003eYou can seamlessly guide users with turn-by-turn directions, support various transportation modes, implement custom UI elements, and access trip data for analysis and optimizations.\u003c/p\u003e\n"]]],[],null,["# Navigation SDK overview\n\nThe Navigation SDK lets you seamlessly integrate the Google Maps turn-by-turn\nnavigation experience directly into your mobile applications. The SDK offers UI\ncustomization for brand look and feel and advanced route configuration.\nProviding customizable, in-app navigation experiences helps you enhance\noperational efficiency, improve user engagement, and gain valuable data-driven\ninsights.\n| **Note:** **European Economic Area (EEA)** : The default user interface and functionality of the Navigation SDK are deemed fully compliant with the [EEA Safety Requirements](https://cloud.google.com/terms/maps-platform/eea-safety-requirements).\n\nWhy use the Navigation SDK?\n---------------------------\n\nIntegrating navigation into your app lets you provide a superior experience for\nyour users, while applying your own branding and leveraging trip data:\n\n- Control the end-to-end experience and increase engagement by keeping users within your app during navigation, eliminating the need to switch between apps.\n- Personalize the navigation experience to match your brand's look and feel with customizable UI elements.\n- Optimize the route experience by managing routing preferences, destinations, and waypoints.\n- Utilize location and event data from trip routing for analytics, optimizations, customer communications, and real-time monitoring.\n\nWhat can you do with the Navigation SDK?\n----------------------------------------\n\nThe Navigation SDK lets you create a comprehensive in-app navigation experience:\n\n- Provide your users with a seamless and reliable turn-by-turn navigation experience powered by Google Maps.\n- Support various modes of transportation, including driving, walking, cycling, and two-wheel vehicles.\n- Implement custom markers, overlays, and UI elements to highlight key navigation information and to personalize the navigation experience to match your brand.\n- Access trip data to analyze trends, identify areas for improvement, and optimize operations.\n\nHow the Navigation SDK works\n----------------------------\n\nYou can use the Navigation SDK to incorporate both maps and navigation features\ninto your app. The two main components of the Navigation SDK are:\n\n- **Map Layer** : Begin with a map layer, including map view, styling, UI controls, camera, and interaction behavior. The Navigation SDK includes the map functionality from the [Maps SDK](/maps/documentation/android-sdk), and apps that include the Navigation SDK cannot include the Maps SDK. If your app uses the Maps SDK, you need to remove it in order to use the Navigation SDK. However, the maps API is nearly identical in the Navigation SDK, so you typically don't need to update your implementation, other than removing the Maps SDK. For information on the maps API and functionality differences between the Maps SDK and the Navigation SDK, see the [Overview](https://developers.google.com/maps/documentation/navigation/android-sdk/reference) page in the Reference section\n- **Navigation Experience** : Add the navigation experience using the, which includes the turn-by-turn navigation overlay, turn cards, and additional UI elements. You can either use the [Google Navigation\n experience](/maps/documentation/navigation/android-sdk/intro-google-nav) or build your own [custom navigation\n experience](/maps/documentation/navigation/android-sdk/intro-custom-nav).\n\n| **Note:** If your app already uses the [Maps SDK](/maps/documentation/android-sdk), the Navigation SDK replaces the Maps SDK for both map layer and navigation features. You cannot use the Navigation SDK and Maps SDK in the same app.\n\nHow to use the Navigation SDK\n-----------------------------\n\nThe steps below cover a typical use case scenario for using the Navigation SDK:\n\n|---|----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Create a Google Cloud project, add the Navigation SDK to your API key, and set up your Android Studio project. For more information, see [Set up your project](/maps/documentation/navigation/android-sdk/set-up-project). |\n| 2 | **Navigate to your first route** | Plot a route within your app to a single destination. For more information, see [Navigate a single-destination route](/maps/documentation/navigation/android-sdk/route). |\n| 3 | **Modify the navigation UI** | Customize the navigation experience and visual appearance by modifying the built-in UI controls and elements appear on the map. For more information, see [Modify the navigation UI](/maps/documentation/navigation/android-sdk/controls). |\n| 4 | **Adjust routing details** | Modify routing preferences and manage waypoints. For more information, see [Route experience](/maps/documentation/navigation/android-sdk/intro-route-experience). |\n\nFor more information about the Navigation SDK features, see\n[Reference](/maps/documentation/navigation/android-sdk/reference), or [Try\nthe demo](/maps/documentation/navigation/android-sdk/try-demo)."]]
