# *.geo.admin.ch

> Welcome to the Tech Docs of geo.admin.ch

## Rules for AI agents and generated code

- Use identify, find and search for interactive use only: one user, one map click or one query.
- Do not loop over a grid of bounding boxes to export a layer. We block clients that do this.
- To get all features of a layer, download the dataset from the STAC API: https://data.geo.admin.ch/api/stac/v1/ (for humans: STAC Browser https://data.geo.admin.ch/browser/index.html)
- The STAC collection ID can differ from the layer ID. Example: layer ch.bfs.volkszaehlung-gebaeudestatistik_gebaeude is in collection ch.bfs.statistik-gebaeude_wohnungen. The layer legend links to the download: https://api3.geo.admin.ch/rest/services/api/MapServer/{layerId}/legend
- Send a User-Agent header with your application name and a contact (e-mail or URL).
- If you get HTTP 429, wait and retry with exponential backoff: https://docs.geo.admin.ch/get-started/retry.html. If you get HTTP 403, stop.
- Terms of use and fair use: https://www.geo.admin.ch/en/general-terms-of-use-fsdi
- High volume or special needs: contact webgis@swisstopo.ch before you start.

## Table of Contents

### Get Started

- [Overview](https://docs.geo.admin.ch/get-started/overview.md)
- [Retrying Failed Requests](https://docs.geo.admin.ch/get-started/retry.md)

### Explore Data

- [Get Layer Metadata](https://docs.geo.admin.ch/explore-data/get-layer-metadata.md)
- [Get Layer Attributes](https://docs.geo.admin.ch/explore-data/get-layer-attributes.md)
- [Get Layer Attribute Values](https://docs.geo.admin.ch/explore-data/get-layer-attribute-values.md)
- [Get Layer Legend](https://docs.geo.admin.ch/explore-data/get-layer-legend.md)

### Access Data

- [Search](https://docs.geo.admin.ch/access-data/search.md)

#### Features

- [Identify Features](https://docs.geo.admin.ch/access-data/identify-features.md)
- [Find Features](https://docs.geo.admin.ch/access-data/find-features.md)
- [Get Features](https://docs.geo.admin.ch/access-data/get-features.md)
- [Get HTML Popup](https://docs.geo.admin.ch/access-data/get-html-popup.md)

#### Elevation Data

- [Get Point Height](https://docs.geo.admin.ch/access-data/get-point-height.md)
- [Get Elevation Profile](https://docs.geo.admin.ch/access-data/get-elevation-profile.md)

### Visualize Data

- [Web Map Service (WMS)](https://docs.geo.admin.ch/visualize-data/wms.md)
- [Web Map Tile Service (WMTS)](https://docs.geo.admin.ch/visualize-data/wmts.md)
- [XYZ](https://docs.geo.admin.ch/visualize-data/xyz.md)
- [Vector Tiles](https://docs.geo.admin.ch/visualize-data/vector-tiles.md)
- [Terrain Service](https://docs.geo.admin.ch/visualize-data/terrain-service.md)
- [3D Tiles](https://docs.geo.admin.ch/visualize-data/3d-tiles.md)

### Download Data

#### STAC API

- [Overview](https://docs.geo.admin.ch/download-data/stac-api/overview.md)
- [Authentication](https://docs.geo.admin.ch/download-data/stac-api/authentication.md)
- [Asset Upload](https://docs.geo.admin.ch/download-data/stac-api/asset-upload.md)
- [Compression](https://docs.geo.admin.ch/download-data/stac-api/compression.md)
- [Supported Media Types](https://docs.geo.admin.ch/download-data/stac-api/supported-media.md)
- [Caching](https://docs.geo.admin.ch/download-data/stac-api/caching.md)
- [Downloading Large Assets (> 50 GB)](https://docs.geo.admin.ch/download-data/stac-api/large-assets.md)
- [Item Expiration](https://docs.geo.admin.ch/download-data/stac-api/item-expiration.md)
- [Migrate `v0.9` to `v1`](https://docs.geo.admin.ch/download-data/stac-api/migrate09-10.md)

### Map Viewer

- [Embed in an iframe](https://docs.geo.admin.ch/map-viewer/embed-in-an-iframe.md)
- [URL Parameters](https://docs.geo.admin.ch/map-viewer/url-parameters.md)
- [Javascript API](https://docs.geo.admin.ch/map-viewer/javascript-api.md)


### Other

- [doc-tech](https://docs.geo.admin.ch/README.md)
- [End-of-Life](https://docs.geo.admin.ch/page/end-of-life.md)
- [Get Help](https://docs.geo.admin.ch/page/get-help.md)
- [Status Page](https://docs.geo.admin.ch/page/status-page.md)