Để chạy bản minh hoạ, bạn phải có một tài khoản Google Cloud và một khoá API do bộ phận bán hàng bật cho Navigation SDK. Sau khi có tài khoản Google Cloud, hãy xem phần Thiết lập dự án phát triển và khoá API.
Thiết lập dự án phát triển và khoá API
Tạo hoặc mở một dự án trong Google Cloud Console để sử dụng với Maps SDK cho iOS. Đợi vài phút cho đến khi dự án xuất hiện trên Cloud Console.
Bật Maps SDK cho iOS trong bảng điều khiển Google Cloud.
Trong dự án, hãy mở phần API rồi bật Maps SDK cho iOS.
Tạo khoá API cho dự án bằng cách chọn API và Dịch vụ > Thông tin xác thực > Tạo thông tin xác thực > Khoá API.
Thêm Maps SDK cho iOS vào khoá API của bạn. Để biết thêm thông tin, hãy xem bài viết Sử dụng khoá API.
Dùng thử ứng dụng minh hoạ
Giờ đây, bạn có thể tải xuống, tạo và chạy bản minh hoạ.
Thêm khoá API của riêng bạn vào tệp SDKDemoAPIKey. Bạn phải sử dụng khoá API mà bạn đã tạo trong các bước ở phần Thiết lập dự án phát triển và khoá API.
Để chạy bản minh hoạ, hãy tạo ứng dụng trong Xcode khi một thiết bị iOS kết nối với máy tính của bạn hoặc sử dụng một trình mô phỏng.
Khắc phục sự cố
Hiện/Ẩn thông tin khắc phục sự cố
Chọn một thiết bị iOS hoặc trình mô phỏng chạy iOS 15 trở lên.
Nếu bạn không thấy trình mô phỏng nào, hãy thêm các đích đến Rosetta: trong Product > Destination > Destination Architectures (Sản phẩm > Đích đến > Cấu trúc đích đến), hãy chọn Show Rosetta Destinations (Hiện các đích đến Rosetta).
Nếu bản dựng của bạn không thành công với Sandbox: rsync.samba() deny, hãy tắt tính năng Chạy tập lệnh người dùng trong môi trường hộp cát: trong Build Settings > Build Options (Cài đặt bản dựng > Lựa chọn bản dựng), hãy đặt User Script Sandboxing (Chạy tập lệnh người dùng trong môi trường hộp cát) thành No (Không).
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\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**."]]
