The Details Page for a Data Source allows for administrative controls such as making a source public, generate API keys, and delete data sets.
At the end of this tutorial, you’ll be able to
- Adjust Viewing Privileges
- Share API Keys
- Maintain and Export Your Data
Sources Details Page
1. Sources Details Page
Each data type in Stae has a Data Source Details Page. For example, for the Data Type of 911 calls, Jersey City has a data stream that updates every minute with police dispatch data. To find the Data Sources for your city, navigate to the Sources tab and then click on any Data Source you see. This example will walk you through the Jersey City Police Dispatch Data to highlight features on the Details Page.
Adjust data visibility and permissions by clicking on the edit button
2. Adjust Data Viewing Privileges
For sensitive datasets or internal facing data, you may want to manage who can view and export the data. To do this, click on the Edit button next to Visibility. A menu will appear and you can adjust viewing privileges and source description there. To assign Admin and Staff, please see the Team Tutorial (insert URL). You can also adjust viewing privileges when you Create a Data Source (insert URL).
3. Share API Keys
Each Data Source in Stae has its own API Key. To share this key, click on the Send button on the Importer for that data source. To see your city's API endpoints and documentation, see the API documentation.
API documentation page with URLs and responses
4. Manage Your Data
You can manage your data at the bottom of the Sources Page. The Wipe feature will delete all imported data: this is useful if an import was unsuccessful or if incorrect data was imported. You can Delete a data source you’ve created: this is irreversible and you will be unable to access your source if you decide you want it later. Using the Remove feature will remove the source from the city’s official sources and place it in the Community Sources section to be accessed at any time.
Exporting options for different services and file formats
5. Export Your Data
To export your data and view a source’s data fields, click on the Data Tab at the top of the page. On this page, it works similarly to other data analysis software: clicking on a column’s header will toggle the table in ascending/descending modes. You can also filter down to specific data by clicking on the Fields dropdown menu. You can add as many filters as you want on a data set. If you’d like to export to a data analysis software, like CartoDB or Tableau, click the Export button and select your format. For a more detailed tutorial on exporting and filtering, see Filtering & Exporting Data (tutorial URL).
“You take delight not in a city’s seven or seventy wonders, but in the answer it gives to a question of yours.”
Italo Calvino, Invisible Cities
Have any questions or running into issues with this feature?
Reach us at: firstname.lastname@example.org