개발자 데이터 가이드라인

투표 정보

Google Civic Information API는 Voting Information Project에서 지원하는 선거에 대해 투표소, 사전 투표 장소, 지역 선거 관리 담당자 연락처 정보, 투표 정보와 같은 시민 정보를 사용자에게 반환합니다.

데이터 가용성

개발자 가이드라인

모든 개발자는 다음 가이드라인을 준수해야 합니다.

  • API 서비스 약관을 준수합니다.
  • API를 사용하면 개발자는 캐시 제어 헤더가 있는 경우 이를 준수하는 데 동의하는 것으로 간주됩니다. 캐시 제어 헤더가 없는 경우 개발자는 투표 장소 및 대회 정보는 24시간 이상, 공직자 및 선거구는 30일 이상 캐시하지 않는 데 동의합니다.
  • API를 사용하는 개발자는 모든 사용자에게 동일한 환경이 제공되도록 최선을 다해야 합니다. 홀드백, A/B 테스트 또는 유사한 실험은 허용되지 않습니다.

  • 사용 사례를 사용 설정하는 데 추가 할당량이 필요한 경우 개발자 콘솔에서 프로젝트별 증가를 요청할 수 있습니다. 추가 할당량 프로비저닝은 제한되어 있으며 최대 허용량의 적용을 받습니다.

    참고: 승인 절차는 1~2개월이 소요됩니다.이에 따라 할당량 상향 요청을 계획하세요. 2024년 대통령 선거 할당량 상향을 준비하려면 8월까지 할당량 요청을 제출하세요.

  • Civic Info API의 추가 할당량은 사용자 대상 사용 사례만 지원하기 위한 것입니다. 다른 사용 사례에 대해서는 할당량 상향 조정 요청이 승인되지 않습니다.

추가 데이터 가이드라인

이 데이터는 특히 작업하기가 까다롭습니다. 다음 사항에 유의하세요.

  • 선거 관리위원회는 선거 전 마지막 몇 주, 심지어 마지막 며칠 동안 이 데이터를 자주 수정합니다. 사용자에게 투표하기 전에 다시 확인해야 한다고 경고하는 것이 좋습니다.
  • 대부분의 공식 피드에는 도로 구간이 포함되어 있습니다. 즉, 선거 관리자가 일련의 주소를 선거구 및 투표 장소와 연결합니다. 범위에 해당 주소에 등록된 유권자가 있을 수도 있고 없을 수도 있습니다. 따라서 투표 정보 프로젝트를 통해 공식 피드를 제공하는 주의 경우 등록된 유권자가 없는 주소가 성공을 반환할 수 있습니다.
  • 공식 피드를 제공하지 않는 주의 경우 등록된 유권자가 있는 주소만 성공을 반환합니다.
  • 경우에 따라 동일한 정보에 대해 여러 소스가 있을 수 있습니다. Google은 지역 선거 관리 위원회 연락처 정보와 투표 정보에 대해 이용 가능한 최고 품질의 정보를 제공합니다. officialSourcesOnly 매개변수를 통해 비공식 소스를 삭제하는 방법 외에는 이 동작을 재정의할 방법이 없습니다. 투표소 정보의 경우 항상 다른 소스보다 공식 데이터 소스를 우선시합니다.
  • 데이터 품질 문제가 발견되면 문제가 해결될 때까지 특정 선거구에 대한 데이터가 반환되지 않을 수 있습니다.
  • 주소에 관한 데이터가 없다고 해서 해당 주소에 등록된 유권자가 없다는 의미는 아닙니다. 애플리케이션은 사용자에게 전체 정보를 제공하기 위해 지역 선거 관리위원회로 안내해야 합니다.
  • 선거는 선거일이 지나면 자동으로 만료됩니다. 이 시점 이후의 선거에 대한 데이터는 반환되지 않습니다.

기여 분석

Civic Information API에 대한 저작자 표시는 선택사항입니다. 개발자가 Civic Information API에 출처를 표시하고 사용자를 Civic Information API에 관한 자세한 정보로 연결하는 경우 개발자는 다음 출처 표시 언어 옵션과 아래에 링크된 웹페이지 중 하나를 사용해야 합니다.

  • 'Civic Information API 제공'
  • '투표 정보는 Civic Information API를 기반으로 제공됩니다.'
  • '선거 정보는 Civic Information API를 기반으로 제공됩니다'
  • '자세히 알아보기'

상태 코드

voterInfoQuery 호출에는 주소가 허용될 때 success으로 설정되는 status 필드가 포함됩니다. 그 외의 경우에는 오류 코드가 반환됩니다. 일반적인 오류 코드 설명은 아래를 참고하세요. 오류 코드가 있어도 정보가 반환될 수 있습니다.

상태 설명
success 요청된 주소가 API에서 유효한 주소로 인식됩니다.
noStreetSegmentFound API에는 현재 이 주소가 속한 선거구 또는 지역에 대한 정보가 없습니다. 아직 새 데이터를 소싱/처리 중이거나 이 주소에 등록된 유권자가 없을 수 있습니다.
addressUnparseable 요청된 주소의 형식이 올바르지 않거나 지오코딩할 수 없습니다 (즉, Google 지도 API가 이 주소에 대해 알지 못함).
noAddressParameter 주소가 제공되지 않았습니다.
multipleStreetSegmentsFound API가 지정된 주소의 정보를 찾을 수 없지만 근처 주소에 관한 정보는 있습니다. 자세한 내용은 사용자가 선거 관리 위원회에 문의해야 합니다.
electionOver 요청된 선거가 종료되었습니다. 선거의 API 결과를 더 이상 사용할 수 없습니다. electionQuery를 만들어 다가오는 선거의 ID를 찾습니다.
electionUnknown 요청된 선거 ID가 잘못되었습니다. 유효한 ID를 찾기 위해 electionQuery를 만듭니다.
internalLookupFailure 요청을 처리하는 중에 지정되지 않은 오류가 발생했습니다.