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

इस दस्तावेज़ में, Places Insights API के लिए अनुरोध पैरामीटर के बारे में बताया गया है. साथ ही, इस सेवा का इस्तेमाल करने के लिए अहम जानकारी और सबसे सही तरीके भी शामिल हैं.

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

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

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

इस सेक्शन में, Places Insights API को अनुरोध करते समय ज़रूरी पैरामीटर के बारे में बताया गया है. हर अनुरोध में ये चीज़ें होनी चाहिए:

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

अहम जानकारी का टाइप

इससे पता चलता है कि आपको किस तरह की अहम जानकारी का हिसाब लगाना है. इन टाइप की अहम जानकारी देखी जा सकती है:

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

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

फ़िल्टर

जगहों को फ़िल्टर करने की शर्तों के बारे में बताता है. कम से कम, आपको LocationFilter और TypeFilter की जानकारी देनी होगी.

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

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

  • circle: किसी क्षेत्र को केंद्र और त्रिज्या वाले सर्कल के तौर पर दिखाता है.
  • region: किसी इलाके को क्षेत्र के तौर पर तय करता है.
  • customArea: किसी इलाके को कस्टम पॉलीगॉन के तौर पर दिखाता है.
सर्कल

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

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

place पैरामीटर में जगह का आईडी डालकर, अपने इलाके को क्षेत्र के तौर पर तय करें. प्लेस आईडी, किसी भौगोलिक इलाके को दिखाता है. जैसे, ऐसा इलाका जिसे पॉलीगॉन से दिखाया जा सकता है. उदाहरण के लिए, टैम्पा, फ़्लोरिडा का प्लेस आईडी places/ChIJ4dG5s4K3wogRY7SWr4kTX6c है. ध्यान दें कि सभी जगह के आईडी की ज्यामिति अच्छी तरह से तय नहीं होती. ऐसे मामलों में, Places Insights API 404 गड़बड़ी कोड दिखाता है.

यहां दी गई टेबल में, ऐसे इलाकों की सूची दी गई है जहां यह सुविधा काम नहीं करती. यह पता लगाने के लिए कि जगह का आईडी, किसी ऐसे इलाके का है जहां यह सुविधा काम नहीं करती, Geocoding API के अनुरोध में जगह का आईडी डालें. जवाब में, type कलेक्शन शामिल होता है. इसमें जगह के आईडी से जुड़े क्षेत्रों की सूची होती है, जैसे कि city, neighborhood या country.

ऐसे इलाके जिनमें यह सुविधा उपलब्ध नहीं है
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
कस्टम एरिया

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

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

उदाहरण के लिए:

"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 के साथ काम करने वाली जगहों के प्राइमरी और सेकंडरी टाइप की सूची के लिए, Places API (नया वर्शन) के जगह के टाइप में जाकर टेबल A देखें. आपको कम से कम एक includedTypes या includedPrimaryTypes टाइप की वैल्यू देनी होगी.

  • includedTypes: शामिल की गई जगहों के टाइप की सूची.
  • excludedTypes: उन जगहों की सूची जिन्हें शामिल नहीं किया गया है.
  • includedPrimaryTypes: शामिल की गई मुख्य जगहों की सूची.
  • excludedPrimaryTypes: उन मुख्य जगहों की सूची जिन्हें शामिल नहीं किया गया है.

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

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

इन फ़िल्टर का इस्तेमाल करना ज़रूरी नहीं है:

  • operatingStatus: इसमें उन जगहों की स्थितियां बताई जाती हैं जिन्हें शामिल या बाहर रखना है. डिफ़ॉल्ट रूप से, operatingStatus: OPERATING_STATUS_OPERATIONAL (एक खास वैल्यू) के हिसाब से फ़िल्टर किया जाता है.
  • priceLevels: जगहों के लिए कीमत के लेवल की जानकारी देता है. डिफ़ॉल्ट रूप से, फ़िल्टर नहीं किया जाता (नतीजों में सभी कीमत के लेवल शामिल होते हैं).
  • ratingFilter: इससे जगहों की रेटिंग की रेंज का पता चलता है. डिफ़ॉल्ट रूप से, कोई फ़िल्टर नहीं होता (नतीजों में सभी रेटिंग शामिल होती हैं).

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

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

कीमत स्तर

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

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

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

  • minRating: उपयोगकर्ताओं की औसत रेटिंग कम से कम 1.0 और 5.0 के बीच होनी चाहिए.
  • maxRating: उपयोगकर्ता की सबसे ज़्यादा औसत रेटिंग (1.0 से 5.0 के बीच).