अनुरोध के पैरामीटर

इस दस्तावेज़ में, इसके सभी पैरामीटर के बारे में साफ़ तौर पर बताया गया है जगहों की अहम जानकारी का एपीआई. हम हर विषय के बारे में विस्तार से बताएंगे, जिसमें के बारे में जानें.

Places Insights API की मदद से, कई मुख्य काम किए जा सकते हैं:

  • जगहों की गिनती करें: किसी खास जगह से मिलती-जुलती जगहों की संख्या का पता लगाएं जगह का टाइप, कारोबार की स्थिति, कीमत का लेवल, और रेटिंग जैसी शर्तें.
  • जगह की जानकारी पाएं: उन जगहों के नाम पाएं जो फ़िल्टर कर सकते है, तो Places API.
  • सुविधाजनक फ़िल्टर: सटीक जानकारी पाने के लिए, बेहतर फ़िल्टर का इस्तेमाल करें. उपलब्ध फ़िल्टर में ये शामिल हैं:
    • भौगोलिक इलाका (सर्कल, इलाका या कस्टम पॉलीगॉन)
    • स्थान प्रकार
    • कारोबार की स्थिति
    • कीमत के लेवल
    • रेटिंग की सीमाएं

ज़रूरी पैरामीटर

इस भाग में जगहों की अहम जानकारी का एपीआई. हर अनुरोध में यह जानकारी होनी चाहिए:

  • खास तरह की अहम जानकारी.
  • जगह का फ़िल्टर और टाइप फ़िल्टर.

अहम जानकारी

उस टाइप की अहम जानकारी का पता लगाता है जिसका आपको हिसाब लगाना है. यहां दी गई अहम जानकारी के टाइप समर्थित हैं:

  • INSIGHT_COUNT: फ़िल्टर करने की शर्तों से मेल खाने वाली जगहों की संख्या दिखाता है.
  • INSIGHT_PLACES: फ़िल्टर करने की शर्तों से मेल खाने वाले जगह के आईडी दिखाता है.

ध्यान दें: अगर यह विकल्प चुना जाता है, तो Places Insights API, जगह के आईडी दिखाता है सिर्फ़ तब, जब count 100 या उससे कम हो.

फ़िल्टर

स्थानों को फ़िल्टर करने के मानदंड तय करता है. कम से कम आपको LocationFilter और TypeFilter.

स्थान फ़िल्टर

जगह के हिसाब से फ़िल्टर का टाइप, इनमें से किसी एक तरह का हो सकता है:

  • circle: सेंटर और रेडियस वाले एरिया को सर्कल के तौर पर बताता है.
  • region: इलाके के बारे में बताता है.
  • custom_area: इलाके को कस्टम पॉलीगॉन के तौर पर बताता है.
सर्कल

अगर अपनी भौगोलिक जगह को सर्कल के तौर पर चुना जाता है, तो आपको center देना होगा और एक radius. इसके केंद्र में अक्षांश और देशांतर या किसी जगह का नाम हो सकता है सर्कल के बीच की आईडी.

  • बीच में:
    • lat_lng: सर्कल के केंद्र का अक्षांश और देशांतर. अक्षांश यह -90, 90, और इनके बीच की कोई संख्या होनी चाहिए. देशांतर एक संख्या होना चाहिए -180, 180 के बीच, -180, 180 के बीच.
    • place: सर्कल के बीच का जगह का आईडी. ध्यान दें कि सिर्फ़ जगहें समर्थित हैं. यह स्ट्रिंग, places/ प्रीफ़िक्स से शुरू होनी चाहिए.
  • radius: वृत्त का दायरा मीटर में. यह संख्या पॉज़िटिव होनी चाहिए.
क्षेत्र

place पैरामीटर का इस्तेमाल करके, अपने इलाके को क्षेत्र के तौर पर तय किया जा सकता है. जगह के आईडी का इस्तेमाल करें जो किसी भौगोलिक क्षेत्र को दिखाता हो. जैसे, ऐसा क्षेत्र जिसे किसी पॉलीगॉन). उदाहरण के लिए, टैंपा, FL का स्थान आईडी है places/ChIJ4dG5s4K3wogRY7SWr4kTX6c.

इस तरह के क्षेत्र काम नहीं करते
establishment place_of_worship
floor post_box
food postal_code_suffix
general_contractor room
geocode street_address
health street_number
intersection sublocality_level_5
landmark subpremise

आप जियोकोडिंग एपीआई कॉल से types फ़ील्ड का इस्तेमाल करके किसी जगह के आईडी से जुड़ी जगह या पते का टाइप. उदाहरण के लिए, क्या वह शहर, आस-पड़ोस या देश का नाम.

कस्टम क्षेत्र

निर्देशांकों का इस्तेमाल करके, कस्टम पॉलीगॉन का क्षेत्रफल तय करता है.

कस्टम पॉलीगॉन बनाने के लिए, https://geojson.io/ पर जाएं और अनुरोध में उन निर्देशांकों को डालें. पॉलीगॉन में कम से कम 4 होने चाहिए निर्देशांक, जहां पहले और अंतिम निर्देशांक एक जैसे होते हैं. इसके अलावा पहला और आखिरी निर्देशांक, कोई दूसरा डुप्लीकेट निर्देशांक नहीं होना चाहिए. उदाहरण के लिए:

"coordinates":[
   {
      "latitude":37.776,
      "longitude":-122.666
   },
   {
      "latitude":37.130,
      "longitude":-121.898
   },
   {
      "latitude":37.326,
      "longitude":-121.598
   },
   {
      "latitude":37.912,
      "longitude":-122.247
   },
   {
      "latitude":37.776,
      "longitude":-122.666
   }
]

टाइप फ़िल्टर

इससे पता चलता है कि किस तरह की जगहों को शामिल करना है या बाहर रखना है. दोनों प्राथमिक तरीकों की सूची के लिए और अन्य स्थान प्रकार, जिनका समर्थन Places Insights API में दिया जाता है, इसके लिए टेबल A सेक्शन में जाकर, Places API के लिए जगह के टाइप वाली गाइड में जाएं (नया). कम से कम एक included_types या included_primary_types टाइप होना चाहिए शामिल हैं.

  • included_types: शामिल की गई अलग-अलग तरह की जगहों की सूची.
  • excluded_types: बाहर रखी गई अलग-अलग तरह की जगहों की सूची.
  • included_primary_types: शामिल की गई मुख्य जगहों के टाइप की सूची.
  • excluded_primary_types: बाहर रखी गई मुख्य जगहों के टाइप की सूची.

टाइप फ़िल्टर और जगह के टाइप के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, टाइप के बारे में ज़्यादा जानकारी देखें फ़िल्टर.

ज़रूरी नहीं पैरामीटर

बाकी के तीन फ़िल्टर वैकल्पिक हैं:

  • operating_status: शामिल की जाने वाली या बाहर रखी जाने वाली जगहों के स्टेटस के बारे में बताता है. डिफ़ॉल्ट रूप से, operating_status: OPERATING_STATUS_OPERATIONAL के हिसाब से फ़िल्टर किया जाता है (एक खास वैल्यू).
  • price_levels: इससे जगहों के किराये के लेवल की जानकारी मिलती है. डिफ़ॉल्ट रूप से 'नहीं' पर सेट होती है फ़िल्टर करना (खोज के नतीजों में कीमत के सभी लेवल शामिल होते हैं).
  • rating_filter: जगहों की रेटिंग की रेंज बताता है. डिफ़ॉल्ट रूप से 'नहीं' पर सेट होती है फ़िल्टर करना (नतीजों में सभी रेटिंग शामिल होती हैं).

कारोबार की स्थिति

आपके काम करने की स्थिति के हिसाब से फ़िल्टर करना. जैसे, काम कर रहा है या कुछ समय के लिए बंद).

कीमत स्तर

कीमत के लेवल के हिसाब से फ़िल्टर करें. जैसे, मुफ़्त, सामान्य या महंगा.

रेटिंग फ़िल्टर

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

  • min_rating: उपयोगकर्ता की कम से कम औसत रेटिंग (1.0 से 5.0 के बीच).
  • max_rating: उपयोगकर्ता की ज़्यादा से ज़्यादा औसत रेटिंग (1.0 से 5.0 के बीच).