- HTTP অনুরোধ
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- অনুমোদনের সুযোগ
- অন্তর্দৃষ্টি
- ফিল্টার
- অবস্থান ফিল্টার
- বৃত্ত
- LatLng
- অঞ্চল
- কাস্টম এরিয়া
- বহুভুজ
- টাইপ ফিল্টার
- অপারেটিং স্ট্যাটাস
- প্রাইস লেভেল
- রেটিং ফিল্টার
- প্লেসইনসাইট
কম্পিউট ইনসাইটস RPC
এই পদ্ধতিটি আপনাকে বিভিন্ন ধরনের ফিল্টার ব্যবহার করে এলাকা সম্পর্কে অন্তর্দৃষ্টি পুনরুদ্ধার করতে দেয় যেমন: এলাকা, স্থানের ধরন, অপারেটিং স্থিতি, মূল্য স্তর এবং রেটিং। বর্তমানে "গণনা" এবং "স্থান" অন্তর্দৃষ্টি সমর্থিত। "গণনা" অন্তর্দৃষ্টি দিয়ে আপনি প্রশ্নের উত্তর দিতে পারেন যেমন "ক্যালিফোর্নিয়ায় কতগুলি রেস্তোরাঁ আছে যেগুলি চালু আছে, সস্তা এবং কমপক্ষে 4 তারার গড় রেটিং আছে" (আরো বিশদ বিবরণের জন্য insight
enum দেখুন)৷ "স্থান" অন্তর্দৃষ্টি দিয়ে, আপনি নির্ধারণ করতে পারেন কোন স্থানগুলি অনুরোধ করা ফিল্টারের সাথে মেলে৷ ক্লায়েন্টরা তারপর স্থানগুলি API ব্যবহার করে প্রতিটি পৃথক স্থান সম্পর্কে আরও বিশদ আনতে সেই স্থানগুলির সংস্থানগুলির নামগুলি ব্যবহার করতে পারে৷
HTTP অনুরোধ
POST https://areainsights.googleapis.com/v1:computeInsights
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{ "insights": [ enum ( |
ক্ষেত্র | |
---|---|
insights[] | প্রয়োজন। গণনা করার অন্তর্দৃষ্টি। বর্তমানে শুধুমাত্র INSIGHT_COUNT এবং INSIGHT_PLACES সমর্থিত। |
filter | প্রয়োজন। অন্তর্দৃষ্টি ফিল্টার। |
প্রতিক্রিয়া শরীর
v1.computeInsights RPC-এর প্রতিক্রিয়া।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{
"placeInsights": [
{
object ( |
ক্ষেত্র | |
---|---|
placeInsights[] | অন্তর্দৃষ্টির ফলাফল৷INSIGHT_PLACES৷ |
count | অন্তর্দৃষ্টির ফলাফল৷INSIGHT_COUNT৷ |
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth সুযোগ প্রয়োজন:
-
https://www.googleapis.com/auth/cloud-platform
অন্তর্দৃষ্টি
সমর্থিত অন্তর্দৃষ্টি.
Enums | |
---|---|
INSIGHT_UNSPECIFIED | নির্দিষ্ট করা হয়নি। |
INSIGHT_COUNT | অন্তর্দৃষ্টি গণনা. যখন এই অন্তর্দৃষ্টি নির্দিষ্ট করা হয় v1.computeInsights নির্দিষ্ট ফিল্টার মানদণ্ডের সাথে মেলে এমন স্থানের সংখ্যা প্রদান করে।
|
INSIGHT_PLACES | রিটার্ন প্লেস যখন এই অন্তর্দৃষ্টি নির্দিষ্ট করা হয় v1.computeInsights নির্দিষ্ট ফিল্টার মানদণ্ডের সাথে মেলে এমন স্থানগুলি প্রদান করে৷
|
ফিল্টার
v1.computeInsights RPC-এর জন্য ফিল্টার।
JSON প্রতিনিধিত্ব |
---|
{ "locationFilter": { object ( |
ক্ষেত্র | |
---|---|
locationFilter | প্রয়োজন। অবস্থান ফিল্টার দ্বারা নির্দিষ্ট এলাকায় অবস্থিত স্থানগুলিতে ফলাফল সীমাবদ্ধ করে৷ |
typeFilter | প্রয়োজন। জায়গা টাইপ ফিল্টার. |
operatingStatus[] | ঐচ্ছিক। ফলাফলগুলিকে সেই স্থানগুলিতে সীমাবদ্ধ করে যার অপারেটিং স্থিতি এই তালিকায় অন্তর্ভুক্ত করা হয়েছে৷ অপারেটিং স্ট্যাটাস সেট করা না থাকলে, OPERATING_STATUS_OPERATIONAL ডিফল্ট হিসাবে ব্যবহার করা হয়। |
priceLevels[] | ঐচ্ছিক। এই তালিকায় মূল্য স্তর অন্তর্ভুক্ত করা হয়েছে এমন স্থানগুলিতে ফলাফল সীমাবদ্ধ করে৷ মূল্য_স্তর সেট করা না থাকলে, সমস্ত মূল্য স্তর ফলাফলে অন্তর্ভুক্ত করা হয়। |
ratingFilter | ঐচ্ছিক। রেটিংফিল্টার দ্বারা নির্দিষ্ট সীমার মধ্যে ব্যবহারকারীর গড় রেটিং এমন জায়গায় ফলাফল সীমাবদ্ধ করে। রেটিং ফিল্টার সেট করা না থাকলে, সমস্ত রেটিং ফলাফলে অন্তর্ভুক্ত করা হয়। |
অবস্থান ফিল্টার
অবস্থান ফিল্টার.
অন্তর্দৃষ্টির জন্য আগ্রহের ক্ষেত্র নির্দিষ্ট করে।
JSON প্রতিনিধিত্ব |
---|
{ // Union field |
ক্ষেত্র | |
---|---|
ইউনিয়ন মাঠ area । নিম্নলিখিত একটি নির্দিষ্ট করা আবশ্যক. area নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: | |
circle | একটি বৃত্ত হিসাবে এলাকা। |
region | অঞ্চল হিসাবে এলাকা। |
customArea | একটি বহুভুজ দ্বারা নির্দিষ্ট কাস্টম এলাকা। |
বৃত্ত
একটি বৃত্ত একটি কেন্দ্র বিন্দু এবং মিটার ব্যাসার্ধ দ্বারা সংজ্ঞায়িত করা হয়।
JSON প্রতিনিধিত্ব |
---|
{ "radius": integer, // Union field |
ক্ষেত্র | |
---|---|
radius | ঐচ্ছিক। বৃত্তের ব্যাসার্ধ মিটারে |
ইউনিয়ন মাঠ center । বৃত্তের কেন্দ্র। center নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: | |
latLng | বৃত্তের কেন্দ্রের অক্ষাংশ এবং দ্রাঘিমাংশ। |
place | বৃত্তের কেন্দ্রের স্থান সম্পদের নাম। শুধুমাত্র পয়েন্ট স্থান সমর্থিত. |
LatLng
একটি বস্তু যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া প্রতিনিধিত্ব করে। এটি ডিগ্রী অক্ষাংশ এবং ডিগ্রী দ্রাঘিমাংশের প্রতিনিধিত্ব করার জন্য এক জোড়া দ্বিগুণ হিসাবে প্রকাশ করা হয়। অন্যথায় নির্দিষ্ট করা না থাকলে, এই বস্তুটিকে অবশ্যই WGS84 মান মেনে চলতে হবে। মানগুলি অবশ্যই স্বাভাবিক সীমার মধ্যে থাকতে হবে৷
JSON প্রতিনিধিত্ব |
---|
{ "latitude": number, "longitude": number } |
ক্ষেত্র | |
---|---|
latitude | ডিগ্রী অক্ষাংশ. এটি অবশ্যই [-90.0, +90.0] এর মধ্যে হতে হবে। |
longitude | ডিগ্রী দ্রাঘিমাংশ. এটি অবশ্যই [-180.0, +180.0] পরিসরে হতে হবে। |
অঞ্চল
একটি অঞ্চল হল একটি ভৌগলিক সীমানা যেমন: শহর, পোস্টাল কোড, কাউন্টি, রাজ্য ইত্যাদি।
JSON প্রতিনিধিত্ব |
---|
{ // Union field |
ক্ষেত্র | |
---|---|
ইউনিয়ন মাঠ region । একটি ভৌগলিক অঞ্চল সংজ্ঞায়িত করে। এক সময়ে শুধুমাত্র এক ধরনের অঞ্চল (যেমন স্থান) নির্দিষ্ট করা যেতে পারে। region নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: | |
place | একটি নির্দিষ্ট ভৌগলিক অঞ্চলের অনন্য শনাক্তকারী। |
কাস্টম এরিয়া
কাস্টম এলাকা।
JSON প্রতিনিধিত্ব |
---|
{
"polygon": {
object ( |
ক্ষেত্র | |
---|---|
polygon | প্রয়োজন। একটি বহুভুজ হিসাবে উপস্থাপিত কাস্টম এলাকা |
বহুভুজ
একটি বহুভুজকে ঘড়ির কাঁটার বিপরীতে ক্রমানুসারে সংযুক্ত স্থানাঙ্কের একটি সিরিজ দ্বারা উপস্থাপন করা হয়। স্থানাঙ্কগুলি একটি বন্ধ লুপ গঠন করে এবং একটি ভরাট অঞ্চলকে সংজ্ঞায়িত করে। প্রথম এবং শেষ স্থানাঙ্কগুলি সমতুল্য, এবং তাদের অবশ্যই অভিন্ন মান থাকতে হবে। বিন্যাসটি GeoJSON বহুভুজের একটি সরলীকৃত সংস্করণ (আমরা শুধুমাত্র একটি ঘড়ির কাঁটার বিপরীতে বহিরাগত রিং সমর্থন করি)।
JSON প্রতিনিধিত্ব |
---|
{
"coordinates": [
{
object ( |
ক্ষেত্র | |
---|---|
coordinates[] | ঐচ্ছিক। যে স্থানাঙ্কগুলি বহুভুজকে সংজ্ঞায়িত করে। |
টাইপ ফিল্টার
জায়গা টাইপ ফিল্টার.
সারণি a থেকে শুধুমাত্র স্থানের ধরন সমর্থিত।
একটি স্থানের সাথে শুধুমাত্র একটি প্রাথমিক প্রকার যুক্ত থাকতে পারে। উদাহরণস্বরূপ, প্রাথমিক প্রকার হতে পারে "mexican_restaurant" বা "steak_house"। একটি স্থানের প্রাথমিক প্রকারের ফলাফলগুলি ফিল্টার করতে অন্তর্ভুক্তপ্রাইমারি টাইপস এবং বাদ দেওয়া প্রাথমিক প্রকারগুলি ব্যবহার করুন৷
একটি জায়গার সাথে একাধিক ধরণের মানও যুক্ত থাকতে পারে। যেমন একটি রেস্তোরাঁর এই ধরনের হতে পারে: "সীফুড_রেস্তোরাঁ", "রেস্তোরাঁ", "খাবার", "পয়েন্ট_অফ_ইন্টারেস্ট", "প্রতিষ্ঠা"। একটি স্থানের সাথে সম্পর্কিত প্রকারের তালিকায় ফলাফলগুলি ফিল্টার করতে অন্তর্ভুক্ত প্রকার এবং বহিষ্কৃত প্রকারগুলি ব্যবহার করুন৷
যদি একটি অনুসন্ধান একাধিক প্রকারের বিধিনিষেধের সাথে নির্দিষ্ট করা হয়, শুধুমাত্র সেই স্থানগুলি যা সমস্ত বিধিনিষেধ পূরণ করে ফেরত দেওয়া হয়৷ উদাহরণ স্বরূপ, আপনি যদি {"includedTypes": ["restaurant"], "excludedPrimaryTypes": ["steak_house"]} উল্লেখ করেন, তাহলে প্রত্যাবর্তিত স্থানগুলি "রেস্তোরাঁ" সম্পর্কিত পরিষেবা প্রদান করে কিন্তু প্রাথমিকভাবে "স্টেক_হাউস" হিসেবে কাজ করে না।
যদি কোনো পরস্পরবিরোধী প্রকার থাকে, যেমন একটি টাইপ অন্তর্ভুক্ত টাইপস এবং এক্সক্লুড টাইপস উভয় প্রকারে বা অন্তর্ভুক্তপ্রাইমারি টাইপস এবং এক্সক্লুডডপ্রাইমারি টাইপস উভয় ক্ষেত্রেই দেখা যায়, একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়।
অন্তর্ভুক্ত প্রকার বা অন্তর্ভুক্তপ্রাইমারি টাইপগুলির মধ্যে একটি সেট করতে হবে।
JSON প্রতিনিধিত্ব |
---|
{ "includedTypes": [ string ], "excludedTypes": [ string ], "includedPrimaryTypes": [ string ], "excludedPrimaryTypes": [ string ] } |
ক্ষেত্র | |
---|---|
includedTypes[] | ঐচ্ছিক। স্থান প্রকার অন্তর্ভুক্ত. |
excludedTypes[] | ঐচ্ছিক। বাদ দেওয়া জায়গার ধরন। |
includedPrimaryTypes[] | ঐচ্ছিক। প্রাথমিক স্থানের ধরন অন্তর্ভুক্ত। |
excludedPrimaryTypes[] | ঐচ্ছিক। প্রাথমিক স্থানের প্রকারগুলি বাদ দেওয়া হয়েছে৷ |
অপারেটিং স্ট্যাটাস
স্থানটির অপারেটিং অবস্থা।
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 | ঐচ্ছিক। ফলাফলগুলিকে এমন জায়গায় সীমাবদ্ধ করে যেগুলির গড় ব্যবহারকারীর রেটিং minRating এর থেকে বেশি বা সমান৷ মান 1.0 এবং 5.0 এর মধ্যে হতে হবে। |
maxRating | ঐচ্ছিক। ফলাফলগুলিকে এমন জায়গায় সীমাবদ্ধ করে যেগুলির গড় ব্যবহারকারীর রেটিং maxRating-এর থেকে কঠোরভাবে কম বা সমান৷ মান 1.0 এবং 5.0 এর মধ্যে হতে হবে। |
প্লেসইনসাইট
একটি স্থান সম্পর্কে তথ্য ধারণ করে
JSON প্রতিনিধিত্ব |
---|
{ "place": string } |
ক্ষেত্র | |
---|---|
place | জায়গাটির অনন্য শনাক্তকারী। স্থান API ব্যবহার করে স্থান সম্পর্কে বিশদ পুনরুদ্ধার করতে এই সংস্থান নামটি ব্যবহার করা যেতে পারে। |