বিকাশকারী ডেটা নির্দেশিকা

ভোটদানের তথ্য

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

তথ্যের প্রাপ্যতা

বিকাশকারী নির্দেশিকা

আমরা সকল ডেভেলপারদের নিম্নলিখিত নির্দেশিকাগুলি মেনে চলতে বাধ্য করি:

  • API-এর পরিষেবার শর্তাবলী মেনে চলুন।
  • API ব্যবহার করে, ডেভেলপাররা যেকোনো ক্যাশ-কন্ট্রোল হেডার মেনে চলতে সম্মত হন, যদি থাকে। ক্যাশ-কন্ট্রোল হেডার অনুপস্থিত থাকলে, ডেভেলপাররা ভোটদানের স্থান এবং প্রতিযোগিতার তথ্যের জন্য 24 ঘন্টার বেশি এবং অফিস হোল্ডার এবং জেলাগুলির জন্য 30 দিনের বেশি ক্যাশ না করতে সম্মত হন।
  • API ব্যবহারকারী ডেভেলপারদের সকল ব্যবহারকারীর একই অভিজ্ঞতা নিশ্চিত করার জন্য সর্বাত্মক প্রচেষ্টা করা উচিত। আমরা হোল্ডব্যাক, A/B পরীক্ষা, বা অনুরূপ পরীক্ষা-নিরীক্ষার অনুমতি দিই না।
  • আপনার ব্যবহারের ক্ষেত্রে সক্ষম করার জন্য যদি অতিরিক্ত কোটার প্রয়োজন হয়, তাহলে আপনি আপনার ডেভেলপার কনসোলে প্রতি প্রকল্পের জন্য বৃদ্ধির অনুরোধ করতে পারেন। অতিরিক্ত কোটার ব্যবস্থা সীমিত এবং সর্বোচ্চ মঞ্জুরি সাপেক্ষে।

    দ্রষ্টব্য: অনুমোদন প্রক্রিয়াটি ১-২ মাস সময় নেয়। সেই অনুযায়ী আপনার কোটা বৃদ্ধির অনুরোধগুলি পরিকল্পনা করুন। ২০২৪ সালের রাষ্ট্রপতি নির্বাচনের কোটা বৃদ্ধির প্রস্তুতি নিতে, আগস্টের মধ্যে কোটার অনুরোধ জমা দিন।

  • সিভিক ইনফো এপিআই-এর জন্য অতিরিক্ত কোটা শুধুমাত্র ব্যবহারকারী-মুখী ব্যবহারের ক্ষেত্রে সহায়তা করার উদ্দেশ্যে। অন্যান্য ব্যবহারের ক্ষেত্রে কোটা বৃদ্ধির অনুরোধ মঞ্জুর করা হয় না।

অতিরিক্ত ডেটা নির্দেশিকা

এই তথ্যগুলো নিয়ে কাজ করা বিশেষভাবে কঠিন। অনুগ্রহ করে নিম্নলিখিত বিষয়গুলো মনে রাখবেন।

  • নির্বাচন কর্মকর্তারা প্রায়শই শেষ কয়েক সপ্তাহে এবং এমনকি নির্বাচনের আগের শেষ কয়েক দিনেও এই তথ্য সংশোধন করেন। ব্যবহারকারীদের সতর্ক করে দেওয়া ভালো যে ভোট দেওয়ার আগে তাদের আবার পরীক্ষা করা উচিত।
  • বেশিরভাগ অফিসিয়াল ফিডে রাস্তার অংশ থাকে, যার অর্থ নির্বাচন কর্মকর্তারা বিভিন্ন ঠিকানা নির্বাচনী এলাকা এবং ভোটকেন্দ্রের সাথে সংযুক্ত করেন। রেঞ্জগুলিতে সেই ঠিকানাগুলিতে কোনও ভোটার নিবন্ধিত থাকতে পারে বা নাও থাকতে পারে। ফলস্বরূপ, ভোটিং তথ্য প্রকল্পের মাধ্যমে অফিসিয়াল ফিড সরবরাহকারী রাজ্যগুলির জন্য, যে ঠিকানায় কোনও নিবন্ধিত ভোটার নেই, সে ঠিকানা সফল হতে পারে।
  • যেসব রাজ্যে অফিসিয়াল ফিড দেওয়া হয় না, শুধুমাত্র সেইসব ঠিকানায় ভোটার নিবন্ধিত থাকলেই সাফল্য পাওয়া যাবে।
  • মাঝে মাঝে, একই তথ্যের জন্য আমাদের একাধিক উৎস থাকবে। আমরা স্থানীয় নির্বাচন কর্মকর্তার যোগাযোগের তথ্য এবং ব্যালট তথ্যের জন্য উপলব্ধ সর্বোচ্চ মানের তথ্য পরিবেশন করি। এই আচরণকে অগ্রাহ্য করার কোনও উপায় নেই, শুধুমাত্র officialSourcesOnly প্যারামিটারের মাধ্যমে অ-সরকারি উৎসগুলি বাদ দেওয়া ছাড়া। ভোটকেন্দ্রের তথ্যের জন্য, আমরা সর্বদা অন্যান্য উৎসের চেয়ে অফিসিয়াল তথ্য উৎসগুলিকে অগ্রাধিকার দিই।
  • যদি আমরা ডেটার মানের সমস্যা খুঁজে পাই, তাহলে সমস্যাটির সমাধান না হওয়া পর্যন্ত আমরা কোনও নির্দিষ্ট নির্বাচনী জেলার জন্য কোনও ডেটা ফেরত দিতে পারব না।
  • যদি আমাদের কাছে কোনও ঠিকানার তথ্য না থাকে, তাহলে এর অর্থ এই নয় যে সেখানে ভোট দেওয়ার জন্য কেউ নিবন্ধিত নেই। অ্যাপ্লিকেশনগুলির সম্পূর্ণ তথ্যের জন্য ব্যবহারকারীদের তাদের স্থানীয় নির্বাচন কর্মকর্তাদের কাছে পাঠানো উচিত।
  • নির্বাচনের দিন শেষ হওয়ার পর নির্বাচন স্বয়ংক্রিয়ভাবে শেষ হয়ে যায়। সেই সময়ের পরে নির্বাচনের জন্য কোনও তথ্য ফেরত পাঠানো হবে না।

গুণাবলী

সিভিক ইনফরমেশন এপিআই-তে অ্যাট্রিবিউশন ঐচ্ছিক। যদি কোনও ডেভেলপার সিভিক ইনফরমেশন এপিআই-তে অ্যাট্রিবিউট করতে চান এবং সিভিক ইনফরমেশন এপিআই-তে ব্যবহারকারীদের আরও তথ্যের সাথে লিঙ্ক করতে চান, তাহলে আমরা ডেভেলপারদের নিম্নলিখিত অ্যাট্রিবিউশন ভাষা বিকল্প এবং নীচের লিঙ্কযুক্ত ওয়েবপৃষ্ঠাগুলির মধ্যে একটি ব্যবহার করতে বাধ্য করি:

  • "সিভিক ইনফরমেশন এপিআই দ্বারা চালিত"
  • "সিভিক ইনফরমেশন এপিআই দ্বারা চালিত ভোটদানের তথ্য"
  • "সিভিক ইনফরমেশন এপিআই দ্বারা চালিত ব্যালট তথ্য"
  • "আরও জানুন"

স্ট্যাটাস কোড

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

অবস্থা ব্যাখ্যা
success অনুরোধ করা ঠিকানাটি API দ্বারা একটি বৈধ ঠিকানা হিসেবে স্বীকৃত।
noStreetSegmentFound এই ঠিকানাটি কোন নির্বাচনী এলাকা এবং/অথবা জেলার অন্তর্গত, সে সম্পর্কে API-এর কাছে বর্তমানে কোনও তথ্য নেই। হতে পারে আমরা এখনও নতুন তথ্য সংগ্রহ/প্রক্রিয়াকরণ করছি, অথবা এই ঠিকানায় ভোট দেওয়ার জন্য নিবন্ধিত কোনও ভোটার নেই।
addressUnparseable অনুরোধ করা ঠিকানাটি সঠিকভাবে ফর্ম্যাট করা হয়নি অথবা জিওকোড করা যাবে না (অর্থাৎ গুগল ম্যাপস এপিআই এই ঠিকানা সম্পর্কে কিছুই জানে না)।
noAddressParameter কোন ঠিকানা দেওয়া হয়নি।
multipleStreetSegmentsFound API নির্দিষ্ট ঠিকানার তথ্য খুঁজে পাচ্ছে না, তবে এতে কাছাকাছি ঠিকানা সম্পর্কে তথ্য রয়েছে। আরও তথ্যের জন্য ব্যবহারকারীর তাদের নির্বাচন কর্মকর্তার সাথে যোগাযোগ করা উচিত।
electionOver অনুরোধকৃত নির্বাচন শেষ। নির্বাচনের API ফলাফল আর উপলব্ধ নেই। আসন্ন নির্বাচনের জন্য একটি আইডি খুঁজে পেতে একটি নির্বাচন প্রশ্ন তৈরি করুন।
electionUnknown অনুরোধ করা নির্বাচনী আইডিটি অবৈধ। একটি বৈধ আইডি খুঁজে পেতে একটি নির্বাচনী প্রশ্ন করুন।
internalLookupFailure অনুরোধটি প্রক্রিয়া করার সময় একটি অনির্দিষ্ট ত্রুটি ঘটেছে।