iOS पर काम करने वाले अपने उपभोक्ता ऐप्लिकेशन में, मांग के हिसाब से ट्रिप की जानकारी पाने के लिए, Consumer SDK का इस्तेमाल करें. यात्राएं फ़ॉलो करने के बारे में ज़्यादा जानने और इसे आज़माने के लिए, iOS में यात्रा फ़ॉलो करना लेख पढ़ें.
अपने iOS उपभोक्ता ऐप्लिकेशन के लिए Consumer SDK सेट अप करने के लिए, यह तरीका अपनाएं:
Consumer SDK के जिस वर्शन का इस्तेमाल किया जा रहा है उसके लिए, ज़रूरी शर्तों के बारे में जानकारी देने वाले रिलीज़ नोट देखें. प्रॉडक्ट की जानकारी देखें.
मोबाइल डिवाइस में iOS 14 या इसके बाद का वर्शन होना चाहिए.
Consumer SDK को CocoaPods की मदद से इंस्टॉल और कॉन्फ़िगर किया जाता है.
Swift Package Manager
Consumer SDK को
Swift Package Manager की मदद से इंस्टॉल किया जा सकता है. एसडीके टूल जोड़ने के लिए, पक्का करें कि आपने Consumer SDK की सभी मौजूदा डिपेंडेंसी हटा दी हों.
किसी नए या मौजूदा प्रोजेक्ट में SDK टूल जोड़ने के लिए, यह तरीका अपनाएं:
Xcode project या workspace खोलें. इसके बाद, File > Add Package Dependencies पर जाएं.
किसी खास version को इंस्टॉल करने के लिए, Dependency Rule फ़ील्ड को वर्शन के आधार पर उपलब्ध विकल्पों में से किसी एक पर सेट करें. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि आप नए वर्शन के बारे में बताएं और "Exact Version" विकल्प का इस्तेमाल करें. यह चरण पूरा होने के बाद, "पैकेज जोड़ें" पर क्लिक करें.
किसी मौजूदा प्रोजेक्ट के लिए package अपडेट करने के लिए, यह तरीका अपनाएं:
इंस्टॉल करने की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन पर जाएं. यहां पैकेज और उसके वर्शन की पुष्टि करें.
मैन्युअल तरीके से इंस्टॉल किए गए मौजूदा Consumer SDK को हटाने के लिए, यह तरीका अपनाएं:
Xcode प्रोजेक्ट कॉन्फ़िगरेशन सेटिंग में जाकर, Frameworks, Libraries, and Embedded Content ढूंढें. नीचे दिए गए फ़्रेमवर्क को हटाने के लिए, माइनस के निशान(-) का इस्तेमाल करें:
GoogleRidesharingConsumer.xcframework
अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री से, GoogleRidesharingConsumer बंडल हटाएं.
CocoaPods का इस्तेमाल करना
CocoaPods टूल इंस्टॉल करें: टर्मिनल विंडो खोलें और यह कमांड चलाएं:
Consumer SDK के लिए Podfile बनाएं: एपीआई और उसकी डिपेंडेंसी इंस्टॉल करने के लिए, Podfile का इस्तेमाल करें.
अपने प्रोजेक्ट डायरेक्ट्री में Podfile नाम की फ़ाइल बनाएं. इस फ़ाइल में, आपके प्रोजेक्ट की डिपेंडेंसी तय की जाती हैं.
Podfile में बदलाव करें और अपनी डिपेंडेंसी जोड़ें. यहां एक उदाहरण दिया गया है, जिसमें डिपेंडेंसी शामिल हैं:
source"https://github.com/CocoaPods/Specs.git"
target'YOUR_APPLICATION_TARGET_NAME_HERE'dopod'GoogleRidesharingConsumer'
end
Podfile सेव करें: टर्मिनल खोलें और उस फ़ोल्डर पर जाएं जिसमें Podfile है:
cd<path-to-project>
pod install कमांड चलाएं: यह कमांड, Podfile में बताए गए एपीआई और उनसे जुड़ी सभी डिपेंडेंसी इंस्टॉल करती है.
podinstall
Xcode में अपना प्रोजेक्ट खोलें: Xcode को बंद करें. इसके बाद, Xcode लॉन्च करने के लिए, अपने प्रोजेक्ट की .xcworkspace फ़ाइल को खोलें (डबल-क्लिक करें). प्रोजेक्ट को बाद में खोलने के लिए, .xcworkspace फ़ाइल का इस्तेमाल करें.
मैन्युअल तरीके से इंस्टॉल करना
इस गाइड में, Consumer SDK वाले XCFramework को अपने प्रोजेक्ट में मैन्युअल तरीके से जोड़ने का तरीका बताया गया है. साथ ही, Xcode में अपनी बिल्ड सेटिंग को कॉन्फ़िगर करने का तरीका भी बताया गया है.
इस गाइड में दिए गए निर्देशों का पालन करने से पहले, ये काम करें:
XCFramework डाउनलोड करें. यह एक बाइनरी पैकेज है, जिसका इस्तेमाल Consumer SDK को इंस्टॉल करने के लिए किया जाता है. इस पैकेज का इस्तेमाल कई प्लैटफ़ॉर्म पर किया जा सकता है. इनमें M1 चिपसेट का इस्तेमाल करने वाली मशीनें भी शामिल हैं.
XCFramework और संसाधनों को ऐक्सेस करने के लिए, ज़िप की गई फ़ाइलों को अनपैक करें.
Xcode शुरू करें और कोई प्रोजेक्ट खोलें या बनाएं. अगर आपने iOS का इस्तेमाल पहले कभी नहीं किया है, तो नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें.
अगर आपके प्रोजेक्ट ग्रुप में फ़्रेमवर्क ग्रुप नहीं है, तो उसे बनाएं.
डाउनलोड की गई gRPCCertificates.bundle फ़ाइल को खींचकर, अपने Xcode प्रोजेक्ट की टॉप-लेवल डायरेक्ट्री में ले जाएं. अगर कहा जाए, तो आइटम कॉपी करें चुनें.
Consumer SDK टूल को इंस्टॉल करने के लिए, GoogleRidesharingConsumer.xcframework फ़ाइल को अपने प्रोजेक्ट में Frameworks, Libraries, and Embedded Content में जाकर खींचें और छोड़ें. अगर कहा जाए, तो आइटम कॉपी करें चुनें.
डाउनलोड किए गए GoogleRidesharingConsumer.bundle को अपने Xcode प्रोजेक्ट की टॉप-लेवल डायरेक्ट्री में खींचें और छोड़ें. अगर कहा जाए, तो आइटम कॉपी करें चुनें.
प्रोजेक्ट नेविगेटर में जाकर अपना प्रोजेक्ट चुनें. इसके बाद, अपने ऐप्लिकेशन का टारगेट चुनें.
Build Phases टैब खोलें. इसके बाद, Link Binary with Libraries में जाकर, अगर ये फ़्रेमवर्क और लाइब्रेरी पहले से मौजूद नहीं हैं, तो इन्हें जोड़ें:
Accelerate.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libz.tbd
Metal.framework
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
किसी खास टारगेट के बजाय, अपना प्रोजेक्ट चुनें. इसके बाद, Build Settings टैब खोलें. अन्य लिंकर फ़्लैग सेक्शन में जाकर, डीबग और रिलीज़, दोनों के लिए -ObjC जोड़ें.
अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में मौजूद फ़िल्टर को बेसिक से सभी पर बदलें.
Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करना
Apple के हिसाब से यह ज़रूरी है कि App Store पर मौजूद ऐप्लिकेशन के लिए, निजता से जुड़ी जानकारी दी जाए. अपडेट और ज़्यादा जानकारी के लिए, Apple App Store के निजता नीति के ब्यौरे वाले पेज पर जाएं.
Apple की Privacy Manifest फ़ाइल, एसडीके के रिसॉर्स बंडल में शामिल होती है. निजता मेनिफ़ेस्ट फ़ाइल को शामिल किया गया है या नहीं, इसकी पुष्टि करने के लिए अपने ऐप्लिकेशन का संग्रह बनाएं. साथ ही, इसके कॉन्टेंट की जांच करने के लिए, संग्रह से निजता रिपोर्ट जनरेट करें.
[null,null,["आखिरी बार 2025-08-31 (UTC) को अपडेट किया गया."],[[["\u003cp\u003eThis documentation outlines the setup process for the Google Maps Platform Consumer SDK for iOS, enabling on-demand trip following in your iOS consumer apps.\u003c/p\u003e\n"],["\u003cp\u003eThe SDK requires iOS 14 or later, Xcode 15 or later, and can be installed using CocoaPods, Swift Package Manager, or manual installation.\u003c/p\u003e\n"],["\u003cp\u003eAfter installation, developers must configure a Google Cloud Console project, obtain authentication tokens, and initialize the SDK in their app.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should inspect the included Apple Privacy Manifest file to ensure compliance with Apple's App Store privacy requirements.\u003c/p\u003e\n"]]],["To integrate the Consumer SDK for on-demand trip tracking in iOS apps, start by checking the minimum system requirements: iOS 14+ and Xcode 15+. Install the SDK using Swift Package Manager or CocoaPods, ensuring removal of any existing Consumer SDK dependencies. Alternatively, a manual installation option is described. Add required frameworks and libraries, set the `-ObjC` linker flag, then inspect the Apple Privacy Manifest file, and configure your Google Cloud Console project.\n"],null,["Select platform: [Android](/maps/documentation/mobility/journey-sharing/on-demand/android/setup \"View this page for the Android platform docs.\") [iOS](/maps/documentation/mobility/journey-sharing/on-demand/ios/setup \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/mobility/journey-sharing/on-demand/javascript/setup \"View this page for the JavaScript platform docs.\")\n\n\u003cbr /\u003e\n\nTo follow on-demand trips in your iOS consumer apps, use\nthe Consumer SDK. For more information on and an introduction to following\ntrips, see\n[Follow a trip in iOS](/maps/documentation/mobility/journey-sharing/on-demand).\n| For examples, see the [iOS sample apps](https://github.com/googlemaps/ios-on-demand-rides-deliveries-samples) or [combined samples](https://github.com/googlemaps/on-demand-rides-deliveries-samples).\n\nTo set up the Consumer SDK for your iOS consumer app, follow these steps:\n\n1. [Check the minimum system requirements](#check-min).\n2. [Get the Consumer SDK](#install).\n3. [Inspect Apple Privacy Manifest file](/maps/documentation/mobility/journey-sharing/on-demand/ios/setup#inspect-apple).\n4. [Configure a Google Cloud Console project](/maps/documentation/mobility/journey-sharing/on-demand/ios/configure-project).\n5. [Get authentication tokens](/maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk).\n6. [Initialize the Consumer SDK](/maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk).\n\nCheck the minimum system requirements\n\nCheck the release notes for the minimum requirements for the version of the\nConsumer SDK you are using. See [Release notes](/maps/documentation/mobility/services/resources/relnotes_consumer_sdk_ios).\n\n- The mobile device must be running iOS 14 or later.\n- Apple [Xcode](https://developer.apple.com/xcode/) **version 15** or later.\n\nGet the Consumer SDK\n\nYou install and configure the Consumer SDK with CocoaPods. \n\nSwift Package Manager\n\n\nThe Consumer SDK can be installed via [Swift Package Manager](https://developer.apple.com/documentation/xcode/swift-packages). To add the SDK, ensure you have\nremoved any existing Consumer SDK dependencies.\n\n| Important: These instructions assume the use of Xcode 15 or later, but should be similar for previous versions of Xcode.\n\n\u003cbr /\u003e\n\n\nTo add the SDK to a new or existing project, follow these steps:\n\n1. Open your Xcode `project` or `workspace`, then go to **File \\\u003e Add Package Dependencies**.\n2. Enter \u003chttps://github.com/googlemaps/ios-consumer-sdk\u003e as the URL, press **Enter** to pull in the package, and click \"Add Package\".\n3. To install a specific `version`, set the **Dependency Rule** field to one of the version-based options. For new projects, we recommend specifying the latest version and using the \"Exact Version\" option. Once complete, click \"Add Package\".\n\nTo update the `package` for an existing project, follow these steps:\n\n1. To verify your installation, go to the **Package Dependencies** section of **Project Navigator** to verify the package and its version.\n\n| **Important:** Sometimes, artifacts cannot be resolved or errors can occur, in this case select \"File \\\u003e Packages \\\u003e Reset Package Cache\".\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nTo remove the existing Consumer SDK installed\nmanually, follow these steps:\n\n1. From your Xcode project configuration settings, find **Frameworks,\n Libraries, and Embedded Content** . Use the **minus sign`(-)`** to remove\n the following framework:\n\n - `GoogleRidesharingConsumer.xcframework`\n2. From the top level directory of your Xcode project, remove the\n `GoogleRidesharingConsumer` bundle.\n\nUse CocoaPods\n\n1. **Install the CocoaPods tool**: Open a terminal window and\n run the following command:\n\n sudo gem install cocoapods\n\n For more details, refer to the\n [CocoaPods Get Started guide](https://guides.cocoapods.org/using/getting-started.html).\n2. **Create a Podfile for the Consumer SDK**: You\n use the Podfile to install the API and its dependencies.\n\n 1. Create a file named `Podfile` in your project directory. This file\n defines your project's dependencies.\n\n 2. Edit the Podfile and add your dependencies. Here is\n an example which includes the dependencies:\n\n source \"https://github.com/CocoaPods/Specs.git\"\n target 'YOUR_APPLICATION_TARGET_NAME_HERE' do\n pod 'GoogleRidesharingConsumer'\n end\n\n 3. **Save the Podfile**: Open a terminal and go to the folder with\n the Podfile:\n\n cd \u003cpath-to-project\u003e\n\n3. **Run the pod install command**: This command installs the APIs\n specified in the Podfile, along with any dependencies they may have.\n\n pod install\n\n4. **Open your project in Xcode**: Close Xcode and then open (double-click)\n your project's .xcworkspace file to launch Xcode. To open the project\n later, use the .xcworkspace file.\n\n | **Note:** Periodically run `pod outdated` to detect when there's a newer version of the SDK. For more information, see Consumer SDK Versions in the [Consumer SDK Release notes](/maps/documentation/mobility/services/resources/relnotes_consumer_sdk_ios).\n\nManual installation\n\nThis guide shows how to manually add the XCFramework containing the\nConsumer SDK to your project and configure your build settings in Xcode.\n| **Caution**: As a best practice, use Cocoapods to install the Consumer SDK whenever possible.\n\nBefore following this guide, do the following:\n\n- Download the XCFramework, a binary package that you use to install the\n Consumer SDK. You can use this package on multiple platforms, including\n machines using the M1 chipset.\n\n- Install the\n [Maps SDK](/maps/documentation/ios-sdk/config#install-the-sdk).\n\n1. Download the SDK binary and resources:\n\n - [GoogleRidesharingConsumer.xcframework](https://dl.google.com/geosdk/swiftpm/3.2.0/GoogleRidesharingConsumer_3p.xcframework.zip)\n - [GoogleRidesharingConsumer.bundle](https://dl.google.com/geosdk/swiftpm/3.2.0/GoogleRidesharingConsumer.zip)\n - [gRPCCertificates.bundle](https://dl.google.com/geosdk/gRPCCertificates.bundle.zip)\n\n \u003cbr /\u003e\n\n2. Unpack the zipped files to access the XCFramework and resources.\n\n3. Start Xcode and either open or create a project. If you're new to iOS,\n create a new project and select the iOS App template.\n\n4. If your project group does not contain a Frameworks group, create it.\n\n5. Drag the downloaded `gRPCCertificates.bundle` file into the top-level\n directory of your Xcode project. If prompted, select **Copy items**.\n\n6. To install the Consumer SDK, drag the\n `GoogleRidesharingConsumer.xcframework` file into your project under\n **Frameworks, Libraries, and Embedded Content** . If prompted, select\n **Copy items**.\n\n7. Drag the downloaded `GoogleRidesharingConsumer.bundle` into the\n top-level directory of your Xcode project. If prompted, select\n **Copy items**.\n\n8. Select your project from the Project Navigator, and choose your\n application's target.\n\n9. Open the **Build Phases** tab, and in **Link Binary with Libraries**,\n add the following frameworks and libraries if they are not already\n present:\n\n - `Accelerate.framework`\n - `CoreData.framework`\n - `CoreGraphics.framework`\n - `CoreImage.framework`\n - `CoreLocation.framework`\n - `CoreTelephony.framework`\n - `CoreText.framework`\n - `GLKit.framework`\n - `ImageIO.framework`\n - `libc++.tbd`\n - `libz.tbd`\n - `Metal.framework`\n - `OpenGLES.framework`\n - `QuartzCore.framework`\n - `SystemConfiguration.framework`\n - `UIKit.framework`\n10. Choose your project, rather than a specific target, and open the\n **Build Settings** tab. In the **Other Linker Flags** section,\n add `-ObjC` for both debug and release.\n\n If these settings are not visible, change the filter in the\n **Build Settings** bar from **Basic** to **All**.\n\nInspect Apple Privacy Manifest file\n\nApple requires app privacy details for apps on the App Store. Visit the [Apple App Store Privacy Details page](/maps/documentation/ios-sdk/apple-privacy-policy) for updates and more information.\n\nThe Apple Privacy Manifest file is included in the resources bundle for the SDK. To verify that the Privacy Manifest File has been included, and to inspect its contents, create an archive of your app and [generate a privacy report](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_data_use_in_privacy_manifests#4239187) from the archive.\n\nWhat's next\n\n[Configure a Google Cloud Console project](/maps/documentation/mobility/journey-sharing/on-demand/ios/configure-project)"]]
