Overview
Stay organized with collections
Save and categorize content based on your preferences.
This developer site provides best practices for the creation of a Civics Data
Format (CDF) feed. It contains a Unified Modeling Language (UML) model of
election and officeholder data and an XML format derived from the UML model. It
also contains background information about how political geography is structured
and used as it relates to elections and election results. The data model is
comprehensive and at the same time very flexible, able to accommodate
pre-election, election, and post-election scenarios.
The following are the significant features of this specification:
- Defines major data elements, their attributes, and their associations in a
UML data model.
- Lets you use the data model to generate supported data formats such as XML.
- Lets you report aggregated or detailed election data and results, as well as
officeholder data.
- Supports multiple types of identifiers and cross-references.
This site is intended for partner organizations who provide Google with data to
support our search features for officeholder and election results. Partners need
to follow the guidelines given here along with the
Civics CDF Validator
and the NIST 1500-100 specification on which the CDF is based.
The following documents provide useful background information:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-21 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-08-21 UTC."],[[["\u003cp\u003eThis site provides best practices and guidelines for creating a Civics Data Format (CDF) feed for Google's election and officeholder search features.\u003c/p\u003e\n"],["\u003cp\u003eThe CDF utilizes a Unified Modeling Language (UML) model to define election and officeholder data elements and their relationships, which can be used to generate formats like XML.\u003c/p\u003e\n"],["\u003cp\u003eThe comprehensive data model accommodates pre-election, election, and post-election data, supporting various identifier types and cross-references for detailed or aggregated reporting.\u003c/p\u003e\n"],["\u003cp\u003ePartner organizations providing data to Google should adhere to these guidelines, utilize the Civics CDF Validator, and follow the NIST 1500-100 specification.\u003c/p\u003e\n"],["\u003cp\u003eResources include a UML data model, XML format, data schema documentation, and a full XML Schema Definition file with Google-specific modifications.\u003c/p\u003e\n"]]],[],null,[]]