मौजूदा जगह

iOS के लिए Places SDK टूल का इस्तेमाल करके, उस जगह की खोज की जा सकती है जहां डिवाइस मौजूद है. इसका मतलब है कि डिवाइस के मौजूदा जगह की जानकारी. जगहों के उदाहरण हैं: स्थानीय कारोबार, लोकप्रिय जगहें, और भौगोलिक जगहें.

1. जगह की जानकारी की अनुमति का अनुरोध करें
2. ट्रैक इस्तेमाल करने की सीमाएं
3. मौजूदा जगह की जानकारी पाना
4. अपने ऐप्लिकेशन में एट्रिब्यूशन दिखाना

जगह की जानकारी की अनुमति का अनुरोध किया जा रहा है

अगर आपका ऐप्लिकेशन GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:, आपके ऐप्लिकेशन को जगह की जानकारी का इस्तेमाल करने के लिए अनुमति का अनुरोध करना होगा. जोड़ें आपके Info.plist के लिए NSLocationWhenInUseUsageDescription कुंजी फ़ाइल का उपयोग करें, जिससे उपयोगकर्ता को यह बताने वाली स्ट्रिंग है कि आपको स्थान क्यों चाहिए सेवाओं. उदाहरण के लिए:

<key>NSLocationWhenInUseUsageDescription</key>
<string>Show your location on the map</string>

अगर आपको कॉल करना है findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: जब ऐप के बैकग्राउंड में चलने की पुष्टि करने वाला डायलॉग शुरू किए बिना, कॉल करने से पहले, यह तरीका अपनाएं:

1. अपनी Info.plistफ़ाइल में NSLocationAlwaysUsageDescription बटन जोड़ें.
2. CLLocationManager के किसी भी इंस्टेंस पर requestAlwaysAuthorization को कॉल करें कॉल करने से पहले.

CLLocationManager से अनुमति देने का अनुरोध इस तरह करें:

    locationManager.requestAlwaysAuthorization()
    

    [self.locationManager requestAlwaysAuthorization];
    

वर्तमान स्थान ढूंढा जा रहा है

उस स्थानीय कारोबार या अन्य जगह का पता लगाने के लिए जहां डिवाइस अभी मौजूद है पता लगाया गया, कॉल GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:. शामिल करें नीचे दिए पैरामीटर:

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

फ़ील्ड, जगह के बारे में खोज के नतीजों के मुताबिक हैं और इन्हें तीन बिलिंग कैटगरी में बांटा गया है: बुनियादी, संपर्क, और माहौल. बेसिक फ़ील्ड का बिल, मूल दर के हिसाब से भेजा जाता है. इसके लिए, अलग से कोई शुल्क नहीं देना पड़ता शुल्क. संपर्क और वातावरण फ़ील्ड के लिए ज़्यादा शुल्क लिया जाता है. Reader Revenue Manager को सेट अप करने के बारे में स्थान डेटा अनुरोधों को बिल करने के तरीके के बारे में, देखें इस्तेमाल और बिलिंग.

एपीआई बताए गए कॉलबैक तरीके को शुरू करता है और GMSPlaceLikelihood ऑब्जेक्ट हैं.

हर GMSPlaceLikelihood ऑब्जेक्ट किसी जगह को दिखाता है. हर जगह के लिए, नतीजे में इस बात का संकेत कि वह जगह सही है या नहीं. ज़्यादा वैल्यू का मतलब इस बात की संभावना ज़्यादा है कि वह जगह सबसे अच्छी तरह मेल खाती है. बफ़र अगर डिवाइस की जगह की जानकारी के हिसाब से कोई जगह मौजूद नहीं है, तो फ़ील्ड को खाली छोड़ा जा सकता है.

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

// Specify the place data types to return.
let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) |
                                          UInt(GMSPlaceField.placeID.rawValue))!
placesClient?.findPlaceLikelihoodsFromCurrentLocation(withPlaceFields: fields, callback: {
  (placeLikelihoodList: Array<GMSPlaceLikelihood>?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }

  if let placeLikelihoodList = placeLikelihoodList {
    for likelihood in placeLikelihoodList {
      let place = likelihood.place
      print("Current Place name \(String(describing: place.name)) at likelihood \(likelihood.likelihood)")
      print("Current PlaceID \(String(describing: place.placeID))")
    }
  }
})

// Specify the place data types to return.
GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID);
[_placesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:fields callback:^(NSArray<GMSPlaceLikelihood *> * _Nullable likelihoods, NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"An error occurred %@", [error localizedDescription]);
    return;
  }
  if (likelihoods != nil) {
    for (GMSPlaceLikelihood *likelihood in likelihoods) {
      GMSPlace *place = likelihood.place;
      NSLog(@"Current place name: %@", place.name);
      NSLog(@"Place ID: %@", place.placeID);
    }
  }
}];

संभावित वैल्यू के बारे में नोट:

• यह संभावना, रिलेटिव प्रॉबबिलिटी देता है के लिए लौटाए गए स्थानों की सूची के भीतर सर्वश्रेष्ठ मिलान का स्थान है एक बार अनुरोध करना होगा. अलग-अलग अनुरोधों के हिसाब से, मिलने वाली संभावना की तुलना नहीं की जा सकती.
• संभावना की वैल्यू 0 और 1.0 के बीच होगी.
• के दिखाए गए सरणी में संभावितों का योग GMSPlaceLikelihood ऑब्जेक्ट हमेशा 1.0 से कम या उसके बराबर होते हैं. ध्यान दें कि कुल योग यह नहीं है ज़रूरी नहीं है.

उदाहरण के लिए, जगह A के सही होने की 55% संभावना दिखाने के लिए, और इसके स्थान B होने की 35% संभावना हो, तो संभावना श्रेणी में दो सदस्य होते हैं: जगह A के लिए, 0.55 की संभावना और स्थान B को 0.35 की संभावना के साथ.

अपने ऐप्लिकेशन में एट्रिब्यूशन दिखाना

जब आपका ऐप्लिकेशन इनसे मिली जानकारी को दिखाता है GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:, ऐप्लिकेशन एट्रिब्यूशन भी दिखाने चाहिए. इसके बारे में और पढ़ें एट्रिब्यूशन.