#
Data Widget
Available for Pozi Pro, Enterprise and Enterprise Cloud customers
The Pozi data widget enables users to search any address to display specific details about the location (eg, waste collection details).
Type '3 Queen Street' to try it out.
Embed code:
<iframe height="300px" width="100%" overflow="hidden" frameBorder="0" src="https://southerngrampians.pozi.com/widget.html#card=Waste%20Collection&fieldnames=Next Rubbish Pickup,Next Recycling Pickup,Next Organics Pickup&fontsize=20"></iframe>
#
Configuration
Two configuration options exist for data widgets:
- Standard (typical): for any result that appears in the What's Here section in the Info Panel of the Pozi map app
- CKAN: for any dataset is published as a WFS on data.gov.au (and which doesn't appear in the What's Here section)
Any result that appears in the What's Here section in the Info Panel of your site can be exposed in a Pozi data widget. All you need is the name of the dataset (as displayed in the relevant tab heading).
https://
+ site
+ /#card=
+ dataset
+ &widget=true
Example:
- site:
strathbogie.pozi.com
- dataset:
wastecollection
(derived from the "Waste Collection" tab heading in the What's Here results, with any spaces or underscores removed)
The basic widget URL is constructed as follows:
https://
+ strathbogie.pozi.com
+ /#card=
+ wastecollection
+ &widget=true
Widget URL: https://strathbogie.pozi.com/#card=wastecollection&widget=true
The resulting widget displays a table view of the results for the address specified by the user. See the Options section below for customising the results.
Any dataset that is published as a data.gov.au WFS service can be configured as a data widget, regardless of whether is appears in the map app's What's Here section.
https://
+ site
+ /#ckan=
+ ckan id
+ &widget=true
#
Obtaining the CKAN id
The final URL will look like this:
https://northerngrampians.pozi.com/#ckan=ckan_f5d810f3_9b62_43c9_9a4e_e3afda01fe62&widget=true
The results from the data.gov.au API will not have any data transformers applied. If you require any data manipulation (such as waste collection calculations), you can specify them a parameters in the widget URL. See Data Transformer details below.
#
Options
#
Display Specific Fields
By default, the data widget displays all fields as a table. If you want to instead see a list of fields, you can specify the field names within the &fieldnames=...
parameter, separated by commas.
Example:
https://southerngrampians.pozi.com/widget.html#card=Waste Collection&fieldnames=Next Rubbish Pickup,Next Recycling Pickup,Next Organics Pickup
#
Hide Field Names
This parameter hides the field names and only displays the field data.
fieldnameshide=true
#
Font Size
By default the font size of the widget text is set to 18. However, you can specify a different font size by using the optional font size parameter, for example:
fontsize=10
#
Data Transformer
If using the standard (not CKAN) configuration option, any transformers are already applied within the Pozi app, so there is typically no need to configure any transformer in the widget URL.
However, if using the CKAN option, the results will not have any transformers applied, and so you can specify them here in the widget URL.
transformer=garbage
#
Troubleshooting
If the widget URL specifies field names to display via fieldnames=...
, these fields must exist in the source data.
If expected attributes are not showing, check that the field names in the source data have not changed. If they have changed, update the widget URL accordingly.