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

ভোটের তথ্য

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

ডেটা প্রাপ্যতা

ডেভেলপার নির্দেশিকা

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

  • এপিআই-এর পরিষেবার শর্তাবলী মেনে চলুন।
  • এপিআই ব্যবহার করার মাধ্যমে, ডেভেলপাররা কোনো ক্যাশ-কন্ট্রোল হেডার থাকলে তা মেনে চলতে সম্মত হন। ক্যাশ-কন্ট্রোল হেডার না থাকলে, ডেভেলপাররা ভোটকেন্দ্র ও প্রতিযোগিতার তথ্যের জন্য ২৪ ঘণ্টার বেশি এবং পদাধিকারী ও জেলার জন্য ৩০ দিনের বেশি ক্যাশ না করতে সম্মত হন।
  • এপিআই ব্যবহারকারী ডেভেলপারদের অবশ্যই সর্বাত্মক চেষ্টা করতে হবে যেন সকল ব্যবহারকারী একই রকম অভিজ্ঞতা পান। আমরা হোল্ডব্যাক, এ/বি টেস্টিং বা এই জাতীয় কোনো পরীক্ষা-নিরীক্ষার অনুমতি দিই না।
  • আপনার ব্যবহারের ক্ষেত্রটি সক্ষম করার জন্য যদি অতিরিক্ত কোটার প্রয়োজন হয়, তবে আপনি আপনার ডেভেলপার কনসোলে প্রকল্প-ভিত্তিক বৃদ্ধির জন্য অনুরোধ করতে পারেন। অতিরিক্ত কোটার বরাদ্দ সীমিত এবং একটি সর্বোচ্চ বরাদ্দের অধীন।

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

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

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

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

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

অ্যাট্রিবিউশন

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

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

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

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

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