उदाहरण

इस सेक्शन में, Places Insights API से जुड़े अनुरोधों के कई उदाहरण दिए गए हैं.

computeInsights का इस्तेमाल करने के लिए, नीचे दिए गए फ़ॉर्म में एचटीटीपी पोस्ट अनुरोध सबमिट करें:

https://areainsights.googleapis.com/v1:computeInsights

किसी सर्कल में मौजूद जगहों की जानकारी दिखाना

लंदन के ट्रैफ़ल्गर स्क्वेयर के 200 मीटर के दायरे में मौजूद सभी रेस्टोरेंट वापस करें.

• खोज के लिए चुना गया इलाका, किसी खास अक्षांश और देशांतर के बीच का एक गोला होता है. इस सर्कल की रेडियस 200 मीटर है, जिससे तय होता है कि क्षेत्र खोजें.
• अनुरोध की गई जगह का प्रकार रेस्टोरेंट है और इसे इसके साथ पास किया जाता है type_filters में included_types.
• संख्या का अनुरोध INSIGHTS_COUNT का इस्तेमाल करके किया गया है, जबकि जगह के आईडी हैं INSIGHTS_PLACES का इस्तेमाल करके अनुरोध किया गया है.

{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "location_filter": {
      "circle": {
        "lat_lng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "type_filter": { "included_types": "restaurant" }
  }
}

स्थान प्रकार हटाएं

जगह के टाइप को संख्या से बाहर भी रखा जा सकता है.

नीचे दिया गया अनुरोध पहले उदाहरण के जैसा ही है, लेकिन type_filters के लिए excluded_types. स्ट्रिंग या अरे का इस्तेमाल किया जा सकता है जिसमें included_types और excluded_types के लिए स्ट्रिंग का इस्तेमाल किया गया है.

इस उदाहरण में दो तरह की जगहों को शामिल नहीं किया गया है: cafe और bakery restaurant की संख्या.

{
    "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
    "filter": {
        "location_filter": {
            "circle": {
                "lat_lng": { "latitude": 51.508, "longitude": -0.128},
                "radius": 200
            }
        },
        "type_filter": {
            "included_types": "restaurant",
            "excluded_types": [
                "cafe",
                "bakery"
            ]
        }
    }
}

प्राथमिक प्रकार का उपयोग करें

यह उदाहरण पहले उदाहरण से मिले अनुरोध में बदलाव करता है, ताकि सिर्फ़ जगहों की जानकारी शामिल की जा सके जिसे गिनती में restaurant का primaryType हो.

{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "location_filter": {
      "circle": {
        "lat_lng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "type_filter": { "included_primary_types": "restaurant" }
  }
}

कस्टम पॉलीगॉन

इस उदाहरण में, आपकी खोज को तय करने के लिए कस्टम पॉलीगॉन का इस्तेमाल करने का तरीका बताया गया है क्षेत्र. ध्यान रखें कि INSIGHTS_PLACES तय करने से, खोज बॉक्स में इतने छोटे क्षेत्र मिल सकते हैं, जहां 100 स्थान आईडी तक दिखाई जा सकती हैं. बड़े एरिया के लिए, इस्तेमाल करें INSIGHTS_COUNT को इस सीमा को बायपास करना होगा, ताकि सेवा का इस्तेमाल करने की ज़रूरत न पड़े अलग-अलग जगह के आईडी दिखाएं.

पहले की तरह ही, restaurant जगह का टाइप इस्तेमाल किया गया है. इस उदाहरण में, आपको तीन अन्य फ़िल्टर:

• operating_status: इस उदाहरण में, सिर्फ़ उन जगहों की गिनती की जाती है जो काम कर रही हैं.
• price_level: इस उदाहरण में सिर्फ़ सस्ता और सामान्य किराया दिखाया गया है जगहें.
• rating_filter: इस उदाहरण में सिर्फ़ उन जगहों को गिना गया है जिनकी समीक्षा का स्कोर 4.0 से 5.0 के बीच है.

{
    "insights": [ "INSIGHT_COUNT" ],
    "filter": {
        "location_filter": {
            "custom_area": {
                "polygon": {
                    "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 }
                    ]
                }
            }
        },
        "type_filter": {
            "included_types": "restaurant"
        },
        "operating_status": [ "OPERATING_STATUS_OPERATIONAL" ],
        "price_levels": [ "PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE" ],
        "rating_filter": { "min_rating": 4.0, "max_rating": 5.0 }
    }
}

भौगोलिक इलाका

इस उदाहरण में, खोज करने का इलाका सेट करने के लिए, भौगोलिक इलाके के आईडी का इस्तेमाल किया गया है. इन स्थान आईडी में किसी जगह की ज्यामिति शामिल होती है, जैसे कोई नगर या शहर. कॉन्टेंट बनाने यहां इस्तेमाल किया गया जगह का आईडी ChIJiQHsW0m3j4ARm69rRkrUF3w है, जो शहर में मौजूद है माउंटेन व्यू, कैलिफ़ोर्निया.

जगह के आईडी को Places Insights API में पास करने पर, खोज के लिए इस्तेमाल होने वाली जगह की सीमाएं सेट हो जाती हैं भौगोलिक क्षेत्र का. जगह का आईडी, place का इस्तेमाल करके, places/<place_ID> फ़ॉर्मैट में पास किया जाता है.

आप इनमें से किसी भी तरीके से भौगोलिक क्षेत्र का आईडी पा सकते हैं:

• जियोकोडिंग एपीआई
• टेक्स्ट खोज (नई सुविधा)
• आस-पास खोजने की सुविधा (नया)
• पते की पुष्टि करने वाला एपीआई
• किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा

{
    "insights": [
        "INSIGHT_COUNT"
    ],
    "filter": {
        "location_filter": {
            "region": {
                "place": "places/ChIJiQHsW0m3j4ARm69rRkrUF3w"
            }
        },
        "type_filter": {
            "included_types": [
                "restaurant"
            ]
        }
    }
}