# Here

HERE Technologies provides comprehensive location data and mapping services, offering APIs and SDKs for developers to integrate maps, geocoding, routing, and other location-based features into their applications.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 100
- **Triggers:** 0
- **Slug:** `HERE`
- **Version:** 20260313_00

## Tools

### Autosuggest Places

**Slug:** `HERE_AUTOSUGGEST`

Tool to fetch possible completions for a partial search term. Use after capturing a partial query and location context to generate typeahead suggestions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | Yes | Free-form text to suggest on (partial or misspelled) |
| `at` | string | No | Latitude,longitude to bias suggestions (e.g., '52.5200,13.4050') |
| `in` | string | No | Geographic filter region. Must be one of: 'circle:lat,lon;r=meters' (e.g., 'circle:52.5200,13.4050;r=1000'), 'bbox:west,south,east,north', or 'ring:lat1,lon1,lat2,lon2,...' |
| `lang` | string | No | IETF BCP 47 language tag for results (e.g., 'en-US') |
| `limit` | integer | No | Maximum number of suggestions to return |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Browse Places

**Slug:** `HERE_BROWSE`

Tool to search for places around a given location with optional filters. Use when you need nearby points of interest filtered by categories, food types, or name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `at` | string | Yes | Center point for the search area, formatted as 'lat,lng'. |
| `lang` | string | No | BCP 47 language tag for localized results, e.g., 'en-US'. |
| `name` | string | No | Text filter to match place names within the chosen categories. |
| `limit` | integer | No | Maximum number of items to return. |
| `foodTypes` | string | No | Comma-separated HERE Places cuisine/food type IDs to filter results. |
| `categories` | string | No | Comma-separated HERE Places category IDs to filter results (e.g., '700-7000-0322'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Calculate Fleet Telematics Route

**Slug:** `HERE_CALCULATE_ROUTE`

Calculate optimal routes between multiple waypoints supporting various transport modes (car, truck, bicycle, pedestrian). Returns route summary with travel time and distance. Supports fleet-specific parameters like fuel type and preferred routes. Uses HERE Fleet Telematics API with automatic fallback to Routing v8 API.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string | Yes | Routing profile in format '{routingType};{transportMode}' where routingType is 'fastest' or 'shortest', and transportMode is 'car', 'truck', 'bicycle', or 'pedestrian'. |
| `fuelType` | string ("petrol" | "diesel" | "lng" | "lpg" | "cng" | "ethanol" | "propane" | "hydrogen" | "electric") | No | Fuel type affecting toll/environmental rules. |
| `overlays` | string | No | Comma-separated map overlay names for custom routing layers. |
| `waypoints` | array | Yes | List of waypoints in 'latitude,longitude' format. First waypoint is origin, last is destination. Intermediate waypoints are via points the route must pass through. Minimum 2 waypoints required. |
| `routeAttributes` | array | No | List of route attributes to return. Note: 'shape' attribute is only available when Fleet Telematics API succeeds (not in v8 fallback). Common values: 'shape', 'summary', 'legs'. |
| `instructionFormat` | string ("text" | "html") | No | Format for maneuver instructions. |
| `maneuverAttributes` | array | No | Additional maneuver attributes to include, e.g., ['direction','action']. |
| `ignorePreferredRoutes` | boolean | No | Disable preferred truck routes when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Tour Planning Problem

**Slug:** `HERE_CANCEL_PROBLEM`

Tool to cancel a running asynchronous tour planning optimization job. Use when you need to stop an in-progress optimization calculation that is no longer needed or was submitted in error.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `problemId` | string | Yes | The unique identifier of the tour planning problem to cancel. This ID is returned when submitting a problem for asynchronous optimization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Coordinates to Tile Indices

**Slug:** `HERE_COORDINATES_TO_TILE_INDICES`

Tool to convert geographic coordinates to Web Mercator XYZ tile indices. Use when mapping a lat/lng to its containing tile at a given zoom level.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lat` | number | Yes | Latitude in degrees, must be between -85 and 85 |
| `lng` | number | Yes | Longitude in degrees, must be between -180 and 180 |
| `zoom` | integer | Yes | Zoom level, integer between 0 and 20 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Decode Route Handle

**Slug:** `HERE_DECODE_ROUTE_HANDLE`

Tool to decode and return a route from a previously calculated route handle via POST request. Use when you need to retrieve a route using a handle obtained from a previous route calculation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lang` | array | No | List of preferred languages for the response (IETF BCP 47). First supported language is used. |
| `avoid` | object | No | Avoid configuration for POST body. |
| `spans` | array | No | Map content attributes to include in response spans. Requires 'polyline' in return parameter. |
| `units` | string ("metric" | "imperial") | No | Units of measurement used in guidance instructions. Defaults to 'metric'. |
| `origin` | string | No | A location defining the origin of the trip in format '{lat},{lng}[PlaceOptions][WaypointOptions]'. The origin has to be located along the previously calculated route. |
| `return` | array | No | Attributes to include in the response. Options: 'polyline', 'actions', 'instructions', 'summary', 'travelSummary', 'turnByTurnActions', 'mlDuration', 'typicalDuration', 'elevation', 'routeHandle', 'passthrough', 'incidents', 'routingZones', 'truckRoadTypes', 'tolls'. |
| `currency` | string | No | ISO 4217 currency code for route costs. Router will specify it if not provided. |
| `routeHandle` | string | Yes | Route handle returned from a previous route calculation. See 'return' parameter of '/routes' endpoint for more information. |
| `X-Request-ID` | string | No | User-provided token to trace requests sent to the service. |
| `departureTime` | string | No | Time of departure in RFC 3339 format (e.g., '2019-06-24T01:23:45'). Special value 'any' indicates time should not be considered. Defaults to current time if not specified. |
| `transportMode` | string ("car" | "truck" | "pedestrian" | "bicycle" | "scooter" | "taxi" | "bus" | "privateBus") | Yes | Mode of transport to be used for the calculation of the route. Note: 'bicycle', 'bus', 'privateBus', and 'taxi' modes are currently provided as Beta with limited functionality. |
| `pedestrian_speed` | number | No | Walking speed in meters per second. Influences walking segment duration. |
| `maxSpeedOnSegment` | array | No | Segments with restrictions on maximum baseSpeed. Maximum 250 penalized segments per request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Discover Places

**Slug:** `HERE_DISCOVER`

Tool to discover places and addresses by free-form text near a location. Use when you need to find points of interest or specific addresses from a natural-language query.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | Yes | Free-form search query for places or addresses. |
| `at` | string | No | Latitude and longitude to center the search, formatted 'lat,lng'. Required if 'in' is omitted. |
| `in_` | string | No | Geographical filter for search area. Must use one of: 'bbox:west,south,east,north' (bounding box), 'circle:lat,lng;r=meters' (circle with radius), or 'ring:encoded_polyline' (polygon area). Cannot be used alone with countryCode - requires 'at' parameter if using country filtering. |
| `lang` | string | No | Preferred response language (BCP-47), e.g., 'en-US'. |
| `limit` | integer | No | Maximum number of results to return (1-100). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Solve Vehicle Routing Problem

**Slug:** `HERE_FIND_SEQUENCE`

Tool to solve a Vehicle Routing Problem (VRP) by optimizing routes for a fleet of vehicles serving multiple jobs. Use when you need to optimize delivery routes, pickup sequences, or multi-stop journeys with vehicle capacity constraints. This is a preview feature and subject to change.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Unique identifier for this problem. Avoid confidential or personal information. |
| `plan` | object | Yes | Plan containing jobs to be served. |
| `fleet` | object | Yes | Fleet definition with vehicle profiles and types. |
| `app_id` | string | No | Optional application identifier. |
| `configuration` | object | No | Optional configuration to tweak solver behavior. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Optimal Waypoint Sequence

**Slug:** `HERE_FIND_WAYPOINT_SEQUENCE`

Tool to find the optimal sequence of waypoints using POST request to solve the Travelling Salesman Problem. Supports advanced vehicle parameters including truck restrictions, hazardous goods, toll calculations, and environmental zones. Returns optimized visit order with distance, time, and interconnections between waypoints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end` | string | No | Ending waypoint as 'lat,lon'. If not provided, optimization ends at the last destination. |
| `algo` | string | No | Algorithm to use for sequence optimization. |
| `mode` | string | Yes | Routing mode in format '{type};{transport}' where type is 'fastest' or 'shortest', and transport is 'car', 'truck', 'bicycle', or 'pedestrian'. Example: 'fastest;car' |
| `start` | string | No | Starting waypoint as 'lat,lon'. If not provided, optimization starts from the first destination. |
| `width` | string | No | Vehicle width with unit (e.g., '2.5m', '250cm'). Used for truck restrictions. |
| `height` | string | No | Vehicle height with unit (e.g., '3.5m', '350cm', '138in'). Used for truck restrictions and toll calculations. |
| `length` | string | No | Vehicle length with unit (e.g., '10m', '1000cm'). Used for truck restrictions and toll calculations. |
| `arrival` | string | No | Arrival time in ISO 8601 format. Cannot be used together with departure time. |
| `fuelType` | string | No | Vehicle fuel type: Diesel, Petrol, LPG, LNG, CNG, Ethanol, Propane, Hydrogen, Electric. Used for environmental zones, toll cost, and consumption routing. |
| `departure` | string | No | Departure time in ISO 8601 format (e.g., '2023-01-01T08:00:00Z') or relative format (e.g., '2023-01-01T08:00:00+01:00'). |
| `requestId` | string | No | Custom request identifier for tracking. |
| `verbosity` | string | No | Response verbosity level. |
| `avoidAreas` | string | No | Areas to avoid in routing, specified as bounding boxes. |
| `avoidLinks` | string | No | Comma-separated list of link IDs to avoid in routing. |
| `commercial` | string | No | 1=commercial vehicle, 0=otherwise. Used for toll cost, environmental zones, and delivery-only zones. |
| `hasTrailer` | string | No | Whether vehicle has a trailer attached (true/false). |
| `improveFor` | string | No | Optimization objective: 'time' for fastest route, 'distance' for shortest. If not specified, uses mode type. |
| `destinations` | array | Yes | List of destination waypoints as 'lat,lon' strings. These will be optimized for the best visit sequence. Minimum 1 destination required. |
| `emissionType` | string | No | Emission standard: 1=EURO I, 2=EURO II, 3=EURO III, 4=EURO IV, 5=EURO V, 6=EURO VI, 7=EURO EEV, 8=Electric. Used for toll cost and environmental zones. |
| `limitedWeight` | string | No | Total vehicle weight including payload and trailers with unit (e.g., '7.5t', '7500kg', '16500lbs'). Used for truck restrictions, speed profile, and toll calculations. |
| `trailerWeight` | string | No | Total weight of trailers with payload (e.g., '3t', '3000kg'). Used for toll calculations. |
| `trailersCount` | string | No | Number of trailers: 0=none, 1=one or more, 2=two or more, 3=three or more, 4=one or more semi-trailers. Used for toll cost and truck restrictions. |
| `vehicleWeight` | string | No | Vehicle weight excluding trailers with unit (e.g., '5t', '5000kg'). Used for toll calculations. |
| `weightPerAxle` | string | No | Weight per axle including payload with unit (e.g., '2t', '2000kg'). Used for toll cost and truck restrictions. |
| `tunnelCategory` | string | No | Tunnel categories to avoid: B, C, D, or E. A tunnels have no restrictions, E have most. If C is specified, route uses A and B tunnels but not C, D, or E. |
| `passengersCount` | string | No | Actual number of passengers. Used for toll cost calculations and carpool/HOV lanes. |
| `trailerNumberAxles` | string | No | Number of trailer axles. Used for toll cost and country-wide truck restrictions. |
| `vehicleNumberAxles` | string | No | Number of vehicle axles excluding trailers. Used for toll cost and country-wide truck restrictions. |
| `shippedHazardousGoods` | string | No | Comma-separated list of hazardous goods: explosive, gas, flammable, combustible, organic, poison, radioActive, corrosive, poisonousInhalation, harmfulToWater, other, allhazardousGoods, explosiveFlammable. Used for toll cost and truck restrictions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Geocode Address

**Slug:** `HERE_GEOCODE`

Tool to convert structured address data into geographic coordinates. Use when you need precise lat/lng from a free-text or qualified address input.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Free-text address or place query. Required if 'qq' is not used. |
| `at` | string | No | Position context to bias results, formatted 'lat,lng'. |
| `qq` | string | No | Qualified key=value query string, e.g., 'street=Invalidenstr;city=Berlin;postalCode=10115;country=DE'. Required if 'q' is not used. |
| `in_` | string | No | Spatial filter for search area, e.g., 'circle:lat,lng;r=radius', 'bbox:west,south,east,north', or country/region filters as documented. |
| `lang` | string | No | Response language (BCP-47), e.g., 'en-US'. |
| `show` | string | No | Additional sections to include, e.g., 'tz' for time zone. |
| `limit` | integer | No | Maximum number of results to return. |
| `politicalView` | string | No | Political view to use for disputed areas (ISO country code). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Aliases Service Health

**Slug:** `HERE_GET_ALIASES_HEALTH`

Tool to check the health status of the HERE Tracking aliases service. Use to verify service availability before making other aliases API calls.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Aliases Service Version

**Slug:** `HERE_GET_ALIASES_VERSION`

Tool to get the current version of the HERE Tracking Aliases service. Use when you need to verify the service version for compatibility or debugging purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Associations Service Health

**Slug:** `HERE_GET_ASSOCIATIONS_HEALTH`

Tool to check the health status of the HERE Tracking Associations API service. Use when you need to verify that the associations service is operational and responding correctly.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Associations Service Version

**Slug:** `HERE_GET_ASSOCIATIONS_VERSION`

Tool to retrieve the current version of the HERE Associations tracking service. Use when you need to verify the service version or check service availability.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Address Autocomplete

**Slug:** `HERE_GET_AUTOCOMPLETE`

Tool to get address autocomplete suggestions for partial address queries. Use when you need address-specific completions focusing on addresses and administrative areas, unlike autosuggest which includes broader place categories.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | Yes | Free-text query for address autocomplete suggestions. Enter partial address text (e.g., 'ber', 'berl', 'berlin+p'). Whitespace, URLs, email addresses, or other out-of-scope queries will yield no results. |
| `at` | string | No | Center of the search context expressed as coordinates. Format: '{latitude},{longitude}' (e.g., '-13.163068,-72.545128' for Machu Picchu Mountain, Peru). |
| `in` | string | No | Search within a geographic area. This is a hard filter. Results will be returned only if they are located within the specified area. Format: 'countryCode:{countryCode}[,{countryCode}]*' (e.g., 'countryCode:USA' or 'countryCode:CAN,MEX,USA'). Country codes must be ISO 3166-1 alpha-3 in uppercase. |
| `lang` | string | No | Select the preferred response language for result rendering from a list of BCP47 compliant Language Codes. The autocomplete endpoint tries to detect the query language based on matching name variants and then chooses the same language for the response. |
| `show` | string | No | Select additional fields to be rendered in the response. Supported values: 'streetInfo' (renders additional block with street name decomposed into parts like base name, street type, etc.). |
| `limit` | integer | No | Maximum number of results to be returned. Default is 5. |
| `types` | string | No | BETA: Limit the result items to the specified types. Provide one of the supported values or a comma separated list. Supported values: 'area' (restricts to locality or administrativeArea including sub-types), 'city' (restricts to locality type city), 'postalCode' (restricts to locality type postalCode). |
| `X-Request-ID` | string | No | Used to correlate requests with their responses within a customer's application, for logging and error reporting. A valid UUIDv4 is recommended. |
| `politicalView` | string | No | Toggle the political view. This parameter accepts single ISO 3166-1 alpha-3 country code in uppercase. Supported views: ARG, EGY, IND, KEN, MAR, PAK, RUS, SDN, SRB, SUR, SYR, TUR, TZA, URY. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Base Map Tile

**Slug:** `HERE_GET_BASE_MAP_TILE`

Retrieves a base map tile image from HERE Raster Tile API v3. Returns map tiles in various styles (normal day/night, satellite, reduced/lite) at specified zoom levels and tile coordinates using the Web Mercator projection. Tiles are provided in 256x256 or 512x512 pixel sizes in PNG or JPEG format. Use this to display map imagery in applications requiring tiled map rendering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `x` | integer | Yes | Tile column index in Web Mercator grid, zero-based. |
| `y` | integer | Yes | Tile row index in Web Mercator grid, zero-based. |
| `size` | integer ("256" | "512") | Yes | Tile image size in pixels. Allowed values: 256 or 512. |
| `zoom` | integer | Yes | Zoom level as an integer between 0 (world) and 20 (street-level). |
| `format` | string ("png" | "png8" | "png32" | "jpg" | "jpg70") | Yes | Image format for the tile. |
| `scheme` | string ("normal.day" | "normal.day.grey" | "normal.day.transit" | "normal.night" | "normal.night.grey" | "normal.night.transit" | "reduced.day" | "reduced.night" | "satellite.day" | "satellite.day.transit") | Yes | Map style/scheme for the base tile. Common options: 'normal.day' for standard day map, 'normal.night' for night mode, 'satellite.day' for satellite imagery, 'reduced.day' for simplified map. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Bulkjobs Service Health

**Slug:** `HERE_GET_BULKJOBS_HEALTH`

Tool to check the health status of the HERE Tracking bulkjobs service. Use to verify service availability before making other bulkjobs API calls.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Bulkjobs Service Version

**Slug:** `HERE_GET_BULKJOBS_VERSION`

Tool to retrieve the current version of the HERE Bulkjobs tracking service. Use when you need to verify the service version number.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get C2C Service Health

**Slug:** `HERE_GET_C2_C_HEALTH`

Tool to check HERE C2C service health status. Use when you need to verify if the Car-to-Cloud tracking service is operational.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get C2C Service Version

**Slug:** `HERE_GET_C2_C_VERSION`

Tool to get the current version of the HERE C2C tracking service. Use when you need to check the service version for compatibility or monitoring purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Copyright

**Slug:** `HERE_GET_COPYRIGHT`

Tool to retrieve copyright information for HERE map tiles. Returns copyright text, labels, and geographic coverage areas for different map styles and zoom levels. Use when you need to display proper attribution for HERE map tiles in your application.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transit Departures

**Slug:** `HERE_GET_DEPARTURES`

Tool to get next departures from transit stations. Returns upcoming departures with line information, destination, and real-time delays. Use when you need to find public transit departure times either by station ID or by geographic location.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | string | No | Comma-separated list of station IDs to query (max 50). Required if 'in_location' is not provided. |
| `lang` | string | No | Preferred language of response (IETF BCP 47 format). |
| `sort` | string ("time" | "transport") | No | Sort order for departures. |
| `time` | string | No | Time of earliest departure in RFC 3339 format (e.g., '2019-06-24T01:23:45'). Converts to local time at each location. When timezone offset is not specified, time is assumed to be local. If not set, current time at departure place is used. |
| `modes` | string | No | Transit mode filter (comma-separated). Supported modes: highSpeedTrain, intercityTrain, interRegionalTrain, regionalTrain, cityTrain, bus, ferry, subway, lightRail, privateBus, inclined, aerial, busRapid, monorail, flight, spaceship. Can use exclusion list by prefixing with '-' (e.g., '-subway,-bus'). Cannot mix inclusive and exclusive modes. |
| `timespan` | string | No | Limit departures to defined time window starting from 'time'. Format is ISO 8601 duration (e.g., 'PT2H' for 2 hours). When not set, max 24 hours of departures can be returned. |
| `in_location` | string | No | Location-based query in format 'latitude,longitude;r=radius_in_meters'. Default radius is 500m if not specified. Required if 'ids' is not provided. |
| `maxPerBoard` | integer | No | Maximum number of subsequent departures per station board to include in response. |
| `maxPerTransport` | integer | No | Maximum number of subsequent departures per transport (identified by name, direction, and mode). When not set, all departures are returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Events Health Status

**Slug:** `HERE_GET_EVENTS_HEALTH`

Tool to check the health status of the HERE Events API service. Use to verify if the Events API is operational.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Events Service Version

**Slug:** `HERE_GET_EVENTS_VERSION`

Tool to get the current version of the HERE Events service. Use when you need to check the service version for compatibility or monitoring purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Features

**Slug:** `HERE_GET_FEATURES`

Tool to retrieve available map features per style for tile rendering. Use when you need to discover which features (environmental zones, congestion zones, POIs, vehicle restrictions) are supported by different map styles.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Geofences Health

**Slug:** `HERE_GET_GEOFENCES_HEALTH`

Tool to check the health status of the HERE Geofences service. Use when you need to verify if the geofences API is operational before making other requests.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Geofences Service Version

**Slug:** `HERE_GET_GEOFENCES_VERSION`

Tool to get the current version of the HERE Geofences service. Use when you need to check the service version for compatibility or monitoring purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Service Health Status

**Slug:** `HERE_GET_HEALTH`

Tool to check the health status of the HERE Tracking API service. Use when you need to verify if the service is operational and performing as expected.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Incident By ID

**Slug:** `HERE_GET_INCIDENTS_BY_ID`

Tool to get details of a specific traffic incident by its ID. Returns full incident information including description, severity, and affected road segments. Use when you need comprehensive details about a known traffic incident.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lang` | string | No | The language to be used for incident descriptions (BCP47 format). Supported values are available at iana.org. |
| `units` | string ("metric" | "imperial") | No | Units of measurement for incident descriptions. |
| `originalId` | string | Yes | Identifier of the first traffic incident in a chain of updates. Once an incident chain has been created, this value will never change. |
| `X-Request-Id` | string | No | User-provided token for tracing requests. Any string is accepted, but UUID is preferred. |
| `locationReferencing` | string ("none" | "olr" | "shape" | "tmc") | Yes | The location referencing scheme to be used in the response. Options: none (no location references), olr (TISA OpenLR standard), shape (series of geo-coordinates), tmc (Traffic Message Channel). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Raster Tile API Info

**Slug:** `HERE_GET_INFO`

Tool to get metadata about the HERE Raster Tile API v3. Returns information about accepted values of API parameters including supported image formats, sizes, styles, projections, resources, and zoom level ranges. Use when you need to discover available options before requesting map tiles.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Isolines

**Slug:** `HERE_GET_ISOLINES`

Tool to calculate isolines. Use when you need reachable area polygons based on time, distance, or consumption ranges.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `origin` | string | No | Starting coordinate for forward isolines, formatted as 'lat,lng'. Required if destination is not provided. |
| `range_type` | string ("time" | "distance" | "consumption") | Yes | Basis of isoline calculation: time (seconds), distance (meters), or consumption. |
| `destination` | string | No | Target coordinate for reverse isolines, formatted as 'lat,lng'. Required if origin is not provided. |
| `routingMode` | string ("fast" | "short") | No | Routing preference for calculation. |
| `range_values` | array | Yes | One or more range break values; seconds for time, meters for distance. |
| `departureTime` | string | No | Departure time in ISO 8601 format for traffic-aware isolines. |
| `transportMode` | string ("car" | "pedestrian" | "truck" | "taxi" | "bus") | No | Transport mode for calculation. Defaults to 'car' if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Labels Service Health

**Slug:** `HERE_GET_LABELS_HEALTH`

Tool to check the health status of the HERE Labels service. Use when you need to verify if the labels service is operational.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Labels Service Version

**Slug:** `HERE_GET_LABELS_VERSION`

Tool to retrieve the current version of the HERE Labels service. Use when you need to check the service version for compatibility or debugging purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Label Tile

**Slug:** `HERE_GET_LABEL_TILE`

Retrieves a map tile image with text labels using HERE Raster Tile API v3. Returns map tiles in various styles (day/night, grayscale, terrain) with street names, city names, and POI labels rendered in specified language(s). Use this when you need labeled map imagery at specific tile coordinates and zoom levels for tiled map rendering. Tiles use Web Mercator projection in standard 256x256 or 512x512 pixel sizes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `x` | integer | Yes | Tile column index in Web Mercator grid. Must be 0 ≤ x < 2^zoom. For zoom=10, valid range is 0-1023. |
| `y` | integer | Yes | Tile row index in Web Mercator grid. Must be 0 ≤ y < 2^zoom. For zoom=10, valid range is 0-1023. |
| `ppi` | integer ("100" | "200" | "400") | No | Pixels-per-inch for label rendering. Higher values = sharper images. 100=low-res, 200=standard, 400=high-res. |
| `lang` | string | No | Primary label language code (ISO 639-1, e.g., 'en', 'de', 'fr', 'es'). Labels will be displayed in this language when available. |
| `size` | integer ("256" | "512") | No | Tile image size in pixels (width and height). 256 is standard, 512 provides higher detail. |
| `zoom` | integer | Yes | Zoom level as integer between 0 (world view) and 20 (street-level detail). |
| `lang2` | string | No | Secondary label language code (ISO 639-1, e.g., 'de', 'en'). Used as fallback when primary language is unavailable for a label. |
| `pview` | string | No | Geopolitical view code (three-letter country code, e.g., 'USA'). Adjusts border rendering based on country's territorial claims. Note: not all country codes are supported; check '/politicalViews' endpoint for valid values. |
| `format` | string ("png" | "png8") | No | Image format for the tile. 'png' for full 32-bit color with transparency, 'png8' for smaller 8-bit indexed color. |
| `scheme` | string ("normal.day" | "normal.day.grey" | "normal.day.transit" | "normal.night" | "normal.night.grey" | "normal.night.transit" | "terrain.day" | "terrain.day.grey" | "terrain.day.transit") | Yes | Map rendering scheme for the tile. 'normal.day' for standard daytime colors, 'normal.night' for dark mode, '.grey' for grayscale, '.transit' includes public transport labels, 'terrain.*' for topographic maps. Maps to Raster Tile API v3 styles (explore/lite). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Supported Languages

**Slug:** `HERE_GET_LANGUAGES`

Tool to retrieve supported languages for map tile labels from HERE Raster Tile API. Use when you need to determine which language options are available for rendering map labels and text on different map layers.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Largedata Service Health

**Slug:** `HERE_GET_LARGEDATA_HEALTH`

Tool to check the health status of the HERE Tracking largedata service. Use to verify service availability before making other largedata API calls.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Largedata Service Version

**Slug:** `HERE_GET_LARGEDATA_VERSION`

Tool to retrieve the current version of the HERE largedata tracking service. Use when you need to verify the service version number.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Locations Service Health

**Slug:** `HERE_GET_LOCATIONS_HEALTH`

Tool to check the health status of HERE's locations tracking service. Use when you need to verify if the locations API is operational and responding correctly.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Locations Service Version

**Slug:** `HERE_GET_LOCATIONS_VERSION`

Tool to retrieve the current version of the HERE Tracking Locations service. Use when you need to check the service version or verify service availability.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Map Image

**Slug:** `HERE_GET_MAP_IMAGE`

Retrieves a static map image from HERE Map Image API v3. Returns a downloadable PNG image with customizable center/zoom, dimensions, style, and overlay markers/shapes. Useful for generating map snapshots for reports, visualizations, or embedding in applications.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `size` | string | Yes | Image dimensions in pixels as '{width}x{height}', e.g., '480x370'. |
| `style` | string | No | Map style identifier. Common values: 'lite.day', 'explore.day', 'explore.night'. Defaults to standard style if not specified. |
| `format` | string ("png8" | "png") | Yes | Output image format. Supported values: 'png8' (8-bit PNG, smaller file size) or 'png' (24-bit PNG, higher quality). |
| `geojson` | string | No | URL-encoded GeoJSON FeatureCollection to overlay custom shapes. Must be valid JSON string. |
| `overlay` | string | No | Compact overlay encoding for custom points/lines/polygons with styling. Format: 'type:coordinates[;property=value]'. Examples: 'point:52.5,13.4', 'line:52.5,13.4,52.6,13.5;color=#E82D89;width=5' |
| `features` | string | No | Comma-separated list of feature toggles with modes. E.g., 'vehicle_restrictions:active_and_inactive,pois:disabled'. |
| `scaleBar` | string | No | Units for the scale bar, e.g., 'mi' or 'km'. |
| `parameters` | string | Yes | Path segment defining map positioning. Use 'center:latitude,longitude;zoom=level' for fixed center (zoom 0-20, where 0 is world view and 20 is street level), or 'overlay:padding=pixels' to auto-fit overlay content with specified padding. Example: 'center:52.5200,13.4050;zoom=14' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Map Tile with Transit

**Slug:** `HERE_GET_MAP_TILE_TRANSIT`

Tool to request a map tile with public transport overlay from HERE Raster Tile API v3. Use when you need street map tiles with transit information displayed (buses, trains, tram lines, etc.). Returns a PNG image with base map and public transport overlays.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `x` | integer | Yes | The x-coordinate (column) of the tile in the tile grid, must be non-negative |
| `y` | integer | Yes | The y-coordinate (row) of the tile in the tile grid, must be non-negative |
| `zoom` | integer | Yes | Zoom level for the map tile, integer between 0 (world view) and 20 (street level) |
| `style` | string | No | Map style to use. Supported values: explore.day, explore.night, explore.satellite.day, satellite.day |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Compute Routing Matrix

**Slug:** `HERE_GET_MATRIX`

Computes routing matrices for batch distance and travel time calculations between multiple origins and destinations. Use this tool when you need to: - Calculate distances/times for all combinations of multiple starting points and destinations - Perform batch routing calculations efficiently (up to 10,000 origins × 10,000 destinations) - Get travel times with traffic considerations (when departureTime is provided) - Optimize delivery routes, logistics planning, or proximity analysis The response returns flat arrays in row-major order where element k represents the route from origin i to destination j, calculated as: k = numDestinations * i + j

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `origins` | array | Yes | List of origin points (up to 10,000). Each origin is paired with each destination. |
| `async_mode` | boolean | No | If true, request is processed asynchronously and returns immediately with matrixId and statusUrl for polling. If false (default), waits for computation and returns results directly. |
| `destinations` | array | Yes | List of destination points (up to 10,000). Each destination is paired with each origin. |
| `departureTime` | string | No | ISO 8601 departure time (e.g., '2024-12-01T08:00:00Z'). Required when 'travelTime' is in summaryAttributes for traffic-aware calculations. |
| `transportMode` | string ("car" | "truck" | "pedestrian" | "bicycle") | No | Transportation mode for routing calculations. Affects speed, route selection, and restrictions. |
| `summaryAttributes` | array | No | Metrics to compute for each route: 'distance' (meters), 'travelTime' (seconds, requires departureTime), 'consumptions' (fuel usage), 'tollCost' (estimated toll charges). Default: ['distance', 'travelTime'] |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Matrix Calculation Result

**Slug:** `HERE_GET_MATRIX_MATRIX_ID`

Tool to retrieve the result of a successfully completed matrix calculation. Use when you have a matrixId from a previous matrix calculation request and need to fetch the computed distances and travel times.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `matrixId` | string | Yes | Matrix ID obtained upon successful submission of a matrix calculation request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Metadata Service Health

**Slug:** `HERE_GET_METADATA_HEALTH`

Tool to retrieve the health status of the HERE Tracking metadata service. Use when you need to verify if the service is operational.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Service Version

**Slug:** `HERE_GET_METADATA_VERSION`

Tool to retrieve the current version number of the HERE Tracking service. Use when you need to verify the service version or check API compatibility.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Meta Info Tile (Deprecated)

**Slug:** `HERE_GET_META_INFO_TILE`

DEPRECATED: This action uses HERE Map Tile API v2 which was shut down in Q1 2025. The metainfo/metadata endpoint is not available in the replacement Raster Tile API v3. For tile metadata, consider using HERE Vector Tile API v2 which provides geometric data and metadata in vector format. Original functionality: Retrieve JSON metadata for a specific map tile including information about street labels, POIs, buildings, and other rendered objects without downloading the tile image.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `x` | integer | Yes | Tile column index (XYZ scheme), must be non-negative |
| `y` | integer | Yes | Tile row index (XYZ scheme), must be non-negative |
| `pois` | boolean | No | Include POI-related information in metadata if true |
| `size` | integer ("256" | "512") | Yes | Tile size in pixels (width and height), either 256 or 512 |
| `zoom` | integer | Yes | Tile zoom level (XYZ scheme), must be between 0 and 22 inclusive |
| `format` | string ("png" | "png8") | Yes | Tile image format, either 'png' or 'png8' |
| `scheme` | string ("normal.day" | "normal.day.grey" | "normal.day.mobile" | "normal.night" | "normal.night.grey" | "terrain.day") | Yes | Map tile scheme, e.g., 'normal.day', 'terrain.day' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Notifications Service Health

**Slug:** `HERE_GET_NOTIFICATIONS_HEALTH`

Tool to check the health status of the HERE Tracking Notifications service. Use when you need to verify if the notifications service is operational and performing as expected.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Notifications Service Version

**Slug:** `HERE_GET_NOTIFICATIONS_VERSION`

Tool to get the current version of the HERE Notifications service. Use when you need to check the service version for compatibility or monitoring purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get OpenAPI Specification

**Slug:** `HERE_GET_OPENAPI`

Tool to retrieve the OpenAPI 3 specification for the HERE Traffic API v7. Use when you need the complete API schema documentation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `X-Request-Id` | string | No | User-provided token that can be used to trace a request or a group of requests sent to the service. This can be any string but UUID is preferred. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Political Views

**Slug:** `HERE_GET_POLITICAL_VIEWS`

Tool to retrieve available geopolitical views for HERE map rendering. Returns a mapping of map resources to supported country-specific boundary representations (ISO 3166-1 alpha-2 codes). Use when you need to determine which political views are available for displaying maps with region-specific boundaries.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tour Planning Solution

**Slug:** `HERE_GET_PROBLEMS_SOLUTION`

Tool to retrieve the solution for a completed tour planning problem. Returns optimized tours with routes, stops, schedules, and statistics. Use after submitting a problem asynchronously to get the calculated solution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `problemId` | string | Yes | Problem ID from the async submission. This is the unique identifier returned when you submit a tour planning problem. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Matrix Routing Profile

**Slug:** `HERE_GET_PROFILE`

Tool to retrieve a specific matrix routing profile definition by its ID. Use when you need to inspect predefined routing configurations including transport mode, routing optimization, avoid options, and region definitions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `profileId` | string | Yes | Profile ID. This parameter is case-sensitive. Examples: 'carFast', 'carShort', 'truckFast', 'bicycleFast', 'pedestrianFast'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Matrix Routing Profiles

**Slug:** `HERE_GET_PROFILES`

Tool to list all supported predefined routing profiles for matrix routing calculations. Use when you need to discover available profiles with their transport modes, routing optimizations, and constraints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `X-Request-Id` | string | No | User-provided token that can be used to trace a request or a group of requests sent to the service. This can be any string but UUID is preferred. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Registry Health

**Slug:** `HERE_GET_REGISTRY_HEALTH`

Tool to check the health status of the HERE Tracking Registry service. Use this to verify if the registry service is operational and responding normally.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Registry Service Version

**Slug:** `HERE_GET_REGISTRY_VERSION`

Tool to get the current version of the HERE Registry service. Use when you need to check the service version for compatibility or monitoring purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Service Health Status

**Slug:** `HERE_GET_REPORTS_HEALTH`

Tool to check the HERE Tracking service health status. Use when you need to verify if the service is operational and performing as expected.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Raster Map Tile

**Slug:** `HERE_GET_RESOURCE_PROJECTION_ZOOM_COLUMN_ROW_FORMAT`

Tool to retrieve a raster map tile image for a specific zoom level, column, and row from HERE Raster Tile API v3. Use when you need to fetch map tiles in various formats (PNG, JPEG) for different resource types (base maps, aerial imagery, traffic overlays, etc.). Supports customization options including language, geopolitical views, styles, and resolution.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mv` | string | No | Map version identifier. If not specified, the latest map version is used. Query the /info endpoint to retrieve the current map version. |
| `ppi` | integer ("100" | "400") | No | Pixels per inch resolution. Valid values: 100 for normal resolution, 400 for high-resolution (hi-res) tiles. Default is 100 if not specified. |
| `row` | integer | Yes | Tile row index (y-coordinate in tile grid), must be non-negative. Valid range is 0 to (2^zoom - 1). The coordinate [0,0] (column, row) corresponds to the top-left of a map in Mercator projection. |
| `lang` | string | No | Primary language for map labels using BCP47 language code (ISO 639-1 two-letter code, optionally with ISO 15924 script code). If not specified, each country uses its default language. Supported languages are listed in the /languages resource endpoint. |
| `size` | integer | No | Tile image size in pixels (width and height). Common values: 256, 512. Default is 256 if not specified. Supported sizes are listed in the info resource endpoint. |
| `zoom` | integer | Yes | Zoom level of the map tile, must be non-negative. Minimum and maximum zoom levels are specified in the info resource endpoint. Typical range is 0 (world view) to 20 (street level). |
| `lang2` | string | No | Secondary language for dual labeling, follows same format as lang parameter (BCP47 language code). Use this to show labels in two languages simultaneously. |
| `pview` | string | No | Geopolitical view for rendering boundaries. Uses ISO 3166-1 alpha-2 country codes (e.g., 'IN' for India, 'US' for United States). If not specified, the international view is used. Check /politicalViews endpoint for supported values. |
| `style` | string | No | Map style to use for rendering the tile. Common values: 'explore.day', 'explore.night', 'lite.day', 'satellite.day'. If not provided, the default style 'explore.day' is used. See the info resource endpoint for all supported styles. |
| `column` | integer | Yes | Tile column index (x-coordinate in tile grid), must be non-negative. Valid range is 0 to (2^zoom - 1). The coordinate [0,0] (column, row) corresponds to the top-left of a map in Mercator projection. |
| `format` | string | Yes | Output image format for the tile. Common values: 'png', 'png8', 'jpeg', 'jpg'. Supported formats are listed in the info resource endpoint. |
| `features` | string | No | Comma-separated list of map features with modes in format 'feature:mode'. Features are rendered independently. Examples: 'congestion_zones:active', 'environmental_zones:all', 'pois:default', 'vehicle_restrictions:active'. See /features endpoint for supported values. |
| `resource` | string | Yes | Type of tile resource. Common values include 'base' for base map tiles, 'aerial' for aerial imagery, 'traffic' for traffic overlay, 'hybrid' for satellite with labels. See the info resource endpoint for all supported values for this map version. |
| `projection` | string | Yes | Tile projection system. Supported value: 'mc' for Mercator Projection. See the info resource endpoint for all supported projections. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Calculate Routes

**Slug:** `HERE_GET_ROUTES`

Tool to calculate routes between waypoints supporting multiple transport modes (car, truck, pedestrian, bicycle, scooter, taxi, bus). Returns route geometry, turn-by-turn instructions, travel time, and distance. Use when planning navigation or analyzing travel options.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `via` | array | No | List of intermediate waypoints in 'lat,lng' format. Route will traverse these sequentially between origin and destination. Can include place and waypoint options. |
| `lang` | array | No | List of preferred languages for the response (IETF BCP 47 format). First supported language is used. Default is ['en-US']. |
| `spans` | array | No | Map content attributes to include in route spans (e.g., 'speedLimit', 'dynamicSpeedInfo'). Requires 'polyline' in return parameter. |
| `units` | string ("metric" | "imperial") | No | Units of measurement |
| `origin` | string | Yes | Origin waypoint in format 'lat,lng' (e.g., '52.5200,13.4050'). Can include place options (e.g., ';radius=200') and waypoint options (e.g., '!stopDuration=60'). |
| `return` | array | No | Attributes to include in response. Options: 'polyline' (route geometry), 'actions' (maneuvers), 'instructions' (localized guidance), 'summary' (route summary), 'travelSummary', 'turnByTurnActions', 'elevation', 'routeHandle', 'passthrough', 'incidents', 'routingZones', 'truckRoadTypes', 'tolls', 'typicalDuration', 'mlDuration'. Some require other attributes (e.g., 'actions' requires 'polyline'). |
| `currency` | string | No | ISO 4217 currency code for toll costs. If not provided, router will specify local currency on best-effort basis. |
| `arrivalTime` | string | No | Arrival time in RFC 3339 format (e.g., '2019-06-24T01:23:45'). Not supported for EV routing, route handle, or route import. Cannot be used with departureTime. |
| `destination` | string | Yes | Destination waypoint in format 'lat,lng' (e.g., '48.1351,11.5820'). Can include place and waypoint options like origin. |
| `routingMode` | string ("fast" | "short") | No | Routing optimization mode |
| `X-Request-ID` | string | No | User-provided token for tracing requests to the service. |
| `alternatives` | integer | No | Number of alternative routes to return in addition to the optimal route. Default is 0. |
| `departureTime` | string | No | Departure time in RFC 3339 format (e.g., '2019-06-24T01:23:45' or '2019-06-24T01:23:45Z'). Use 'any' to ignore time. If not specified, current time is used. |
| `transportMode` | string ("car" | "truck" | "pedestrian" | "bicycle" | "scooter" | "taxi" | "bus" | "privateBus") | Yes | Mode of transport for route calculation. Note: bicycle, bus, privateBus, and taxi are Beta features with limited functionality. |
| `pedestrian_speed` | number | No | Walking speed in meters per second for pedestrian transport mode. Default is 1 m/s. Influences duration of walking segments. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Rules Service Health

**Slug:** `HERE_GET_RULES_HEALTH`

Tool to check the health status of the HERE Tracking Rules service. Use when you need to verify if the Rules API service is operational. Returns a simple health status message.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Rules Service Version

**Slug:** `HERE_GET_RULES_VERSION`

Tool to retrieve the current version of the HERE Tracking Rules service. Use when you need to check the service version for compatibility or debugging purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Sensors Health

**Slug:** `HERE_GET_SENSORS_HEALTH`

Tool to check the health status of the HERE Tracking Sensors service. Use this to verify that the service is operational and performing as expected.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Sensors Service Version

**Slug:** `HERE_GET_SENSORS_VERSION`

Tool to retrieve the current version of the HERE Tracking sensors service. Use when you need to check the service version information.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Shadows Service Health

**Slug:** `HERE_GET_SHADOWS_HEALTH`

Tool to check the health status of the HERE Tracking Shadows service. Use when you need to verify if the shadows service is operational and performing as expected.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Shadows Service Version

**Slug:** `HERE_GET_SHADOWS_VERSION`

Tool to retrieve the current version of the HERE Shadows tracking service. Use when you need to verify the service version number.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Shipments Health

**Slug:** `HERE_GET_SHIPMENTS_HEALTH`

Tool to check the health status of the HERE Shipments service. Use when you need to verify if the tracking service is operational.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Shipments Service Version

**Slug:** `HERE_GET_SHIPMENTS_VERSION`

Tool to get the HERE shipments tracking service version. Use when you need to check the current version of the shipments API service.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transit Stations

**Slug:** `HERE_GET_STATIONS`

Tool to search for transit stations around a location. Returns station names, locations, and available transit lines. Use when you need to find public transportation stations within a specific area or by station ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | string | No | Comma-separated list of station IDs (max 50, up to 1000 chars). At least one of ids, in, or name+in must be provided. |
| `in_` | string | No | Circular area with center coordinates and optional radius. Format: {lat},{lng};r={radius}. Radius in meters (default: 500). At least one of ids, in, or name+in must be provided. |
| `name` | string | No | Station name or partial name for search (requires 'in' parameter to be set as well) |
| `method` | string | No | For name searches only - 'fuzzy' (default) or 'strict' matching |
| `return_` | string | No | Defines which place attributes are included. Comma-separated values: transport, accessPoints |
| `maxPlaces` | integer | No | Maximum number of stations to return (default: 5, max: 50 for location search or 25 for name search) |
| `modesInPlace` | string | No | Transit mode filter (inclusive or exclusive list) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tour Planning Job Status

**Slug:** `HERE_GET_STATUS_STATUS_ID`

Check the status of an asynchronous tour planning optimization job. Use when you have submitted a tour planning problem and need to poll for completion. Returns the current status ('pending', 'inProgress', 'success', 'timeout', or 'failure'). When completed successfully, provides resource object with problemId and solution URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `statusId` | string | Yes | Status ID returned from async tour planning problem submission. Use this to poll for job completion status. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Server Timestamp

**Slug:** `HERE_GET_TIMESTAMP`

Tool to get the current server timestamp from HERE Tracking API. Use when you need a synchronized Unix epoch timestamp (seconds since 1970-01-01 00:00:00 UTC) from HERE servers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `X_Request_Id` | string | No | ID used for correlating requests within HERE Tracking. Used for logging and error reporting. Must be a valid UUIDv4. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Traces Service Health

**Slug:** `HERE_GET_TRACES_HEALTH`

Tool to check the health status of the HERE Tracking service. Use when you need to verify if the traces API is operational and performing as expected.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tracking Service Version

**Slug:** `HERE_GET_TRACES_VERSION`

Tool to retrieve the current version of the HERE Tracking service. Use when you need to check the service version for compatibility or diagnostic purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Traffic Flow

**Slug:** `HERE_GET_TRAFFIC_FLOW`

Tool to retrieve real-time traffic flow data. Use when you need current congestion metrics for a specified area.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `in` | string | Yes | Spatial filter defining area of interest. Formats: circle:lat,lng;r=radiusMeters \| bbox:west,south,east,north \| corridor:flexiblePolyline;r=bufferMeters |
| `advancedFeatures` | string | No | Optional advanced feature flag; e.g., 'deepCoverage'. |
| `useRefReplacements` | boolean | No | Optional flag for reference replacements in corridor requests. |
| `locationReferencing` | string ("shape" | "tmc" | "olr") | Yes | Location referencing scheme for road segments. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Traffic Incidents

**Slug:** `HERE_GET_TRAFFIC_INCIDENTS`

Tool to fetch real-time traffic incidents within a specified area. Use when you need up-to-date incident data for a geographic region.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `in` | string | Yes | Geospatial filter for the query area. Syntax: circle:lat,lng;r=meters \| bbox:w,s,e,n \| corridor:ENCODED_POLYLINE;r=meters |
| `type` | string | No | Filter incidents by type (e.g., construction, accident). |
| `criticality` | string | No | Filter incidents by severity (e.g., major, minor). |
| `locationReferencing` | string ("shape" | "tmc" | "olr") | Yes | Road location referencing scheme; one of shape, tmc (Traffic Message Channel), or olr (OpenLR). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Traffic Tile

**Slug:** `HERE_GET_TRAFFIC_TILE`

Retrieve a traffic flow overlay tile image showing real-time traffic conditions. Returns a PNG image tile that can be overlaid on maps to visualize traffic speed and congestion. Use this when you need to display traffic flow data for a specific geographic area defined by tile coordinates (zoom, x, y).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `x` | integer | Yes | Tile column index (XYZ scheme), must be non-negative |
| `y` | integer | Yes | Tile row index (XYZ scheme), must be non-negative |
| `size` | integer ("256" | "512") | Yes | Tile size in pixels. Allowed values: 256 or 512. |
| `zoom` | integer | Yes | Tile zoom level (XYZ scheme), must be between 0 and 20 |
| `format` | string ("png" | "png8") | Yes | Image format for the traffic tile (only png and png8 are supported by the v3 flow API) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Users Service Health

**Slug:** `HERE_GET_USERS_HEALTH`

Tool to check the HERE Tracking Users API service health status. Use this to verify that the service is operational before making other API calls.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Users Service Version

**Slug:** `HERE_GET_USERS_VERSION`

Tool to get the current version of the HERE tracking service. Use when you need to verify the service version or check service availability.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Vector Tile

**Slug:** `HERE_GET_VECTOR_TILE`

Retrieves protocol buffer encoded binary vector tiles using HERE Vector Tile API v2. Returns map tiles in OMV (Optimized Map for Visualization) format following the Map Vector Tile open specification. Use this when you need vector tile data at specific tile coordinates and zoom levels for client-side map rendering. Supports layer exclusion and conditional requests via ETags.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `x` | integer | Yes | Specifies the X coordinate index. This parameter is dependent upon the tile Zoom level. Minimum is 0, maximum is 2^z-1 (depends on the Zoom level). |
| `y` | integer | Yes | Specifies the Y coordinate index. This parameter is dependent upon the tile Zoom level. Minimum is 0, maximum is 2^z-1 (depends on the Zoom level). |
| `z` | integer | Yes | Specifies the tile Zoom level. Accepted values range from 0-17. |
| `mv` | string | No | Specifies the map version to be used. The map version can be retrieved by querying /info endpoint. |
| `layer` | string ("base" | "core") | Yes | Specifies the layers available in the tile. The access to each layer is determined by the contract of the user. 'base' includes base layer, 'core' includes everything from 'base' and additional data for some countries (for example: Japan). |
| `format` | string ("omv") | Yes | Specifies the tile format. 'omv' = Optimized Map for Visualization (follows Map Vector Tile open specification). |
| `datasets` | string | No | Specifies comma separated list of layer names to be excluded from the resulting Map Vector Tile. Should follow: (-LAYER_1,-LAYER_2,...). Examples: (-roads) to remove just roads, (-roads,-water,-buildings) to remove roads, water areas and buildings. |
| `projection` | string ("mc") | Yes | Specifies the tile projection. 'mc' = Mercator Projection. |
| `if_none_match` | string | No | Specifies an optional entity tag of the resource cached in the client. Used for conditional requests. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Vector Tiles Layers Documentation

**Slug:** `HERE_GET_VECTORTILE_DOCS_LAYERS_JSON`

Tool to retrieve OMV-2 layers documentation for HERE Vector Tiles. Returns comprehensive schema documentation including layer definitions, geometry types, field names, and possible values in TileJSON 3.0.0 format. Use when you need to understand the data structure of vector tiles before requesting or processing them.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Vector Tiles Copyright

**Slug:** `HERE_GET_VECTORTILES_COPYRIGHT`

Tool to retrieve copyright information for HERE vector tiles. Returns copyright labels, alt text, zoom level ranges, and bounding boxes for both base and core map layers. Use when you need to display proper copyright attribution for vector tile maps.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Vector Tiles Info

**Slug:** `HERE_GET_VECTORTILES_INFO`

Tool to retrieve the current map version from HERE Vector Tiles Service. Use when you need the encoded map version identifier, which is valid for 24 hours and must be refreshed after that period.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Vector Tiles Languages

**Slug:** `HERE_GET_VECTORTILES_LANGUAGES`

Tool to retrieve supported languages for vector map tiles from HERE Vector Tiles API. Use when you need to determine which language options are available for rendering vector map labels and text on different layers (base, core).

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Vector Tiles OpenAPI Specification

**Slug:** `HERE_GET_VECTORTILES_OPENAPI`

Tool to retrieve the OpenAPI specification for the HERE Vector Tiles API v2. Use when you need the complete API schema documentation for vector tile endpoints.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Vector Tiles Proto Formats

**Slug:** `HERE_GET_VECTORTILES_PROTO`

Tool to retrieve a list of available protocol buffer formats from HERE Vector Tiles Service. Use when you need to discover available proto file formats for subsequent requests.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Vector Tiles Proto File

**Slug:** `HERE_GET_VECTORTILES_PROTO_NAME`

Tool to retrieve protocol buffer (.proto) file format definitions from HERE Vector Tiles API. Returns the specified .proto file that defines the data structure for vector tiles. Use when you need the protocol buffer schema to parse or understand the binary vector tile format.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Specifies the name of the requested protocol buffer format file. This is the filename of the .proto file to retrieve, such as 'vector_tile.proto' which defines the structure for vector tile data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Vector Tiles Political Views

**Slug:** `HERE_GET_VECTORTILES_PVIEWS`

Tool to retrieve available political views for HERE vector tiles. Returns lists of country codes that have disputed territories in base and core map data. Use when you need to determine which political view codes are valid for the 'pview' parameter in tile requests.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Version

**Slug:** `HERE_GET_VERSION`

Tool to retrieve the version information of the HERE Traffic API. Use when you need to check the current API version or service version.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `X-Request-Id` | string | No | User-provided token that can be used to trace a request or a group of requests sent to the service. This can be any string but UUID is preferred. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Waypoint Sequence

**Slug:** `HERE_GET_WAYPOINT_SEQUENCE`

Optimizes the visit order of multiple waypoints between a fixed origin and destination. Returns the most efficient sequence to visit all intermediate points, minimizing either travel time or distance. Useful for delivery routing, tour planning, and multi-stop journey optimization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `origin` | string | Yes | Start coordinate as 'lat,lon', e.g., '52.53086,13.38474'. |
| `return` | array | No | Additional response data to include. 'summary' contains travel time and distance (always included). 'polyline' adds encoded route geometry. |
| `waypoint` | array | Yes | One or more intermediate waypoints as 'lat,lon'. |
| `arrivalTime` | string | No | ISO 8601 arrival time, e.g., '2023-01-01T17:00:00Z'. |
| `destination` | string | Yes | End coordinate as 'lat,lon', e.g., '52.52079,13.40942'. |
| `routingMode` | string ("fast" | "short") | No | Routing optimization objective: 'fast' minimizes travel time, 'short' minimizes distance. Defaults to 'fast'. |
| `alternatives` | boolean | No | If true, include alternative optimized sequence if available. |
| `departureTime` | string | No | ISO 8601 departure time, e.g., '2023-01-01T08:00:00Z'. |
| `transportMode` | string ("car" | "truck" | "pedestrian" | "bicycle") | No | Mode of transport for route optimization. Different modes use different speeds and road access rules. Defaults to 'car'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Daily Weather Forecast

**Slug:** `HERE_GET_WEATHER_FORECAST_DAILY`

Get 7-day weather forecasts for any location worldwide. Returns either detailed segment-level forecasts (morning/afternoon/evening/night) or simplified daily summaries. Supports location queries by city name, coordinates, or U.S. ZIP codes. Use 'forecast7days' for comprehensive weather planning, 'forecast7daysSimple' for quick daily overview.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Location as free-form text query (e.g., 'Berlin,Germany' or 'Tokyo,Japan'). Provide exactly one of: q, location, or zipCode. |
| `lang` | string | No | Response language as IETF BCP-47 language tag (e.g., 'en-US' for English, 'fr-FR' for French, 'de-DE' for German). Affects weather descriptions and text. |
| `units` | string ("metric" | "imperial") | No | Measurement system. One of 'metric' (default) or 'imperial'. |
| `zipCode` | string | No | U.S. ZIP code for location (e.g., '90210' for Beverly Hills). Only works for U.S. locations. Provide exactly one of: q, location, or zipCode. |
| `location` | string | No | Geographic coordinates as 'latitude,longitude' in WGS-84 format (e.g., '40.7128,-74.0060' for NYC). Provide exactly one of: q, location, or zipCode. |
| `products` | string ("forecast7days" | "forecast7daysSimple") | Yes | Forecast product type: 'forecast7days' returns detailed segment-level forecasts (morning/afternoon/evening/night) with full weather data, 'forecast7daysSimple' returns one summary per day with high/low temps and UV index. |
| `politicalView` | string | No | Political view for disputed territories as ISO 3166-1 alpha-3 country code (e.g., 'CHN' for China, 'IND' for India). Affects how borders/territories are represented. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Weather Observation

**Slug:** `HERE_GET_WEATHER_OBSERVATION`

Tool to retrieve current weather observation. Use after determining a specific location to get up-to-date weather conditions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Free-text location query (e.g., 'Berlin, Germany') |
| `lang` | string | No | Response language (BCP-47 language tag, e.g., 'en-US') |
| `units` | string ("metric" | "imperial") | No | Units of measurement: 'metric' (SI) or 'imperial' |
| `zipCode` | string | No | US ZIP code (e.g., '10001') |
| `location` | string | No | Latitude,longitude pair in WGS-84 format (e.g., '52.52,13.4050') |
| `politicalView` | string | No | Political view (ISO country code) for disputed territories |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Import Route from Trace

**Slug:** `HERE_IMPORT_ROUTE`

Tool to import and calculate a route from GPS trace points. Accepts a polyline of coordinates and returns routing information including traffic delays, turn-by-turn instructions, and actions. Use when you need to convert a sequence of GPS coordinates into a structured route with navigation details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `via` | array | No | List of via waypoints specifying indices in the trace array that must be passed through. |
| `lang` | array | No | List of preferred languages for response (IETF BCP 47 format, e.g., ['en-US', 'de-DE']). First supported language will be used. |
| `spans` | array | No | Map content attributes to include in response spans (e.g., attributes, length, countryCode). Requires polyline in return parameter. |
| `trace` | array | Yes | List of GPS trace points defining the route path. Minimum 2 points required, maximum 50,000 points allowed. |
| `units` | string ("metric" | "imperial") | No | Units of measurement for guidance instructions. |
| `return` | array | No | Attributes to include in response. Options: polyline, actions, instructions, summary, travelSummary, turnByTurnActions, mlDuration, typicalDuration, elevation, routeHandle, passthrough, incidents, routingZones, truckRoadTypes, tolls. Note: actions requires polyline; instructions requires actions; turnByTurnActions requires polyline. |
| `departureTime` | string | No | Departure time in RFC 3339 format (e.g., '2019-06-24T01:23:45'). Use 'any' to ignore time. If omitted, current time at departure is used. |
| `transportMode` | string ("car" | "truck" | "pedestrian" | "bicycle" | "scooter" | "taxi" | "bus" | "privateBus") | Yes | Mode of transport for route calculation. Note: bicycle, bus, privateBus, and taxi are Beta with limited functionality. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Locate Device

**Slug:** `HERE_LOCATE_DEVICE`

Determine device location based on WiFi and cellular network measurements. Supports 2G/3G/4G/5G cellular (GSM, WCDMA, TD-SCDMA, LTE, CDMA) and WLAN positioning. Use when you need to locate a device using network infrastructure data instead of GPS. At least one network measurement type must be provided.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `gsm` | array | No | GSM cell measurements (GERAN, 2G). Minimum 1, maximum 16 items. At least one of gsm, wcdma, tdscdma, lte, cdma, or wlan must be provided. |
| `lte` | array | No | LTE cell measurements (E-UTRA, 4G). Minimum 1, maximum 16 items. At least one of gsm, wcdma, tdscdma, lte, cdma, or wlan must be provided. |
| `cdma` | array | No | CDMA cell measurements (CDMA2000). Minimum 1, maximum 16 items. At least one of gsm, wcdma, tdscdma, lte, cdma, or wlan must be provided. |
| `wlan` | array | No | WLAN access point measurements. Minimum 1, maximum 256 items. For privacy, positioning based on a single WLAN AP requires fallback=singleWifi. At least one of gsm, wcdma, tdscdma, lte, cdma, or wlan must be provided. |
| `wcdma` | array | No | WCDMA cell measurements (UTRA-FDD, 3G UMTS). Minimum 1, maximum 16 items. At least one of gsm, wcdma, tdscdma, lte, cdma, or wlan must be provided. |
| `client` | object | Yes | Information about the client device and software. |
| `desired` | array | No | Additional data fields to include in the response if data is available. Supports value 'altitude'. |
| `tdscdma` | array | No | TD-SCDMA cell measurements (UTRA-TDD, 3G UMTS TDD). Minimum 1, maximum 16 items. At least one of gsm, wcdma, tdscdma, lte, cdma, or wlan must be provided. |
| `fallback` | array | No | Acceptable fallback options for cell and WLAN positioning. Values 'area' and 'any' apply to cell based positioning, and value 'singleWifi' applies to WLAN based positioning. |
| `required` | array | No | Additional data fields that must be included in the response. If the data is not available, the response contains an error message. Supports value 'altitude'. |
| `confidence` | integer | No | Confidence level in percent for the accuracy/uncertainty in the location estimate response. If not specified, the default is 68 (this corresponds to a 68%% probability that the true position is within the accuracy/uncertainty radius: the higher the number, the greater the confidence level). |
| `X-Request-ID` | string | No | ID used for correlating customer requests within HERE services. Used for logging and error reporting. Can be any string, but UUID is recommended. |
| `Content-Encoding` | string ("gzip") | No | Content encoding types for request body. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Lookup Location by HERE ID

**Slug:** `HERE_LOOKUP`

Retrieves comprehensive details for a location using its HERE ID. Returns structured data including address, coordinates, categories, contacts, and references. Use this action when you have a HERE ID from geocoding, search, or discovery actions and need complete information about that specific location. Supports both place IDs and address IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | HERE location identifier to look up. Must be a valid HERE ID obtained from geocoding, search, or discovery endpoints. Supports place IDs (e.g., 'here:pds:place:...') and address IDs (e.g., 'here:af:streetsection:...'). |
| `lang` | string | No | Language code for localized results (BCP-47 format, e.g., 'en-US', 'de-DE', 'fr-FR'). If not specified, defaults to the location's native language. |
| `show` | string | No | Comma-separated list of additional data sections to include. Use 'tz' to include timezone information. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Calculate Routes via POST

**Slug:** `HERE_POST_ROUTES`

Calculate routes using POST method with extensive customization options via request body. Supports car, truck, pedestrian, bicycle, scooter, taxi, and bus modes. Use when you need to avoid specific areas/segments, specify EV preferences, or set speed restrictions that exceed URL length limits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ev` | object | No | EV parameters for electric vehicle routing |
| `via` | array | No | Via waypoints in format '{lat},{lng}[PlaceOptions][WaypointOptions]'. Route will traverse these sequentially. |
| `lang` | array | No | List of preferred languages (IETF BCP 47). First supported language will be used. Example: ['zh-tw', 'en-gb'] |
| `avoid` | object | No | Avoid routes through specified areas or segments |
| `spans` | array | No | Map content attributes for spans (e.g., 'attributes', 'length'). Requires 'polyline' in return parameter. |
| `units` | string ("metric" | "imperial") | No | Units of measurement for guidance instructions. Default is 'metric'. |
| `origin` | string | Yes | Origin location in format '{lat},{lng}[PlaceOptions][WaypointOptions]'. Example: '52.5200,13.4050' |
| `return` | array | No | Route/section attributes to include: 'polyline', 'actions', 'instructions', 'summary', 'travelSummary', 'turnByTurnActions', 'elevation', 'routeHandle', 'incidents', 'tolls', etc. Note: 'actions' requires 'polyline'. |
| `currency` | string | No | ISO 4217 currency code for toll cost calculation. If not provided, router specifies local currency. |
| `arrivalTime` | string | No | Arrival time in RFC 3339 format. Not supported for EV routing, route handle, or route import. |
| `destination` | string | Yes | Destination location in format '{lat},{lng}[PlaceOptions][WaypointOptions]'. Example: '50.1109,8.6821' |
| `routingMode` | string ("fast" | "short") | No | Optimization type: 'fast' optimizes by travel time, 'short' minimizes distance. Note: bicycle, bus, pedestrian, privateBus, scooter, taxi only support 'fast'. |
| `alternatives` | integer | No | Number of alternative routes to return aside from optimal route. |
| `departureTime` | string | No | Departure time in RFC 3339 format (e.g., '2019-06-24T01:23:45'). Special value 'any' means time-independent routing. |
| `transportMode` | string ("car" | "truck" | "pedestrian" | "bicycle" | "scooter" | "taxi" | "bus" | "privateBus") | Yes | Mode of transport for route calculation. Note: bicycle, bus, privateBus, and taxi modes are Beta with limited functionality. |
| `pedestrian_speed` | number | No | Walking speed in meters per second. Influences duration of walking segments. |
| `maxSpeedOnSegment` | array | No | Segments with maximum base speed restrictions. Max 250 penalized segments total. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reverse Geocode Coordinates

**Slug:** `HERE_REVERSE_GEOCODE`

Converts geographic coordinates (latitude, longitude) into human-readable addresses and location details. Use this tool when you need to: - Find the street address for a specific GPS coordinate - Identify what place or building is at a location - Get detailed address components (street, city, postal code, country) - Determine timezone information for coordinates Returns structured address data including full labels, administrative divisions, and distance from query point. Supports worldwide coverage with responses in multiple languages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `at` | string | Yes | Geographic coordinates to reverse geocode, formatted as 'latitude,longitude' (e.g., '52.5160,13.3779' for Berlin). Use decimal degrees with up to 5 decimal places for precision. |
| `lang` | string | No | Preferred language for the response using BCP-47 language tags (e.g., 'en-US' for English, 'de-DE' for German, 'ja-JP' for Japanese). Affects address labels and place names. |
| `show` | string | No | Additional information to include in the response. Use 'tz' to include timezone data (name and UTC offset) for the location. Can be useful for determining local time at coordinates. |
| `_showNavAttributes` | string | No | Navigation-specific attributes to include, such as 'speedLimits' for road speed limit information. Useful for routing and navigation applications. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Submit Tour Planning Problem

**Slug:** `HERE_SUBMIT_TOUR_PLANNING_PROBLEM`

Submit a tour planning problem synchronously to solve vehicle routing problems with constraints like time windows, capacity, and vehicle types. Returns optimized tours for the fleet with routes, schedules, and statistics. Use when you need to optimize delivery/pickup routes for multiple vehicles.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `plan` | object | Yes | Plan containing jobs with delivery/pickup tasks and time windows. |
| `fleet` | object | Yes | Fleet definition with vehicle types and routing profiles. |
| `configuration` | object | No | Optional algorithm configuration including termination criteria. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Submit Tour Planning Problem (Async)

**Slug:** `HERE_SUBMIT_TOUR_PLANNING_PROBLEM_ASYNC`

Submit a tour planning problem asynchronously for large-scale vehicle routing optimization. Returns a status ID to poll for results. Use this for complex problems with multiple vehicles, jobs, and constraints. Supports up to 3000 jobs and 150 vehicle types.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `plan` | object | Yes | Tour planning problem definition with jobs |
| `fleet` | object | Yes | Fleet configuration with vehicle types and profiles |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Weather Alerts

**Slug:** `HERE_WEATHER_ALERTS`

Retrieve severe weather alerts for specified locations or routes. This tool queries the HERE Weather API to get active weather alerts including severe weather warnings, watches, and advisories. Supports multiple location inputs: - q: Free-text location query (e.g., 'Berlin, Germany', 'New York') - location: Precise coordinates in 'lat,lng' format (e.g., '52.5200,13.4050') - zipCode: US ZIP code (e.g., '10001') Optional parameters: - units: 'metric' or 'imperial' for measurement units - lang: Language code for alert descriptions (e.g., 'en-US', 'de-DE') - politicalView: ISO country code for disputed territory representation Returns alert information including location, severity, type, and time segments when alerts are active. Empty timeSegments list indicates no active alerts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Free-text location query (e.g., 'Berlin, Germany') |
| `body` | object | No | GeoJSON FeatureCollection describing points or routes to check |
| `lang` | string | No | Response language (IETF BCP-47 tag, e.g., 'en-US') |
| `units` | string ("metric" | "imperial") | No | Units of measurement: 'metric' or 'imperial' |
| `apiKey` | string | Yes | HERE API key for authentication |
| `zipCode` | string | No | US ZIP code (e.g., '10001') |
| `location` | string | No | Coordinates in 'lat,lng' WGS-84 format (e.g., '52.5200,13.4050') |
| `politicalView` | string | No | Political view (ISO country code) for disputed territories |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Astronomy Forecast

**Slug:** `HERE_WEATHER_ASTRONOMY`

Tool to fetch astronomical data (sunrise, sunset) for a specific location. Use when you need daily sun and moon event times.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Free-text place query (e.g., 'Riga, Latvia'). |
| `lang` | string | No | IETF BCP-47 language tag for response (e.g., 'en-US'). |
| `units` | string ("metric" | "imperial") | No | Measurement units: 'metric' (default) or 'imperial'. |
| `zipCode` | string | No | U.S. ZIP code (e.g., '90210'). |
| `location` | string | No | Coordinates as 'latitude,longitude' (e.g., '52.5251,13.3694'). |
| `hourlyDate` | string | No | Filter hourly products by date 'YYYY-MM-DD'. |
| `politicalView` | string | No | ISO-3166-1 country code for disputed territories (e.g., 'CHN'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Hourly Weather Forecast

**Slug:** `HERE_WEATHER_FORECAST_HOURLY`

Tool to fetch hourly weather forecasts. Use when you need up to 48 hours of forecast data for a location.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Free-text location query (e.g., 'Berlin, Germany') |
| `lang` | string | No | IETF language tag for localized output (e.g., 'en-US') |
| `units` | string ("metric" | "imperial") | No | Measurement units: 'metric' (default) or 'imperial' |
| `apiKey` | string | Yes | HERE API key for authentication |
| `zipCode` | string | No | U.S. ZIP code (e.g., '90210'), US only |
| `location` | string | No | Coordinates in 'lat,lon' WGS-84 format (e.g., '52.5200,13.4050') |
| `products` | string | Yes | Must be 'forecastHourly' to retrieve hourly forecasts |
| `hourlyDate` | string | No | Date (YYYY-MM-DD) for which hourly data is requested |
| `politicalView` | string | No | Political view for disputed territories, ISO country code |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |