GMSवेयर क्लाइंट क्लास का रेफ़रंस

पब्लिक मेंबर के फ़ंक्शन | स्टैटिक पब्लिक मेंबर फ़ंक्शन | मिलते-जुलते फ़ंक्शन

GMSवेयर क्लाइंट क्लास का रेफ़रंस

---

खास जानकारी

Places SDK टूल का मुख्य इंटरफ़ेस.

इसका इस्तेमाल जगहों को खोजने और उनकी जानकारी पाने के लिए किया जाता है. इस क्लास को [GMSPLACESClient sharedClient] से ऐक्सेस किया जाना चाहिए.

GMSPLACESClient तरीके को सिर्फ़ मुख्य थ्रेड से कॉल किया जाना चाहिए. इन तरीकों से किसी दूसरे थ्रेड से कॉल करने पर, यह अपवाद या तय नहीं किया गया व्यवहार दिखाएगा. जब तक कि कुछ और तय नहीं किया जाता, तब तक सभी कॉलबैक मुख्य थ्रेड पर शुरू किए जाएंगे.

पब्लिक मेंबर फ़ंक्शन
(शून्य)	- lookUpPlaceID:कॉलबैक:
	किसी जगह की जानकारी पाएं.
(शून्य)	- lookUpPhotosForPlaceID:कॉलबैक:
	किसी जगह से जुड़ी 10 फ़ोटो तक का मेटाडेटा पाएं.
(शून्य)	- loadPlaceफ़ोटो:कॉलबैक:
	किसी खास फ़ोटो के लिए इमेज को उसके सबसे बड़े साइज़ में लोड करता है.
(शून्य)	- loadPlacePhoto:restrictToSize:Scale:callback:
	दिए गए ज़्यादा से ज़्यादा डाइमेंशन में फ़िट करने के लिए, किसी खास फ़ोटो के लिए इमेज को लोड करता है.
(शून्य)	- currentPlaceWithCallback:
	इससे उस जगह की अनुमानित जानकारी मिलती है जहां डिवाइस फ़िलहाल मौजूद है.
(शून्य)	- ढूंढ अपने-आप पूरा करने का सुझाव देंQuery:filter:sessionToken:callback:
	टेक्स्ट क्वेरी से अपने-आप मिलने वाले सुझावों को ढूंढें.
(शून्य)	- fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
	किसी जगह की जानकारी फ़ेच करें.
(शून्य)	- findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:कॉलबैक:
	उपयोगकर्ता की मौजूदा जगह का इस्तेमाल करके, जगह की जानकारी का पता लगाएं.
स्टैटिक पब्लिक मेंबर फ़ंक्शन
(इंस्टेंस टाइप)	+ शेयर किए गए क्लाइंट
	iOS के लिए, Google Places SDK टूल के लिए GMS PlacesClient का शेयर किया गया इंस्टेंस देता है, ताकि ज़रूरत पड़ने पर उसे बनाया जा सके.
(बूल)	+ provideAPIKey:
	iOS के लिए Google Places SDK को आपकी API कुंजी देता है.
(NSString *)	+ openSourceLicenseInfo
	iOS के लिए Google स्थल SDK के लिए ओपन सोर्स सॉफ़्टवेयर लाइसेंस जानकारी देता है.
(NSString *)	+ SDKVersion
	iOS के लिए Google Places SDK के इस रिलीज़ का वर्शन देता है.
(NSString *)	+ SDKLengthVersion
	iOS के लिए Google Places SDK के इस रिलीज़ का लंबा वर्शन देता है.
मिलते-जुलते फ़ंक्शन
(ध्यान दें कि ये सदस्यों के काम नहीं हैं.)
typedef अमान्य(^	GMSPlaceResultCallback )(GMSPlace *_Nullable नतीजा, NSError *_Nullable गड़बड़ी)
	स्थान विवरण लुकअप पाने के लिए कॉलबैक प्रकार.
typedef अमान्य(^	GMSPlaceलाइकलाइडलिस्टकॉलबैक )(GMSPlaceLikeliwingList *_NullablepotentialList, NSError *_Nullable गड़बड़ी)
	जगह की संभावना की सूचियां पाने के लिए, किस तरह का कॉलबैक है.
typedef अमान्य(^	GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikeliwing * > *_Nullable ऑपरेशंस, NSError *_Nullable गड़बड़ी)
	GMSPlaceLikelihood की श्रेणी पाने के लिए कॉलबैक टाइप.
typedef अमान्य(^	GMSAutocomplete PredictionsCallback )(NSArray< GMSAutocompletePredion * > *_Nullable नतीजे, NSError *_Nullable गड़बड़ी)
	अपने-आप पूरा होने के नतीजे पाने के लिए, कॉलबैक टाइप.
typedef अमान्य(^	GMSPlacePhotoमेटाडेटाResultCallback )(GMSPlacePhotoमेटाडेटाList *_Nullable फ़ोटो, NSError *_Nullable गड़बड़ी)
	स्थान के फ़ोटो परिणाम पाने के लिए कॉलबैक प्रकार.
typedef अमान्य(^	GMSPlacePhotoImageResultCallback )(UIImage *_Nullable फ़ोटो, NSError *_Nullable गड़बड़ी)
	GMSPlacePhotoMetadata ऑब्जेक्ट से UIImage ऑब्जेक्ट पाने के लिए कॉलबैक टाइप.

---

मेंबर फ़ंक्शन के दस्तावेज़

+ (इंस्टेंस टाइप) sharedClient

iOS के लिए, Google Places SDK टूल के लिए GMS PlacesClient का शेयर किया गया इंस्टेंस देता है, ताकि ज़रूरत पड़ने पर उसे बनाया जा सके.

अगर आपका ऐप्लिकेशन अक्सर GMSPLACESClient के तरीकों का इस्तेमाल करता है, तो हो सकता है कि आप इस ऑब्जेक्ट को सीधे होल्ड करना चाहें, नहीं तो Google से आपका कनेक्शन नियमित रूप से फिर से शुरू किया जा सकता है.

+ (BOOL) provideAPIKey:

(NSString *)

बटन

iOS के लिए Google Places SDK को आपकी API कुंजी देता है.

यह कुंजी, Google Cloud Platform Console की मदद से आपके ऐप्लिकेशन के लिए जनरेट की जाती है. साथ ही, इसे पहचानने के लिए आपके ऐप्लिकेशन के बंडल आईडी के साथ जोड़ा जाता है. GMSLocationsClient का इस्तेमाल करने से पहले, इसे आपके ऐप्लिकेशन को कॉल करना चाहिए (उदाहरण के लिए, application:didFinishLaunchingWithOptions:).

लौटाए गए सामान की जानकारी:

अगर एपीआई पासकोड दिया गया है, तो

+ (NSString *) openSourceLicenseInfo

iOS के लिए Google स्थल SDK के लिए ओपन सोर्स सॉफ़्टवेयर लाइसेंस जानकारी देता है.

यह जानकारी आपके ऐप्लिकेशन में उपलब्ध कराई जानी चाहिए.

+ (NSString *) SDKVersion

iOS के लिए Google Places SDK के इस रिलीज़ का वर्शन देता है.

. उदाहरण के लिए, "1.0.0".

+ (NSString *) SDKLongVersion

iOS के लिए Google Places SDK के इस रिलीज़ का लंबा वर्शन देता है.

. उदाहरण के लिए, "1.0.0 (102.1)".

- (शून्य) lookUpPlaceID:		(NSString *)	प्लेस आईडी
कॉलबैक:		(GMSPlaceResultCallback)	कॉलबैक

किसी जगह की जानकारी पाएं.

यह तरीका ब्लॉक नहीं है.

पैरामीटर:

प्लेस आईडी	लुकअप के लिए जगह का आईडी.
कॉलबैक	लुकअप नतीजे को शुरू करने के लिए कॉलबैक.

- (शून्य) lookUpPhotosForPlaceID:		(NSString *)	प्लेस आईडी
कॉलबैक:		(GMSPlacePhotoमेटाडेटाResultCallback)	कॉलबैक

किसी जगह से जुड़ी 10 फ़ोटो तक का मेटाडेटा पाएं.

फ़ोटो कई जगहों से ली जाती हैं. इनमें कारोबार के मालिक और वे फ़ोटो भी शामिल होती हैं जिन्हें Google+ के उपयोगकर्ताओं ने योगदान दिया है. ज़्यादातर मामलों में, इन फ़ोटो का इस्तेमाल एट्रिब्यूशन के बिना किया जा सकता है या इमेज के हिस्से के तौर पर ज़रूरी एट्रिब्यूशन शामिल किया जा सकता है. हालांकि, सभी ज़रूरी एट्रिब्यूशन को वापस पाने के लिए, रिस्पॉन्स में attributions प्रॉपर्टी का इस्तेमाल किया जाना चाहिए. साथ ही, जहां भी इमेज दिखाई जाए, वहां आपको उन एट्रिब्यूशन को दिखाना होगा. ज़्यादा से ज़्यादा 10 फ़ोटो दिखाई जाती हैं.

हो सकता है कि इस तरीके को बार-बार कॉल करने पर, एक ही फ़ोटो हर बार दिखे. हालांकि, इसकी गारंटी नहीं है, क्योंकि डेटा में बदलाव हो सकता है.

इस तरीके से नेटवर्क लुकअप लागू होता है.

पैरामीटर:

प्लेस आईडी	वह जगह आईडी जिसके लिए फ़ोटो खोजना है.
कॉलबैक	लुकअप नतीजे को शुरू करने के लिए कॉलबैक.

- (शून्य) loadPlaceफ़ोटो:		(GMSPlacePhotoमेटाडेटा *)	फ़ोटोमेटाडेटा
कॉलबैक:		(GMSPlacePhotoImageResultCallback)	कॉलबैक

किसी खास फ़ोटो के लिए इमेज को उसके सबसे बड़े साइज़ में लोड करता है.

SDK टूल, इमेज के डेटा को कैश मेमोरी में सेव कर सकता है. कैश में अनुरोध की गई फ़ोटो मौजूद न होने पर, नेटवर्क लुकअप किया जाएगा.

पैरामीटर:

फ़ोटोमेटाडेटा	इसके लिए: GMSPlacePhotoMetadata को UIImage लोड करना है.
कॉलबैक	UIImage के लोड होने की प्रोसेस शुरू करने के लिए, कॉलबैक.

- (शून्य) loadPlaceफ़ोटो:		(GMSPlacePhotoमेटाडेटा *)	फ़ोटोमेटाडेटा
पाबंदी वाला साइज़:		(CGSize)	मैक्ससाइज़
स्केल:		(CGFloat)	स्केल
कॉलबैक:		(GMSPlacePhotoImageResultCallback)	कॉलबैक

दिए गए ज़्यादा से ज़्यादा डाइमेंशन में फ़िट करने के लिए, किसी खास फ़ोटो के लिए इमेज को लोड करता है.

ओरिजनल इमेज के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) को बनाए रखते हुए, इमेज को दिए गए डाइमेंशन के हिसाब से स्केल किया जाएगा. यह स्केलिंग, सर्वर-साइड पर की जाती है.

अगर स्केल पैरामीटर 1.0 अधिकतम साइज़ नहीं है, तो इस मान से गुणा किया जाएगा और लौटाए गए UIImage को तय स्केल पर सेट किया जाएगा. अगर स्क्रीन पर दिखाने के लिए इमेज लोड की जा रही हैं, तो यह पैरामीटर स्क्रीन स्केल पर सेट होना चाहिए.

SDK टूल, इमेज के डेटा को कैश मेमोरी में सेव कर सकता है. कैश में अनुरोध की गई फ़ोटो मौजूद न होने पर, नेटवर्क लुकअप किया जाएगा.

ध्यान दें:

स्केल फ़ैक्टर लागू करने के बाद, maxSize के डाइमेंशन को इस्तेमाल करने से पहले, सबसे करीब वाली पूरी संख्या में बदल दिया जाएगा. अगर इमेज का अनुरोध किया जाता है, जो उपलब्ध साइज़ से बड़ी होती है, तो छोटी इमेज दिखाई जा सकती है.

पैरामीटर:

फ़ोटोमेटाडेटा	इसके लिए: GMSPlacePhotoMetadata को UIImage लोड करना है.
ज़्यादा से ज़्यादा साइज़	इमेज का ज़्यादा से ज़्यादा साइज़
स्केल	इमेज लोड करने के लिए स्केल.
कॉलबैक	UIImage के लोड होने की प्रोसेस शुरू करने के लिए, कॉलबैक.

- (शून्य) currentPlaceWithCallback:

(GMSPlaceLikeliwingListCallback)

कॉलबैक

इससे उस जगह की अनुमानित जानकारी मिलती है जहां डिवाइस फ़िलहाल मौजूद है.

डिवाइस की पिछली अनुमानित जगह के आधार पर, जगह की जानकारी की सूची जनरेट करता है. सफलता मिलने पर, इस संभावित सूची के साथ दिए गए कॉलबैक को लागू किया जाएगा. साथ ही, गड़बड़ी होने पर NSError को भी लागू किया जाएगा.

ध्यान दें:

इस तरीके का इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को मौजूदा जगह की जानकारी ऐक्सेस करने की अनुमति चाहिए. कॉल करने से पहले, पक्का करें कि आपने उपयोगकर्ताओं की जगह की जानकारी ऐक्सेस करने का अनुरोध किया हो. इसके लिए, [CLLocationManager requestwhenInUseAuthorization] या [CLLocationManager requestAllAuthorization] का इस्तेमाल करें. अगर इस तरीके का इस्तेमाल करने के बाद भी आपके ऐप्लिकेशन के लिए अनुमति देने की स्थिति सही नहीं है, तो कॉलबैक का अनुरोध करते समय गड़बड़ी का मैसेज मिलेगा.

पैरामीटर:

कॉलबैक

जगह की संभावना की सूची शुरू करने के लिए कॉलबैक.

- (शून्य) findऑटोकंप्लीट अनुमान की क्वेरी:		(NSString *)	क्वेरी
फ़िल्टर:		(GMSAutocompleteFilter * (शून्य)	फ़िल्टर
सेशन के लिए टोकन:		(GMSAutocompleteSessionToken *) (	sessionToken
कॉलबैक:		(GMSअपने-आप पूरा होने का अनुमान कॉलबैक)	कॉलबैक

टेक्स्ट क्वेरी से अपने-आप मिलने वाले सुझावों को ढूंढें.

ऐसा हो सकता है कि ये नतीजे किसी खास जगह पर या किसी इलाके तक सीमित हों. यह तरीका ब्लॉक नहीं है.

दिए गए कॉलबैक को शुरू करने पर, उसके अपने-आप पूरा होने के सुझाव और किसी गड़बड़ी पर NSError की सुविधा शुरू की जाएगी.

पैरामीटर:

query	अपने-आप पूरा होने के लिए आंशिक टेक्स्ट.
फ़िल्टर करें	नतीजों पर लागू करने के लिए फ़िल्टर. यह पैरामीटर शून्य हो सकता है.
सेशन के लिए टोकन	बिलिंग सेशन से जुड़े अनुरोध को जोड़ने के लिए, GMSAutocompleteSessionToken.
कॉलबैक	अनुमानों को शुरू करने के लिए, कॉलबैक.

- (शून्य) fetchPlaceFromPlaceID:		(NSString *)	प्लेस आईडी
प्लेसफ़ील्ड:		(GMSPlaceField)	placeFields
सेशन के लिए टोकन:		(GMSAutocompleteSessionToken *) (	sessionToken
कॉलबैक:		(GMSPlaceResultCallback)	कॉलबैक

किसी जगह की जानकारी फ़ेच करें.

यह तरीका ब्लॉक नहीं है.

पैरामीटर:

प्लेस आईडी	लुकअप के लिए जगह का आईडी.
प्लेसफ़ील्ड	सूची में शामिल जगहों की जानकारी के लिए अनुरोध किए गए अलग-अलग जगह फ़ील्ड.
सेशन के लिए टोकन	बिलिंग सेशन से जुड़े अनुरोध को जोड़ने के लिए, GMSAutocompleteSessionToken.
कॉलबैक	लुकअप नतीजे को शुरू करने के लिए कॉलबैक.

- (शून्य) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:		(GMSPlaceField)	placeFields
कॉलबैक:		(GMSPlaceLikelihoodsCallback)	कॉलबैक

उपयोगकर्ता की मौजूदा जगह का इस्तेमाल करके, जगह की जानकारी का पता लगाएं.

यह तरीका ब्लॉक नहीं है.

दिए गए कॉलबैक को जगहों की एक श्रेणी के साथ शुरू किया जाएगा, जिसके सफल होने पर संभावित स्कोर मिलता है और गड़बड़ी होने पर NSError होती है.

पैरामीटर:

प्लेसफ़ील्ड	सूची में शामिल जगहों की जानकारी के लिए अनुरोध किए गए अलग-अलग जगह फ़ील्ड.
कॉलबैक	जगह की जानकारी के साथ शुरू करने के लिए कॉलबैक.

---

दोस्त और उनसे जुड़े फ़ंक्शन का दस्तावेज़

- (typedef false(^ GMSPlaceResultCallback)(GMSPlace *_Nullable नतीजा, NSError *_Nullable गड़बड़ी)) [related]

स्थान विवरण लुकअप पाने के लिए कॉलबैक प्रकार.

अगर कोई गड़बड़ी हुई है, तो result सटीक नहीं होगा और error में गड़बड़ी के बारे में जानकारी होगी.

पैरामीटर:

नतीजा	GMSPlace दिखाया गया.
error	अगर कोई गड़बड़ी हो, तो वह होती है.

- (typedef false(^ GPlacePlaceliwingListCallback)(GMSPlaceLikeliwingList *_NullablepotentialList, NSError *_Nullable गड़बड़ी)) [related]

जगह की संभावना की सूचियां पाने के लिए, किस तरह का कॉलबैक है.

अगर कोई गड़बड़ी हुई है, तो likelihoodList सटीक नहीं होगा और error में गड़बड़ी के बारे में जानकारी होगी.

पैरामीटर:

संभावना सूची	जगहों की जानकारी की सूची.
error	अगर कोई गड़बड़ी हो, तो वह होती है.

- (typedef null(^ GMSPlaceLikeliwingsCallback)(NSArray< GMSPlaceLikelihood * > *_Nullable ऑपरेशंस, NSगड़बड़ी *_Nullable गड़बड़ी) [related]

GMSPlaceLikelihood की श्रेणी पाने के लिए कॉलबैक टाइप.

अगर कोई गड़बड़ी होती है, तो श्रेणी शून्य होगी और error में गड़बड़ी के बारे में जानकारी होगी.

- (typedef false(^ GMSAutocompletePresionionsCallback)(NSArray< GMSAutocompletePredक्शन * > *_Nullable नतीजे, NSError *_Nullable गड़बड़ी) [related]

अपने-आप पूरा होने के नतीजे पाने के लिए, कॉलबैक टाइप.

results, GMS के ऑटोकंप्लीट सुविधा की मदद से मिलने वाले अनुमानों की एक कैटगरी है.

पैरामीटर:

नतीजे	GMSAutocompletePrediction की कैटगरी.
error	अगर कोई गड़बड़ी हो, तो वह होती है.

- (typedef false(^ GMSPlacePhotoमेटाडेटाResultCallback)(GMSPlacePhotoमेटाडेटाList *_Nullable फ़ोटो, NSError *_Nullable गड़बड़ी)) [related]

स्थान के फ़ोटो परिणाम पाने के लिए कॉलबैक प्रकार.

अगर कोई गड़बड़ी हुई है, तो photos सटीक नहीं होगा और error में गड़बड़ी के बारे में जानकारी होगी.

पैरामीटर:

फ़ोटो	ऐसे नतीजे जिनमें GMSPlacePhotoMetadata ऑब्जेक्ट शामिल हैं.
error	अगर कोई गड़बड़ी हो, तो वह होती है.

- (typedef false(^ GMSPlacePhotoImageCallCallback)(UIImage *_Nullable फ़ोटो, NSError *_Nullable गड़बड़ी) [related]

GMSPlacePhotoMetadata ऑब्जेक्ट से UIImage ऑब्जेक्ट पाने के लिए कॉलबैक टाइप.

अगर कोई गड़बड़ी हुई है, तो photo सटीक नहीं होगा और error में गड़बड़ी के बारे में जानकारी होगी.

पैरामीटर:

फ़ोटो	UIImage को लोड किया गया.
error	अगर कोई गड़बड़ी हो, तो वह होती है.