Link-Ins
Pozi link-ins enable external applications to launch Pozi and zoom to specific locations on the map.
Example: https://council.pozi.com/#/feature[playgrounds.fid,790]/
URL parameters are used to launch a Pozi instance to control various of its aspects including the map’s location and display.
The URL parameters can be manually or programmatically constructed, or you can simply copy the URL of a Pozi session from your browser’s address bar to capture and share its current state.
The URL can contain any of the following information:
| State | URL Parameters |
|---|---|
| Map View | x[<longitude>]/y[<latitude>]/z[<zoomlevel>] |
| Active Layers | layers[<layername>] |
| What’s Here Location | feature[whatshere,<targetgeometry>] |
| Selected Feature | feature[<layername>,<featureid>] |
| Search | search[<searchname>,<searchvalue>]/ |
| Active Panel | tab[search|info|layers|tools|about] |
| Layer Name Filter | filter[<filtertext>] |
Feature Selection
Single Feature
Given a layer name and feature id, Pozi will activate the layer, select and highlight the target feature, zoom the map to it, and display its details in the Info Panel.
https://<sitename>.pozi.com/#/feature[<layername>.<fieldname>,<idvalue>]/
Example: link to a feature in the Parks layer where the fid field is 15:
https://council.pozi.com/#/feature[parks.fid,15]/
This also works for datasets that are configured for What’s Here. Even though the layer may not be displayed in the layer panel, Pozi can still use feature link-ins to select and highlight the target feature.
https://council.pozi.com/#/feature[propertyandrating.land_id,1234797]/
Layers must be configured as selectable in QGIS for feature link-ins to work. (QGIS typically sets layers to be selectable by default.)
Multiple Features
Pozi also supports multiple feature link-ins. Feature ids are separated by a comma within the feature parameter.
https://<sitename>.pozi.com/#/feature[<layername>.<fieldname>,<idvalue1>,<idvalue2>]/
Examples:
- https://council.pozi.com/#/feature[propertyandrating.land_id,1375426,1375562]/
- https://council.pozi.com/#/feature[playgrounds.fid,790,795,829]/
Alternatively, each feature can be specified in its own feature parameter.
https://<sitename>.pozi.com/#/feature[<layername>.<fieldname>,<idvalue1>]/feature[<layername>.<fieldname>,<idvalue2>]/
Example:
What’s Here
Pozi will display the Info Panel results for any location based on a geometry target or pre-configured search.
Location
Pozi will display the Info Panel results for a target point, line or region that is specified in well-known text (WKT).
https://<sitename>.pozi.com/#/feature[whatshere,<WKT>]
Unlike feature link-ins (above), the Pozi map does not automatically zoom to the target location. For this reason, it is useful to include the x, y and z parameters to focus the map on the target location.
- Point Location: https://gleneira.pozi.com/#/x[145.05178]/y[-37.90975]/z[18]/feature[whatshere,POINT(145.05178%20-37.90975)]/
- Line: https://gleneira.pozi.com/#/x[145.05178]/y[-37.90975]/z[18]/feature[whatshere,LINESTRING(145.050482%20-37.90864%2C145.05267%20-37.90895)]/
- Region: https://strathbogie.pozi.com/#/x[145.56842]/y[-36.75206]/z[19]/feature[whatshere,POLYGON((145.56777%20-36.75196%2C145.568832%20-36.75147%2C145.56863%20-36.75224%2C145.56777%20-36.75196))]/
Search
Your Pozi site may be configured with dedicated search options for users to type in values for searching. (These pre-configured search is one that appears in the top section of the search drop-down menu.)
These pre-configured search options can be accessed via a URL parameter.
https://<sitename>.pozi.com/#/search[<searchname>,<searchvalue>]/
Use the name of the search, convert to lower case, and remove any spaces or special characters. For example, if your search is called Property Number, use propertynumber as the search parameter name.
Examples:
- Property Number: https://mansfield.pozi.com/#/search[propertynumber,A7706]/
- Property PFI: https://mansfield.pozi.com/#/search[propertypfi,45386823]/
- Parcel PFI: https://mansfield.pozi.com/#/search[parcelpfi,5409508]/
- Parcel SPI: https://mansfield.pozi.com/#/search[parcelspi,1\TP225210]/
Parameters
Location
Centre and zoom the map on a specific location by adding x, y and z parameters to the URL.
https://<sitename>.pozi.com/#/x[<longitude>]/y[<latitude>]/z[<zoom>]/
Example: https://frankston.pozi.com/#/x[145.12617]/y[-38.14357]/z[17]/
When the x, y and z parameters are not present, Pozi will display the site’s default map view.
Note
Any Pozi link that you copy from the browser address bar will contain the x, y and z values for your current map view. If you intend to display your entire region (ie, your site’s default map view), remove the x, y and z parameters.
This will ensure that Pozi displays the whole region and automatically set the most appropriate zoom level based on the user’s screen size and resolution.
Layer Display
Display a specified layer. Specify the layer name in lower case and with any spaces or underscores removed.
https://<sitename>.pozi.com/#/layers[<layername>]/
Examples:
- single layer: https://shepparton.pozi.com/#/layers[wastecollectionzones]/
- multiple layers: https://shepparton.pozi.com/#/layers[wastecollectionzones]/layers[communityinfrastructurelevy]/
Note that if a layer is removed or renamed in the QGIS project after a link is shared, the link will not load the layer.
Panel Focus
Launch Pozi with one of the five available panels displayed to the left of the map, using the tab parameter.
https://<sitename>.pozi.com/#/tab[<tabname>]/
Available tabs:
searchinfolayerstoolsabout
Example: https://bendigo.pozi.com/#/tab[layers]/
Profile
Launching Pozi with a specific profile to display a subset of available layers.
https://<sitename>.pozi.com/#/profile[<profilename>]/
Example: https://council.pozi.com/#/profile[assets]/tab[layers]/
See profiles for more information.
Layer Filter
Launch Pozi with a filtered view of the available layers.
https://<sitename>.pozi.com/#/filter[<text>]/
It can also be useful to include /tab[layers]/ to open the layer panel and display the filtered layers.
Example: https://northerngrampians.pozi.com/#/filter[assets]/tab[layers]/
In this example, only layers whose name or folder name contains “assets” will be displayed in the layer panel.
Specified Search
Override the site’s default search by launching Pozi with a specific search item. Specify the search name in lower case and with any spaces or underscores removed.
https://<sitename>.pozi.com/#/search[<searchname>]/
Optionally use it in conjunction with tab[search] to open the search tab to prompt the user to start typing for the search you’ve specified.
https://frankston.pozi.com/#/search[roadresponsibility]/tab[search]/
The URL can also contain a value for the search. Users can pick from any of the result candidates.
https://frankston.pozi.com/#/search[roadresponsibility,seabrook]/tab[search]/
Browser Tab and iframe Interaction
When configuring the links in your application or web page, instead of using target="_blank" to open Pozi in a new tab, use target="pozi". This will open a new tab on the first time you use it. As long as that tab stays open, any subsequent link-ins to Pozi will reuse the same browser tab.
The same applies to iframes. If you’re using Pozi as an embedded map in your web application, specify target="pozi" so that the embedded map can respond to updated URLs to reflect some change in the application’s state.
For instance, if the application selects a different property, the Pozi URL can be updated to reflect the new property location.
Append the URL with /reload[true] to trigger a reload of the Pozi map.
<a href="https://westwimmera.pozi.com/#/search[propertynumber,1018753]/reload[true]/" target="pozi">Tab/iframe load</a>
<a href="https://westwimmera.pozi.com/#/search[propertynumber,1018530]/reload[true]/" target="pozi">Tab/iframe update</a>