Method: computeInsights

इस तरीके से, अलग-अलग फ़िल्टर का इस्तेमाल करके इलाकों के बारे में अहम जानकारी हासिल की जा सकती है. जैसे: इलाका, जगह का टाइप, कारोबार के खुले होने की स्थिति, कीमत का लेवल, और रेटिंग. फ़िलहाल, "गिनती" और "जगहें" इनसाइट काम करती हैं. "count" की अहम जानकारी की मदद से, "कैलिफ़ोर्निया में कितने रेस्टोरेंट खुले हैं, जो कि सस्ते हैं और जिनकी औसत रेटिंग कम से कम चार स्टार है" जैसे सवालों के जवाब मिल सकते हैं. ज़्यादा जानकारी के लिए, insight enum देखें. "जगहें" की अहम जानकारी की मदद से, यह पता लगाया जा सकता है कि अनुरोध किए गए फ़िल्टर से कौनसी जगहें मैच करती हैं. इसके बाद, क्लाइंट उन जगहों के संसाधन के नामों का इस्तेमाल करके, Places API का इस्तेमाल करके हर जगह के बारे में ज़्यादा जानकारी हासिल कर सकते हैं.

एचटीटीपी अनुरोध

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

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "insights": [
    enum (Insight)
  ],
  "filter": {
    object (Filter)
  }
}
फ़ील्ड
insights[]

enum (Insight)

ज़रूरी है. अहम जानकारी का हिसाब लगाना. फ़िलहाल, सिर्फ़ INSIGHT_COUNT और INSIGHT_PLACES का इस्तेमाल किया जा सकता है.
filter

object (Filter)

ज़रूरी है. अहम जानकारी फ़िल्टर.

जवाब का मुख्य भाग

v1.computeInsights RPC के लिए रिस्पॉन्स.

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

JSON के काेड में दिखाना 
{
  "placeInsights": [
    {
      object (PlaceInsight)
    }
  ],
  "count": string
}
फ़ील्ड
placeInsights[]

object (PlaceInsight)

Insights.INSIGHT_PLACES के लिए नतीजा.
count

string (int64 format)

Insights.INSIGHT_COUNT के लिए नतीजा.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform

अहम जानकारी

काम की अहम जानकारी.

Enums
INSIGHT_UNSPECIFIED जानकारी नहीं दी गई है.
INSIGHT_COUNT

इनसाइट की गिनती करें.

जब यह अहम जानकारी दी जाती है, तो v1.computeInsights, फ़िल्टर की तय शर्तों से मैच करने वाली जगहों की संख्या दिखाता है.

अनुरोध का उदाहरण:

{
  "insights": ["INSIGHT_COUNT"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

जवाब का उदाहरण:

{
  "count": 1234
}
INSIGHT_PLACES

सामान लौटाने की जगहें

इस इनसाइट को तय करने पर, v1.computeInsights उन जगहों के आईडी दिखाता है जो फ़िल्टर की बताई गई शर्तों से मेल खाते हैं.

अनुरोध का उदाहरण:

{
  "insights": ["INSIGHT_PLACES"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

जवाब का उदाहरण:

{
  "placeInsights": [
    {"place": "places/ABC"},
    {"place": "places/PQR"},
    {"place": "places/XYZ"}
  ]
}

फ़िल्टर

v1.computeInsights आरपीसी के लिए फ़िल्टर.

JSON के काेड में दिखाना 
{
  "locationFilter": {
    object (LocationFilter)
  },
  "typeFilter": {
    object (TypeFilter)
  },
  "operatingStatus": [
    enum (OperatingStatus)
  ],
  "priceLevels": [
    enum (PriceLevel)
  ],
  "ratingFilter": {
    object (RatingFilter)
  }
}
फ़ील्ड
locationFilter

object (LocationFilter)

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

object (TypeFilter)

ज़रूरी है. जगह के टाइप के फ़िल्टर.
operatingStatus[]

enum (OperatingStatus)

ज़रूरी नहीं. इस सूची में शामिल जगहों के हिसाब से खोज के नतीजे दिखाता है. अगर operatingStatus सेट नहीं है, तो OPERATING_STATUS_OPERATIONAL का इस्तेमाल डिफ़ॉल्ट तौर पर किया जाता है.
priceLevels[]

enum (PriceLevel)

ज़रूरी नहीं. इस सूची में शामिल कीमत वाले होटलों के नतीजे दिखाता है. अगर priceLevels सेट नहीं है, तो नतीजों में सभी किराये के लेवल शामिल होते हैं.
ratingFilter

object (RatingFilter)

ज़रूरी नहीं. नतीजों को उन जगहों तक सीमित करता है जिनकी औसत उपयोगकर्ता रेटिंग, ratingFilter की तय की गई रेंज में है. अगर ratingFilter सेट नहीं है, तो नतीजे में सभी रेटिंग शामिल होती हैं.

LocationFilter

जगह के हिसाब से फ़िल्टर.

अहम जानकारी के लिए, पसंद के विषय के बारे में बताता है.

JSON के काेड में दिखाना 
{

  // Union field area can be only one of the following:
  "circle": {
    object (Circle)
  },
  "region": {
    object (Region)
  },
  "customArea": {
    object (CustomArea)
  }
  // End of list of possible types for union field area.
}
फ़ील्ड
यूनियन फ़ील्ड area. इनमें से कोई एक वैल्यू दी जानी चाहिए. area इनमें से कोई एक हो सकता है:
circle

object (Circle)

क्षेत्रफल को सर्कल के तौर पर दिखाना.
region

object (Region)

इलाके को क्षेत्र के तौर पर सेट करना.
customArea

object (CustomArea)

पॉलीगॉन से तय किया गया कस्टम एरिया.

सर्कल

वृत्त को केंद्र बिंदु और त्रिज्या के हिसाब से मीटर में तय किया जाता है.

JSON के काेड में दिखाना 
{
  "radius": integer,

  // Union field center can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "place": string
  // End of list of possible types for union field center.
}
फ़ील्ड
radius

integer

ज़रूरी नहीं. सर्कल का दायरा मीटर में
यूनियन फ़ील्ड center. सर्कल का केंद्र. center इनमें से कोई एक हो सकता है:
latLng

object (LatLng)

सर्कल के बीच के हिस्से का अक्षांश और देशांतर.
place

string

फ़ॉर्मैट: यह places/PLACE_ID फ़ॉर्मैट में होना चाहिए. यहां PLACE_ID, किसी जगह का यूनीक आइडेंटिफ़ायर है. उदाहरण के लिए: places/ChIJgUbEo8cfqokR5lP9_Wh_DaM.

LatLng

अक्षांश/देशांतर के पेयर को दिखाने वाला ऑब्जेक्ट. अक्षांश और देशांतर की डिग्री दिखाने के लिए, इसे दो डबल वैल्यू के तौर पर दिखाया जाता है. अगर इस बारे में अलग से जानकारी नहीं दी गई है, तो यह ऑब्जेक्ट WGS84 स्टैंडर्ड के मुताबिक होना चाहिए. वैल्यू, सामान्य सीमा के अंदर होनी चाहिए.

JSON के काेड में दिखाना 
{
  "latitude": number,
  "longitude": number
}
फ़ील्ड
latitude

number

अक्षांश, डिग्री में. यह वैल्यू [-90.0, +90.0] की रेंज में होनी चाहिए.
longitude

number

डिग्री में देशांतर. यह वैल्यू, [-180.0, +180.0] की रेंज में होनी चाहिए.

क्षेत्र

कोई इलाका, भौगोलिक सीमा होती है. जैसे: शहर, पिन कोड, काउंटी, राज्य वगैरह.

JSON के काेड में दिखाना 
{

  // Union field region can be only one of the following:
  "place": string
  // End of list of possible types for union field region.
}
फ़ील्ड
यूनियन फ़ील्ड region. किसी भौगोलिक क्षेत्र की जानकारी देता है. एक बार में सिर्फ़ एक तरह के इलाके (जैसे, जगह) की जानकारी दी जा सकती है. region इनमें से कोई एक हो सकता है:
place

string

किसी खास भौगोलिक इलाके का यूनीक आइडेंटिफ़ायर.

CustomArea

कस्टम एरिया.

JSON के काेड में दिखाना 
{
  "polygon": {
    object (Polygon)
  }
}
फ़ील्ड
polygon

object (Polygon)

ज़रूरी है. कस्टम एरिया को पॉलीगॉन के तौर पर दिखाया गया है

पॉलीगॉन

पॉलीगॉन को, आपस में जुड़े निर्देशांकों की सीरीज़ से दिखाया जाता है. ये निर्देशांक, घड़ी की सुई के उलट दिशा में क्रम में होते हैं. निर्देशांक एक बंद लूप बनाते हैं और भरे हुए क्षेत्र को दिखाते हैं. पहले और आखिरी निर्देशांक एक जैसे होते हैं और इनमें एक जैसी वैल्यू होनी चाहिए. यह फ़ॉर्मैट, GeoJSON पॉलीगॉन का आसान वर्शन है. हम सिर्फ़ एक एंटी-क्लाइकवाइज़ बाहरी रिंग का इस्तेमाल करते हैं.

JSON के काेड में दिखाना 
{
  "coordinates": [
    {
      object (LatLng)
    }
  ]
}
फ़ील्ड
coordinates[]

object (LatLng)

ज़रूरी नहीं. पॉलीगॉन की जानकारी देने वाले निर्देशांक.

TypeFilter

जगह के टाइप के फ़िल्टर.

सिर्फ़ टेबल a में मौजूद जगह के टाइप इस्तेमाल किए जा सकते हैं.

किसी जगह के लिए, सिर्फ़ एक प्राइमरी टाइप सेट किया जा सकता है. उदाहरण के लिए, प्राइमरी टाइप "mexican_restaurant" या "steak_house" हो सकता है. किसी जगह के प्राइमरी टाइप के हिसाब से नतीजों को फ़िल्टर करने के लिए, includedPrimaryTypes और excludedPrimaryTypes का इस्तेमाल करें.

किसी जगह के लिए, टाइप की कई वैल्यू भी हो सकती हैं. उदाहरण के लिए, किसी रेस्टोरेंट के लिए ये टाइप इस्तेमाल किए जा सकते हैं: "seafood_restaurant", "restaurant", "food", "point_of_interest", "establishment". किसी जगह से जुड़े टाइप की सूची में नतीजों को फ़िल्टर करने के लिए, includedTypes और excludedTypes का इस्तेमाल करें.

अगर किसी खोज में कई तरह की पाबंदियां तय की गई हैं, तो सिर्फ़ वे जगहें दिखाई जाती हैं जो सभी पाबंदियों को पूरा करती हैं. उदाहरण के लिए, अगर आपने {"includedTypes": ["restaurant"], "excludedPrimaryTypes": ["steak_house"]} की वैल्यू दी है, तो खोज के नतीजों में ऐसी जगहें दिखेंगी जो "restaurant" से जुड़ी सेवाएं देती हैं, लेकिन मुख्य रूप से "steak_house" के तौर पर काम नहीं करती हैं.

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

includedTypes या includedPrimaryTypes में से कोई एक सेट होना चाहिए.

JSON के काेड में दिखाना 
{
  "includedTypes": [
    string
  ],
  "excludedTypes": [
    string
  ],
  "includedPrimaryTypes": [
    string
  ],
  "excludedPrimaryTypes": [
    string
  ]
}
फ़ील्ड
includedTypes[]

string

ज़रूरी नहीं. शामिल की गई जगहों के टाइप.
excludedTypes[]

string

ज़रूरी नहीं. जगह के ऐसे टाइप जिन्हें शामिल नहीं किया गया है.
includedPrimaryTypes[]

string

ज़रूरी नहीं. शामिल की गई जगह के मुख्य टाइप.
excludedPrimaryTypes[]

string

ज़रूरी नहीं. जगह के मुख्य टाइप, जिन्हें शामिल नहीं किया गया है.

OperatingStatus

जगह के खुले या बंद होने की स्थिति.

Enums
OPERATING_STATUS_UNSPECIFIED इसकी जानकारी नहीं दी गई है. इस वैल्यू का इस्तेमाल नहीं किया जाना चाहिए.
OPERATING_STATUS_OPERATIONAL जगह खुली हो और तय किए गए समय के दौरान खुली हो.
OPERATING_STATUS_PERMANENTLY_CLOSED जगह अब बंद हो गई है.
OPERATING_STATUS_TEMPORARILY_CLOSED यह जगह कुछ समय के लिए बंद है. आने वाले समय में इसे फिर से खोला जा सकता है.

PriceLevel

जगह की कीमत का लेवल.

Enums
PRICE_LEVEL_UNSPECIFIED इसकी जानकारी नहीं दी गई है. इस वैल्यू का इस्तेमाल नहीं किया जाना चाहिए.
PRICE_LEVEL_FREE जगह पर मुफ़्त सेवाएं दी जाती हैं.
PRICE_LEVEL_INEXPENSIVE जगह पर कम कीमत पर सेवाएं मिलती हैं.
PRICE_LEVEL_MODERATE यहां पर मध्यम कीमत पर सेवाएं दी जाती हैं.
PRICE_LEVEL_EXPENSIVE जगह महंगी सेवाएं देती है.
PRICE_LEVEL_VERY_EXPENSIVE जगह बहुत महंगी सेवाएं देती है.

RatingFilter

उपयोगकर्ता रेटिंग के लिए औसत रेटिंग वाले फ़िल्टर.

JSON के काेड में दिखाना 
{
  "minRating": number,
  "maxRating": number
}
फ़ील्ड
minRating

number

ज़रूरी नहीं. इससे नतीजों में सिर्फ़ ऐसी जगहें दिखती हैं जिनकी औसत उपयोगकर्ता रेटिंग, minRating से ज़्यादा या उसके बराबर हो. वैल्यू, 1.0 से 5.0 के बीच होनी चाहिए.
maxRating

number

ज़रूरी नहीं. इससे नतीजों को ऐसी जगहों तक सीमित किया जाता है जिनकी औसत उपयोगकर्ता रेटिंग, maxRating से कम या उसके बराबर हो. वैल्यू, 1.0 से 5.0 के बीच होनी चाहिए.

PlaceInsight

किसी जगह की जानकारी रखता है

JSON के काेड में दिखाना 
{
  "place": string
}
फ़ील्ड
place

string

जगह का यूनीक आइडेंटिफ़ायर. Places API का इस्तेमाल करके, जगह की जानकारी पाने के लिए, इस संसाधन के नाम का इस्तेमाल किया जा सकता है.