Getting Started with Developers
Welcome to the City of Virginia Beach Open Data toolkit , your resource for working with and understanding data published by the City of Virginia Beach at data.vbgov.com. The Toolkit provides a wealth of guidance, how to guides, and examples for both publishers and users of data.
Developers and entrepreneurs are a key part in the process of turning raw data into innovative new services and solutions for the wider community, industry, and government. As a developer you will be responsible for two critical parts of the data life cycle – the technical implementation and integration of data services and APIs in your own applications; and developing a strong understanding of the nature, limitations, and origins of the data that your department is leveraging. As an entrepreneur you will be part of the discovery process of finding the right data to support your new venture, will be responsible for understanding the licensing terms applied to data, and ensure that any use, commercial or otherwise, is in line with the attribution and use requirements of the data custodians.
The responsibilities of a data developer fall into four broad categories:
1. Understanding and Using Data Responsibly
You should develop a strong understanding of the nature, limitations, and origins of the data that you’re using by reading and understanding the contextual metadata provided (the information about how the data was made). The creators of City’s data will publish this through metadata on data.vbgov.com, and will often include a range of additional collateral and supporting material for their data, including:
- Data dictionaries
- Methodology statements describing how the data was constructed
- And more.
You should take all of this supporting information into account to ensure that you’re using the data appropriately and responsibly. If you find the material is lacking, or that you have further questions that aren’t answered in the material, you should contact the authors and maintainers listed for the data set on data.vbgov.com.
2. Respect Licensing and Usage Terms
As the person responsible for working directly with the data for your department, you’ll be responsible for understanding the licensing terms applied to data. You should make sure that any data your department is using, commercial or otherwise, is in line with the attribution and any usage constraints specified by the data custodians. In many cases, a data custodian will opt to use one of the licenses from the Creative Commons suite. However, you may also encounter data that has multiple licenses applied (commercial vs non-commercial), or has yet to have a licensed specified. If you find yourself uncertain about how a data set is licensed, you should contact the data set maintainer listed to explain your use case and ask them to clarify the licensing stance.
3. Keeping Data Up-to-Date
Where you are designing systems that extract and take copies of data from data.vbgov.com, it’s important to put processes (both technical and human) in place to ensure your copies of the data are kept up-to-date . How often you need to refresh the data will depend on your particular use case:
- How often the data you’re using is updated
- How much of an impact using a stale copy of the data would have on your use of it
- Whether there are any risks to your department in using stale data.
As the person working directly with the data, and the one responsible for putting update processes in place, you should make sure your department carefully considers all of these issues. Information about the intended and actual frequency of updates to data is published with all of the data on data.vbgov.com. As always, if you need further clarification we encourage you to reach out to the data set maintainers.
4. Showcasing your use of data
The data life cycle doesn’t stop with your application and use of data. There’s a final key step in the life cycle, contributing your data stories back to the community of data publishers and users. One of the most effective drivers for government to release more data openly is demonstrating the value of open data. This can be done through showcasing the innovative applications and solutions built using the City’s data as well as showing the data publishers how their data is used.