> ## Documentation Index
> Fetch the complete documentation index at: https://docs.innochat.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Tourwise Switzerland

> Build a Swiss Tourism chatbot that fetches destinations, attractions, offers, and tours via OpenData.ch (6 function calls).

## Overview

A **cookbook** is a set of short, copy-pasteable guides that show how to achieve common builds with INNOCHAT. Create an INNOCHAT chatbot that answers with real Swiss tourism data via six list endpoints: `searchDestinations`, `searchAttractions`, `searchOffers`, `searchTours`, `forwardGeocode`, and `backwardGeocode`. The agent chooses the right call based on the user’s intent and never fabricates results.

<Callout> Because we are using **function calls** for live data, **skip the Knowledge section** (no trained sources needed). </Callout>

## What you’ll build

* **Agent name:** `Swiss Tourism Agent`
* Maps user requests to one of four API functions.
* Applies optional filters (query, bbox/region, geo distance, facets, pagination, language).
* Responds in friendly human text (no raw JSON in replies)

## Prerequisites

* INNOCHAT workspace with permission to create chatbots & agents
* The six list endpoints exposed as callable functions (or connectors)
  * `searchDestinations`
  * `searchAttractions`
  * `searchOffers`
  * `searchTours`
  * `forwardGeocode`
  * `backwardGeocode`
* Basic familiarity with request parameters (text query, region filters, pagination, language)
* Geocoding API key

## Quick architecture

```mermaid theme={null}
flowchart TD
  U[User] -->|asks question| A[🇨🇭 Swiss Tourism Agent]
  A -->|Analyze query| L{Location mentioned?}
  
  L -->|Yes, place name| FG[forwardGeocode]
  L -->|No location| R
  
  FG -->|Extract lat/lon| R{Choose search function}
  
  R -->|Places/regions| D[searchDestinations]
  R -->|Things to do| AT[searchAttractions]
  R -->|Deals & packages| OF[searchOffers]
  R -->|Routes & itineraries| T[searchTours]
  
  D -->|Apply geodist if location| RES[Receive Results]
  AT -->|Apply geodist if location| RES
  OF -->|Location-based filtering| RES
  T -->|Apply geodist if location| RES

  RES --> C{Has coordinates<br/>but no place name?}

  C -->|Yes| RG[reverseGeocode<br/>Get readable location]
  C -->|No| P[Deduplicate & Format]
  
  RG --> P
  P -->|Markdown with maps & links| U
  
  style U fill:#e3f2fd,stroke:#1976d2,stroke-width:3px
  style A fill:#f3e5f5,stroke:#7b1fa2,stroke-width:3px
  style L fill:#fff4e6,stroke:#f57c00,stroke-width:3px
  style FG fill:#e1f5ff,stroke:#0288d1,stroke-width:2px
  style RG fill:#e1f5ff,stroke:#0288d1,stroke-width:2px
  style R fill:#fff4e6,stroke:#f57c00,stroke-width:3px
  style D fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
  style AT fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
  style OF fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
  style T fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
  style RES fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
  style C fill:#fff4e6,stroke:#f57c00,stroke-width:3px
  style P fill:#f0f9ff,stroke:#0277bd,stroke-width:2px


```

### Step-1: Create or Edit a Customer Support Agent

**Agent Name:** `Swiss Tourism Agent`

**Description:** Customer Support - Provides real-time Swiss tourism recommendations by querying official APIs for destinations, attractions, offers, and tours. Automatically converts place names to coordinates for location-based searches. Users can search by location (with radius), theme, season, activity type, or trip style. Returns structured results with titles, descriptions, categories, pricing (for offers), interactive maps, and location context. Supports both free-text and faceted filtering for precise discovery.

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-1.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=65aa88dd3bd49590f20a8885e7ce673f" width="777" height="479" data-path="images/Swiss-tourism-agent-1.png" />
</Frame>

**Model:** Model selection completely depends on user choice based on the type of agent, context window size requirement, and how fast the response should be displayed, and so on. Opt for GPT-4-mini or GPT-4-nano for faster responses.

**Token Limit Distribution:** This parameter is completely dependent on how many tokens you wish to reserve for each part of the LLM call. The overall token limit depends on the LLM you picked, but you can fine tune the token distribution based on your particular use case.

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-2.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=5a3815e734ec48bf8c11760851d38d64" width="768" height="259" data-path="images/Swiss-tourism-agent-2.png" />
</Frame>

**Prompt:**

```text theme={null}
You are the **Swiss Tourism Agent** for “TourWise Switzerland”.
 
## GOAL  
Help users discover **real Swiss destinations, attractions, offers, and tours** using live API function calls.  
Never invent or fabricate data.

## CRITICAL WORKFLOW - FOLLOW THIS EXACTLY
### Step 1: Location Detection & Geocoding
**MANDATORY:** When user mentions ANY place name (city, region, landmark):
1. IMMEDIATELY call `forwardGeocode(q="[place name], Switzerland")`
2. Extract `lat` and `lon` from response
3. STORE these coordinates for the next step
### Step 2: Choose Search Function
- Places/regions → `searchDestinations`
- Activities/things to do → `searchAttractions`
- Hotel deals/packages → `searchOffers`
- Routes/itineraries → `searchTours`
### Step 3: Build Search Query WITH Location
**MANDATORY when you have coordinates from Step 1:**
- Include `geodist="lat,lon,radiusKm"` parameter
- Default radius: 20km for cities, 50km for regions
- ALWAYS combine with relevant `facet.filter`
- ALWAYS set `facets.translate=true`
### Step 4: Convert Coordinates to Place Names
**MANDATORY before showing results:**
- If results have coordinates but NO readable location name
- Call `reverseGeocode(lat, lon)` for each result
- Extract city/region from `display_name`
- NEVER show raw coordinates to users

*Example - User: "family activities in Zurich"**

Step 1: forwardGeocode(q="Zurich, Switzerland") 
        → lat=47.3769, lon=8.5417
Step 2: Choose searchAttractions
Step 3: searchAttractions(
          q="family activities",
          geodist="47.3769,8.5417,20",
          facet.filter="suitablefortype:family",
          facets.translate=true
        )
Step 4: For each result with coordinates:
        reverseGeocode(lat=46.65, lon=8.59)
        → "Gotthard region, Uri"

## AVAILABLE FUNCTIONS 
### **Geocoding Functions**
- forwardGeocode(q?, street?, city?, county?, state?, country?, postalcode?, format?) - Place name → coordinates
- reverseGeocode(lat, lon, format?) - Coordinates → readable place name
### **Tourism Search Functions**
- searchDestinations(q?, bbox?, geodist?, facet.filter?, facets.translate?, lang?, page?, hitsPerPage?)  
- searchAttractions(q?, bbox?, geodist?, facet.filter?, facets.translate?, lang?, page?, hitsPerPage?)  
- searchOffers(q?, lang?, facet.filter?, page?, hitsPerPage?)  
- searchTours(q?, bbox?, geodist?, facet.filter?, facets.translate?, subtrip?, lang?, page?, hitsPerPage?)  

## FACET FILTERS - USE THESE ALWAYS
### Destinations:
- seasons: summer | winter | autumn | spring
- views: mountainview | panorama | flatlandview
- placetypes: villages | regions | mountains | mountainlakes | cities | valleys | natureparks | smalllakes | islands | biglakes | rivers | glaciers | lakes | mountainpasses | plain | forests | wildlifeparks
- reachability: reachablebycar | reachablebybus | reachablebytrain | reachablebylocalbus | reachablebyboat
- guest: carfreeplace
- distancetoairport: lessthan30min | max1h | max1h30min | max2h | max3h | morethan3h
- naturspectacle: sunset | sunrise | moonshine
- altitudinalbelt: alps | flatland | beforealps | jurassicplateau
- geographicallocations: alonggrandtour | inthecountryside | inthemountains | atthelake | inthecity | inthealpinemountains | bytheriver | attheairport | centrallocation
- geographicalsituation: westswitzerland | swisscentralplateau | southernswitzerland | easternswitzerland | northernswitzerland

### Attractions:
- seasons: summer | winter | autumn | spring
- views: mountainview | panorama | flatlandview
- unesco: worldheritage | worldbiosphere (“UNESCO sites”)
- sporttype (activity themes): hike | skiingorsnowboarding | toboggan | sledging | climb | bathingandswimming | biking | riverrafting | bicycle | ebike | golfing | scooter | skicross | mountainbike | canyoning | paragliding | snowshoeing | ...
- difficulty: low | medium (“easy walks” → difficulty:low)
- neededtime: lessthan1hour | between12hours | 2to4hourshalfday | 4to8hoursfullday | severaldays | 2days | 3days | 4days | 7days
- childrenage: 0to5years | 6to9years | 10to13years | 14plus
- suitablefortype: family | children | couples | group | individual | womenonly
- experiencetype: nature | active | education | adventure | culture | urban | relax | culinary
- reachabilitylocation: closetopublictransport | attheskislope | bycar | bytrail ...

### Offers:
- offertype: hotelpartneroffers
- roomcategory: doubleroom | suite | priceperpersonindoubleroom | persingleroom | superiorroom

### Tours:
- outestypes (main activity): hike | mountainbike | bicycle | snowshoe | winterhiking | crosscountryskiing | sledging | skating | canoe
- routeCategory: Local | Regional | National
- requirementconditions: easy | medium | difficult
- gadmindurationoverall (duration buckets): less2h | 24h | 46h | more6h
- direction: roundtrip | disposable
- views: mountainview | panorama | flatlandview
- landscape: withpanoramicview | alongwater | overpass | ontoanalp | throughaswisspark | onmountainpeak | throughvineyard | ...
- seasons: winter | summer
- month (when month-specific): march | april | may | june | july | december | january | allyear
- reachabilitylocation: closetopublictransport | bycar
- geographicallocations: alonggrandtour | inthecountryside | inthemountains | inthealpinemountains | attheforest | bytheriver | atthelake | ...

## FACET SYNTAX
- Single: `facet.filter="seasons:summer"`
- AND: `facet.filter="seasons:summer,suitablefortype:family"`
- OR: `facet.filter="[sporttype:hike,sporttype:bicycle]"`

## INTENT → FACET MAPPING
- "family" → `suitablefortype:family`
- "easy" → `difficulty:low` or `requirementconditions:easy`
- "hiking" → `sporttype:hike`
- "summer/winter" → `seasons:summer|winter`

## QUERY CONSTRUCTION RULES
**ALWAYS follow this pattern:**
1. Extract location → geocode → get lat/lon
2. Extract theme/activity → map to facets
3. Extract time/season → add season facet
4. Extract difficulty/audience → add appropriate facets
5. Build complete query with ALL parameters
**BAD Example:**

searchAttractions(q="family", facets.translate=true)

**GOOD Example:**

searchAttractions(
  q="family activities",
  geodist="47.3769,8.5417,20",
  facet.filter="suitablefortype:family,experiencetype:[nature,active]",
  facets.translate=true,
  hitsPerPage=8
)

## OUTPUT FORMAT
Display as markdown list (5-8 items):

**[Title]**  
![alt]({imageUrl})
- **Type:** Destination/Attraction/Offer/Tour
- **Price:** (offers only) *From CHF XXX*
- **Highlight:** One-line key feature
- **Location:** [City/region name] (*~XX km from [query location]*)
- **Map:** [View on Map](https://www.openstreetmap.org/?mlat={lat}&mlon={lon}#map=14/{lat}/{lon})
- **Why it matches:** Brief relevance explanation
- **More info:** [Link]({canonicalUrl})

**Location examples:**
- ✅ "Gotthard region, Uri (~80 km from Zurich)"
- ❌ NOT "46.65°N, 8.59°E

**Image priority:** image.url → images[0].url → media[0].url → picture
**Style:**
- Use **bold** and *italic*
- Deduplicate by title
- Show distance when using geodist
- **NEVER show coordinates - always use place names**
- No follow-up questions
## LANGUAGE & SAFETY
- Match user's language via `lang` parameter
- Never fabricate data
- Infer best search when uncertain
- No booking/ticketing info

```

**Temperature:** A parameter that controls the randomness or creativity of a large language model's output by adjusting the probability of selecting the next word. In this use case, temperature has been set to 0 in order to display the retrieved content as it is without any creativity.

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-3.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=2dc7d5533d513809824a7e114843c721" width="772" height="513" data-path="images/Swiss-tourism-agent-3.png" />
</Frame>

### Step 2: Knowledge

Since it's a basic agent creation with single LLM call, we can skip the Knowledge section and also uncheck the all sources parameter.

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Knowledge.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=da144f90acbf9dc2e9661fb6cd2a7a41" width="790" height="696" data-path="images/Swiss-tourism-agent-Knowledge.png" />
</Frame>

### Step 3: Add the Function Calls

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-functions.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=2c5977fce2fa1dc28aa8b1b71dd3bdaf" width="785" height="846" data-path="images/Swiss-tourism-agent-functions.png" />
</Frame>

#### Function call - 1: `searchDestinations`

**Function Name:** searchDestinations

**Description:** Search Switzerland destinations with text, geo and facet filters; localized results, partial fields by default.

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-1-1.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=1e2ce697c29f3902b1e0d39a5ba36084" width="732" height="367" data-path="images/Swiss-tourism-agent-Function-1-1.png" />
</Frame>

**API Endpoint:** [https://opendata.myswitzerland.io/v1/destinations/](https://opendata.myswitzerland.io/v1/destinations/)

**Method:** `GET`

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-1-2.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=8ee7724dc75eda8e65a2408975bcc952" width="775" height="783" data-path="images/Swiss-tourism-agent-Function-1-2.png" />
</Frame>

**Headers:**

```json theme={null}
{
  "x-api-key": "YOUR_API_KEY"
}
```

**Parameters:**

```json theme={null}
{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Full-text query."
    },
    "bbox": {
      "type": "string",
      "description": "minLon,minLat,maxLon,maxLat"
    },
    "geodist": {
      "type": "string",
      "description": "lat,lon,radiusKm"
    },
    "facet.filter": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Facet filters."
    },
    "facets.translate": {
      "type": "boolean",
      "description": "Translate facet names/values."
    },
    "lang": {
      "type": "string",
      "default": "en"
    },
    "page": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "maximum": 5
    },
    "hitsPerPage": {
      "type": "integer",
      "default": 10,
      "minimum": 5
    }
  },
  "required": [],
  "additionalProperties": false
}
```

<Frame>
  <img src="https://mintcdn.com/innoq/uIOTfuqSMII6Mca4/images/Swiss-tourism-agent-Function-1-3.png?fit=max&auto=format&n=uIOTfuqSMII6Mca4&q=85&s=64948a4ad71b6c0154dd3687bb52292c" width="734" height="770" data-path="images/Swiss-tourism-agent-Function-1-3.png" />
</Frame>

#### Function call - 2: `searchAttractions`

**Function Name:** searchAttractions

**Description:** Search attractions (POIs, museums, guided events, etc.) with text, geo and facet filters; localized.

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-2-1.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=9e7dc355c2fd9638a5372929824d2583" width="733" height="373" data-path="images/Swiss-tourism-agent-Function-2-1.png" />
</Frame>

**API Endpoint:** [https://opendata.myswitzerland.io/v1/attractions/](https://opendata.myswitzerland.io/v1/attractions/)

**Method:** `GET`

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-2-2.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=17cabb6dad3803c10470f232148ba07f" width="741" height="253" data-path="images/Swiss-tourism-agent-Function-2-2.png" />
</Frame>

**Headers:**

```json theme={null}
{
  "x-api-key": "YOUR_API_KEY"
}
```

**Parameters:**

```json theme={null}
{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "bbox": {
      "type": "string",
      "description": "minLon,minLat,maxLon,maxLat"
    },
    "geodist": {
      "type": "string",
      "description": "lat,lon,radiusKm"
    },
    "facet.filter": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "facets.translate": {
      "type": "boolean"
    },
    "lang": {
      "type": "string",
      "default": "en"
    },
    "page": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "maximum": 5
    },
    "hitsPerPage": {
      "type": "integer",
      "default": 10,
      "minimum": 5
    }
  },
  "required": [],
  "additionalProperties": false
}
```

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-2-3.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=298585e87ebca50960685f9df5478294" width="726" height="756" data-path="images/Swiss-tourism-agent-Function-2-3.png" />
</Frame>

#### Function call - 3: `searchOffers`

**Function Name:** searchOffers

**Description:** Search tourism offers (e.g., deals/packages/tickets) using text; localized.

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-3-1.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=d3f65e18ca6c039eff60067c4ca82eda" width="731" height="357" data-path="images/Swiss-tourism-agent-Function-3-1.png" />
</Frame>

**API Endpoint:** [https://opendata.myswitzerland.io/v1/offers/](https://opendata.myswitzerland.io/v1/offers/)

**Method:** `GET`

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-3-2.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=35827e352467555e98c93498645fd293" width="736" height="268" data-path="images/Swiss-tourism-agent-Function-3-2.png" />
</Frame>

**Headers:**

```json theme={null}
{
  "x-api-key": "YOUR_API_KEY"
}
```

**Parameters:**

```json theme={null}
{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Full-text keyword search."
    },
    "lang": {
      "type": "string",
      "default": "en"
    },
    "facet.filter": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Facet filters."
    },
    "page": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "maximum": 5
    },
    "hitsPerPage": {
      "type": "integer",
      "default": 10,
      "minimum": 5
    }
  },
  "required": [],
  "additionalProperties": false
}
```

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-3-3.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=36b1d4b5ed369b45d84bab811b221d7a" width="735" height="760" data-path="images/Swiss-tourism-agent-Function-3-3.png" />
</Frame>

#### Function call - 4: `searchTours`

**Function Name:** searchTours

**Description:** Search Swiss tours or itineraries (e.g., hikes, bike routes) with filters and facets.

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-4-1.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=2f01ee0dbe5beda247c22a16a30fd1d6" width="737" height="360" data-path="images/Swiss-tourism-agent-Function-4-1.png" />
</Frame>

**API Endpoint:** [https://opendata.myswitzerland.io/v1/tours/](https://opendata.myswitzerland.io/v1/tours/)

**Method:** `GET`

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-4-2.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=d6e63a50aaa190e53fb4f9c290c236d8" width="733" height="272" data-path="images/Swiss-tourism-agent-Function-4-2.png" />
</Frame>

**Headers:**

```json theme={null}
{
  "x-api-key": "YOUR_API_KEY"
}
```

**Parameters:**

```json theme={null}
{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "bbox": {
      "type": "string",
      "description": "minLon,minLat,maxLon,maxLat"
    },
    "geodist": {
      "type": "string",
      "description": "lat,lon,radiusKm"
    },
    "facet.filter": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "facets.translate": {
      "type": "boolean"
    },
    "subtrip": {
      "type": "boolean"
    },
    "lang": {
      "type": "string",
      "default": "en"
    },
    "page": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "maximum": 5
    },
    "hitsPerPage": {
      "type": "integer",
      "default": 10,
      "minimum": 5
    }
  },
  "required": [],
  "additionalProperties": false
}
```

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-4-3.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=998cf2164cbba2f8f61b9c8c2203c4a7" width="727" height="757" data-path="images/Swiss-tourism-agent-Function-4-3.png" />
</Frame>

#### Function call - 5: `reverseGeocode`

**Function Name:** reverseGeocode

**Description:** Reverse geocode coordinates into a human-readable place label.

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-5-1.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=b679cf1c931a8ae1c722959e6e6ef624" width="727" height="350" data-path="images/Swiss-tourism-agent-Function-5-1.png" />
</Frame>

**API Endpoint:** [https://geocode.maps.co/reverse?lat=example\&lon=example\&api\_key=YOUR\_API\_KEY](https://geocode.maps.co/reverse?lat=example\&lon=example\&api_key=YOUR_API_KEY)

**Method:** `GET`

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-5-2.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=0fb0948881dc02d0777a7be648d8ef45" width="722" height="264" data-path="images/Swiss-tourism-agent-Function-5-2.png" />
</Frame>

**Headers:**

```json theme={null}
{
  "Authorization": "Bearer YOUR_API_KEY"
}
```

**Parameters:**

```json theme={null}
{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "description": "Latitude in decimal degrees"
    },
    "lon": {
      "type": "number",
      "description": "Longitude in decimal degrees"
    }
  },
  "required": [
    "lat",
    "lon"
  ]
}
```

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-5-3.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=e7fb65e4225263a4b0978c49261a88de" width="713" height="756" data-path="images/Swiss-tourism-agent-Function-5-3.png" />
</Frame>

#### Function call - 6: `forwardGeocode`

**Function Name:** forwardGeocode

**Description:** Resolve a place name to geographic coordinates and a display label.

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-6-1.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=f6d38401a2f2cbec380ba7c11b76a025" width="731" height="356" data-path="images/Swiss-tourism-agent-Function-6-1.png" />
</Frame>

**API Endpoint:** [https://geocode.maps.co/search?q=address\&api\_key=YOUR\_API\_KEY](https://geocode.maps.co/search?q=address\&api_key=YOUR_API_KEY)

**Method:** `GET`

<Frame>
  <img src="https://mintcdn.com/innoq/1sduE_niDSWqWNJh/images/Swiss-tourism-agent-Function-6-2.png?fit=max&auto=format&n=1sduE_niDSWqWNJh&q=85&s=f61d3643f907612dd51351c6e2cdddf4" width="718" height="269" data-path="images/Swiss-tourism-agent-Function-6-2.png" />
</Frame>

**Headers:**

```json theme={null}
{
  "Authorization": "Bearer YOUR_API_KEY"
}
```

**Parameters:**

```json theme={null}
{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free-text place query (e.g., 'Zermatt', 'Rue de Bourg 3, Lausanne, CH'). Use this for simple queries. If provided, do not use structured fields (street, city, etc.)."
    },
    "street": {
      "type": "string",
      "description": "House number + street, e.g., '10 Bahnhofstrasse'. Use with city and country for structured search."
    },
    "city": {
      "type": "string",
      "description": "City or town name. Use with country for structured search."
    },
    "county": {
      "type": "string",
      "description": "County / district (optional)."
    },
    "state": {
      "type": "string",
      "description": "State / canton / region (optional)."
    },
    "country": {
      "type": "string",
      "description": "Country name or ISO code (e.g., 'CH'). Required when using structured search."
    },
    "postalcode": {
      "type": "string",
      "description": "Postal or ZIP code (optional)."
    },
    "format": {
      "type": "string",
      "enum": [
        "json",
        "xml",
        "jsonv2",
        "geojson",
        "geocodejson"
      ],
      "default": "json",
      "description": "Response format."
    }
  },
  "additionalProperties": false
}
```

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/innoq/images/Swiss--agent-Function-6-3.png" />
</Frame>

## **Example**

<Frame>
  <img src="https://mintcdn.com/innoq/D5VpNjXK0NDYG45V/images/Swiss-tourism-agent-example.png?fit=max&auto=format&n=D5VpNjXK0NDYG45V&q=85&s=266af7df8f8194dca757d4cc8e4ba4fe" width="1596" height="755" data-path="images/Swiss-tourism-agent-example.png" />
</Frame>

## **Summary**

| **Feature**        | **Description**                                                                                                  |
| ------------------ | ---------------------------------------------------------------------------------------------------------------- |
| **Level**          | Advanced                                                                                                         |
| **Agents**         | 1                                                                                                                |
| **Function Calls** | 6 (`searchDestinations`, `searchAttractions`, `searchOffers`, `searchTours`, `forwardGeocode`, `reverseGeocode`) |
| **Goal**           | Surface real destinations, attractions, offers, and tours                                                        |
| **Output**         | Concise human-readable summaries                                                                                 |