> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to HERE

The HERE connector lets your AI agent act in each user's HERE account. Each user connects their own HERE API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 26 tools.

**Authentication:** API Key
**Categories:** Search, Analytics
**Tools:** 26: 26 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=HERE)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the HERE connection

   In **AgentKit > Connections**, create a HERE connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'here'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize HERE:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'here_geocode',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "here"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize HERE:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="here_geocode",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their HERE credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'here_address_autocomplete',
  toolInput: {
    q: '<q>',
  },
  connector: 'here',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="here_address_autocomplete",
    tool_input={
        "q": "<q>",
    },
    connection_name="here",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `here_address_autocomplete`

Autocomplete Address · Read-only

Complete a partial address entry into full address candidates. Returns items with title, id, resultType, address and highlighting. Use this for address forms. Use here_places_autosuggest when places should be included.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Partial address text. Example: Invalidenstraße 1.
- `at` (`string`, optional): Position as latitude,longitude to bias results toward. Example: 52.5308,13.3847.
- `in` (`string`, optional): Area filter: countryCode:<ISO 3166-1 alpha-3 list>, circle:lat,lng;r=<meters>, or bbox:west,south,east,north. Example: countryCode:USA,CAN.
- `lang` (`string`, optional): BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
- `limit` (`integer`, optional): Maximum number of results (1-100, default 20). Example: 10.
- `political_view` (`string`, optional): ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
- `types` (`string`, optional): Result types to return, comma-separated: address, area, city, houseNumber, postalCode, street. Example: houseNumber,street.

Example input: `{"q":"<q>"}`

### `here_geocode`

Geocode Address · Read-only

Convert a free-form or qualified address or place into coordinates, with the normalized address and match quality. Returns items with title, id, resultType, address, position (lat, lng), mapView and scoring. Use this for a known address. Use here_places_discover to search places by name or category, or here_reverse_geocode for coordinates to address.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `at` (`string`, optional): Position as latitude,longitude to bias results toward. Example: 52.5308,13.3847.
- `in` (`string`, optional): Area filter: countryCode:<ISO 3166-1 alpha-3 list>, circle:lat,lng;r=<meters>, or bbox:west,south,east,north. Example: countryCode:USA,CAN.
- `lang` (`string`, optional): BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
- `limit` (`integer`, optional): Maximum number of results (1-100, default 20). Example: 10.
- `political_view` (`string`, optional): ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
- `q` (`string`, optional): Free-form address query. Provide q or qq. Example: Invalidenstr 117 Berlin.
- `qq` (`string`, optional): Qualified query: key=value pairs separated by ; with keys country, state, county, city, district, street, houseNumber, postalCode. Example: houseNumber=117;street=Invalidenstr;city=Berlin.
- `show` (`string`, optional): Extra sections, comma-separated: countryInfo, parsing, streetInfo, tz. Example: tz,streetInfo.
- `types` (`string`, optional): Result types to return, comma-separated: address, area, city, houseNumber, postalCode, street. Example: houseNumber,street.

Example input: `{}`

### `here_intermodal_routes_calculate`

Calculate Intermodal Route · Read-only

Calculate routes that combine public transit with car (park and ride), taxi, rented vehicles, bicycle or walking. Returns routes with sections per mode, times, places and optional polyline and travel summary. Use this for mixed-mode trips. Use here_transit_routes_calculate for transit only or here_routes_calculate for driving.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `destination` (`string`, required): End as latitude,longitude. Example: 52.5005,13.4489.
- `origin` (`string`, required): Start as latitude,longitude. Example: 52.5307,13.3847.
- `alternatives` (`integer`, optional): Number of alternative routes. Example: 2.
- `changes` (`integer`, optional): Maximum number of transit changes. Example: 3.
- `departure_time` (`string`, optional): Departure time, RFC 3339 date-time; use any to ignore traffic. Defaults to now. Example: 2026-01-15T08:30:00+01:00.
- `lang` (`string`, optional): BCP 47 language. Example: en-US.
- `rented_enable` (`string`, optional): Where rented vehicles may be used: routeHead, routeTail and/or entireRoute. Example: routeHead.
- `return` (`string`, optional): Sections to return, comma-separated: polyline, actions, travelSummary. Example: travelSummary,polyline.
- `taxi_enable` (`string`, optional): Where a taxi may be used: routeHead, routeTail and/or entireRoute. Example: routeTail.
- `units` (`string`, optional): Unit system for instructions: metric (default) or imperial. Example: metric. One of: `metric`, `imperial`.
- `vehicle_enable` (`string`, optional): Where a private car may be used: routeHead, routeTail and/or entireRoute, comma-separated. Example: routeHead.

Example input: `{"destination":"<destination>","origin":"<origin>"}`

### `here_isolines_calculate`

Calculate Isolines · Read-only

Calculate the area reachable from an origin (or that can reach a destination) within given travel times, distances or energy budgets. Returns isolines per range value with polygons as encoded flexible polylines, plus departure/arrival place. Use this for reachability or service-area questions. Use here_routes_calculate for a single route.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `range_type` (`string`, required): What the range values measure. Example: time. One of: `distance`, `time`, `consumption`.
- `range_values` (`string`, required): Comma-separated range values: seconds for time, meters for distance, Wh for consumption. Example: 600,1200.
- `transport_mode` (`string`, required): Mode of transport. Example: car. One of: `car`, `truck`, `pedestrian`, `bicycle`, `scooter`, `taxi`, `bus`, `privateBus`.
- `avoid_features` (`string`, optional): Features to avoid, comma-separated: tollRoad, controlledAccessHighway, ferry, carShuttleTrain, tunnel, dirtRoad, difficultTurns, uTurns. Example: tollRoad,ferry.
- `departure_time` (`string`, optional): Departure time, RFC 3339 date-time; use any to ignore traffic. Defaults to now. Example: 2026-01-15T08:30:00+01:00.
- `destination` (`string`, optional): Center as latitude,longitude (isolines to here). Example: 52.5308,13.3847.
- `optimize_for` (`string`, optional): quality, performance or balanced. Example: balanced. One of: `quality`, `performance`, `balanced`.
- `origin` (`string`, optional): Center as latitude,longitude (isolines from here). Provide origin or destination. Example: 52.5308,13.3847.
- `routing_mode` (`string`, optional): fast (default) or short. Example: fast. One of: `fast`, `short`.
- `shape_max_points` (`integer`, optional): Maximum points per isoline polygon. Example: 200.

Example input: `{"range_type":"distance","range_values":"<range_values>","transport_mode":"car"}`

### `here_matrix_calculate`

Calculate Route Matrix · Read-only

Calculate travel times and/or distances between every origin and destination. With async=false the matrix is returned directly; otherwise poll the status. Returns matrix with numOrigins, numDestinations, travelTimes and/or distances arrays (sync), or matrixId and status (async). Use this for many-to-many travel times. Use here_routes_calculate for directions between two points.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `origins` (`array`, required): Origins, each an object with lat and lng. Example: [{"lat": 52.5308, "lng": 13.3847}, {"lat": 52.5200, "lng": 13.4050}]
- `region_definition` (`object`, required): Area the calculation may use: {"type": "world"} (needs a profile or flexible mode), {"type": "autoCircle"}, a circle, a boundingBox or a polygon. Example: {"type": "autoCircle", "margin": 10000}
- `async` (`boolean`, optional): false for a synchronous response (small matrices); true (default) to queue and poll here_matrix_status_get. Example: false.
- `departure_time` (`string`, optional): RFC 3339 departure time, or any for time-independent results. Example: any.
- `destinations` (`array`, optional): Destinations, each an object with lat and lng. Defaults to the origins. Example: [{"lat": 52.5264, "lng": 13.3686}]
- `matrix_attributes` (`array`, optional): What to return: travelTimes and/or distances. Example: ["travelTimes", "distances"]
- `profile` (`string`, optional): Predefined profile ID from here_matrix_profiles_list (needed with a world region). Example: carFast.
- `routing_mode` (`string`, optional): fast or short. Example: fast. One of: `fast`, `short`.
- `transport_mode` (`string`, optional): Mode of transport (default car). Example: car. One of: `car`, `truck`, `pedestrian`, `bicycle`, `scooter`, `taxi`, `bus`, `privateBus`.

Example input: `{"origins":[{"lat":52.5308,"lng":13.3847},{"lat":52.52,"lng":13.405}],"region_definition":{"type":"autoCircle","margin":10000}}`

### `here_matrix_profile_get`

Get Matrix Profile · Read-only

Get one predefined matrix profile. Returns the profile's transport mode, routing mode and vehicle options. Use this to check a profile before using it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `profile_id` (`string`, required): Profile ID from here_matrix_profiles_list. Example: carFast.

Example input: `{"profile_id":"<profile_id>"}`

### `here_matrix_profiles_list`

List Matrix Profiles · Read-only

List the predefined routing profiles for world-wide matrix calculations. Returns profiles with id, transportMode and options. Use this to pick a profile for here_matrix_calculate.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `here_matrix_result_get`

Get Matrix Result · Read-only

Get the result of a completed asynchronous matrix calculation. Returns matrix with travelTimes and/or distances arrays and any errorCodes. Use this once here_matrix_status_get reports completed.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `matrix_id` (`string`, required): Matrix ID from here_matrix_calculate. Example: b2a3c4d5-e6f7-4890-a1b2-c3d4e5f60718.

Example input: `{"matrix_id":"<matrix_id>"}`

### `here_matrix_status_get`

Get Matrix Status · Read-only

Get the status of an asynchronous matrix calculation. Returns matrixId, status (accepted, inProgress, completed, failed) and resultUrl when completed. Use this to poll after here_matrix_calculate with async=true, then here_matrix_result_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `matrix_id` (`string`, required): Matrix ID from here_matrix_calculate. Example: b2a3c4d5-e6f7-4890-a1b2-c3d4e5f60718.

Example input: `{"matrix_id":"<matrix_id>"}`

### `here_place_lookup`

Look Up Place · Read-only

Get one place or address by its HERE ID from a search result. Returns the place with title, address, position, categories, contacts, openingHours and references. Use this to refresh a result from here_places_discover or here_geocode by id.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): HERE ID of a place or location. Example: here:pds:place:276u33db-8097f3194e4b411081b761ea9a366776.
- `lang` (`string`, optional): BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
- `political_view` (`string`, optional): ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
- `show` (`string`, optional): Extra sections to render, comma-separated, e.g. details, tz, phonemes, streetInfo. Example: details,tz.

Example input: `{"id":"<id>"}`

### `here_places_autosuggest`

Autosuggest Places · Read-only

Suggest places, addresses and query completions for a partial or misspelled query, for type-ahead search. Returns items (place, address, categoryQuery or chainQuery) with title, id, position and highlighting, plus query terms. Use this while the user types. Use here_places_discover for the final search, or here_address_autocomplete for addresses only.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Partial query text. Example: Eiffel tow.
- `at` (`string`, optional): Search center as latitude,longitude. Results are ranked by distance from it. Example: 52.5308,13.3847.
- `in` (`string`, optional): Area filter: countryCode:<ISO 3166-1 alpha-3 list>, circle:lat,lng;r=<meters>, or bbox:west,south,east,north. Example: countryCode:USA,CAN.
- `lang` (`string`, optional): BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
- `limit` (`integer`, optional): Maximum number of results (1-100, default 20). Example: 10.
- `political_view` (`string`, optional): ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
- `show` (`string`, optional): Extra sections to render, comma-separated, e.g. details, tz, phonemes, streetInfo. Example: details,tz.
- `terms_limit` (`integer`, optional): Maximum number of query-term suggestions (0-10). Example: 3.

Example input: `{"q":"<q>"}`

### `here_places_browse`

Browse Places · Read-only

List places around a position filtered by HERE category IDs, chain IDs, food types or name, ranked by distance. Returns items with title, id, address, position, distance, categories, chains, contacts and openingHours. Use this for 'restaurants near here' style lists. Use here_places_discover for free-text search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `at` (`string`, required): Search center as latitude,longitude. Results are ranked by distance from it. Example: 52.5308,13.3847.
- `categories` (`string`, optional): HERE category IDs, comma-separated (e.g. 100-1000-0000 restaurant, 700-7600-0116 petrol station). Example: 100-1000-0000.
- `chains` (`string`, optional): HERE chain IDs, comma-separated. Example: 1566.
- `food_types` (`string`, optional): HERE cuisine IDs, comma-separated. Example: 101-000.
- `in` (`string`, optional): Area filter: countryCode:<ISO 3166-1 alpha-3 list>, circle:lat,lng;r=<meters>, or bbox:west,south,east,north. Example: countryCode:USA,CAN.
- `lang` (`string`, optional): BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
- `limit` (`integer`, optional): Maximum number of results (1-100, default 20). Example: 10.
- `name` (`string`, optional): Filter by place name. Example: Starbucks.
- `political_view` (`string`, optional): ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
- `show` (`string`, optional): Extra sections to render, comma-separated, e.g. details, tz, phonemes, streetInfo. Example: details,tz.

Example input: `{"at":"<at>"}`

### `here_places_discover`

Discover Places · Read-only

Search for places and addresses with a free-text query (a name, category or address) near a position or in an area. Returns items with title, id, resultType, address, position, distance, categories, contacts and openingHours. Use this for a full search query. Use here_places_autosuggest for type-ahead, or here_places_browse to list places by category.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Free-text query. Example: coffee shop.
- `at` (`string`, optional): Search center as latitude,longitude. Results are ranked by distance from it. Example: 52.5308,13.3847.
- `in` (`string`, optional): Area filter: countryCode:<ISO 3166-1 alpha-3 list>, circle:lat,lng;r=<meters>, or bbox:west,south,east,north. Example: countryCode:USA,CAN.
- `lang` (`string`, optional): BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
- `limit` (`integer`, optional): Maximum number of results (1-100, default 20). Example: 10.
- `political_view` (`string`, optional): ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
- `show` (`string`, optional): Extra sections to render, comma-separated, e.g. details, tz, phonemes, streetInfo. Example: details,tz.

Example input: `{"q":"<q>"}`

### `here_reverse_geocode`

Reverse Geocode · Read-only

Find the nearest address or place for a coordinate. Returns items with title, address, position, distance and resultType. Use this for coordinates to address. Use here_geocode for address to coordinates.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `at` (`string`, required): Coordinate as latitude,longitude. Example: 52.5308,13.3847.
- `bearing` (`integer`, optional): Direction of travel in degrees (0 = north) to prefer the side of the street. Example: 90.
- `lang` (`string`, optional): BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
- `limit` (`integer`, optional): Maximum number of results (1-100, default 20). Example: 10.
- `political_view` (`string`, optional): ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
- `show` (`string`, optional): Extra sections, comma-separated: countryInfo, streetInfo, tz. Example: tz.
- `types` (`string`, optional): Result types to return, comma-separated: address, area, city, houseNumber, postalCode, street. Example: houseNumber,street.

Example input: `{"at":"<at>"}`

### `here_route_get_by_handle`

Get Route by Handle · Read-only

Recalculate a previously returned route from its route handle (return=routeHandle), e.g. with fresh traffic. Returns the route with the requested sections. Use this after here_routes_calculate with return=routeHandle.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `route_handle` (`string`, required): Route handle from a previous routes response. Example: AFDAQQoDaXVyWg4BAwAAAG4BLC0AAAAz.
- `transport_mode` (`string`, required): Mode of transport. Example: car. One of: `car`, `truck`, `pedestrian`, `bicycle`, `scooter`, `taxi`, `bus`, `privateBus`.
- `departure_time` (`string`, optional): Departure time, RFC 3339 date-time; use any to ignore traffic. Defaults to now. Example: 2026-01-15T08:30:00+01:00.
- `lang` (`string`, optional): BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
- `origin` (`string`, optional): Current position as latitude,longitude to recalculate from. Example: 52.5308,13.3847.
- `return` (`string`, optional): Sections to return, comma-separated: summary, polyline, actions, instructions, travelSummary, turnByTurnActions, elevation, routeHandle, incidents, tolls, routingZones, typicalDuration, passthrough, mlDuration, potentialTimeDependentViolations. Example: summary,polyline,actions,instructions.
- `spans` (`string`, optional): Span attributes to return along the route, comma-separated, e.g. names, speedLimit, length, duration, countryCode. Example: names,speedLimit.
- `units` (`string`, optional): Unit system for instructions: metric (default) or imperial. Example: metric. One of: `metric`, `imperial`.

Example input: `{"route_handle":"<route_handle>","transport_mode":"car"}`

### `here_route_import`

Import Route from Trace · Read-only

Match a sequence of GPS trace points to the road network and build a route from it. Returns routes with sections, summary and the requested return attributes, plus any notices about unmatched points. Use this to turn a recorded GPS track into a route. Use here_routes_calculate to plan a new one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `trace` (`array`, required): Trace points in order, each an object with lat and lng (optional heading, speed, timestamp). Example: [{"lat": 52.5308, "lng": 13.3847}, {"lat": 52.5264, "lng": 13.3686}]
- `transport_mode` (`string`, required): Mode of transport. Example: car. One of: `car`, `truck`, `pedestrian`, `bicycle`, `scooter`, `taxi`, `bus`, `privateBus`.
- `departure_time` (`string`, optional): Departure time, RFC 3339 date-time; use any to ignore traffic. Defaults to now. Example: 2026-01-15T08:30:00+01:00.
- `return` (`string`, optional): Sections to return, comma-separated: summary, polyline, actions, instructions, travelSummary, turnByTurnActions, elevation, routeHandle, incidents, tolls, routingZones, typicalDuration, passthrough, mlDuration, potentialTimeDependentViolations. Example: summary,polyline,actions,instructions.
- `spans` (`string`, optional): Span attributes to return along the route, comma-separated, e.g. names, speedLimit, length, duration, countryCode. Example: names,speedLimit.
- `units` (`string`, optional): Unit system for instructions: metric (default) or imperial. Example: metric. One of: `metric`, `imperial`.

Example input: `{"trace":[{"lat":52.5308,"lng":13.3847},{"lat":52.5264,"lng":13.3686}],"transport_mode":"car"}`

### `here_routes_calculate`

Calculate Route · Read-only

Calculate a route between an origin and destination, optionally via waypoints, for car, truck, pedestrian, bicycle, scooter, taxi or bus, with traffic-aware timing. Returns routes with sections (departure, arrival, transport, summary with duration and length, polyline, actions and turn instructions when requested). Use this for A-to-B directions. Use here_transit_routes_calculate for public transport and here_matrix_calculate for many-to-many travel times.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `destination` (`string`, required): End as latitude,longitude. Example: 52.5264,13.3686.
- `origin` (`string`, required): Start as latitude,longitude. Example: 52.5308,13.3847.
- `transport_mode` (`string`, required): Mode of transport. Example: car. One of: `car`, `truck`, `pedestrian`, `bicycle`, `scooter`, `taxi`, `bus`, `privateBus`.
- `alternatives` (`integer`, optional): Number of alternative routes (0-6). Example: 1.
- `arrival_time` (`string`, optional): Arrival time, RFC 3339 date-time (cannot be combined with departure_time). Example: 2026-01-15T09:30:00+01:00.
- `avoid_areas` (`string`, optional): Areas to avoid, separated by |, each bbox:west,south,east,north or polygon:lat,lng;lat,lng;... Example: bbox:13.082,52.416,13.628,52.626.
- `avoid_features` (`string`, optional): Features to avoid, comma-separated: tollRoad, controlledAccessHighway, ferry, carShuttleTrain, tunnel, dirtRoad, difficultTurns, uTurns. Example: tollRoad,ferry.
- `currency` (`string`, optional): ISO 4217 currency for toll costs. Example: EUR.
- `departure_time` (`string`, optional): Departure time, RFC 3339 date-time; use any to ignore traffic. Defaults to now. Example: 2026-01-15T08:30:00+01:00.
- `lang` (`string`, optional): BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
- `return` (`string`, optional): Sections to return, comma-separated: summary, polyline, actions, instructions, travelSummary, turnByTurnActions, elevation, routeHandle, incidents, tolls, routingZones, typicalDuration, passthrough, mlDuration, potentialTimeDependentViolations. Example: summary,polyline,actions,instructions.
- `routing_mode` (`string`, optional): fast (default) or short. Example: fast. One of: `fast`, `short`.
- `spans` (`string`, optional): Span attributes to return along the route, comma-separated, e.g. names, speedLimit, length, duration, countryCode. Example: names,speedLimit.
- `units` (`string`, optional): Unit system for instructions: metric (default) or imperial. Example: metric. One of: `metric`, `imperial`.
- `vehicle_gross_weight` (`integer`, optional): Vehicle gross weight in kilograms (truck routing). Example: 18000.
- `vehicle_height` (`integer`, optional): Vehicle height in centimeters (truck routing). Example: 400.
- `via` (`array`, optional): Waypoints as latitude,longitude (each sent as its own via parameter, in order). Add !stopDuration=<seconds> to make one a stop. Example: ["52.5200,13.3800"]

Example input: `{"destination":"<destination>","origin":"<origin>","transport_mode":"car"}`

### `here_traffic_flow_get`

Get Traffic Flow · Read-only

Get real-time traffic flow (speed, free-flow speed, jam factor) for road segments in an area. Returns results with location (description, shape or reference) and currentFlow (speed, speedUncapped, freeFlow, jamFactor, confidence, traversability). Use this for congestion levels. Use here_traffic_incidents_list for accidents and closures.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `in` (`string`, required): Area: circle:lat,lng;r=<meters>, bbox:west,south,east,north or corridor:<flexible polyline>;r=<meters>. Example: circle:52.5308,13.3847;r=1000.
- `location_referencing` (`string`, required): Location referencing to return: shape (coordinates), olr (OpenLR), tmc, or segmentRef; comma-separated. Example: shape.
- `functional_classes` (`string`, optional): Road functional classes 1-5, comma-separated (1 = major highways). Example: 1,2.
- `max_jam_factor` (`number`, optional): Only segments with jam factor at or below this (0-10). Example: 10.
- `min_jam_factor` (`number`, optional): Only segments with jam factor at or above this (0-10). Example: 4.

Example input: `{"in":"<in>","location_referencing":"<location_referencing>"}`

### `here_traffic_incident_get`

Get Traffic Incident · Read-only

Get one traffic incident by its original ID. Returns the incident's location and details. Use this to refresh an incident from here_traffic_incidents_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `location_referencing` (`string`, required): Location referencing to return: shape (coordinates), olr (OpenLR), tmc, or segmentRef; comma-separated. Example: shape.
- `original_id` (`string`, required): originalId from an incident. Example: 4236935297806712858.
- `lang` (`string`, optional): BCP 47 language for descriptions. Example: en-US.
- `units` (`string`, optional): Unit system for instructions: metric (default) or imperial. Example: metric. One of: `metric`, `imperial`.

Example input: `{"location_referencing":"<location_referencing>","original_id":"<original_id>"}`

### `here_traffic_incidents_list`

List Traffic Incidents · Read-only

List real-time traffic incidents (accidents, construction, closures, congestion) in an area. Returns results with location and incidentDetails (id, type, criticality, description, startTime, endTime, roadClosed). Use this for disruptions. Use here_traffic_incident_get for one incident and here_traffic_flow_get for speeds.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `in` (`string`, required): Area: circle:lat,lng;r=<meters>, bbox:west,south,east,north or corridor:<flexible polyline>;r=<meters>. Example: circle:52.5308,13.3847;r=1000.
- `location_referencing` (`string`, required): Location referencing to return: shape (coordinates), olr (OpenLR), tmc, or segmentRef; comma-separated. Example: shape.
- `criticality` (`string`, optional): Criticality levels, comma-separated: critical, major, minor, low. Example: critical,major.
- `earliest_start_time` (`string`, optional): Only incidents starting at or after this RFC 3339 time. Example: 2026-01-15T00:00:00Z.
- `lang` (`string`, optional): BCP 47 language for descriptions. Example: en-US.
- `latest_end_time` (`string`, optional): Only incidents ending at or before this RFC 3339 time. Example: 2026-01-16T00:00:00Z.
- `type` (`string`, optional): Incident types, comma-separated: accident, congestion, construction, disabledVehicle, massTransit, plannedEvent, roadHazard, roadClosure, weather, laneRestriction, other. Example: accident,roadClosure.
- `units` (`string`, optional): Unit system for instructions: metric (default) or imperial. Example: metric. One of: `metric`, `imperial`.

Example input: `{"in":"<in>","location_referencing":"<location_referencing>"}`

### `here_transit_departures_list`

List Transit Departures · Read-only

List the next public transit departures from stations near a location or from given station IDs. Returns boards with place (station name, id, location) and departures (time, delay, transport name, headsign, mode, agency). Use this for live departure boards. Use here_transit_stations_search to find station IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`string`, optional): Station IDs, comma-separated (max 50). Example: 415272394.
- `in` (`string`, optional): Search area as lat,lng;r=<meters> (radius optional, default 500). Provide in or ids. Example: 41.90123,12.50091;r=500.
- `lang` (`string`, optional): BCP 47 language. Example: en-US.
- `max_per_board` (`integer`, optional): Maximum departures per station (default 40). Example: 10.
- `max_places` (`integer`, optional): Maximum number of stations when searching by location (1-50, default 5). Example: 3.
- `modes` (`string`, optional): Transit modes to include or exclude, comma-separated. Example: bus,subway.
- `time` (`string`, optional): Start of the departure window, RFC 3339. Defaults to now. Example: 2026-01-15T08:00:00+01:00.

Example input: `{}`

### `here_transit_routes_calculate`

Calculate Transit Route · Read-only

Calculate public transit routes between two points, with walking legs and transfers. Returns routes with sections (pedestrian or transit, departure and arrival place and time, transport name, headsign, agency) and optional polyline, travelSummary, fares. Use this for public transport directions. Use here_intermodal_routes_calculate to combine transit with car, taxi or bike.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `destination` (`string`, required): End as latitude,longitude. Example: 41.90096,12.50243.
- `origin` (`string`, required): Start as latitude,longitude. Example: 41.79457,12.25473.
- `alternatives` (`integer`, optional): Number of alternative routes (0-6). Example: 2.
- `arrival_time` (`string`, optional): Arrival time, RFC 3339 date-time (cannot be combined with departure_time). Example: 2026-01-15T09:30:00+01:00.
- `changes` (`integer`, optional): Maximum number of transfers. Example: 2.
- `departure_time` (`string`, optional): Departure time, RFC 3339 date-time; use any to ignore traffic. Defaults to now. Example: 2026-01-15T08:30:00+01:00.
- `lang` (`string`, optional): BCP 47 language. Example: en-US.
- `modes` (`string`, optional): Transit modes to include or exclude (prefix -), comma-separated, e.g. subway,bus or -highSpeedTrain. Example: subway,bus.
- `return` (`string`, optional): Sections to return, comma-separated: polyline, actions, travelSummary, fares, intermediate, bookingLinks. Example: travelSummary,polyline.
- `units` (`string`, optional): Unit system for instructions: metric (default) or imperial. Example: metric. One of: `metric`, `imperial`.

Example input: `{"destination":"<destination>","origin":"<origin>"}`

### `here_transit_stations_search`

Search Transit Stations · Read-only

Find public transit stations near a location, by name, or by ID. Returns stations with place (name, id, location, type) and optional transports and accessPoints. Use this to get station IDs for here_transit_departures_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`string`, optional): Station IDs, comma-separated. Example: 415272394.
- `in` (`string`, optional): Search area as lat,lng;r=<meters>. Provide in, name (with in) or ids. Example: 41.90123,12.50091;r=500.
- `max_places` (`integer`, optional): Maximum number of stations (1-50, default 5). Example: 5.
- `name` (`string`, optional): Station name or part of it. Example: Termini.
- `return` (`string`, optional): Extra attributes: transport and/or accessPoints, comma-separated. Example: transport.

Example input: `{}`

### `here_waypoints_sequence_find`

Find Waypoint Sequence · Read-only

Find the fastest or shortest order to visit a set of waypoints between a start and an optional end. Returns results with the optimized waypoints order, distance, time and interconnections. Use this to optimize a multi-stop trip before routing it with here_routes_calculate.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `destination1` (`string`, required): First stop to visit as id;lat,lng (add ;st:<seconds> for a stop time). Example: CustomerA;52.5206,13.3862.
- `mode` (`string`, required): Mode as optimization;transport;traffic, e.g. fastest;car;traffic:enabled. Example: fastest;car;traffic:disabled.
- `start` (`string`, required): Start as id;lat,lng. Example: Warehouse;52.5160,13.3779.
- `departure` (`string`, optional): Departure time (ISO 8601) or now. Example: 2026-01-15T08:30:00+01:00.
- `destination2` (`string`, optional): Second stop as id;lat,lng. Example: CustomerB;52.5054,13.3926.
- `destination3` (`string`, optional): Third stop as id;lat,lng. Example: CustomerC;52.4993,13.4180.
- `destination4` (`string`, optional): Fourth stop as id;lat,lng. Example: CustomerD;52.5300,13.4100.
- `destination5` (`string`, optional): Fifth stop as id;lat,lng. Example: CustomerE;52.5400,13.3500.
- `end` (`string`, optional): End as id;lat,lng; omit for an open trip. Example: Warehouse;52.5160,13.3779.
- `improve_for` (`string`, optional): time (default) or distance. Example: time. One of: `time`, `distance`.

Example input: `{"destination1":"<destination1>","mode":"<mode>","start":"<start>"}`

### `here_weather_alerts_get`

Get Weather Alerts · Read-only

Get weather alerts that affect GeoJSON features (points, a route line or an area polygon), with optional time windows per feature. Returns alerts per feature with type, severity, description and validity window. Use this for alerts along a route. Use here_weather_report_get with products=alerts for a single place.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `features` (`array`, required): GeoJSON Feature objects (Point, LineString or Polygon geometry), optionally with properties.width and timeSegments. Example: [{"type": "Feature", "geometry": {"type": "Point", "coordinates": [13.3847, 52.5308]}}]

Example input: `{"features":[]}`

### `here_weather_report_get`

Get Weather Report · Read-only

Get current observations, hourly or daily forecasts, astronomy or alerts for a location given by coordinates, free-text query or ZIP code. Returns places with the requested products (observations, forecasts, nwsAlerts, astronomyForecasts) including temperature, precipitation, wind and description. Use this for weather at a place. Use here_weather_alerts_get for alerts along a route or area.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `products` (`string`, required): Products, comma-separated: observation, forecast7days, forecast7daysSimple, forecastHourly, forecastAstronomy, alerts, nwsAlerts. Example: observation,forecastHourly.
- `lang` (`string`, optional): Language code. Example: en-US.
- `location` (`string`, optional): Coordinate as latitude,longitude. Provide location, q or zip_code. Example: 52.5308,13.3847.
- `one_observation` (`boolean`, optional): Return only the closest observation station. Example: true.
- `q` (`string`, optional): Free-text place, e.g. a city name. Example: Berlin, Germany.
- `units` (`string`, optional): metric (default) or imperial. Example: metric. One of: `metric`, `imperial`.
- `zip_code` (`string`, optional): US ZIP code. Example: 10001.

Example input: `{"products":"<products>"}`

## Related

Other Search connectors ([all 89](/agentkit/connectors/?category=search)):

- [Supadata](/agentkit/connectors/supadata/): Scalekit connector, API key, 21 tools
- [Exa](/agentkit/connectors/exa/): Scalekit connector, API key, 21 tools
- [Brave Search](/agentkit/connectors/brave/): Scalekit connector, API key, 18 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
