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

# here

> HERE Geocoding & Search

**Server path:** `/here` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                            | Description                 |
| ----------------------------------------------- | --------------------------- |
| [`here_autocomplete`](#here_autocomplete)       | Autocomplete an address     |
| [`here_autosuggest`](#here_autosuggest)         | Get search suggestions      |
| [`here_browse`](#here_browse)                   | Browse places by category   |
| [`here_discover`](#here_discover)               | Search for places           |
| [`here_geocode`](#here_geocode)                 | Geocode an address          |
| [`here_lookup`](#here_lookup)                   | Look up a place by ID       |
| [`here_reverse_geocode`](#here_reverse_geocode) | Reverse geocode coordinates |

***

## here\_autocomplete

Autocomplete an address

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                                                |
| --------- | ------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
| `q`       | string  | Yes      | —       | Partial text query to autocomplete.                                                                                        |
| `at`      | string  | No       | —       | Center of the search context as lat,lon coordinates.                                                                       |
| `in`      | string  | No       | —       | Geographic filter. Formats: countryCode:\{ISO3}, circle:\{lat},\{lon};r=\{meters}, bbox:\{west},\{south},\{east},\{north}. |
| `types`   | string  | No       | —       | Filter result types. Comma-separated values: address, area, city, houseNumber, postalCode, street.                         |
| `lang`    | string  | No       | —       | Response language as BCP 47 code.                                                                                          |
| `limit`   | integer | No       | —       | Maximum number of results. Range: 1-20. Default: 5.                                                                        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "q": {
        "type": "string",
        "description": "Partial text query to autocomplete."
      },
      "at": {
        "type": "string",
        "description": "Center of the search context as lat,lon coordinates."
      },
      "in": {
        "type": "string",
        "description": "Geographic filter. Formats: countryCode:{ISO3}, circle:{lat},{lon};r={meters}, bbox:{west},{south},{east},{north}."
      },
      "types": {
        "type": "string",
        "description": "Filter result types. Comma-separated values: address, area, city, houseNumber, postalCode, street."
      },
      "lang": {
        "type": "string",
        "description": "Response language as BCP 47 code."
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of results. Range: 1-20. Default: 5."
      }
    },
    "required": [
      "PCID",
      "q"
    ]
  }
  ```
</Expandable>

***

## here\_autosuggest

Get search suggestions

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                                                                                |
| ------------ | ------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
| `q`          | string  | Yes      | —       | Free-text query, can be partial or misspelled.                                                                             |
| `at`         | string  | No       | —       | Center of the search context as lat,lon coordinates.                                                                       |
| `in`         | string  | No       | —       | Geographic filter. Formats: countryCode:\{ISO3}, circle:\{lat},\{lon};r=\{meters}, bbox:\{west},\{south},\{east},\{north}. |
| `termsLimit` | integer | No       | —       | Maximum number of query term suggestions. Range: 0-10.                                                                     |
| `lang`       | string  | No       | —       | Response language as BCP 47 code.                                                                                          |
| `limit`      | integer | No       | —       | Maximum number of results. Range: 1-100. Default: 20.                                                                      |
| `show`       | string  | No       | —       | Additional response fields. Comma-separated values: details, phonemes, streetInfo, tz.                                     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "q": {
        "type": "string",
        "description": "Free-text query, can be partial or misspelled."
      },
      "at": {
        "type": "string",
        "description": "Center of the search context as lat,lon coordinates."
      },
      "in": {
        "type": "string",
        "description": "Geographic filter. Formats: countryCode:{ISO3}, circle:{lat},{lon};r={meters}, bbox:{west},{south},{east},{north}."
      },
      "termsLimit": {
        "type": "integer",
        "description": "Maximum number of query term suggestions. Range: 0-10."
      },
      "lang": {
        "type": "string",
        "description": "Response language as BCP 47 code."
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of results. Range: 1-100. Default: 20."
      },
      "show": {
        "type": "string",
        "description": "Additional response fields. Comma-separated values: details, phonemes, streetInfo, tz."
      }
    },
    "required": [
      "PCID",
      "q"
    ]
  }
  ```
</Expandable>

***

## here\_browse

Browse places by category

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                                                                                |
| ------------ | ------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
| `at`         | string  | Yes      | —       | Center of the search as lat,lon coordinates.                                                                               |
| `categories` | string  | No       | —       | Filter by HERE category IDs, comma-separated. Prefix with ! to exclude.                                                    |
| `chains`     | string  | No       | —       | Filter by HERE chain IDs, comma-separated. Prefix with ! to exclude.                                                       |
| `foodTypes`  | string  | No       | —       | Filter by cuisine IDs, comma-separated. Prefix with ! to exclude.                                                          |
| `name`       | string  | No       | —       | Filter places by partial name match.                                                                                       |
| `in`         | string  | No       | —       | Geographic filter. Formats: countryCode:\{ISO3}, circle:\{lat},\{lon};r=\{meters}, bbox:\{west},\{south},\{east},\{north}. |
| `lang`       | string  | No       | —       | Response language as BCP 47 code.                                                                                          |
| `limit`      | integer | No       | —       | Maximum number of results. Range: 1-100. Default: 20.                                                                      |
| `show`       | string  | No       | —       | Additional response fields. Comma-separated values: phonemes, streetInfo, tz.                                              |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "at": {
        "type": "string",
        "description": "Center of the search as lat,lon coordinates."
      },
      "categories": {
        "type": "string",
        "description": "Filter by HERE category IDs, comma-separated. Prefix with ! to exclude."
      },
      "chains": {
        "type": "string",
        "description": "Filter by HERE chain IDs, comma-separated. Prefix with ! to exclude."
      },
      "foodTypes": {
        "type": "string",
        "description": "Filter by cuisine IDs, comma-separated. Prefix with ! to exclude."
      },
      "name": {
        "type": "string",
        "description": "Filter places by partial name match."
      },
      "in": {
        "type": "string",
        "description": "Geographic filter. Formats: countryCode:{ISO3}, circle:{lat},{lon};r={meters}, bbox:{west},{south},{east},{north}."
      },
      "lang": {
        "type": "string",
        "description": "Response language as BCP 47 code."
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of results. Range: 1-100. Default: 20."
      },
      "show": {
        "type": "string",
        "description": "Additional response fields. Comma-separated values: phonemes, streetInfo, tz."
      }
    },
    "required": [
      "PCID",
      "at"
    ]
  }
  ```
</Expandable>

***

## here\_discover

Search for places

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                                                |
| --------- | ------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
| `q`       | string  | Yes      | —       | Free-text search query for places, addresses, or categories.                                                               |
| `at`      | string  | No       | —       | Center of the search context as lat,lon coordinates.                                                                       |
| `in`      | string  | No       | —       | Geographic filter. Formats: countryCode:\{ISO3}, circle:\{lat},\{lon};r=\{meters}, bbox:\{west},\{south},\{east},\{north}. |
| `lang`    | string  | No       | —       | Response language as BCP 47 code.                                                                                          |
| `limit`   | integer | No       | —       | Maximum number of results. Range: 1-100. Default: 20.                                                                      |
| `show`    | string  | No       | —       | Additional response fields. Comma-separated values: phonemes, streetInfo, tz.                                              |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "q": {
        "type": "string",
        "description": "Free-text search query for places, addresses, or categories."
      },
      "at": {
        "type": "string",
        "description": "Center of the search context as lat,lon coordinates."
      },
      "in": {
        "type": "string",
        "description": "Geographic filter. Formats: countryCode:{ISO3}, circle:{lat},{lon};r={meters}, bbox:{west},{south},{east},{north}."
      },
      "lang": {
        "type": "string",
        "description": "Response language as BCP 47 code."
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of results. Range: 1-100. Default: 20."
      },
      "show": {
        "type": "string",
        "description": "Additional response fields. Comma-separated values: phonemes, streetInfo, tz."
      }
    },
    "required": [
      "PCID",
      "q"
    ]
  }
  ```
</Expandable>

***

## here\_geocode

Geocode an address

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                                                                                                              |
| --------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `q`       | string  | No       | —       | Free-text address or place query. Either q or qq is required.                                                                                                                            |
| `qq`      | string  | No       | —       | Structured address query using semicolon-separated key=value pairs. Supported keys: country, state, county, city, district, street, houseNumber, postalCode. Either q or qq is required. |
| `at`      | string  | No       | —       | Center of the search context as lat,lon coordinates.                                                                                                                                     |
| `in`      | string  | No       | —       | Geographic filter. Formats: countryCode:\{ISO3} (e.g. countryCode:DEU), countryCode:\{ISO3},\{ISO3} for multiple countries.                                                              |
| `types`   | string  | No       | —       | Filter result types. Comma-separated values: address, area, city, houseNumber, place, postalCode, street.                                                                                |
| `lang`    | string  | No       | —       | Response language as BCP 47 code (e.g. en-US, de).                                                                                                                                       |
| `limit`   | integer | No       | —       | Maximum number of results to return. Range: 1-100. Default: 20.                                                                                                                          |
| `show`    | string  | No       | —       | Additional response fields to include. Comma-separated values: countryInfo, parsing, postalCodeDetails, streetInfo, tz.                                                                  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "q": {
        "type": "string",
        "description": "Free-text address or place query. Either q or qq is required."
      },
      "qq": {
        "type": "string",
        "description": "Structured address query using semicolon-separated key=value pairs. Supported keys: country, state, county, city, district, street, houseNumber, postalCode. Either q or qq is required."
      },
      "at": {
        "type": "string",
        "description": "Center of the search context as lat,lon coordinates."
      },
      "in": {
        "type": "string",
        "description": "Geographic filter. Formats: countryCode:{ISO3} (e.g. countryCode:DEU), countryCode:{ISO3},{ISO3} for multiple countries."
      },
      "types": {
        "type": "string",
        "description": "Filter result types. Comma-separated values: address, area, city, houseNumber, place, postalCode, street."
      },
      "lang": {
        "type": "string",
        "description": "Response language as BCP 47 code (e.g. en-US, de)."
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of results to return. Range: 1-100. Default: 20."
      },
      "show": {
        "type": "string",
        "description": "Additional response fields to include. Comma-separated values: countryInfo, parsing, postalCodeDetails, streetInfo, tz."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## here\_lookup

Look up a place by ID

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                                                   |
| --------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------- |
| `id`      | string | Yes      | —       | HERE place or location ID obtained from a prior search, geocode, or browse response.                          |
| `lang`    | string | No       | —       | Response language as BCP 47 code.                                                                             |
| `show`    | string | No       | —       | Additional response fields. Comma-separated values: countryInfo, phonemes, postalCodeDetails, streetInfo, tz. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "HERE place or location ID obtained from a prior search, geocode, or browse response."
      },
      "lang": {
        "type": "string",
        "description": "Response language as BCP 47 code."
      },
      "show": {
        "type": "string",
        "description": "Additional response fields. Comma-separated values: countryInfo, phonemes, postalCodeDetails, streetInfo, tz."
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## here\_reverse\_geocode

Reverse geocode coordinates

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                                         |
| --------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------- |
| `at`      | string  | Yes      | —       | Coordinates to reverse geocode as lat,lon.                                                          |
| `types`   | string  | No       | —       | Filter result types. Comma-separated values: address, area, city, houseNumber, place, street.       |
| `lang`    | string  | No       | —       | Response language as BCP 47 code.                                                                   |
| `limit`   | integer | No       | —       | Maximum number of results. Range: 1-100. Default: 1.                                                |
| `show`    | string  | No       | —       | Additional response fields. Comma-separated values: countryInfo, postalCodeDetails, streetInfo, tz. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "at": {
        "type": "string",
        "description": "Coordinates to reverse geocode as lat,lon."
      },
      "types": {
        "type": "string",
        "description": "Filter result types. Comma-separated values: address, area, city, houseNumber, place, street."
      },
      "lang": {
        "type": "string",
        "description": "Response language as BCP 47 code."
      },
      "limit": {
        "type": "integer",
        "description": "Maximum number of results. Range: 1-100. Default: 1."
      },
      "show": {
        "type": "string",
        "description": "Additional response fields. Comma-separated values: countryInfo, postalCodeDetails, streetInfo, tz."
      }
    },
    "required": [
      "PCID",
      "at"
    ]
  }
  ```
</Expandable>