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

রাজনৈতিক ভূগোল এবং নির্বাচিত প্রতিনিধি

Google সিভিক ইনফরমেশন API ফেডারেল থেকে স্থানীয় স্তর পর্যন্ত মার্কিন ঠিকানাগুলির জন্য রাজনৈতিক ভৌগলিক বিভাগ এবং নির্বাচিত প্রতিনিধিদের সম্পর্কে তথ্য সরবরাহ করে। বর্তমানে, রাজ্য, কাউন্টি, এবং কংগ্রেসনাল জেলাগুলির জন্য আমাদের কভারেজ 100% এর কাছাকাছি পৌঁছেছে এবং রাজ্যের আইনসভা জেলাগুলির জন্য 90% কভারেজ অতিক্রম করার লক্ষ্য রয়েছে। নিম্ন স্তরের, যেমন শহর এবং কাউন্টি কাউন্সিল, সর্বোত্তম প্রচেষ্টার ভিত্তিতে পরিবেশিত হয় এবং সময়ের সাথে সাথে উন্নতি হবে।

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

ভোটের তথ্য

Google Civic Information API ভোট প্রদানের স্থান, প্রাথমিক ভোটের অবস্থান, স্থানীয় নির্বাচনী অফিসিয়াল যোগাযোগের তথ্য এবং ভোটিং তথ্য প্রকল্প দ্বারা সমর্থিত নির্বাচনের জন্য ব্যবহারকারীদের ব্যালট তথ্যের মতো নাগরিক তথ্য প্রদান করে।

ডেটা উপলব্ধতা

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

আমরা সকল ডেভেলপারদের নিম্নলিখিত নির্দেশিকা মেনে চলতে চাই:

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

  • আপনার ব্যবহারের ক্ষেত্রে সক্ষম করতে আপনার অতিরিক্ত কোটার প্রয়োজন হলে, আপনি আপনার বিকাশকারী কনসোলে প্রতি-প্রকল্প বৃদ্ধির অনুরোধ করতে পারেন৷ অতিরিক্ত কোটার বিধান সীমিত এবং সর্বোচ্চ ভাতা সাপেক্ষে।

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

  • Civic Info API-এর অতিরিক্ত কোটা শুধুমাত্র ব্যবহারকারী-মুখী ব্যবহারের ক্ষেত্রে সমর্থন করার উদ্দেশ্যে। অন্যান্য ব্যবহারের ক্ষেত্রে কোটা বৃদ্ধির অনুরোধ মঞ্জুর করা হয় না।

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

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

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

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

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

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

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

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

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