PLACES_COUNT_PER_TYPE_V2 ফাংশন

PLACES_COUNT_PER_TYPE_V2 ফাংশনটি একাধিক ইনপুট জিওগ্রাফির জন্য স্থানের সংখ্যা এবং নমুনা প্লেস আইডি সম্বলিত একটি BigQuery টেবিল রিটার্ন করে, যা স্থানের ধরন অনুযায়ী বিভক্ত থাকে। এই ফাংশনটি জিওগ্রাফির একটি ইনপুট টেবিল প্যারামিটার গ্রহণ করে কার্যকর ব্যাচ প্রসেসিংয়ের জন্য ডিজাইন করা হয়েছে। আপনি একটি ইনপুট টেবিলের মাধ্যমে জিওগ্রাফিগুলো সরবরাহ করেন এবং স্থানের ধরনগুলোকে একটি অ্যারে হিসাবে নির্দিষ্ট করেন।

সিনট্যাক্স 

SELECT * FROM `PROJECT_NAME.LINKED_DATASET_NAME.PLACES_COUNT_PER_TYPE_V2`(
  TABLE input_geographies,
  target_types,
  filters
)

পরামিতি

  • PROJECT_NAME : আপনার গুগল ক্লাউড প্রজেক্টের নাম।
  • LINKED_DATASET_NAME : যে BigQuery ডেটাসেটটিতে Places Insights ফাংশনগুলো রয়েছে তার নাম (যেমন, places_insights___us )।
  • input_geographies : বিশ্লেষণের জন্য ভৌগোলিক অঞ্চলগুলো ধারণকারী একটি BigQuery টেবিল। এই টেবিলে অবশ্যই নিম্নলিখিত কলামগুলো অন্তর্ভুক্ত থাকতে হবে:
    • geo_id ( স্ট্রিং ): প্রতিটি ভৌগোলিক অঞ্চলের জন্য একটি অনন্য শনাক্তকারী।
    • geo ( ভূগোল ): এলাকাটির প্রতিনিধিত্বকারী BigQuery GEOGRAPHY অবজেক্ট। এটি একটি বিন্দু, বহুভুজ বা অন্য কোনো ভৌগোলিক প্রকার হতে পারে।
  • target_types ( ARRAY<STRING> ): যে স্থানগুলোর প্রকারের সংখ্যা গণনা করতে চান, সেই স্থানগুলোর প্রকারের স্ট্রিংগুলোর একটি অ্যারে। স্থানগুলো গণনা করা হবে যদি সেগুলো তাদের types অ্যারেতে তালিকাভুক্ত যেকোনো প্রকারের সাথে মেলে, শুধু primary_type সাথে নয়।
  • filters ( JSON ): স্থানসমূহকে অতিরিক্তভাবে ফিল্টার করার জন্য কী-ভ্যালু পেয়ার সম্বলিত একটি JSON অবজেক্ট। ফিল্টার প্যারামিটার দেখুন।

আউটপুট টেবিল স্কিমা

PLACES_COUNT_PER_TYPE_V2 ফাংশনটি নিম্নলিখিত কলামসহ একটি টেবিল রিটার্ন করে:

কলামের নাম ডেটা টাইপ বিবরণ
geo_id স্ট্রিং input_geographies টেবিল থেকে প্রাপ্ত ইনপুট ভূগোলের অনন্য শনাক্তকারী।
input_geography ভূগোল input_geographies টেবিলের মূল GEOGRAPHY অবজেক্ট।
place_type স্ট্রিং target_types অ্যারের যে স্থানের ধরণটি এই সারিটি প্রতিনিধিত্ব করে, এটি সেটিই।
place_count পূর্ণসংখ্যা উক্ত ভৌগোলিক এলাকার মধ্যে বা কাছাকাছি অবস্থিত place_type এবং অন্যান্য ফিল্টারের সাথে মিলে যাওয়া স্থানগুলির সংখ্যা।
sample_place_ids অ্যারে<স্ট্রিং> এই প্রকার ও ভৌগোলিক অবস্থানের মানদণ্ডের সাথে মেলে এমন সর্বোচ্চ ২৫০টি স্থান আইডির একটি অ্যারে।

আউটপুটে target_types অ্যারেতে নির্দিষ্ট করা geo_id এবং place_type এর প্রতিটি সংমিশ্রণের জন্য একটি করে সারি থাকবে, এমনকি যদি সংখ্যা শূন্যও হয়।

এটি কীভাবে কাজ করে

ফাংশনটি input_geographies টেবিলে প্রদত্ত প্রতিটি ভৌগোলিক এলাকাকে প্রসেস করে। প্রতিটি ভৌগোলিক এলাকার জন্য, এটি target_types অ্যারেতে তালিকাভুক্ত যেকোনো ধরনের সাথে মেলে এমন স্থান গণনা করে এবং filters JSON অবজেক্টের সমস্ত শর্তও পূরণ করে। ফলাফলগুলোকে একত্রিত করা হয় এবং প্রতিটি geo_id ও target_types প্রতিটি ধরন অনুযায়ী আলাদা করে দেখানো হয়।

উদাহরণ: নিউ ইয়র্ক সিটির কাউন্টিগুলোতে বিভিন্ন ধরণের খাবারের দোকান গণনা করুন।

এই উদাহরণটি নিউ ইয়র্ক সিটির তিনটি কাউন্টি জুড়ে 'রেস্তোরাঁ', 'ক্যাফে' এবং 'বার' ধরনের সংখ্যার একটি সারণি তৈরি করে।

SELECT geo_id, input_geography, place_type, place_count
FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE_V2`(
  (
    SELECT county_name AS geo_id,
           ST_SIMPLIFY(county_geom, 100) AS geo
    FROM
      `bigquery-public-data.geo_us_boundaries.counties`
    WHERE
      state_fips_code = "36"  -- New York State
      AND county_name IN ("Queens", "Kings", "New York")
  ),
  ['restaurant', 'cafe', 'bar'],  -- target_types
  JSON_OBJECT(
      'business_status', ['OPERATIONAL']
  )
);

ফলাফলস্বরূপ ৯টি সারি (৩টি কাউন্টি * ৩ প্রকার) সহ একটি টেবিল তৈরি হবে। প্রতিটি সারিতে প্রতিটি কাউন্টির মধ্যে অবস্থিত 'রেস্তোরাঁ', 'ক্যাফে' বা 'বার' প্রতিষ্ঠানের সংখ্যা দেখানো হবে। আপনি চাইলে আপনার SELECT স্টেটমেন্টে নমুনা Place ID-গুলোও অন্তর্ভুক্ত করতে পারেন।

নিউ ইয়র্কের কাউন্টিগুলিতে 'Places Count Per Type' ফাংশনের ফলাফল।

PLACES_COUNT_PER_TYPE_V2 ব্যবহারের সুবিধাসমূহ

পুরোনো PLACES_COUNT_PER_TYPE ফাংশনের তুলনায় PLACES_COUNT_PER_TYPE_V2 বেশ কিছু গুরুত্বপূর্ণ সুবিধা প্রদান করে:

  • ভৌগোলিক অঞ্চলের ব্যাচ প্রসেসিং: PLACES_COUNT_PER_TYPE যেখানে একবারে একটি ভৌগোলিক অঞ্চল প্রসেস করে, তার থেকে ভিন্নভাবে PLACES_COUNT_PER_TYPE_V2 ইনপুট ভৌগোলিক অঞ্চলের একটি TABLE (TABLE) গ্রহণ করে। এর ফলে আপনি একাধিক ফাংশন কল করার পরিবর্তে, একটিমাত্র কোয়েরির মাধ্যমেই অসংখ্য ভৌগোলিক অঞ্চল (পয়েন্ট, পলিগন) জুড়ে ধরন-ভিত্তিক গণনা বিশ্লেষণ ও পেতে পারেন।
  • উন্নত পারফরম্যান্স এবং স্কেলেবিলিটি: একটি টেবিল ইনপুট নেওয়ার মাধ্যমে, PLACES_COUNT_PER_TYPE_V2 একই সাথে প্রদত্ত সমস্ত জিওগ্রাফি জুড়ে BigQuery-এর অপ্টিমাইজ করা জিওস্পেশিয়াল জয়েন এবং প্যারালাল প্রসেসিং ক্ষমতার সুবিধা নিতে পারে। এর ফলে, বিপুল সংখ্যক জিওগ্রাফি নিয়ে কাজ করার সময় পারফরম্যান্সে উল্লেখযোগ্য উন্নতি হয় এবং স্কেলেবিলিটি আরও ভালো হয়।
  • শূন্য গণনা অন্তর্ভুক্ত: ব্যাচের মধ্যে একটি নির্দিষ্ট এলাকায় পাওয়া যায়নি এমন প্রকারের জন্য ০ গণনা সহ সারিগুলি ফেরত দেয়, যা সমস্ত প্রকার-ভৌগোলিক সমন্বয়ের জন্য একটি সম্পূর্ণ ফলাফল সেট নিশ্চিত করে।