Package google.maps.areainsights.v1

इंडेक्स

AreaInsights

Places Aggregate RPC के लिए सेवा की परिभाषा.

ComputeInsights

rpc ComputeInsights(ComputeInsightsRequest) returns (ComputeInsightsResponse)

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

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

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

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

ComputeInsightsRequest

ComputeInsights आरपीसी के लिए अनुरोध.

फ़ील्ड
insights[]

Insight

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

Filter

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

ComputeInsightsResponse

ComputeInsights आरपीसी के लिए रिस्पॉन्स.

फ़ील्ड
place_insights[]

PlaceInsight

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

int64

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

फ़िल्टर

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

फ़ील्ड
location_filter

LocationFilter

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

TypeFilter

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

OperatingStatus

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

PriceLevel

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

RatingFilter

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

अहम जानकारी

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

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

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

इस अहम जानकारी के लिए, 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

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

इस इनसाइट को तय करने पर, 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"}
  ]
}

LocationFilter

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

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

फ़ील्ड
यूनियन फ़ील्ड area. इनमें से कोई एक वैल्यू दी जानी चाहिए. area इनमें से कोई एक हो सकता है:
circle

Circle

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

Region

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

CustomArea

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

सर्कल

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

फ़ील्ड
radius

int32

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

LatLng

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

string

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

CustomArea

कस्टम एरिया.

फ़ील्ड
polygon

Polygon

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

पॉलीगॉन

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

फ़ील्ड
coordinates[]

LatLng

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

क्षेत्र

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

फ़ील्ड
यूनियन फ़ील्ड region. किसी भौगोलिक क्षेत्र की जानकारी देता है. एक बार में सिर्फ़ एक तरह के इलाके (जैसे, जगह) की जानकारी दी जा सकती है. region इनमें से कोई एक हो सकता है:
place

string

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

OperatingStatus

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

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

PlaceInsight

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

फ़ील्ड
place

string

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

PriceLevel

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

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

RatingFilter

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

फ़ील्ड
min_rating

float

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

float

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

TypeFilter

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

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

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

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

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

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

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

फ़ील्ड
included_types[]

string

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

string

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

string

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

string

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