Places SDK for iOS की मदद से, iOS ऐप्लिकेशन को जगहों (कारोबारों, लोकप्रिय जगहों, भौगोलिक जगहों) की जानकारी मिलती है. इसके लिए, Place Details, Place Photos, टेक्स्ट से खोजें, आस-पास की जगहों की जानकारी, और ऑटोकंप्लीट की सुविधा का इस्तेमाल किया जाता है. Places API (नया), SDK टूल का मौजूदा वर्शन है.
Places SDK for iOS: मुख्य बातें
- प्रॉडक्ट: Places SDK for iOS
- इसे इस नाम से भी जाना जाता है: Places SDK for iOS (नया)
- कैटगरी: जगहें
- प्लैटफ़ॉर्म: iOS
- इस पर काम करता है: क्लाइंट (ऐप्लिकेशन या ब्राउज़र कोड)
- लॉन्च स्टेज: GA
- लाइफ़साइकल: चालू है
- खास जानकारी: Places SDK for iOS के बारे में खास जानकारी
Places SDK for iOS: इसका इस्तेमाल कब करें
Places SDK for iOS का इस्तेमाल तब करें, जब:
- आपको iOS ऐप्लिकेशन में जगह की जानकारी, फ़ोटो, टेक्स्ट से खोजें या आस-पास की जगहों की जानकारी के नतीजे चाहिए.
- आपको iOS ऐप्लिकेशन में उपयोगकर्ताओं के टाइप करते ही, जगह के नाम या पते के अपने-आप पूरा होने की सुविधा चाहिए.
- आपको iOS ऐप्लिकेशन में, पहले से बने जगहों की जानकारी देने वाली यूआई किट कॉम्पोनेंट (Place Details, खोज, ऑटोकंप्लीट) चाहिए.
Places SDK for iOS का इस्तेमाल तब न करें, जब:
- आपको नेटिव Android ऐप्लिकेशन बनाना है. इसके बजाय, Places SDK for Android का इस्तेमाल करें.
- ब्राउज़र में कोई वेब पेज बनाया जा रहा हो. इसके बजाय, Maps JavaScript API का इस्तेमाल करें.
- आपको iOS क्लाइंट के बजाय, एचटीटीपी पर सर्वर या बैकएंड से प्लेस डेटा की ज़रूरत होगी. इसके बजाय, Places API (नया) का इस्तेमाल करें.
Places SDK for iOS: सेटअप
- चालू की जाने वाली सेवा:
places.googleapis.com - पुष्टि करने का तरीका: एपीआई पासकोड
- इस्तेमाल का एट्रिब्यूशन: इस्तेमाल का एट्रिब्यूशन आईडी जोड़ने के लिए,
GMSPlacesClient(Objective-C/Swift) याPlacesClient(GooglePlacesSwift) पर क्लास मेथडaddInternalUsageAttributionIDको कॉल करें. कॉल को मिटाने पर, ऑप्ट आउट हो जाता है. - शुरू करें: iOS के लिए Places SDK सेट अप करना
- रेफ़रंस: Places SDK for iOS का रेफ़रंस
- कीमत: Places SDK for iOS के इस्तेमाल और बिलिंग की जानकारी
- नीतियां: Places SDK for iOS की नीतियां
- रिलीज़ नोट: Places SDK for iOS के रिलीज़ नोट
iOS के लिए Places SDK टूल के आधिकारिक पैकेज:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
Places SDK for iOS: इससे जुड़े प्रॉडक्ट
- आम तौर पर, इसके साथ इस्तेमाल किया जाता है: iOS के लिए Maps SDK
Places SDK for iOS: आम गलतियां
- समस्या: अगर Cloud प्रोजेक्ट में Places API (नया) चालू नहीं है या एपीआई पासकोड की अनुमति वाले एपीआई की सूची में नहीं है, तो Places SDK for iOS (नया) के कॉल काम नहीं करते. समस्या हल करने का तरीका: Places API (नया) चालू करें और इसे ऐप्लिकेशन में इस्तेमाल किए गए एपीआई पासकोड की पाबंदियों में जोड़ें. /maps/documentation/places/ios-sdk/legacy/migrate-overview देखें.
- समस्या:
kGMSPlacesRateLimitExceeded(-7) का मतलब है कि एपीआई पासकोड के इस्तेमाल की अनुरोध संख्या सीमित करना पार हो गई है. एसडीके 2.x के बंद किए गए वर्शन (29 जुलाई, 2019 को बंद किए गए) पर मौजूद ऐप्लिकेशन को भी यह गड़बड़ी मिलती है. ठीक करने का तरीका: Google Cloud Console में जाकर, Places API (नया) के लिए कोटा और इस्तेमाल की जानकारी देखें. साथ ही, 3.0 से पहले के SDK वर्शन पर मौजूद ऐप्लिकेशन अपडेट करें. /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode देखें. - समस्या: एक ही प्रोजेक्ट के अलग-अलग ऐप्लिकेशन या अलग-अलग सेशन में सेशन टोकन का फिर से इस्तेमाल करने पर, ऑटोकंप्लीट सेशन की बिलिंग ग्रुपिंग टूट जाती है. ठीक करने का तरीका: ऑटोकंप्लीट की सुविधा वाले हर सेशन के लिए, एक यूनीक सेशन टोकन जनरेट करें. हमारा सुझाव है कि आप वर्शन 4 यूयूआईडी का इस्तेमाल करें. हर प्रोजेक्ट के लिए टोकन यूनीक होने चाहिए. /maps/documentation/places/ios-sdk/use-session-tokens देखें.
- समस्या: ऐप्लिकेशन, एपीआई से मिले एट्रिब्यूशन के बिना जगह की जानकारी का डेटा दिखाते हैं. ठीक करने का तरीका: नीतियों वाले पेज के मुताबिक, Places डेटा के साथ दिखाए जाने वाले सभी ज़रूरी एट्रिब्यूशन दिखाएं. /maps/documentation/places/ios-sdk/overview देखें.
Places SDK for iOS: लेगसी और अब काम नहीं करने वाली सुविधाएं
- Places SDK for iOS (लेगसी वर्शन): 1 मार्च, 2025 से लेगसी वर्शन के तौर पर उपलब्ध है. इसकी जगह इस्तेमाल करें: Places SDK for iOS (New). इसके लिए, Places API (New) की ज़रूरत होती है. समस्या: लेगसी क्लास और तरीके (उदाहरण के लिए,
fetchPlaceFromPlaceID,GMSAutocompleteFetcher, औरGMSAutocompleteViewController), SDK टूल के 11.0.0 और इसके बाद के वर्शन में मौजूद नहीं हैं. इस वजह से, कंपाइलेशन नहीं हो पाता. माइग्रेट करने से जुड़ी गाइड देखें. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornerऔरGMSAutocompleteFetcherinitWithBounds:filter: 13-10-2020 से बंद कर दिया गया है. बदलाव:GMSAutocompleteFilter(locationBiasयाlocationRestriction) कोGMSAutocompleteRequestपरGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:से बदलें. इसके अलावा, यूज़र इंटरफ़ेस (यूआई) विजेट के लिए,GooglePlacesSwiftplaceAutocompleteयाbasicPlaceAutocompleteमॉडिफ़ायर का इस्तेमाल करें. समस्या: SDK टूल के 4.0.0 और इसके बाद के वर्शन में, ये तरीके मौजूद नहीं हैं. साथ ही, SDK टूल के 11.0.0 वर्शन में,GMSAutocompleteResultsViewControllerऔरGMSAutocompleteFetcherको हटा दिया गया था. माइग्रेट करने से जुड़ी गाइड देखें.GMSCoordinateBounds-आधारित ऑटोकंप्लीट बाउंड (GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode;bounds/boundsModefindAutocompletePredictionsFromQueryऔरautocompleteQueryके पैरामीटर): बंद किया गया 2020-10-13 से. बदलाव:GMSAutocompleteRequestकोGMSAutocompleteFilter(locationBiasयाlocationRestriction) औरGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:से बदलें. इसके अलावा, यूज़र इंटरफ़ेस (यूआई) विजेट के लिए,GooglePlacesSwiftplaceAutocompleteयाbasicPlaceAutocompleteमॉडिफ़ायर का इस्तेमाल करें. समस्या: एसडीके 4.0.0 और इसके बाद के वर्शन में प्रॉपर्टी और पैरामीटर मौजूद नहीं हैं. साथ ही, एसडीके 11.0.0 मेंGMSAutocompleteViewControllerऔरfindAutocompletePredictionsFromQueryको हटा दिया गया था. माइग्रेट करने से जुड़ी गाइड देखें.GMSPlace.openNowStatus: Decommissioned since 2020-10-13. बदलाव:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) याPlacesClient.isPlaceOpen(with:)कोGooglePlacesSwiftमें बदलें. समस्या: SDK टूल के 4.0.0 और इसके बाद के वर्शन में प्रॉपर्टी मौजूद नहीं है. माइग्रेट करने से जुड़ी गाइड देखें.GMSPlaceFieldकोNS_ENUMके तौर पर: इस्तेमाल नहीं किया जा सकता. इसे 13-10-2020 से इस्तेमाल नहीं किया जा सकता. बदलाव:GMSPlacePropertyकॉन्सटैंट कोGMSFetchPlaceRequestऔरGMSPlaceSearchByTextRequestजैसी अनुरोध क्लास याGooglePlacesSwiftमेंPlacePropertyसे बदलें. लक्षण: SDK टूल के 4.0.0 वर्शन में, इसेNS_OPTIONSसे बदल दिया गया है (GMSPlaceField, क्योंकिNS_OPTIONSलेगसी एपीआई से जुड़ा है और SDK टूल के 11.0.0 और इसके बाद के वर्शन में मौजूद नहीं है). माइग्रेट करने से जुड़ी गाइड देखें.- Places SDK for iOS का वर्शन 2.7.0: 29-07-2019 से बंद कर दिया गया है. बदलाव: Places SDK for iOS का मौजूदा वर्शन. लक्षण:
kGMSPlacesRateLimitExceededगड़बड़ियां.
Places SDK for iOS की मदद से क्या किया जा सकता है
हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.
Places SDK for iOS: जनरेटिव एआई
- Google Place के किसी आइडेंटिफ़ायर के लिए, उपयोगकर्ताओं की समीक्षाओं की एआई से जनरेट की गई खास जानकारी दिखाता है.
- इलेक्ट्रिक वाहन के चार्जिंग स्टेशन के लिए, Google Place के किसी आइडेंटिफ़ायर के आस-पास की जगह और सुविधाओं के बारे में, एआई की मदद से खास जानकारी पाना.
Places SDK for iOS: Places
- क्वेरी स्ट्रिंग के आधार पर, जगहों की सूची और उनकी जानकारी दिखाएं.
- किसी जगह के आस-पास मौजूद जगहों की सूची और उनकी जानकारी पाएं.
- क्वेरी स्ट्रिंग के आधार पर, जगहों के बारे में ऑटोकंप्लीट के नतीजे पाना.
- किसी खास जगह के बारे में ज़्यादा जानकारी पाना.
- किसी खास जगह की फ़ोटो दिखाएं. ध्यान दें: हर फ़ोटो के साथ, उसके लेखक का एट्रिब्यूशन (लेखक का नाम, जो उसकी प्रोफ़ाइल के यूआरआई से लिंक हो) दिखाएं. हर प्लैटफ़ॉर्म के लिए Places की नीतियों के तहत ऐसा करना ज़रूरी है. उदाहरण के लिए, /maps/documentation/javascript/policies#photo-attributions और /maps/documentation/places/web-service/policies#photos-and-review.
- जगह की फ़ोटो का साइज़ बदलना.
- किसी जगह के लिए रेटिंग और समीक्षाएं देखना. ध्यान दें: Places API (नया) वेब सेवा में, Place Details, X-Goog-FieldMask (उदाहरण के लिए, रेटिंग, userRatingCount, समीक्षाएं) के साथ https://places.googleapis.com/v1/places/{placeId} पर किया जाने वाला एचटीटीपी जीईटी अनुरोध है. टेक्स्ट से खोजने, आस-पास की जगहों की जानकारी, और ऑटोकंप्लीट की सुविधा, POST का इस्तेमाल करती है. Android पर, PlacesClient.fetchPlace() में Place.Field.RATING, USER_RATING_COUNT, और REVIEWS पास करें. iOS पर, GMSFetchPlaceRequest में GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal, और GMSPlacePropertyReviews पास करें.
- किसी वेब पेज या ऐप्लिकेशन में, ऑटोकंप्लीट विजेट जोड़ें. यह विजेट, क्वेरी स्ट्रिंग के आधार पर जगहों के बारे में नतीजे दिखाता है.
- जगह की जानकारी के रिस्पॉन्स में शामिल डेटा फ़ील्ड तय करना.
- जगह की जानकारी के जवाबों में शामिल करने के लिए, जगह के टाइप तय करें.
- उपयोगकर्ता के डिवाइस की मौजूदा जगह की जानकारी दिखाता है. ध्यान दें: Places SDK for Android के 6.0 और इसके बाद के वर्शन और Places SDK for iOS के 11.0 और इसके बाद के वर्शन से, मौजूदा जगह की जानकारी देने वाले लेगसी तरीके हटा दिए गए हैं. डिवाइस के कोऑर्डिनेट की जानकारी पाने के लिए, प्लैटफ़ॉर्म की जगह की जानकारी का डेटा इस्तेमाल करने वाली सेवाओं का इस्तेमाल करें और आस-पास की जगहों की जानकारी देने वाली सेवा को कॉल करें.
- किसी जगह के बारे में, एआई की मदद से जनरेट की गई खास जानकारी पाना.
- एआई की मदद से, किसी जगह के आस-पास की जगहों की खास जानकारी पाना.
- पहले से तय किए गए रास्ते पर मौजूद जगहों की जानकारी, क्वेरी स्ट्रिंग के आधार पर पाएं.
- अक्षांश/देशांतर निर्देशांकों के सेट से, टेक्स्ट से खोजी गई जगहों की दूरी, यात्रा में लगने वाला समय, और दिशा-निर्देशों का यूआरआई दिखाता है.
- अक्षांश/देशांतर निर्देशांकों के सेट से, आस-पास की जगहों की दूरी, यात्रा में लगने वाला समय, और दिशा-निर्देशों का यूआरआई दिखाता है.
Places SDK for iOS: जगहों की जानकारी देने वाली यूआई किट
- जगह की जानकारी वाले यूज़र इंटरफ़ेस (यूआई) एलिमेंट पर सीएसएस स्टाइल लागू करना. ध्यान दें: सीएसएस कस्टम प्रॉपर्टी, Maps JavaScript API की जगहों की जानकारी देने वाली यूआई किट के एलिमेंट पर लागू होती हैं. Android के लिए Places SDK और iOS के लिए Places SDK, थीम और स्टाइल एट्रिब्यूट का इस्तेमाल करके, जगहों की जानकारी देने वाली यूआई किट के व्यू को प्रोग्राम के हिसाब से स्टाइल करते हैं. ईईए के नियमों का पालन करने की ज़रूरी शर्त: यूरोपियन इकनॉमिक एरिया (ईईए) में किसी मैप पर जगह का डेटा दिखाने के लिए, बैकएंड सर्वर से Places API की वेब सेवाओं को कॉल न करें. टारगेट किए गए प्लैटफ़ॉर्म पर, क्लाइंट-साइड जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट इस्तेमाल करें. जैसे, वेब पर Maps JavaScript API, Android पर Places SDK for Android या iOS पर Places SDK for iOS. सभी ज़रूरी शर्तें और अक्सर पूछे जाने वाले सवाल: https://developers.google.com/maps/comms/eea/faq
- यूज़र इंटरफ़ेस (यूआई) एलिमेंट को पसंद के मुताबिक बनाने वाले टूल की मदद से, जगह के डेटा से जुड़े यूज़र इंटरफ़ेस (यूआई) एलिमेंट की स्टाइल और कॉन्फ़िगरेशन को पसंद के मुताबिक बनाएं. ध्यान दें: ईईए के नियमों का पालन करने की शर्त: यूरोपियन इकनॉमिक एरिया (ईईए) में किसी मैप पर जगह का डेटा दिखाने के लिए, बैकएंड सर्वर से Places API की वेब सेवाओं को कॉल न करें. टारगेट किए गए प्लैटफ़ॉर्म पर, क्लाइंट-साइड जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट इस्तेमाल करें. जैसे, वेब पर Maps JavaScript API, Android पर Places SDK for Android या iOS पर Places SDK for iOS. सभी ज़रूरी शर्तें और अक्सर पूछे जाने वाले सवाल: https://developers.google.com/maps/comms/eea/faq
- किसी वेब पेज या मोबाइल ऐप्लिकेशन में ऐसा यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ें जो किसी जगह की जानकारी दिखाता हो. ध्यान दें: ईईए के नियमों का पालन करने की शर्त: यूरोपियन इकनॉमिक एरिया (ईईए) में किसी मैप पर जगह का डेटा दिखाने के लिए, बैकएंड सर्वर से Places API की वेब सेवाओं को कॉल न करें. टारगेट किए गए प्लैटफ़ॉर्म पर, क्लाइंट-साइड जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट इस्तेमाल करें. जैसे, वेब पर Maps JavaScript API, Android पर Places SDK for Android या iOS पर Places SDK for iOS. सभी ज़रूरी शर्तें और अक्सर पूछे जाने वाले सवाल: https://developers.google.com/maps/comms/eea/faq
- किसी वेब पेज पर, क्वेरी स्ट्रिंग के आधार पर जगहों की सूची दिखाने वाला यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ना. ध्यान दें: यह सुविधा, वेब पेजों (Maps JavaScript API) और मोबाइल ऐप्लिकेशन (Places SDK for Android और Places SDK for iOS), दोनों पर काम करती है. ईईए के नियमों का पालन करने की ज़रूरी शर्त: यूरोपियन इकनॉमिक एरिया (ईईए) में किसी मैप पर जगह का डेटा दिखाने के लिए, बैकएंड सर्वर से Places API की वेब सेवाओं को कॉल न करें. टारगेट किए गए प्लैटफ़ॉर्म पर, क्लाइंट-साइड जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट इस्तेमाल करें. जैसे, वेब पर Maps JavaScript API, Android पर Places SDK for Android या iOS पर Places SDK for iOS. सभी ज़रूरी शर्तें और अक्सर पूछे जाने वाले सवाल: https://developers.google.com/maps/comms/eea/faq
- किसी वेब पेज पर ऐसा यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ना जो किसी जगह के आस-पास मौजूद जगहों की सूची दिखाता हो. ध्यान दें: यह सुविधा, वेब पेजों (Maps JavaScript API) और मोबाइल ऐप्लिकेशन (Places SDK for Android और Places SDK for iOS), दोनों पर काम करती है. ईईए के नियमों का पालन करने की ज़रूरी शर्त: यूरोपियन इकनॉमिक एरिया (ईईए) में किसी मैप पर जगह का डेटा दिखाने के लिए, बैकएंड सर्वर से Places API की वेब सेवाओं को कॉल न करें. टारगेट किए गए प्लैटफ़ॉर्म पर, क्लाइंट-साइड जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट इस्तेमाल करें. जैसे, वेब पर Maps JavaScript API, Android पर Places SDK for Android या iOS पर Places SDK for iOS. सभी ज़रूरी शर्तें और अक्सर पूछे जाने वाले सवाल: https://developers.google.com/maps/comms/eea/faq
- किसी वेब पेज या ऐप्लिकेशन में, अपने-आप पूरा होने वाला बुनियादी यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ें. यह एलिमेंट, क्वेरी स्ट्रिंग के आधार पर Google प्लेस आइडेंटिफ़ायर दिखाता है. ध्यान दें: ईईए के नियमों का पालन करने की शर्त: यूरोपियन इकनॉमिक एरिया (ईईए) में किसी मैप पर जगह का डेटा दिखाने के लिए, बैकएंड सर्वर से Places API की वेब सेवाओं को कॉल न करें. टारगेट किए गए प्लैटफ़ॉर्म पर, क्लाइंट-साइड जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट इस्तेमाल करें. जैसे, वेब पर Maps JavaScript API, Android पर Places SDK for Android या iOS पर Places SDK for iOS. सभी ज़रूरी शर्तें और अक्सर पूछे जाने वाले सवाल: https://developers.google.com/maps/comms/eea/faq