The HERE connector lets your AI agent act in each user's HERE account. Each user connects their own HERE API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 26 tools.
- Tools
- 26
- What they doRead · write · destructive
- 26 · 0 · 026 read0 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the HERE connection
In AgentKit > Connections, create a HERE connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'here'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize HERE:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'here_geocode',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "here"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize HERE:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="here_geocode",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their HERE credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolhere_address_autocompleteComplete a partial address entry into full address candidates.Read-onlyAutocomplete Address
Complete a partial address entry into full address candidates. Returns items with title, id, resultType, address and highlighting. Use this for address forms. Use here_places_autosuggest when places should be included.
Inputs
qstringrequired- Partial address text. Example: Invalidenstraße 1.
atstring- Position as latitude,longitude to bias results toward. Example: 52.5308,13.3847.
instring- Area filter: countryCode:<ISO 3166-1 alpha-3 list>, circle:lat,lng;r=<meters>, or bbox:west,south,east,north. Example: countryCode:USA,CAN.
langstring- BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
limitinteger- Maximum number of results (1-100, default 20). Example: 10.
political_viewstring- ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
typesstring- Result types to return, comma-separated: address, area, city, houseNumber, postalCode, street. Example: houseNumber,street.
here_geocodeConvert a free-form or qualified address or place into coordinates, with the normalized address and match quality.Read-onlyGeocode Address
Convert a free-form or qualified address or place into coordinates, with the normalized address and match quality. Returns items with title, id, resultType, address, position (lat, lng), mapView and scoring. Use this for a known address. Use here_places_discover to search places by name or category, or here_reverse_geocode for coordinates to address.
Inputs
atstring- Position as latitude,longitude to bias results toward. Example: 52.5308,13.3847.
instring- Area filter: countryCode:<ISO 3166-1 alpha-3 list>, circle:lat,lng;r=<meters>, or bbox:west,south,east,north. Example: countryCode:USA,CAN.
langstring- BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
limitinteger- Maximum number of results (1-100, default 20). Example: 10.
political_viewstring- ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
qstring- Free-form address query. Provide q or qq. Example: Invalidenstr 117 Berlin.
qqstring- Qualified query: key=value pairs separated by ; with keys country, state, county, city, district, street, houseNumber, postalCode. Example: houseNumber=117;street=Invalidenstr;city=Berlin.
showstring- Extra sections, comma-separated: countryInfo, parsing, streetInfo, tz. Example: tz,streetInfo.
typesstring- Result types to return, comma-separated: address, area, city, houseNumber, postalCode, street. Example: houseNumber,street.
here_intermodal_routes_calculateCalculate routes that combine public transit with car (park and ride), taxi, rented vehicles, bicycle or walking.Read-onlyCalculate Intermodal Route
Calculate routes that combine public transit with car (park and ride), taxi, rented vehicles, bicycle or walking. Returns routes with sections per mode, times, places and optional polyline and travel summary. Use this for mixed-mode trips. Use here_transit_routes_calculate for transit only or here_routes_calculate for driving.
Inputs
destinationstringrequired- End as latitude,longitude. Example: 52.5005,13.4489.
originstringrequired- Start as latitude,longitude. Example: 52.5307,13.3847.
alternativesinteger- Number of alternative routes. Example: 2.
changesinteger- Maximum number of transit changes. Example: 3.
departure_timestring- Departure time, RFC 3339 date-time; use any to ignore traffic. Defaults to now. Example: 2026-01-15T08:30:00+01:00.
langstring- BCP 47 language. Example: en-US.
rented_enablestring- Where rented vehicles may be used: routeHead, routeTail and/or entireRoute. Example: routeHead.
returnstring- Sections to return, comma-separated: polyline, actions, travelSummary. Example: travelSummary,polyline.
taxi_enablestring- Where a taxi may be used: routeHead, routeTail and/or entireRoute. Example: routeTail.
unitsstring- Unit system for instructions: metric (default) or imperial. Example: metric.one of
metricimperial vehicle_enablestring- Where a private car may be used: routeHead, routeTail and/or entireRoute, comma-separated. Example: routeHead.
here_isolines_calculateCalculate the area reachable from an origin (or that can reach a destination) within given travel times, distances or energy budgets.Read-onlyCalculate Isolines
Calculate the area reachable from an origin (or that can reach a destination) within given travel times, distances or energy budgets. Returns isolines per range value with polygons as encoded flexible polylines, plus departure/arrival place. Use this for reachability or service-area questions. Use here_routes_calculate for a single route.
Inputs
range_typestringrequired- What the range values measure. Example: time.one of
distancetimeconsumption range_valuesstringrequired- Comma-separated range values: seconds for time, meters for distance, Wh for consumption. Example: 600,1200.
transport_modestringrequired- Mode of transport. Example: car.one of
cartruckpedestrianbicyclescootertaxibusprivateBus avoid_featuresstring- Features to avoid, comma-separated: tollRoad, controlledAccessHighway, ferry, carShuttleTrain, tunnel, dirtRoad, difficultTurns, uTurns. Example: tollRoad,ferry.
departure_timestring- Departure time, RFC 3339 date-time; use any to ignore traffic. Defaults to now. Example: 2026-01-15T08:30:00+01:00.
destinationstring- Center as latitude,longitude (isolines to here). Example: 52.5308,13.3847.
optimize_forstring- quality, performance or balanced. Example: balanced.one of
qualityperformancebalanced originstring- Center as latitude,longitude (isolines from here). Provide origin or destination. Example: 52.5308,13.3847.
routing_modestring- fast (default) or short. Example: fast.one of
fastshort shape_max_pointsinteger- Maximum points per isoline polygon. Example: 200.
here_matrix_calculateCalculate travel times and/or distances between every origin and destination.Read-onlyCalculate Route Matrix
Calculate travel times and/or distances between every origin and destination. With async=false the matrix is returned directly; otherwise poll the status. Returns matrix with numOrigins, numDestinations, travelTimes and/or distances arrays (sync), or matrixId and status (async). Use this for many-to-many travel times. Use here_routes_calculate for directions between two points.
Inputs
originsarrayrequired- Origins, each an object with lat and lng. Example: [{"lat": 52.5308, "lng": 13.3847}, {"lat": 52.5200, "lng": 13.4050}]
region_definitionobjectrequired- Area the calculation may use: {"type": "world"} (needs a profile or flexible mode), {"type": "autoCircle"}, a circle, a boundingBox or a polygon. Example: {"type": "autoCircle", "margin": 10000}
asyncboolean- false for a synchronous response (small matrices); true (default) to queue and poll here_matrix_status_get. Example: false.
departure_timestring- RFC 3339 departure time, or any for time-independent results. Example: any.
destinationsarray- Destinations, each an object with lat and lng. Defaults to the origins. Example: [{"lat": 52.5264, "lng": 13.3686}]
matrix_attributesarray- What to return: travelTimes and/or distances. Example: ["travelTimes", "distances"]
profilestring- Predefined profile ID from here_matrix_profiles_list (needed with a world region). Example: carFast.
routing_modestring- fast or short. Example: fast.one of
fastshort transport_modestring- Mode of transport (default car). Example: car.one of
cartruckpedestrianbicyclescootertaxibusprivateBus
here_matrix_profile_getGet one predefined matrix profile.Read-onlyGet Matrix Profile
Get one predefined matrix profile. Returns the profile's transport mode, routing mode and vehicle options. Use this to check a profile before using it.
Inputs
profile_idstringrequired- Profile ID from here_matrix_profiles_list. Example: carFast.
here_matrix_profiles_listList the predefined routing profiles for world-wide matrix calculations.Read-onlyList Matrix Profiles
List the predefined routing profiles for world-wide matrix calculations. Returns profiles with id, transportMode and options. Use this to pick a profile for here_matrix_calculate.
Inputs
This tool takes no inputs.
here_matrix_result_getGet the result of a completed asynchronous matrix calculation.Read-onlyGet Matrix Result
Get the result of a completed asynchronous matrix calculation. Returns matrix with travelTimes and/or distances arrays and any errorCodes. Use this once here_matrix_status_get reports completed.
Inputs
matrix_idstringrequired- Matrix ID from here_matrix_calculate. Example: b2a3c4d5-e6f7-4890-a1b2-c3d4e5f60718.
here_matrix_status_getGet the status of an asynchronous matrix calculation.Read-onlyGet Matrix Status
Get the status of an asynchronous matrix calculation. Returns matrixId, status (accepted, inProgress, completed, failed) and resultUrl when completed. Use this to poll after here_matrix_calculate with async=true, then here_matrix_result_get.
Inputs
matrix_idstringrequired- Matrix ID from here_matrix_calculate. Example: b2a3c4d5-e6f7-4890-a1b2-c3d4e5f60718.
here_place_lookupGet one place or address by its HERE ID from a search result.Read-onlyLook Up Place
Get one place or address by its HERE ID from a search result. Returns the place with title, address, position, categories, contacts, openingHours and references. Use this to refresh a result from here_places_discover or here_geocode by id.
Inputs
idstringrequired- HERE ID of a place or location. Example: here:pds:place:276u33db-8097f3194e4b411081b761ea9a366776.
langstring- BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
political_viewstring- ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
showstring- Extra sections to render, comma-separated, e.g. details, tz, phonemes, streetInfo. Example: details,tz.
here_places_autosuggestSuggest places, addresses and query completions for a partial or misspelled query, for type-ahead search.Read-onlyAutosuggest Places
Suggest places, addresses and query completions for a partial or misspelled query, for type-ahead search. Returns items (place, address, categoryQuery or chainQuery) with title, id, position and highlighting, plus query terms. Use this while the user types. Use here_places_discover for the final search, or here_address_autocomplete for addresses only.
Inputs
qstringrequired- Partial query text. Example: Eiffel tow.
atstring- Search center as latitude,longitude. Results are ranked by distance from it. Example: 52.5308,13.3847.
instring- Area filter: countryCode:<ISO 3166-1 alpha-3 list>, circle:lat,lng;r=<meters>, or bbox:west,south,east,north. Example: countryCode:USA,CAN.
langstring- BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
limitinteger- Maximum number of results (1-100, default 20). Example: 10.
political_viewstring- ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
showstring- Extra sections to render, comma-separated, e.g. details, tz, phonemes, streetInfo. Example: details,tz.
terms_limitinteger- Maximum number of query-term suggestions (0-10). Example: 3.
here_places_browseList places around a position filtered by HERE category IDs, chain IDs, food types or name, ranked by distance.Read-onlyBrowse Places
List places around a position filtered by HERE category IDs, chain IDs, food types or name, ranked by distance. Returns items with title, id, address, position, distance, categories, chains, contacts and openingHours. Use this for 'restaurants near here' style lists. Use here_places_discover for free-text search.
Inputs
atstringrequired- Search center as latitude,longitude. Results are ranked by distance from it. Example: 52.5308,13.3847.
categoriesstring- HERE category IDs, comma-separated (e.g. 100-1000-0000 restaurant, 700-7600-0116 petrol station). Example: 100-1000-0000.
chainsstring- HERE chain IDs, comma-separated. Example: 1566.
food_typesstring- HERE cuisine IDs, comma-separated. Example: 101-000.
instring- Area filter: countryCode:<ISO 3166-1 alpha-3 list>, circle:lat,lng;r=<meters>, or bbox:west,south,east,north. Example: countryCode:USA,CAN.
langstring- BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
limitinteger- Maximum number of results (1-100, default 20). Example: 10.
namestring- Filter by place name. Example: Starbucks.
political_viewstring- ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
showstring- Extra sections to render, comma-separated, e.g. details, tz, phonemes, streetInfo. Example: details,tz.
here_places_discoverSearch for places and addresses with a free-text query (a name, category or address) near a position or in an area.Read-onlyDiscover Places
Search for places and addresses with a free-text query (a name, category or address) near a position or in an area. Returns items with title, id, resultType, address, position, distance, categories, contacts and openingHours. Use this for a full search query. Use here_places_autosuggest for type-ahead, or here_places_browse to list places by category.
Inputs
qstringrequired- Free-text query. Example: coffee shop.
atstring- Search center as latitude,longitude. Results are ranked by distance from it. Example: 52.5308,13.3847.
instring- Area filter: countryCode:<ISO 3166-1 alpha-3 list>, circle:lat,lng;r=<meters>, or bbox:west,south,east,north. Example: countryCode:USA,CAN.
langstring- BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
limitinteger- Maximum number of results (1-100, default 20). Example: 10.
political_viewstring- ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
showstring- Extra sections to render, comma-separated, e.g. details, tz, phonemes, streetInfo. Example: details,tz.
here_reverse_geocodeFind the nearest address or place for a coordinate.Read-onlyReverse Geocode
Find the nearest address or place for a coordinate. Returns items with title, address, position, distance and resultType. Use this for coordinates to address. Use here_geocode for address to coordinates.
Inputs
atstringrequired- Coordinate as latitude,longitude. Example: 52.5308,13.3847.
bearinginteger- Direction of travel in degrees (0 = north) to prefer the side of the street. Example: 90.
langstring- BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
limitinteger- Maximum number of results (1-100, default 20). Example: 10.
political_viewstring- ISO 3166-1 alpha-3 country code whose political view of disputed areas to use. Example: IND.
showstring- Extra sections, comma-separated: countryInfo, streetInfo, tz. Example: tz.
typesstring- Result types to return, comma-separated: address, area, city, houseNumber, postalCode, street. Example: houseNumber,street.
here_route_get_by_handleRecalculate a previously returned route from its route handle (return=routeHandle), e.g.Read-onlyGet Route by Handle
Recalculate a previously returned route from its route handle (return=routeHandle), e.g. with fresh traffic. Returns the route with the requested sections. Use this after here_routes_calculate with return=routeHandle.
Inputs
route_handlestringrequired- Route handle from a previous routes response. Example: AFDAQQoDaXVyWg4BAwAAAG4BLC0AAAAz.
transport_modestringrequired- Mode of transport. Example: car.one of
cartruckpedestrianbicyclescootertaxibusprivateBus departure_timestring- Departure time, RFC 3339 date-time; use any to ignore traffic. Defaults to now. Example: 2026-01-15T08:30:00+01:00.
langstring- BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
originstring- Current position as latitude,longitude to recalculate from. Example: 52.5308,13.3847.
returnstring- Sections to return, comma-separated: summary, polyline, actions, instructions, travelSummary, turnByTurnActions, elevation, routeHandle, incidents, tolls, routingZones, typicalDuration, passthrough, mlDuration, potentialTimeDependentViolations. Example: summary,polyline,actions,instructions.
spansstring- Span attributes to return along the route, comma-separated, e.g. names, speedLimit, length, duration, countryCode. Example: names,speedLimit.
unitsstring- Unit system for instructions: metric (default) or imperial. Example: metric.one of
metricimperial
here_route_importMatch a sequence of GPS trace points to the road network and build a route from it.Read-onlyImport Route from Trace
Match a sequence of GPS trace points to the road network and build a route from it. Returns routes with sections, summary and the requested return attributes, plus any notices about unmatched points. Use this to turn a recorded GPS track into a route. Use here_routes_calculate to plan a new one.
Inputs
tracearrayrequired- Trace points in order, each an object with lat and lng (optional heading, speed, timestamp). Example: [{"lat": 52.5308, "lng": 13.3847}, {"lat": 52.5264, "lng": 13.3686}]
transport_modestringrequired- Mode of transport. Example: car.one of
cartruckpedestrianbicyclescootertaxibusprivateBus departure_timestring- Departure time, RFC 3339 date-time; use any to ignore traffic. Defaults to now. Example: 2026-01-15T08:30:00+01:00.
returnstring- Sections to return, comma-separated: summary, polyline, actions, instructions, travelSummary, turnByTurnActions, elevation, routeHandle, incidents, tolls, routingZones, typicalDuration, passthrough, mlDuration, potentialTimeDependentViolations. Example: summary,polyline,actions,instructions.
spansstring- Span attributes to return along the route, comma-separated, e.g. names, speedLimit, length, duration, countryCode. Example: names,speedLimit.
unitsstring- Unit system for instructions: metric (default) or imperial. Example: metric.one of
metricimperial
here_routes_calculateCalculate a route between an origin and destination, optionally via waypoints, for car, truck, pedestrian, bicycle, scooter, taxi or bus, with traffic-aware timing.Read-onlyCalculate Route
Calculate a route between an origin and destination, optionally via waypoints, for car, truck, pedestrian, bicycle, scooter, taxi or bus, with traffic-aware timing. Returns routes with sections (departure, arrival, transport, summary with duration and length, polyline, actions and turn instructions when requested). Use this for A-to-B directions. Use here_transit_routes_calculate for public transport and here_matrix_calculate for many-to-many travel times.
Inputs
destinationstringrequired- End as latitude,longitude. Example: 52.5264,13.3686.
originstringrequired- Start as latitude,longitude. Example: 52.5308,13.3847.
transport_modestringrequired- Mode of transport. Example: car.one of
cartruckpedestrianbicyclescootertaxibusprivateBus alternativesinteger- Number of alternative routes (0-6). Example: 1.
arrival_timestring- Arrival time, RFC 3339 date-time (cannot be combined with departure_time). Example: 2026-01-15T09:30:00+01:00.
avoid_areasstring- Areas to avoid, separated by |, each bbox:west,south,east,north or polygon:lat,lng;lat,lng;... Example: bbox:13.082,52.416,13.628,52.626.
avoid_featuresstring- Features to avoid, comma-separated: tollRoad, controlledAccessHighway, ferry, carShuttleTrain, tunnel, dirtRoad, difficultTurns, uTurns. Example: tollRoad,ferry.
currencystring- ISO 4217 currency for toll costs. Example: EUR.
departure_timestring- Departure time, RFC 3339 date-time; use any to ignore traffic. Defaults to now. Example: 2026-01-15T08:30:00+01:00.
langstring- BCP 47 language code(s) for result rendering, comma-separated. Example: en-US.
returnstring- Sections to return, comma-separated: summary, polyline, actions, instructions, travelSummary, turnByTurnActions, elevation, routeHandle, incidents, tolls, routingZones, typicalDuration, passthrough, mlDuration, potentialTimeDependentViolations. Example: summary,polyline,actions,instructions.
routing_modestring- fast (default) or short. Example: fast.one of
fastshort spansstring- Span attributes to return along the route, comma-separated, e.g. names, speedLimit, length, duration, countryCode. Example: names,speedLimit.
unitsstring- Unit system for instructions: metric (default) or imperial. Example: metric.one of
metricimperial vehicle_gross_weightinteger- Vehicle gross weight in kilograms (truck routing). Example: 18000.
vehicle_heightinteger- Vehicle height in centimeters (truck routing). Example: 400.
viaarray- Waypoints as latitude,longitude (each sent as its own via parameter, in order). Add !stopDuration=<seconds> to make one a stop. Example: ["52.5200,13.3800"]
here_traffic_flow_getGet real-time traffic flow (speed, free-flow speed, jam factor) for road segments in an area.Read-onlyGet Traffic Flow
Get real-time traffic flow (speed, free-flow speed, jam factor) for road segments in an area. Returns results with location (description, shape or reference) and currentFlow (speed, speedUncapped, freeFlow, jamFactor, confidence, traversability). Use this for congestion levels. Use here_traffic_incidents_list for accidents and closures.
Inputs
instringrequired- Area: circle:lat,lng;r=<meters>, bbox:west,south,east,north or corridor:<flexible polyline>;r=<meters>. Example: circle:52.5308,13.3847;r=1000.
location_referencingstringrequired- Location referencing to return: shape (coordinates), olr (OpenLR), tmc, or segmentRef; comma-separated. Example: shape.
functional_classesstring- Road functional classes 1-5, comma-separated (1 = major highways). Example: 1,2.
max_jam_factornumber- Only segments with jam factor at or below this (0-10). Example: 10.
min_jam_factornumber- Only segments with jam factor at or above this (0-10). Example: 4.
here_traffic_incident_getGet one traffic incident by its original ID.Read-onlyGet Traffic Incident
Get one traffic incident by its original ID. Returns the incident's location and details. Use this to refresh an incident from here_traffic_incidents_list.
Inputs
location_referencingstringrequired- Location referencing to return: shape (coordinates), olr (OpenLR), tmc, or segmentRef; comma-separated. Example: shape.
original_idstringrequired- originalId from an incident. Example: 4236935297806712858.
langstring- BCP 47 language for descriptions. Example: en-US.
unitsstring- Unit system for instructions: metric (default) or imperial. Example: metric.one of
metricimperial
here_traffic_incidents_listList real-time traffic incidents (accidents, construction, closures, congestion) in an area.Read-onlyList Traffic Incidents
List real-time traffic incidents (accidents, construction, closures, congestion) in an area. Returns results with location and incidentDetails (id, type, criticality, description, startTime, endTime, roadClosed). Use this for disruptions. Use here_traffic_incident_get for one incident and here_traffic_flow_get for speeds.
Inputs
instringrequired- Area: circle:lat,lng;r=<meters>, bbox:west,south,east,north or corridor:<flexible polyline>;r=<meters>. Example: circle:52.5308,13.3847;r=1000.
location_referencingstringrequired- Location referencing to return: shape (coordinates), olr (OpenLR), tmc, or segmentRef; comma-separated. Example: shape.
criticalitystring- Criticality levels, comma-separated: critical, major, minor, low. Example: critical,major.
earliest_start_timestring- Only incidents starting at or after this RFC 3339 time. Example: 2026-01-15T00:00:00Z.
langstring- BCP 47 language for descriptions. Example: en-US.
latest_end_timestring- Only incidents ending at or before this RFC 3339 time. Example: 2026-01-16T00:00:00Z.
typestring- Incident types, comma-separated: accident, congestion, construction, disabledVehicle, massTransit, plannedEvent, roadHazard, roadClosure, weather, laneRestriction, other. Example: accident,roadClosure.
unitsstring- Unit system for instructions: metric (default) or imperial. Example: metric.one of
metricimperial
here_transit_departures_listList the next public transit departures from stations near a location or from given station IDs.Read-onlyList Transit Departures
List the next public transit departures from stations near a location or from given station IDs. Returns boards with place (station name, id, location) and departures (time, delay, transport name, headsign, mode, agency). Use this for live departure boards. Use here_transit_stations_search to find station IDs.
Inputs
idsstring- Station IDs, comma-separated (max 50). Example: 415272394.
instring- Search area as lat,lng;r=<meters> (radius optional, default 500). Provide in or ids. Example: 41.90123,12.50091;r=500.
langstring- BCP 47 language. Example: en-US.
max_per_boardinteger- Maximum departures per station (default 40). Example: 10.
max_placesinteger- Maximum number of stations when searching by location (1-50, default 5). Example: 3.
modesstring- Transit modes to include or exclude, comma-separated. Example: bus,subway.
timestring- Start of the departure window, RFC 3339. Defaults to now. Example: 2026-01-15T08:00:00+01:00.
here_transit_routes_calculateCalculate public transit routes between two points, with walking legs and transfers.Read-onlyCalculate Transit Route
Calculate public transit routes between two points, with walking legs and transfers. Returns routes with sections (pedestrian or transit, departure and arrival place and time, transport name, headsign, agency) and optional polyline, travelSummary, fares. Use this for public transport directions. Use here_intermodal_routes_calculate to combine transit with car, taxi or bike.
Inputs
destinationstringrequired- End as latitude,longitude. Example: 41.90096,12.50243.
originstringrequired- Start as latitude,longitude. Example: 41.79457,12.25473.
alternativesinteger- Number of alternative routes (0-6). Example: 2.
arrival_timestring- Arrival time, RFC 3339 date-time (cannot be combined with departure_time). Example: 2026-01-15T09:30:00+01:00.
changesinteger- Maximum number of transfers. Example: 2.
departure_timestring- Departure time, RFC 3339 date-time; use any to ignore traffic. Defaults to now. Example: 2026-01-15T08:30:00+01:00.
langstring- BCP 47 language. Example: en-US.
modesstring- Transit modes to include or exclude (prefix -), comma-separated, e.g. subway,bus or -highSpeedTrain. Example: subway,bus.
returnstring- Sections to return, comma-separated: polyline, actions, travelSummary, fares, intermediate, bookingLinks. Example: travelSummary,polyline.
unitsstring- Unit system for instructions: metric (default) or imperial. Example: metric.one of
metricimperial
here_transit_stations_searchFind public transit stations near a location, by name, or by ID.Read-onlySearch Transit Stations
Find public transit stations near a location, by name, or by ID. Returns stations with place (name, id, location, type) and optional transports and accessPoints. Use this to get station IDs for here_transit_departures_list.
Inputs
idsstring- Station IDs, comma-separated. Example: 415272394.
instring- Search area as lat,lng;r=<meters>. Provide in, name (with in) or ids. Example: 41.90123,12.50091;r=500.
max_placesinteger- Maximum number of stations (1-50, default 5). Example: 5.
namestring- Station name or part of it. Example: Termini.
returnstring- Extra attributes: transport and/or accessPoints, comma-separated. Example: transport.
here_waypoints_sequence_findFind the fastest or shortest order to visit a set of waypoints between a start and an optional end.Read-onlyFind Waypoint Sequence
Find the fastest or shortest order to visit a set of waypoints between a start and an optional end. Returns results with the optimized waypoints order, distance, time and interconnections. Use this to optimize a multi-stop trip before routing it with here_routes_calculate.
Inputs
destination1stringrequired- First stop to visit as id;lat,lng (add ;st:<seconds> for a stop time). Example: CustomerA;52.5206,13.3862.
modestringrequired- Mode as optimization;transport;traffic, e.g. fastest;car;traffic:enabled. Example: fastest;car;traffic:disabled.
startstringrequired- Start as id;lat,lng. Example: Warehouse;52.5160,13.3779.
departurestring- Departure time (ISO 8601) or now. Example: 2026-01-15T08:30:00+01:00.
destination2string- Second stop as id;lat,lng. Example: CustomerB;52.5054,13.3926.
destination3string- Third stop as id;lat,lng. Example: CustomerC;52.4993,13.4180.
destination4string- Fourth stop as id;lat,lng. Example: CustomerD;52.5300,13.4100.
destination5string- Fifth stop as id;lat,lng. Example: CustomerE;52.5400,13.3500.
endstring- End as id;lat,lng; omit for an open trip. Example: Warehouse;52.5160,13.3779.
improve_forstring- time (default) or distance. Example: time.one of
timedistance
here_weather_alerts_getGet weather alerts that affect GeoJSON features (points, a route line or an area polygon), with optional time windows per feature.Read-onlyGet Weather Alerts
Get weather alerts that affect GeoJSON features (points, a route line or an area polygon), with optional time windows per feature. Returns alerts per feature with type, severity, description and validity window. Use this for alerts along a route. Use here_weather_report_get with products=alerts for a single place.
Inputs
featuresarrayrequired- GeoJSON Feature objects (Point, LineString or Polygon geometry), optionally with properties.width and timeSegments. Example: [{"type": "Feature", "geometry": {"type": "Point", "coordinates": [13.3847, 52.5308]}}]
here_weather_report_getGet current observations, hourly or daily forecasts, astronomy or alerts for a location given by coordinates, free-text query or ZIP code.Read-onlyGet Weather Report
Get current observations, hourly or daily forecasts, astronomy or alerts for a location given by coordinates, free-text query or ZIP code. Returns places with the requested products (observations, forecasts, nwsAlerts, astronomyForecasts) including temperature, precipitation, wind and description. Use this for weather at a place. Use here_weather_alerts_get for alerts along a route or area.
Inputs
productsstringrequired- Products, comma-separated: observation, forecast7days, forecast7daysSimple, forecastHourly, forecastAstronomy, alerts, nwsAlerts. Example: observation,forecastHourly.
langstring- Language code. Example: en-US.
locationstring- Coordinate as latitude,longitude. Provide location, q or zip_code. Example: 52.5308,13.3847.
one_observationboolean- Return only the closest observation station. Example: true.
qstring- Free-text place, e.g. a city name. Example: Berlin, Germany.
unitsstring- metric (default) or imperial. Example: metric.one of
metricimperial zip_codestring- US ZIP code. Example: 10001.
No tools match.