개발자 데이터 가이드라인

투표 정보

Google Civic Information API는 Voting Information Project에서 지원하는 선거의 경우 투표소, 사전 투표 장소, 지역 선거 공무원 연락처 정보, 투표용지 정보와 같은 시민 정보를 사용자에게 반환합니다.

데이터 가용성

개발자 가이드라인

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

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

  • 사용 사례를 사용 설정하는 데 할당량이 더 필요한 경우 Developer Console에서 프로젝트별로 할당량을 늘려 달라고 요청할 수 있습니다. 추가 할당량 프로비저닝은 제한되며 최대 허용량이 적용됩니다.

    참고: 승인 절차는 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가 잘못되었습니다. electionQuery를 만들어 유효한 ID를 찾습니다.
internalLookupFailure 요청을 처리하는 중에 지정되지 않은 오류가 발생했습니다.