Here

Learn how to use Here with Composio

Overview

SLUG: HERE

Description

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.

Authentication Details

full
stringRequired
generic_api_key
stringRequired

Connecting to Here

Create an auth config

Use the dashboard to create an auth config for the Here toolkit. This allows you to connect multiple Here accounts to Composio for agents to use.

1

Select App

Navigate to Here.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Here Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4here_auth_config_id = "ac_YOUR_HERE_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10 # Replace this with a method to retrieve an API key from the user.
11 # Or supply your own.
12 user_api_key = input("[!] Enter API key")
13
14 connection_request = composio.connected_accounts.initiate(
15 user_id=user_id,
16 auth_config_id=auth_config_id,
17 config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18 )
19
20 # API Key authentication is immediate - no redirect needed
21 print(f"Successfully connected Here for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, here_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Here toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["HERE"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Autosuggest Places

Description

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

Action Parameters

at
string
in
string
lang
string
limit
integer
q
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Browse Places

Description

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.

Action Parameters

at
stringRequired
categories
string
foodTypes
string
lang
string
limit
integer
name
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Calculate Fleet Telematics Route

Description

Tool to calculate a route between waypoints with vehicle profile options. Use when planning a route with toll and vehicle constraints.

Action Parameters

fuelType
string
ignorePreferredRoutes
boolean
instructionFormat
string
maneuverAttributes
array
mode
stringRequired
overlays
string
routeAttributes
array
waypoints
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Coordinates to Tile Indices

Description

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.

Action Parameters

lat
numberRequired
lng
numberRequired
zoom
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Discover Places

Description

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.

Action Parameters

at
string
in_
string
lang
string
limit
integer
q
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Geocode Address

Description

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

Action Parameters

at
string
in_
string
lang
string
limit
integer
politicalView
string
q
string
qq
string
show
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Aerial Tile

Description

Tool to retrieve a satellite/aerial map tile. Use when you need tile imagery for a given zoom level and coordinates.

Action Parameters

features
string
format
stringRequired
lang
string
lang2
string
ppi
integer
pview
string
size
integer
style
stringDefaults to satellite.day
x
integerRequired
y
integerRequired
zoom
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Base Map Tile

Description

Tool to retrieve a base map tile image without labels. Use after determining tile scheme, zoom level, x/y coordinates, size, and format.

Action Parameters

format
stringRequired
scheme
stringRequired
size
integerRequired
x
integerRequired
y
integerRequired
zoom
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Hybrid Map Tile

Description

Tool to retrieve a hybrid (aerial + labels) map tile. Use when you need a labeled aerial map tile for a specific zoom level, tile coordinates, size, and format. Example: "Get a 512px PNG hybrid tile for zoom 14 at tile (8587,5700)."

Action Parameters

format
stringRequired
size
integerRequired
x
integerRequired
y
integerRequired
zoom
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Isolines

Description

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

Action Parameters

departureTime
string
destination
string
emptyWeight
number
origin
string
range[type]
stringRequired
range[values]
arrayRequired
routingMode
string
tiresCount
integer
transportMode
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Label Tile

Description

Tool to retrieve a label overlay tile. Use when you need map labels after selecting scheme, zoom, and tile indices.

Action Parameters

format
stringDefaults to png8
lang
string
lang2
string
ppi
integer
pview
string
scheme
stringRequired
size
integerDefaults to 256
x
integerRequired
y
integerRequired
zoom
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Line Overlay Tile

Description

Tool to retrieve a line overlay tile. Use when you need to overlay road and border lines on a base map.

Action Parameters

format
stringRequired
lg
string
ppi
integer
scheme
stringRequired
size
integerRequired
x
integerRequired
y
integerRequired
zoom
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Map Image

Description

Tool to retrieve a static map image. Use when you need a custom map snapshot after specifying center, zoom, overlays, or styles.

Action Parameters

features
string
format
stringRequired
geojson
string
overlay
string
parameters
stringRequired
scaleBar
string
size
stringRequired
style
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Base Map Tile

Description

Tool to retrieve a base map tile. Use when you need map imagery for a specific zoom level, coordinates, size, and format.

Action Parameters

format
stringRequired
scheme
stringRequired
size
integerRequired
x
integerRequired
y
integerRequired
zoom
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Compute Routing Matrix

Description

Tool to compute a routing distance/time matrix. Use when you need batch distances and travel times between multiple origins and destinations.

Action Parameters

async_mode
boolean
departureTime
string
destinations
arrayRequired
origins
arrayRequired
summaryAttributes
array
transportMode
stringDefaults to car

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Meta Info Tile

Description

Tool to retrieve metadata for a specific map tile. Use when you need only metadata about a tile without downloading imagery.

Action Parameters

format
stringRequired
pois
boolean
scheme
stringRequired
size
integerRequired
x
integerRequired
y
integerRequired
zoom
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get POI Tile

Description

Tool to retrieve a point-of-interest overlay tile. Use when you need to overlay POI icons on a map tile at a specific scheme, zoom level, and tile coordinates.

Action Parameters

format
stringRequired
scheme
stringRequired
size
integerRequired
x
integerRequired
y
integerRequired
zoom
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Terrain Map Tile

Description

Tool to retrieve a terrain map tile image. Use when you need terrain and elevation shading details for a specific zoom level, tile coordinates, size, and format.

Action Parameters

format
stringRequired
size
integerRequired
x
integerRequired
y
integerRequired
zoom
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Traffic Flow

Description

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

Action Parameters

advancedFeatures
string
in
stringRequired
locationReferencing
stringRequired
useRefReplacements
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Traffic Incidents

Description

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

Action Parameters

criticality
string
in
stringRequired
locationReferencing
stringRequired
type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Traffic Tile

Description

Tool to retrieve a traffic overlay tile. Use when you need traffic overlay imagery for a given map style, zoom level, tile coordinates, size, and format.

Action Parameters

app_code
string
app_id
string
format
stringRequired
min_traffic_congestion
string
ppi
integer
scheme
stringRequired
size
integerRequired
time
string
x
integerRequired
y
integerRequired
zoom
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Waypoint Sequence

Description

Tool to optimize the visit order of multiple waypoints. Use after specifying a start and end location with intermediate points to get the most efficient route.

Action Parameters

alternatives
boolean
arrivalTime
string
departureTime
string
destination
stringRequired
origin
stringRequired
return
array
routingMode
string
transportMode
string
waypoint
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Daily Weather Forecast

Description

Tool to provide daily weather forecasts (up to 7 days). Use when you need a multi-day outlook for a specific location. Returns detailed or simplified daily data based on the 'products' parameter.

Action Parameters

lang
string
location
string
politicalView
string
products
stringRequired
q
string
units
stringDefaults to metric
zipCode
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Weather Observation

Description

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

Action Parameters

lang
string
location
string
politicalView
string
q
string
units
stringDefaults to metric
zipCode
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Hourly Weather Forecast

Description

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

Action Parameters

apiKey
stringRequired
hourlyDate
string
lang
string
location
string
politicalView
string
products
stringRequired
q
string
units
stringDefaults to metric
zipCode
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Lookup Place Details

Description

Tool to look up detailed information for a place by its HERE ID. Use when you have obtained a HERE identifier and need full metadata about that location.

Action Parameters

id
stringRequired
lang
string
show
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Reverse Geocode Coordinates

Description

Tool to convert geographic coordinates into a human-readable address. Use when you have latitude and longitude and need the nearest address.

Action Parameters

_showNavAttributes
string
at
stringRequired
lang
string
show
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Weather Alerts

Description

Tool to retrieve severe weather alerts for specified locations or routes. Use after constructing a GeoJSON FeatureCollection of points or corridors to assess potential weather hazards.

Action Parameters

apiKey
stringRequired
body
object
lang
string
location
string
politicalView
string
q
string
units
string
zipCode
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Astronomy Forecast

Description

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

Action Parameters

hourlyDate
string
lang
string
location
string
politicalView
string
q
string
units
string
zipCode
string

Action Response

data
objectRequired
error
string
successful
booleanRequired