diff --git a/access-data/search.md b/access-data/search.md index c57ea80..30691ae 100644 --- a/access-data/search.md +++ b/access-data/search.md @@ -94,6 +94,18 @@ Here is a description of the response's data. | `x` and `y` | These attributes represent the coordinates of an entry. If an object's entry is a line or a polygon, those coordinates will always be on the underlying geometry. | | `label` | The HTML label for an entry. | +**Links (for address results):** +| **Field** | **Description** | +| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `links` | An array of related resources for address search results. Each link contains: | +| `rel` | The relationship type, typically "related". | +| `title` | The layer ID of the related resource (e.g., "ch.swisstopo.amtliches-gebaeudeadressverzeichnis", "ch.bfs.gebaeude_wohnungs_register"). | +| `href` | The URL path to access the related feature resource. The `` placeholder contains the actual feature ID. | + +::: tip +For address search results, it is recommended to use the `links` provided in the response to get additional feature information instead of constructing feature URLs manually. The links point to related resources such as the official building address directory and building/dwelling register. +::: + Here is a list of possible origins sorted in ascending ranking order: - **zipcode** (ch.swisstopo-vd.ortschaftenverzeichnis_plz) @@ -139,6 +151,48 @@ example='{ }' /> +Search for an address (note the `links` section containing related resources): + + + Search for locations of type "parcel" and "district" (the origins):