Skip to content

Commit

Permalink
Announce new link-in functionality
Browse files Browse the repository at this point in the history
  • Loading branch information
simonokeefe committed Dec 9, 2024
1 parent 4d2fc2b commit 34fc2ef
Show file tree
Hide file tree
Showing 3 changed files with 53 additions and 5 deletions.
8 changes: 3 additions & 5 deletions admin-guide/link-in.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,13 +82,11 @@ https://strathbogie.pozi.com/#/x[145.56842]/y[-36.75206]/z[19]/feature[whatshere

### Feature Selection

Given a layer name and feature id, Pozi will highlight the feature and display its info results.
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://latrobe.pozi.com/#/layers[skateparks]/feature[skateparks,4]/
Example: link to a feature in the `Parks` layer where the `fid` field is `15`:

If the feature location is known (for example, if you have coordinates in addition to the feature id), specify the coordinates and a suitable zoom level.

https://latrobe.pozi.com/#/x[146.40171]/y[-38.23845]/z[18]/layers[skateparks]/feature[skateparks,4]/
https://council.pozi.com/#/feature[parks.fid,15]/

### Layer Filter

Expand Down
Binary file added admin-guide/qgis/img/pozi-link-in.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
50 changes: 50 additions & 0 deletions blog/2024-12-10-enhanced-link-ins.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
slug: enhanced-link-ins
author: Simon O'Keefe
tags:
description: Smart links to launch Pozi from any third-party application
category: What's New
visibility:
---

# Enhanced Link-Ins

We're excited to announce improvements to Pozi's link-in functionality to make third-party integrations even more powerful.

As the name suggests, the Pozi *link-in* enables third-party applications to link ***in*** to Pozi. Following a simple URL format, any application can launch Pozi and zoom directly to specific features in your map. The new format link-in looks like this:

https://council.pozi.com/#/feature[parks.fid,15]/

This example link launches the Pozi web application, activates the Parks layer, selects and highlights the target feature, zooms the map to it, and displays its details in the Info Panel.

![](../admin-guide/qgis/img/pozi-link-in.png)

## What's New

### Automatically Zoom to Feature

Pozi link-ins have long supported the selection of specific features, but additional URL parameters were required to position the map view at the appropriate location. Pozi now automatically zooms to the selected feature based on its location as well as its size.

### Control Which Field is Used for the Link

Previously, the link-in required Pozi's internal id field as the feature link, which didn't always reflect the id field known to external applications. Now, the link-in URL can specify *any* field from the selected feature's layer to use for the link. Simply append the layer name with a dot followed by the field name to the layer name in the link-in URL.

Example: link to a feature in the `Parks` layer where the `fid` field is `15`:

```
https://council.pozi.com/#/feature[parks.fid,15]/
```

### Turn On Layer Automatically

The link-in now turns on the target layer without requiring a separate `layers[...]` parameter to load it. Link-in URLs are more self-contained, making them easier to generate, share and use.

## Limitations

The new link-in will work for any ***vector*** layer in your map. Layers that are not exposed as a vector layer, or are not exposed in the layer panel, do not currently support link-ins.

However, we're currently working to support link-ins for larger datasets that are not normally exposed in the layer panel. Stay tuned!

## Try It Out

This enhancement is part of our ongoing commitment to make spatial data sharing and collaboration as seamless as possible. Try it out today and let us know what you think!

0 comments on commit 34fc2ef

Please sign in to comment.