تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتوفّر حزمة Navigation SDK كمكتبة ثابتة. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات مرجع Navigation SDK.
قبل البدء
لتشغيل العرض التوضيحي، يجب أن يكون لديك حساب على Google Cloud ومفتاح واجهة برمجة تطبيقات مفعَّل لـ Navigation SDK من خلال فريق المبيعات. بعد إنشاء حساب على Google Cloud، اطّلِع على إعداد مشروع التطوير ومفتاح واجهة برمجة التطبيقات.
إعداد مشروع التطوير ومفتاح واجهة برمجة التطبيقات
أنشئ مشروعًا أو افتحه في وحدة تحكّم Google Cloud لاستخدامه مع
حزمة تطوير البرامج (SDK) لخدمة "خرائط Google" المتوافقة مع iOS. انتظِر بضع دقائق إلى أن يظهر المشروع في Cloud Console.
فعِّل حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لأجهزة iOS في Google Cloud Console.
في المشروع، افتح قسم "واجهات برمجة التطبيقات" وفعِّل Maps SDK لنظام التشغيل iOS.
أنشئ مفتاحًا لواجهة برمجة التطبيقات للمشروع من خلال اختيار واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد > إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات.
أضِف حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS إلى مفتاح واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام مفاتيح واجهة برمجة التطبيقات.
أضِف مفتاح واجهة برمجة التطبيقات الخاص بك إلى ملف SDKDemoAPIKey. يجب استخدام مفتاح واجهة برمجة التطبيقات الذي أنشأته في الخطوات الواردة في مقالة إعداد مشروع التطوير ومفتاح واجهة برمجة التطبيقات.
لتشغيل العرض التوضيحي، أنشئ التطبيق في Xcode مع توصيل جهاز iOS بجهاز الكمبيوتر، أو استخدِم محاكيًا.
تحديد المشاكل وحلّها
إظهار/إخفاء معلومات تحديد المشاكل وحلّها
اختَر جهاز iOS أو محاكيًا يعمل بالإصدار iOS 15 أو إصدار أحدث.
إذا لم يظهر لك محاكي متاح، أضِف وجهات Rosetta باتّباع الخطوات التالية: في المنتج > الوجهة > بنى الوجهة، اختَر عرض وجهات Rosetta.
إذا تعذّر إنشاء الإصدار وظهرت الرسالة Sandbox: rsync.samba() deny، عليك إيقاف ميزة "وضع الحماية لبرامج المستخدمين" من خلال الانتقال إلى إعدادات الإنشاء > خيارات الإنشاء وضبط وضع الحماية لبرامج المستخدمين على لا.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Navigation SDK provides turn-by-turn navigation functionality and requires a Google Cloud account with an API key enabled for the SDK.\u003c/p\u003e\n"],["\u003cp\u003eYou must have the Maps SDK for iOS installed in your app before integrating the Navigation SDK.\u003c/p\u003e\n"],["\u003cp\u003eTo try the demo app, download it as a Cocoapod, add your API key, and build the app in Xcode using a compatible iOS device or simulator.\u003c/p\u003e\n"],["\u003cp\u003eXcode 12 users might encounter compilation issues for the simulator which can be resolved using steps outlined in the Navigation SDK FAQ.\u003c/p\u003e\n"],["\u003cp\u003eFor troubleshooting, use an iOS device or simulator with iOS 15 or above, enable Rosetta destinations if necessary, and disable User Script Sandboxing if encountering build failures related to rsync.samba().\u003c/p\u003e\n"]]],["The Navigation SDK requires a Google Cloud account and an API key enabled by sales. Setup involves creating a project in the Google Cloud console, enabling the Maps SDK for iOS, and generating an API key. The Maps SDK must be installed alongside the Navigation SDK. Demo code is available on GitHub in Swift and Objective-C. To run the demo, Xcode must be installed, and the API key added to the `SDKDemoAPIKey` file. Run the app using an iOS device or simulator, ensuring iOS 15 or above.\n"],null,["# Try the demo\n\nThe Navigation SDK is available as a static library. For\nmore information, see the [Navigation SDK reference\ndocumentation](/maps/documentation/navigation/ios-sdk/reference/objc/Classes).\n\nBefore you begin\n----------------\n\nTo run the demo, you must have a Google Cloud account and an API key enabled for\nthe Navigation SDK by sales. Once you have a Google Cloud account, see [Set up\nyour development project and API key](#setup).\n| **Note:** The Navigation SDK extends the [Maps SDK](/maps/documentation/ios-sdk). If your app uses the Maps SDK for its map layer, you can add the Navigation SDK to your app to enable the navigation experience. You cannot use the Navigation SDK without also having the Maps SDK installed in your app.\n\n### Set up your development project and API key\n\n1. **Create or open a project** in the [Google Cloud console](https://console.cloud.google.com) to use with the\n Maps SDK for iOS. Wait for a few minutes until the\n project is visible on the Cloud console.\n\n2. **Enable Maps SDK for iOS in the Google Cloud console.**\n In the project, open the APIs section and enable the\n Maps SDK for iOS.\n\n3. **Create an API key for the project** , by selecting **APIs \\& Services \\\u003e\n Credentials \\\u003e Create credentials \\\u003e API key**.\n\n4. Add the Maps SDK for iOS to your API key. For more\n information, see [Using API\n Keys](/maps/documentation/navigation/ios-sdk/get-api-key).\n\nTry the demo app\n----------------\n\nYou can now download, build, and run the demo.\n| There is a known issue where apps don't compile properly for the simulator under Xcode 12. If you experience this issue, see the [Navigation SDK FAQ](/maps/documentation/navigation/ios-sdk/faq#demoappxcode12) for steps to resolve the problem.\n\n### Download the demo\n\nThe demo code is available on GitHub:\n\n- [Swift navigation\n demo](https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/tree/main/GoogleNavigation-Swift).\n- [Objective-C navigation\n demo](https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/tree/main/GoogleNavigation).\n\n### Build and run the demo\n\nFollow these steps to build and run the demo app:\n\n1. Install [Xcode](https://developer.apple.com/xcode/).\n\n2. Add your own API key to the `SDKDemoAPIKey` file. You must use the API key\n that you created in the steps in [Set up your development project and API\n key](#setup).\n\n3. To run the demo, build the app in Xcode with an iOS device connected to your\n computer, or use a simulator.\n\n### Troubleshooting\n\nShow/Hide the troubleshooting information\n\n- Choose an iOS device or simulator running iOS 15 or above.\n- If you don't see a simulator available, add Rosetta destinations: in **Product \\\u003e Destination \\\u003e Destination Architectures** , choose **Show Rosetta\n Destinations**.\n- If your build fails with **Sandbox: rsync.samba() deny** , disable User Script Sandboxing: in **Build Settings \\\u003e Build Options** , set **User\n Script Sandboxing** to **No**."]]
