개발자 데이터 가이드라인

정치지리학 및 선출된 대표자

Google Civic Information API는 연방에서 지방 수준까지 미국 주소의 정치 지역 단위 및 선출된 대표자에 대한 정보를 제공합니다. 현재 Google의 지원 범위는 주, 카운티, 하원의원 선거구의 경우 100% 에 근접하며 주 입법 선거구의 지원 범위는 90% 를 초과하는 것을 목표로 합니다. 시 및 카운티 의회와 같은 하위 수준은 최선의 방식으로 서비스를 제공하며 시간이 지남에 따라 개선됩니다.

Google은 연방, 주, 카운티 수준의 모든 선출직 공무원과 미국의 각 주에서 가장 큰 도시 및 인구가 250,000명 이상인 모든 도시의 시 공무원에 대한 최신 정보를 제공할 예정입니다. Google은 여러 소스에서 이 데이터를 집계하여 사용 가능한 최고 품질의 정보를 제공합니다. 데이터 품질 문제가 발견되면 특정 부서, 선출직 또는 선출직 공무원에 대한 데이터를 제공하지 않을 수 있습니다.

투표 정보

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

데이터 가용성

개발자 가이드라인

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

  • API 서비스 약관을 준수합니다.
  • 개발자는 이 API를 사용함으로써 cache-control 헤더가 있는 경우 이를 준수하는 데 동의합니다. 캐시 제어 헤더가 없는 개발자는 투표소 위치 및 대회 정보의 경우 24시간, 공직자 및 교육구의 경우 30일 이상 캐시하지 않는 데 동의합니다.
  • API를 사용하는 개발자는 모든 사용자에게 동일한 경험을 제공하기 위해 최선을 다해야 합니다. 홀드백(Holdback)이나 A/B 테스트 또는 이와 유사한 실험은 허용되지 않습니다.

  • 사용 사례를 사용 설정하기 위해 추가 할당량이 필요한 경우 Play Console에서 프로젝트당 할당량 증가를 요청할 수 있습니다. 추가 할당량의 프로비저닝은 제한되며 최대 허용치가 적용됩니다.

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

  • Civic Info API의 추가 할당량은 사용자 대상 사용 사례를 지원하기 위한 용도로만 사용됩니다. 다른 사용 사례에는 할당량 상향 요청이 승인되지 않습니다.

추가 데이터 가이드라인

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

  • 선거 관리 당국은 지난 몇 주, 심지어 선거 전 며칠 동안 이 데이터를 자주 수정합니다. 투표 전에 사용자에게 다시 확인해야 한다고 경고하는 것이 좋습니다.
  • 대부분의 공식 피드에는 도로 구간이 포함되어 있습니다. 즉, 선거 관리 공무원이 다양한 주소를 선거구 및 투표소와 연결합니다. 범위는 해당 주소에 등록된 유권자가 있을 수도 있고 없을 수도 있습니다. 따라서 Voting Information Project를 통해 공식 피드를 제공하는 주의 경우 등록된 유권자가 없는 주소가 있으면 성공적일 수 있습니다.
  • 공식 피드를 제공하지 않는 주의 경우 등록된 유권자가 있는 주소만 성공 여부를 반환합니다.
  • 경우에 따라 동일한 정보에 대해 여러 출처가 있을 수 있습니다. Google은 지역 선거 공무원 연락처 및 투표 정보에 대해 최고 수준의 품질의 정보를 제공합니다. 공식SourcesOnly 매개변수를 통해 비공식 출처를 제거하는 것 외에는 이 동작을 재정의할 수 있는 방법이 없습니다. 투표소 정보의 경우 Google에서는 항상 다른 출처보다 공식 데이터 소스를 우선시합니다.
  • 데이터 품질 문제가 발견되면 문제가 해결될 때까지 특정 선거구에 대한 데이터가 반환되지 않을 수 있습니다.
  • 주소에 대한 데이터가 없다고 해서 해당 주소에서 투표자로 등록된 사람이 없다는 뜻은 아닙니다. 신청서는 사용자를 지방 선거 공무원에게 안내하여 자세한 정보를 확인해야 합니다.
  • 선거일은 선거일이 지나면 자동으로 만료됩니다. 이후에는 선거에 관한 데이터가 반환되지 않습니다.

기여 분석

Civic Information API에 대한 저작자 표시는 선택사항입니다. 개발자가 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에는 현재 이 주소가 속한 선거 구역 및/또는 선거구에 대한 정보가 없습니다. YouTube에서 아직 새로운 데이터를 수집/처리 중이거나 이 주소에서 유권자로 등록한 투표자가 없기 때문일 수 있습니다.
addressUnparseable 요청한 주소의 형식이 잘못되었거나 지오코딩될 수 없습니다 (즉, Google Maps API가 이 주소에 대해 알지 못함).
noAddressParameter 주소가 제공되지 않았습니다.
multipleStreetSegmentsFound API가 지정된 주소에 대한 정보를 찾을 수 없지만 주변 주소에 대한 정보는 있습니다. 자세한 내용은 사용자가 선거 공무원에게 문의해야 합니다.
electionOver 요청하신 선거가 종료되었습니다. 선거에 대한 API 결과는 더 이상 제공되지 않습니다. electionQuery를 만들어 예정된 선거의 ID를 찾습니다.
electionUnknown 요청한 선거 ID가 잘못되었습니다. electionQuery를 만들어 유효한 ID를 찾습니다.
internalLookupFailure 요청을 처리하는 중에 알 수 없는 오류가 발생했습니다.