Method: computeInsights

এই পদ্ধতিটি আপনাকে বিভিন্ন ফিল্টার ব্যবহার করে এলাকা সম্পর্কে অন্তর্দৃষ্টি পুনরুদ্ধার করতে দেয় যেমন: এলাকা, স্থানের ধরন, অপারেটিং স্থিতি, মূল্য স্তর এবং রেটিং। বর্তমানে "গণনা" এবং "স্থান" অন্তর্দৃষ্টি সমর্থিত। "গণনা" অন্তর্দৃষ্টি দিয়ে আপনি প্রশ্নের উত্তর দিতে পারেন যেমন "ক্যালিফোর্নিয়ায় কতগুলি রেস্তোরাঁ আছে যেগুলি চালু আছে, সস্তা এবং কমপক্ষে 4 তারার গড় রেটিং আছে" (আরো বিশদ বিবরণের জন্য insight enum দেখুন)৷ "স্থান" অন্তর্দৃষ্টি দিয়ে, আপনি নির্ধারণ করতে পারেন কোন স্থানগুলি অনুরোধ করা ফিল্টারের সাথে মেলে৷ ক্লায়েন্টরা তারপর স্থানগুলি API ব্যবহার করে প্রতিটি পৃথক স্থান সম্পর্কে আরও বিশদ আনতে সেই স্থানগুলির সংস্থানগুলির নামগুলি ব্যবহার করতে পারে৷

HTTP অনুরোধ

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

URL 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 )

অন্তর্দৃষ্টির ফলাফল৷INSIGHT_PLACES৷

count

string ( int64 format)

অন্তর্দৃষ্টির ফলাফল৷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 RPC-এর জন্য ফিল্টার।

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 )

ঐচ্ছিক। ফলাফলগুলিকে সেই স্থানগুলিতে সীমাবদ্ধ করে যার অপারেটিং স্থিতি এই তালিকায় অন্তর্ভুক্ত করা হয়েছে৷ অপারেটিং স্ট্যাটাস সেট করা না থাকলে, OPERATING_STATUS_OPERATIONAL ডিফল্ট হিসাবে ব্যবহার করা হয়।

priceLevels[]

enum ( PriceLevel )

ঐচ্ছিক। এই তালিকায় মূল্য স্তর অন্তর্ভুক্ত করা হয়েছে এমন স্থানগুলিতে ফলাফল সীমাবদ্ধ করে৷ priceLevels সেট করা না থাকলে, সমস্ত মূল্য স্তর ফলাফলে অন্তর্ভুক্ত করা হয়।

ratingFilter

object ( RatingFilter )

ঐচ্ছিক। রেটিংফিল্টার দ্বারা নির্দিষ্ট সীমার মধ্যে ব্যবহারকারীর গড় রেটিং এমন জায়গায় ফলাফল সীমাবদ্ধ করে। রেটিং ফিল্টার সেট করা না থাকলে, সমস্ত রেটিং ফলাফলে অন্তর্ভুক্ত করা হয়।

অবস্থান ফিল্টার

অবস্থান ফিল্টার.

অন্তর্দৃষ্টির জন্য আগ্রহের ক্ষেত্র নির্দিষ্ট করে।

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

একটি নির্দিষ্ট ভৌগলিক অঞ্চলের অনন্য শনাক্তকারী।

কাস্টম এরিয়া

কাস্টম এলাকা।

JSON প্রতিনিধিত্ব 
{
  "polygon": {
    object (Polygon)
  }
}
ক্ষেত্র
polygon

object ( Polygon )

প্রয়োজন। একটি বহুভুজ হিসাবে উপস্থাপিত কাস্টম এলাকা

বহুভুজ

একটি বহুভুজকে ঘড়ির কাঁটার বিপরীতে ক্রমানুসারে সংযুক্ত স্থানাঙ্কের একটি সিরিজ দ্বারা উপস্থাপন করা হয়। স্থানাঙ্কগুলি একটি বন্ধ লুপ গঠন করে এবং একটি ভরাট অঞ্চলকে সংজ্ঞায়িত করে। প্রথম এবং শেষ স্থানাঙ্কগুলি সমতুল্য, এবং তাদের অবশ্যই অভিন্ন মান থাকতে হবে। বিন্যাসটি GeoJSON বহুভুজের একটি সরলীকৃত সংস্করণ (আমরা শুধুমাত্র একটি ঘড়ির কাঁটার বিপরীতে বহিরাগত রিং সমর্থন করি)।

JSON প্রতিনিধিত্ব 
{
  "coordinates": [
    {
      object (LatLng)
    }
  ]
}
ক্ষেত্র
coordinates[]

object ( LatLng )

ঐচ্ছিক। যে স্থানাঙ্কগুলি বহুভুজকে সংজ্ঞায়িত করে।

টাইপ ফিল্টার

জায়গা টাইপ ফিল্টার.

সারণি a থেকে শুধুমাত্র স্থানের ধরন সমর্থিত।

একটি স্থানের সাথে শুধুমাত্র একটি প্রাথমিক প্রকার যুক্ত থাকতে পারে। উদাহরণস্বরূপ, প্রাথমিক প্রকার হতে পারে "mexican_restaurant" বা "steak_house"। একটি স্থানের প্রাথমিক প্রকারের ফলাফলগুলি ফিল্টার করতে অন্তর্ভুক্তপ্রাইমারি টাইপস এবং বাদ দেওয়া প্রাথমিক প্রকারগুলি ব্যবহার করুন৷

একটি জায়গার সাথে একাধিক ধরণের মানও যুক্ত থাকতে পারে। যেমন একটি রেস্তোরাঁর এই ধরনের হতে পারে: "সীফুড_রেস্তোরাঁ", "রেস্তোরাঁ", "খাবার", "পয়েন্ট_অফ_ইন্টারেস্ট", "প্রতিষ্ঠা"। একটি স্থানের সাথে সম্পর্কিত প্রকারের তালিকায় ফলাফলগুলি ফিল্টার করতে অন্তর্ভুক্ত প্রকার এবং বহিষ্কৃত প্রকারগুলি ব্যবহার করুন৷

যদি একটি অনুসন্ধান একাধিক প্রকারের বিধিনিষেধের সাথে নির্দিষ্ট করা হয়, শুধুমাত্র সেই স্থানগুলি যা সমস্ত বিধিনিষেধ পূরণ করে ফেরত দেওয়া হয়৷ উদাহরণ স্বরূপ, আপনি যদি {"includedTypes": ["restaurant"], "excludedPrimaryTypes": ["steak_house"]} উল্লেখ করেন, তাহলে প্রত্যাবর্তিত স্থানগুলি "রেস্তোরাঁ" সম্পর্কিত পরিষেবা প্রদান করে কিন্তু প্রাথমিকভাবে "স্টেক_হাউস" হিসেবে কাজ করে না।

যদি কোনো পরস্পরবিরোধী প্রকার থাকে, যেমন একটি টাইপ অন্তর্ভুক্ত টাইপস এবং এক্সক্লুড টাইপস উভয় প্রকারে বা অন্তর্ভুক্তপ্রাইমারি টাইপস এবং এক্সক্লুডডপ্রাইমারি টাইপস উভয় ক্ষেত্রেই দেখা যায়, একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়।

অন্তর্ভুক্ত প্রকার বা অন্তর্ভুক্ত প্রাইমারি টাইপগুলির মধ্যে একটি সেট করতে হবে।

JSON প্রতিনিধিত্ব 
{
  "includedTypes": [
    string
  ],
  "excludedTypes": [
    string
  ],
  "includedPrimaryTypes": [
    string
  ],
  "excludedPrimaryTypes": [
    string
  ]
}
ক্ষেত্র
includedTypes[]

string

ঐচ্ছিক। স্থান প্রকার অন্তর্ভুক্ত.

excludedTypes[]

string

ঐচ্ছিক। বাদ দেওয়া জায়গার ধরন।

includedPrimaryTypes[]

string

ঐচ্ছিক। প্রাথমিক স্থানের ধরন অন্তর্ভুক্ত।

excludedPrimaryTypes[]

string

ঐচ্ছিক। প্রাথমিক স্থানের প্রকারগুলি বাদ দেওয়া হয়েছে৷

অপারেটিং স্ট্যাটাস

স্থানটির অপারেটিং অবস্থা।

Enums
OPERATING_STATUS_UNSPECIFIED উল্লেখ করা হয়নি। এই মান ব্যবহার করা উচিত নয়.
OPERATING_STATUS_OPERATIONAL স্থানটি চালু থাকে এবং নির্ধারিত সময়ের মধ্যে এটি খোলা থাকে।
OPERATING_STATUS_PERMANENTLY_CLOSED জায়গাটি আর ব্যবসায় নেই।
OPERATING_STATUS_TEMPORARILY_CLOSED জায়গাটি সাময়িকভাবে বন্ধ রয়েছে এবং ভবিষ্যতে আবার চালু হবে বলে আশা করা হচ্ছে।

প্রাইস লেভেল

জায়গার দামের স্তর।

Enums
PRICE_LEVEL_UNSPECIFIED উল্লেখ করা হয়নি। এই মান ব্যবহার করা উচিত নয়.
PRICE_LEVEL_FREE স্থান বিনামূল্যে সেবা প্রদান করে.
PRICE_LEVEL_INEXPENSIVE জায়গা সস্তা পরিষেবা প্রদান করে.
PRICE_LEVEL_MODERATE স্থান মাঝারি মূল্যের পরিষেবা প্রদান করে।
PRICE_LEVEL_EXPENSIVE স্থান ব্যয়বহুল সেবা প্রদান করে.
PRICE_LEVEL_VERY_EXPENSIVE স্থান অত্যন্ত ব্যয়বহুল পরিষেবা প্রদান করে।

রেটিং ফিল্টার

গড় ব্যবহারকারী রেটিং ফিল্টার.

JSON প্রতিনিধিত্ব 
{
  "minRating": number,
  "maxRating": number
}
ক্ষেত্র
minRating

number

ঐচ্ছিক। ফলাফলগুলিকে এমন জায়গায় সীমাবদ্ধ করে যেগুলির গড় ব্যবহারকারীর রেটিং minRating এর থেকে বেশি বা সমান৷ মান 1.0 এবং 5.0 এর মধ্যে হতে হবে।

maxRating

number

ঐচ্ছিক। ফলাফলগুলিকে এমন জায়গায় সীমাবদ্ধ করে যেগুলির গড় ব্যবহারকারীর রেটিং maxRating-এর থেকে কঠোরভাবে কম বা সমান৷ মান 1.0 এবং 5.0 এর মধ্যে হতে হবে।

প্লেসইনসাইট

একটি স্থান সম্পর্কে তথ্য ধারণ করে

JSON প্রতিনিধিত্ব 
{
  "place": string
}
ক্ষেত্র
place

string

জায়গাটির অনন্য শনাক্তকারী। স্থান API ব্যবহার করে স্থান সম্পর্কে বিশদ পুনরুদ্ধার করতে এই সংস্থান নামটি ব্যবহার করা যেতে পারে।