iOS के लिए Places SDK टूल के बारे में खास जानकारी

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: सेटअप

iOS के लिए Places SDK टूल के आधिकारिक पैकेज:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

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 और इसके बाद के वर्शन में मौजूद नहीं हैं. इस वजह से, कंपाइलेशन नहीं हो पाता. माइग्रेट करने से जुड़ी गाइड देखें.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner और GMSAutocompleteFetcher initWithBounds:filter: 13-10-2020 से बंद कर दिया गया है. बदलाव: GMSAutocompleteFilter (locationBias या locationRestriction) को GMSAutocompleteRequest पर GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: से बदलें. इसके अलावा, यूज़र इंटरफ़ेस (यूआई) विजेट के लिए, GooglePlacesSwift placeAutocomplete या basicPlaceAutocomplete मॉडिफ़ायर का इस्तेमाल करें. समस्या: SDK टूल के 4.0.0 और इसके बाद के वर्शन में, ये तरीके मौजूद नहीं हैं. साथ ही, SDK टूल के 11.0.0 वर्शन में, GMSAutocompleteResultsViewController और GMSAutocompleteFetcher को हटा दिया गया था. माइग्रेट करने से जुड़ी गाइड देखें.
  • GMSCoordinateBounds-आधारित ऑटोकंप्लीट बाउंड (GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode; bounds/boundsMode findAutocompletePredictionsFromQuery और autocompleteQuery के पैरामीटर): बंद किया गया 2020-10-13 से. बदलाव: GMSAutocompleteRequest को GMSAutocompleteFilter (locationBias या locationRestriction) और GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: से बदलें. इसके अलावा, यूज़र इंटरफ़ेस (यूआई) विजेट के लिए, GooglePlacesSwift placeAutocomplete या basicPlaceAutocomplete मॉडिफ़ायर का इस्तेमाल करें. समस्या: एसडीके 4.0.0 और इसके बाद के वर्शन में प्रॉपर्टी और पैरामीटर मौजूद नहीं हैं. साथ ही, एसडीके 11.0.0 में GMSAutocompleteViewController और findAutocompletePredictionsFromQuery को हटा दिया गया था. माइग्रेट करने से जुड़ी गाइड देखें.
  • GMSPlace.openNowStatus: Decommissioned since 2020-10-13. बदलाव: GMSPlacesClient isOpenWithRequest: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: जनरेटिव एआई

Places SDK for iOS: Places

Places SDK for iOS: जगहों की जानकारी देने वाली यूआई किट