Package google.maps.areainsights.v1

সূচক

এলাকা অন্তর্দৃষ্টি

স্থান সমষ্টি RPC জন্য পরিষেবা সংজ্ঞা.

ComputeInsights

rpc ComputeInsights( ComputeInsightsRequest ) returns ( ComputeInsightsResponse )

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

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

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

ComputeInsightsRequest

ComputeInsights RPC জন্য অনুরোধ.

ক্ষেত্র
insights[]

Insight

প্রয়োজন। গণনা করার অন্তর্দৃষ্টি। বর্তমানে শুধুমাত্র INSIGHT_COUNT এবং INSIGHT_PLACES সমর্থিত।

filter

Filter

প্রয়োজন। অন্তর্দৃষ্টি ফিল্টার।

ComputeInsights Response

ComputeInsights RPC-এর জন্য প্রতিক্রিয়া।

ক্ষেত্র
place_insights[]

PlaceInsight

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

count

int64

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

ফিল্টার

ComputeInsights RPC-এর জন্য ফিল্টার।

ক্ষেত্র
location_filter

LocationFilter

প্রয়োজন। অবস্থান ফিল্টার দ্বারা নির্দিষ্ট এলাকায় অবস্থিত স্থানগুলিতে ফলাফল সীমাবদ্ধ করে৷

type_filter

TypeFilter

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

operating_status[]

OperatingStatus

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

price_levels[]

PriceLevel

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

rating_filter

RatingFilter

ঐচ্ছিক। ফলাফলগুলিকে এমন জায়গায় সীমাবদ্ধ করে যেগুলির গড় ব্যবহারকারীর রেটিং 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"}
  ]
}

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

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

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

ক্ষেত্র
ইউনিয়ন মাঠ 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

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

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

ক্ষেত্র
polygon

Polygon

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

বহুভুজ

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

ক্ষেত্র
coordinates[]

LatLng

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

অঞ্চল

একটি অঞ্চল হল একটি ভৌগলিক সীমানা যেমন: শহর, পোস্টাল কোড, কাউন্টি, রাজ্য ইত্যাদি।

ক্ষেত্র
ইউনিয়ন মাঠ region । একটি ভৌগলিক অঞ্চল সংজ্ঞায়িত করে। এক সময়ে শুধুমাত্র এক ধরনের অঞ্চল (যেমন স্থান) নির্দিষ্ট করা যেতে পারে। region নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
place

string

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

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

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

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

প্লেসইনসাইট

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

ক্ষেত্র
place

string

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

প্রাইস লেভেল

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

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

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

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

ক্ষেত্র
min_rating

float

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

max_rating

float

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

টাইপ ফিল্টার

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

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

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

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

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

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

অন্তর্ভুক্ত_প্রকার বা অন্তর্ভুক্ত_প্রাথমিক_প্রকারের একটি সেট করতে হবে।

ক্ষেত্র
included_types[]

string

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

excluded_types[]

string

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

included_primary_types[]

string

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

excluded_primary_types[]

string

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