# swisstopo

> Look up Switzerland's official places, addresses and map data from swisstopo, the Federal Office of Topography, through the federal geoportal geo.admin.ch. Find any address, postcode, municipality, canton, land parcel or name on the national map with its coordinates; find out which municipality, canton, postcode, parcel and building a point lies in; look up features on about 900 official map layers, from the building register to protected areas and noise maps; get the height of any point and an elevation profile along a line; and convert between latitude and longitude and the Swiss LV95 and LV03 grids. Every action reads: nothing here changes anything. No account or API key required.

App · 11 actions. Web page: https://docs.lodol.com/docs/integrations/swisstopo

## Actions

### Convert latitude and longitude to Swiss coordinates

Turn a latitude and longitude (as GPS and most maps give them) into an easting and northing on the Swiss LV95 grid, the system Swiss land registers, plans and cantonal maps use. Exact to a few centimetres, from swisstopo's official conversion service.

**Inputs**

- Latitude (`latitude`, number, required): Latitude in decimal degrees, between 45.8 and 47.85 (46.9468 for Bern). From 45.8 to 47.85.
- Longitude (`longitude`, number, required): Longitude in decimal degrees, between 5.9 and 10.55 (7.4442 for Bern). From 5.9 to 10.55.

**Outputs**

- `latitude` (number): Latitude in decimal degrees (WGS84, as GPS and most maps use).
- `longitude` (number): Longitude in decimal degrees (WGS84, as GPS and most maps use).
- `lv95_easting` (number): Easting on the Swiss LV95 grid (EPSG:2056), in metres: seven digits starting with 2, such as 2600423.
- `lv95_northing` (number): Northing on the Swiss LV95 grid (EPSG:2056), in metres: seven digits starting with 1, such as 1199521.

**Example output**

```json
{
  "latitude": 46.946774,
  "longitude": 7.444192,
  "lv95_easting": 2600423.251,
  "lv95_northing": 1199520.99
}
```

### Convert Swiss coordinates to latitude and longitude

Turn an easting and northing on a Swiss grid, from a land register, a plan or a cantonal dataset, into latitude and longitude for any map. Reads the current LV95 grid and the older LV03 one, telling them apart by their size, and gives LV95 for both. Exact to a few centimetres, from swisstopo's official conversion service.

**Inputs**

- Easting (`easting`, number, required): The east coordinate (E, or Y on older plans), in metres: seven digits starting with 2 on LV95 (2600000), or six on LV03 (600000). Apostrophes such as 2'600'000 are fine. From 385000.0 to 2935000.0.
- Northing (`northing`, number, required): The north coordinate (N, or X on older plans), in metres: seven digits starting with 1 on LV95 (1200000), or six on LV03 (200000). From 0 to 1404000.0.

**Outputs**

- `easting` (number): The easting given.
- `latitude` (number): Latitude in decimal degrees (WGS84, as GPS and most maps use).
- `longitude` (number): Longitude in decimal degrees (WGS84, as GPS and most maps use).
- `lv95_easting` (number): Easting on the Swiss LV95 grid (EPSG:2056), in metres: seven digits starting with 2, such as 2600423.
- `lv95_northing` (number): Northing on the Swiss LV95 grid (EPSG:2056), in metres: seven digits starting with 1, such as 1199521.
- `northing` (number): The northing given.
- `system` (text): Which Swiss grid the coordinates given were on: LV95, or the older LV03.

**Example output**

```json
{
  "easting": 2600423.257,
  "latitude": 46.9467751,
  "longitude": 7.4441921,
  "lv95_easting": 2600423.257,
  "lv95_northing": 1199521.109,
  "northing": 1199521.109,
  "system": "LV95"
}
```

### Find map features at a location

List what the chosen map layers hold at a point: the building register's entry, the protected area, the noise level, the mobile coverage, the school district or any of hundreds of other federal and cantonal layers. Give an address or place name, or latitude and longitude, and a radius to include what is nearby. Each feature comes with every field the layer holds and an id 'Get a map feature' can read.

**Inputs**

- Layers (`layers`, list, required): The map layers to look at, up to 10. Pick them from the catalogue or type their technical ids. Picture-only layers, such as base maps and aerial photos, hold no features.
- Place (`place`, text): Where to look: an address, a place name, a postcode or a municipality, typed as you would in a map search. A coordinate pair works too, as latitude and longitude ('46.9468, 7.4442') or Swiss coordinates ('2600423, 1199521'). An exact name match is preferred to a partial one, and the result says which place was used. Leave it empty to give Latitude and Longitude instead; when both are filled in, the coordinates are used.
- Latitude (`latitude`, number): The point's latitude in decimal degrees, as GPS and most maps give it (46.9468 for Bern). Switzerland lies between 45.8 and 47.85. Fill in Longitude too, or leave both empty and give a Place. From 45.8 to 47.85.
- Longitude (`longitude`, number): The point's longitude in decimal degrees (7.4442 for Bern). Switzerland lies between 5.9 and 10.55. Fill in Latitude too, or leave both empty and give a Place. From 5.9 to 10.55.
- Search radius (`radius`, number): Also include features up to this many metres from the point, up to 500. Leave it at 0 for what lies exactly at the point, which suits areas such as zones and boundaries; points such as buildings need a few metres. From 0 to 500. Default: `0`.
- How many to return (`limit`, number): The most features to return, up to 200, which is as many as geo.admin.ch answers with at once. From 1 to 200. Default: `50`.

**Outputs**

- `count` (number): How many features came back.
- `features` (list): The features at the point, today's version of each where a layer keeps history.
- `latitude` (number): Latitude in decimal degrees (WGS84, as GPS and most maps use).
- `layers` (list): The layers that were looked at.
- `longitude` (number): Longitude in decimal degrees (WGS84, as GPS and most maps use).
- `lv95_easting` (number): Easting on the Swiss LV95 grid (EPSG:2056), in metres: seven digits starting with 2, such as 2600423.
- `lv95_northing` (number): Northing on the Swiss LV95 grid (EPSG:2056), in metres: seven digits starting with 1, such as 1199521.
- `matched_place` (text): The address or place the Place text was matched to, such as 'Bundesplatz 3, 3011 Bern'. Empty when coordinates were given.
- `more_available` (true/false): True when more features were there than the limit.

**Example output**

```json
{
  "count": 1,
  "features": [
    {
      "attributes": {
        "egid": "2242547",
        "egrid": "CH294676423526",
        "garea": 3697,
        "gbez": "Parlamentsgeb\u00e4ude",
        "gdekt": "BE",
        "ggdename": "Bern",
        "ggdenr": 351,
        "gkat": 1060,
        "gstat": 1004,
        "label": "Bundesplatz 3",
        "lparz": "823",
        "plz_plz6": "3011/301100",
        "strname_deinr": "Bundesplatz 3"
      },
      "feature_id": "2242547_0",
      "label": "Bundesplatz 3",
      "layer_id": "ch.bfs.gebaeude_wohnungs_register",
      "layer_name": "RBD: building status"
    }
  ],
  "latitude": 46.946774,
  "layers": [
    "ch.bfs.gebaeude_wohnungs_register"
  ],
  "longitude": 7.444192,
  "lv95_easting": 2600423.24,
  "lv95_northing": 1199521.02,
  "matched_place": null,
  "more_available": false
}
```

### Find map features by attribute

Find the features of one map layer whose field holds a value: a municipality by name, a building by its EGID, a street by its name, a protected site by its number. Matches part of the value unless an exact match is asked for. Each feature comes with every field the layer holds and an id 'Get a map feature' can read for where it is.

**Inputs**

- Layer (`layer`, text, required): The map layer: pick one from geo.admin.ch's catalogue of about 900, or type its technical id, such as ch.bfs.gebaeude_wohnungs_register (the building register). 'Search map layers' finds one by keyword.
- Field (`field`, text, required): The field to search, picked from the layer's fields or typed as its technical name, such as gemname (a municipality's name) or egid (a building's EGID).
- Value (`value`, text, required): What the field should hold. Without an exact match, any feature whose field contains it is found, in any case.
- Exact match (`exact`, true/false): Only features whose field is exactly the value, with the same capitals. Off by default. Default: `false`.
- How many to return (`limit`, number): The most features to return, up to 200, which is as many as geo.admin.ch answers with at once. From 1 to 200. Default: `50`.

**Outputs**

- `count` (number): How many features came back.
- `features` (list): The matching features, today's version of each where a layer keeps history.
- `field` (text): The field searched.
- `layer_id` (text): The layer searched.
- `more_available` (true/false): True when more features matched than the limit.
- `value` (text): The value searched for.

**Example output**

```json
{
  "count": 1,
  "features": [
    {
      "attributes": {
        "gde_hist_id": 13688,
        "gde_nr": 261,
        "gemflaeche": 9188.0,
        "gemname": "Z\u00fcrich",
        "is_current_jahr": true,
        "jahr": 2026,
        "kanton": "ZH",
        "label": "Z\u00fcrich",
        "link_de": "https://www.agvchapp.bfs.admin.ch/de/communes/results?BfsNr=261&EntriesFrom=01.01.1990&EntriesTo=01.01.2026&IncludeUnassignedEntities=True",
        "objektart": 0,
        "objektart_lookup": "gemeindegebiet",
        "perimeter": 58651.7229898752
      },
      "feature_id": "261",
      "label": "Z\u00fcrich",
      "layer_id": "ch.swisstopo.swissboundaries3d-gemeinde-flaeche.fill",
      "layer_name": "Municipal boundaries"
    }
  ],
  "field": "gemname",
  "layer_id": "ch.swisstopo.swissboundaries3d-gemeinde-flaeche.fill",
  "more_available": false,
  "value": "Z\u00fcrich"
}
```

### Get a map feature

Read one feature of a map layer by its id: every field the layer holds for it, and where it is, as latitude and longitude and on the LV95 grid, with the rectangle it fits in. Ids come from the other steps: a municipality's official number, a building's EGID with its entrance (2242547_0) and so on.

**Inputs**

- Layer (`layer`, text, required): The map layer: pick one from geo.admin.ch's catalogue of about 900, or type its technical id, such as ch.bfs.gebaeude_wohnungs_register (the building register). 'Search map layers' finds one by keyword.
- Feature id (`feature_id`, text, required): The feature's id on that layer, as 'Search Swiss places and addresses', 'Find map features at a location' or 'Find map features by attribute' return it.

**Outputs**

- `attributes` (object): Every field the layer holds for this feature, under the layer's own technical names (such as gemname and gde_nr for a municipality). 'Get a map layer's details' explains them.
- `bounding_box` (object): The rectangle on the LV95 grid that the area or line fits in. Empty for a single point.
- `feature_id` (text): The feature's id on its layer, for 'Get a map feature'.
- `label` (text): The feature's name or number as the map labels it.
- `latitude` (number): Latitude of the feature's middle (of the rectangle it fits in), or of the feature itself when it is a point.
- `layer_id` (text): The map layer's technical id.
- `layer_name` (text): The map layer's name, such as 'Municipal boundaries'.
- `longitude` (number): Longitude of the feature's middle, or of the point.
- `lv95_easting` (number): LV95 easting of the feature's middle, or of the point.
- `lv95_northing` (number): LV95 northing of the feature's middle, or of the point.

**Example output**

```json
{
  "attributes": {
    "gde_hist_id": 13688,
    "gde_nr": 261,
    "gemflaeche": 9188.0,
    "gemname": "Z\u00fcrich",
    "is_current_jahr": true,
    "jahr": 2026,
    "kanton": "ZH",
    "label": "Z\u00fcrich",
    "link_de": "https://www.agvchapp.bfs.admin.ch/de/communes/results?BfsNr=261&EntriesFrom=01.01.1990&EntriesTo=01.01.2026&IncludeUnassignedEntities=True",
    "objektart": 0,
    "objektart_lookup": "gemeindegebiet",
    "perimeter": 58651.7229898752
  },
  "bounding_box": {
    "max_easting": 2689665.8,
    "max_northing": 1254306.2,
    "min_easting": 2676224.7,
    "min_northing": 1241584.1
  },
  "feature_id": "261",
  "label": "Z\u00fcrich",
  "latitude": 47.377117,
  "layer_id": "ch.swisstopo.swissboundaries3d-gemeinde-flaeche.fill",
  "layer_name": "Municipal boundaries",
  "longitude": 8.536954,
  "lv95_easting": 2682945.25,
  "lv95_northing": 1247945.15
}
```

### Get a map layer's details

Read what a map layer holds: its description, the office the data comes from (to name as the source), when it was last updated, where to download it, and every field its features have with example values, for searching it with 'Find map features by attribute'.

**Inputs**

- Layer (`layer`, text, required): The map layer: pick one from geo.admin.ch's catalogue of about 900, or type its technical id, such as ch.bfs.gebaeude_wohnungs_register (the building register). 'Search map layers' finds one by keyword.
- Language (`language`, text): The language for layer names and descriptions. English if left empty. Some data owners write only in German or French. One of: `en` (English), `de` (German (Deutsch)), `fr` (French (Français)), `it` (Italian (Italiano)), `rm` (Romansh (Rumantsch)). Default: `en`.

**Outputs**

- `abstract` (text): What the layer shows, in the data owner's words.
- `data_owner` (text): The office the data comes from, such as 'Federal Statistical Office FSO'. Name it as the source when you publish the data.
- `data_updated` (text): When the data was last updated, as YYYY-MM-DD; for a historical dataset, the years it covers, such as 1998-2006.
- `details_url` (text): The data owner's page about the data.
- `download_url` (text): Where the whole dataset can be downloaded.
- `field_count` (number): How many fields it has.
- `fields` (list): The fields its features have, by name.
- `full_name` (text): Its full name.
- `has_records` (true/false): False for a picture-only layer (a base map, an aerial photo or a map drawn as an image), which has no features to look up.
- `layer_id` (text): The layer's technical id.
- `metadata_url` (text): The dataset's entry in geocat.ch, the Swiss metadata catalogue, which states its terms of use.
- `name` (text): Its short name.
- `scale` (text): The map scales the layer is meant for.

**Example output**

```json
{
  "abstract": "swissBOUNDARIES3D cantonal boundaries constitute the administrative borders of the Swiss cantons. The Swiss Confederation consists of 26 cantons which have the status of constituent states.swissBOUNDARIES3D cantonal boundaries is derived from the parent dataset swissBOUNDARIES3D.",
  "data_owner": "Federal Office of Topography swisstopo",
  "data_updated": "2026-01-01",
  "details_url": "https://www.swisstopo.admin.ch/de/landschaftsmodell-swissboundaries3d",
  "download_url": "https://www.swisstopo.admin.ch/de/landschaftsmodell-swissboundaries3d",
  "field_count": 4,
  "fields": [
    {
      "description": "Abk\u00fcrzung",
      "example_values": [
        "AG",
        "FR",
        "GE",
        "OW",
        "TG"
      ],
      "name": "ak",
      "type": "VARCHAR"
    },
    {
      "description": null,
      "example_values": [
        "28249.0",
        "49058.0",
        "99433.0",
        "140380.0",
        "167243.0"
      ],
      "name": "flaeche",
      "type": "NUMERIC"
    },
    {
      "description": "Canton number according to FSO",
      "example_values": [
        "6",
        "10",
        "19",
        "20",
        "25"
      ],
      "name": "id",
      "type": "INTEGER"
    },
    {
      "description": "Name",
      "example_values": [
        "Aargau",
        "Fribourg",
        "Gen\u00e8ve",
        "Obwalden",
        "Thurgau"
      ],
      "name": "name",
      "type": "VARCHAR"
    }
  ],
  "full_name": "swissBOUNDARIES3D cantonal boundaries",
  "has_records": true,
  "layer_id": "ch.swisstopo.swissboundaries3d-kanton-flaeche.fill",
  "metadata_url": "https://www.geocat.ch/geonetwork/srv/eng/catalog.search#/metadata/9eee6d40-f0a6-46c9-94ad-69679b9f3d38",
  "name": "Cantonal boundaries",
  "scale": "-"
}
```

### Get an elevation profile

Measure the ground along a line through two or more places or points, such as a hike or a planned pipe: its length, the total climb and drop, the lowest and highest point, and the height at evenly spaced points along it. The line runs straight between the points given, so give a route's points to follow a route.

**Inputs**

- Points (`points`, list, required): Where the line goes, in order: at least a start and an end. Each is a place or address, or a coordinate pair such as '46.9468, 7.4442'. A list from an earlier step works, including places from 'Search Swiss places and addresses'. Up to 5,000 points, of which up to 10 can be place names.
- Number of samples (`samples`, number): How many evenly spaced points along the line to measure, from 2 to 1,000. More give a truer climb on a long line. From 2 to 1000. Default: `200`.

**Outputs**

- `ascent_m` (number): The total climb along the line, in metres.
- `descent_m` (number): The total drop along the line, in metres.
- `distance_m` (number): The line's length in metres, measured on the map.
- `end_height_m` (number): The height where the line ends.
- `highest_m` (number): The highest height on the line, in metres above sea level.
- `lowest_m` (number): The lowest height on the line, in metres above sea level.
- `sample_count` (number): How many points along the line were measured.
- `samples` (list): The height at evenly spaced points along the line.
- `start_height_m` (number): The height where the line starts.
- `waypoints` (list): The points the line was drawn through, in order.

**Example output**

```json
{
  "ascent_m": 338.8,
  "descent_m": 39.9,
  "distance_m": 3089.5,
  "end_height_m": 842.0,
  "highest_m": 842.0,
  "lowest_m": 503.2,
  "sample_count": 5,
  "samples": [
    {
      "distance_m": 0.0,
      "height_m": 543.1,
      "latitude": 46.946772,
      "longitude": 7.444196,
      "lv95_easting": 2600423.24,
      "lv95_northing": 1199521.02
    },
    {
      "distance_m": 772.4,
      "height_m": 503.2,
      "latitude": 46.939868,
      "longitude": 7.443069,
      "lv95_easting": 2600337.478,
      "lv95_northing": 1198753.413
    },
    {
      "distance_m": 1544.8,
      "height_m": 539.2,
      "latitude": 46.932963,
      "longitude": 7.441943,
      "lv95_easting": 2600251.715,
      "lv95_northing": 1197985.805
    },
    {
      "distance_m": 2317.2,
      "height_m": 651.0,
      "latitude": 46.926058,
      "longitude": 7.440816,
      "lv95_easting": 2600165.953,
      "lv95_northing": 1197218.198
    },
    {
      "distance_m": 3089.5,
      "height_m": 842.0,
      "latitude": 46.919153,
      "longitude": 7.43969,
      "lv95_easting": 2600080.19,
      "lv95_northing": 1196450.59
    }
  ],
  "start_height_m": 543.1,
  "waypoints": [
    {
      "latitude": 46.946774,
      "longitude": 7.444192,
      "lv95_easting": 2600423.24,
      "lv95_northing": 1199521.02,
      "matched_place": null
    },
    {
      "latitude": 46.919155,
      "longitude": 7.439686,
      "lv95_easting": 2600080.19,
      "lv95_northing": 1196450.59,
      "matched_place": null
    }
  ]
}
```

### Get the height of a location

Get the ground's height above sea level at an address, a place or a point, from swisstopo's elevation models, to a tenth of a metre. Covers Switzerland and the land just around it.

**Inputs**

- Place (`place`, text): Where to look: an address, a place name, a postcode or a municipality, typed as you would in a map search. A coordinate pair works too, as latitude and longitude ('46.9468, 7.4442') or Swiss coordinates ('2600423, 1199521'). An exact name match is preferred to a partial one, and the result says which place was used. Leave it empty to give Latitude and Longitude instead; when both are filled in, the coordinates are used.
- Latitude (`latitude`, number): The point's latitude in decimal degrees, as GPS and most maps give it (46.9468 for Bern). Switzerland lies between 45.8 and 47.85. Fill in Longitude too, or leave both empty and give a Place. From 45.8 to 47.85.
- Longitude (`longitude`, number): The point's longitude in decimal degrees (7.4442 for Bern). Switzerland lies between 5.9 and 10.55. Fill in Latitude too, or leave both empty and give a Place. From 5.9 to 10.55.

**Outputs**

- `height_m` (number): The ground's height in metres above sea level, as on the Swiss national map, to a tenth of a metre.
- `latitude` (number): Latitude in decimal degrees (WGS84, as GPS and most maps use).
- `longitude` (number): Longitude in decimal degrees (WGS84, as GPS and most maps use).
- `lv95_easting` (number): Easting on the Swiss LV95 grid (EPSG:2056), in metres: seven digits starting with 2, such as 2600423.
- `lv95_northing` (number): Northing on the Swiss LV95 grid (EPSG:2056), in metres: seven digits starting with 1, such as 1199521.
- `matched_place` (text): The address or place the Place text was matched to, such as 'Bundesplatz 3, 3011 Bern'. Empty when coordinates were given.

**Example output**

```json
{
  "height_m": 4477.2,
  "latitude": 45.976414,
  "longitude": 7.658612,
  "lv95_easting": 2617048.76,
  "lv95_northing": 1091673.22,
  "matched_place": null
}
```

### Look up what's at a location

Find out which municipality (with its official number), canton, district, postcode and land parcel (with its EGRID) a point in Switzerland lies in, and the nearest official address with its building's EGID and name. Give an address or place name, or latitude and longitude, such as a phone's location. Useful to file a report under the right municipality or to turn a point into an address.

**Inputs**

- Place (`place`, text): Where to look: an address, a place name, a postcode or a municipality, typed as you would in a map search. A coordinate pair works too, as latitude and longitude ('46.9468, 7.4442') or Swiss coordinates ('2600423, 1199521'). An exact name match is preferred to a partial one, and the result says which place was used. Leave it empty to give Latitude and Longitude instead; when both are filled in, the coordinates are used.
- Latitude (`latitude`, number): The point's latitude in decimal degrees, as GPS and most maps give it (46.9468 for Bern). Switzerland lies between 45.8 and 47.85. Fill in Longitude too, or leave both empty and give a Place. From 45.8 to 47.85.
- Longitude (`longitude`, number): The point's longitude in decimal degrees (7.4442 for Bern). Switzerland lies between 5.9 and 10.55. Fill in Latitude too, or leave both empty and give a Place. From 5.9 to 10.55.
- Address search radius (`radius`, number): How far from the point, in metres, to look for the nearest address and building. Up to 100; 0 skips the address. From 0 to 100. Default: `30`.

**Outputs**

- `address` (text): The nearest official address within the search radius, such as 'Bundesplatz 3, 3011 Bern'. Empty when there is none.
- `address_distance_m` (number): How far the address is from the point, in metres.
- `building_name` (text): The building's name in the building register, when it has one, such as 'Parlamentsgebäude'.
- `canton` (text): The canton's two-letter code, such as BE.
- `canton_name` (text): The canton's name, such as 'Bern'.
- `country` (text): CH for Switzerland, LI for Liechtenstein (which the boundary data also covers), or empty outside both.
- `district` (text): The district, such as 'Bern-Mittelland'. Empty in cantons that have none.
- `egid` (text): The federal building identifier (EGID) of that address's building.
- `egrid` (text): The parcel's federal property identifier (EGRID), the key the land register and cadastre extracts use.
- `latitude` (number): Latitude in decimal degrees (WGS84, as GPS and most maps use).
- `locality` (text): The town or locality the postcode belongs to.
- `longitude` (number): Longitude in decimal degrees (WGS84, as GPS and most maps use).
- `lv95_easting` (number): Easting on the Swiss LV95 grid (EPSG:2056), in metres: seven digits starting with 2, such as 2600423.
- `lv95_northing` (number): Northing on the Swiss LV95 grid (EPSG:2056), in metres: seven digits starting with 1, such as 1199521.
- `matched_place` (text): The address or place the Place text was matched to, such as 'Bundesplatz 3, 3011 Bern'. Empty when coordinates were given.
- `municipality` (text): The municipality, such as 'Bern'. On a lake that belongs to no municipality, the lake's own area, such as 'Zürichsee (ZH)'.
- `municipality_number` (number): The municipality's official number from the Federal Statistical Office (BFS number), such as 351 for Bern.
- `parcel_number` (text): The land parcel's number within its municipality.
- `postcode` (text): The four-digit postcode, such as '3011'.

**Example output**

```json
{
  "address": "Bundesplatz 3, 3011 Bern",
  "address_distance_m": 0.0,
  "building_name": "Parlamentsgeb\u00e4ude",
  "canton": "BE",
  "canton_name": "Bern",
  "country": "CH",
  "district": "Bern-Mittelland",
  "egid": "2242547",
  "egrid": "CH294676423526",
  "latitude": 46.946774,
  "locality": "Bern",
  "longitude": 7.444192,
  "lv95_easting": 2600423.257,
  "lv95_northing": 1199521.109,
  "matched_place": "Bundesplatz 3, 3011 Bern",
  "municipality": "Bern",
  "municipality_number": 351,
  "parcel_number": "823",
  "postcode": "3011"
}
```

### Search map layers

Find map layers in geo.admin.ch's catalogue by keyword, such as 'noise', 'building register' or 'protected areas', and get each one's id for the other steps.

**Inputs**

- Search for (`query`, text, required): Words from the layer's name or description.
- Language (`language`, text): The language for layer names and descriptions. English if left empty. Some data owners write only in German or French. One of: `en` (English), `de` (German (Deutsch)), `fr` (French (Français)), `it` (Italian (Italiano)), `rm` (Romansh (Rumantsch)). Default: `en`.
- How many to return (`limit`, number): The most layers to return, up to 30. From 1 to 30. Default: `10`.

**Outputs**

- `count` (number): How many layers came back.
- `layers` (list): The matching layers, best match first.
- `query` (text): The text that was searched.

**Example output**

```json
{
  "count": 3,
  "layers": [
    {
      "layer_id": "ch.bfs.gebaeude_wohnungs_register",
      "title": "RBD: building status"
    },
    {
      "layer_id": "ch.are.wohnungsinventar-zweitwohnungsanteil",
      "title": "Housing inventory"
    },
    {
      "layer_id": "ch.bfs.gebaeude_wohnungs_register_waermequelle_heizung",
      "title": "RBD: energy/heat source heating"
    }
  ],
  "query": "building register"
}
```

### Search Swiss places and addresses

Find a Swiss address, postcode, municipality, district, canton, land parcel or any name on the national map (a peak, a lake, a station) and get where it is, as latitude and longitude and on the Swiss LV95 grid. Addresses come with their building's EGID and parcels with their EGRID, and municipalities, cantons and addresses with an id 'Get a map feature' can read. The most likely match is also returned on its own, for the next step to use.

**Inputs**

- Search for (`query`, text, required): What to look for, up to 10 words: an address, a place name, a postcode, a municipality or a parcel (its municipality and number).
- Kinds of place (`location_types`, list): Only return these kinds of place. Leave it empty for every kind. One or more of: `address` (Addresses), `postcode` (Postcodes), `municipality` (Municipalities), `district` (Districts), `canton` (Cantons), `place_name` (Names on the national map (peaks, lakes, stations, areas)), `parcel` (Land parcels).
- How many to return (`limit`, number): The most places to return, up to 50. From 1 to 50. Default: `10`.

**Outputs**

- `best_match` (object): The place the text most likely means: an exact name match if there is one, otherwise the first result. The same place a Place field resolves this text to. Empty when nothing matched.
- `count` (number): How many places came back.
- `fuzzy` (true/false): True when nothing matched exactly and these are the closest spellings geo.admin.ch could find.
- `locations` (list): Every match, in geo.admin.ch's order.
- `query` (text): The text that was searched.

**Example output**

```json
{
  "best_match": {
    "bounding_box": {
      "max_easting": 2689665.813,
      "max_northing": 1254306.233,
      "min_easting": 2676224.694,
      "min_northing": 1241584.105
    },
    "egid": null,
    "egrid": null,
    "feature_id": "261",
    "latitude": 47.377213,
    "layer_id": "ch.swisstopo.swissboundaries3d-gemeinde-flaeche.fill",
    "longitude": 8.527311,
    "lv95_easting": 2682217.0,
    "lv95_northing": 1247945.25,
    "name": "Z\u00fcrich (ZH)",
    "parcel_number": null,
    "place_kind": null,
    "type": "municipality"
  },
  "count": 3,
  "fuzzy": false,
  "locations": [
    {
      "bounding_box": {
        "max_easting": 2689665.813,
        "max_northing": 1254306.233,
        "min_easting": 2676224.694,
        "min_northing": 1241584.105
      },
      "egid": null,
      "egrid": null,
      "feature_id": "261",
      "latitude": 47.377213,
      "layer_id": "ch.swisstopo.swissboundaries3d-gemeinde-flaeche.fill",
      "longitude": 8.527311,
      "lv95_easting": 2682217.0,
      "lv95_northing": 1247945.25,
      "name": "Z\u00fcrich (ZH)",
      "parcel_number": null,
      "place_kind": null,
      "type": "municipality"
    },
    {
      "bounding_box": {
        "max_easting": 2716900.4,
        "max_northing": 1283342.861,
        "min_easting": 2669244.906,
        "min_northing": 1223895.629
      },
      "egid": null,
      "egrid": null,
      "feature_id": "1",
      "latitude": 47.427097,
      "layer_id": "ch.swisstopo.swissboundaries3d-kanton-flaeche.fill",
      "longitude": 8.644238,
      "lv95_easting": 2690961.25,
      "lv95_northing": 1253619.875,
      "name": "Z\u00fcrich",
      "parcel_number": null,
      "place_kind": null,
      "type": "canton"
    },
    {
      "bounding_box": {
        "max_easting": 2688298.72,
        "max_northing": 1254281.806,
        "min_easting": 2677461.639,
        "min_northing": 1241764.354
      },
      "egid": null,
      "egrid": null,
      "feature_id": null,
      "latitude": 47.383949,
      "layer_id": null,
      "longitude": 8.530146,
      "lv95_easting": 2682420.5,
      "lv95_northing": 1248697.125,
      "name": "Z\u00fcrich (ZH) - D\u00fcbendorf,Zollikon,Kilchberg (ZH),Wallisellen,Opfikon,R\u00fcmlang,Oberengstringen,Adliswil,Z\u00fcrich,Schlieren",
      "parcel_number": null,
      "place_kind": null,
      "type": "place_name"
    }
  ],
  "query": "Z\u00fcrich"
}
```
