Probe the configured HERE API key against every service this server uses and report connectivity, HTTP status, latency and any rate-limit headers. Services probed: geocode, reverseGeocode, discover, autosuggest, routing, matrix, isoline, traffic, mapImage; waypointSequence only when probeCalculations=true (it has no /health endpoint and would consume routing quota). Use this first when a HERE tool fails: it distinguishes a bad/expired key (401/403), a missing entitlement (403), an outage (5xx) and a network problem, service by service. Note: HERE does not expose remaining monthly quota per key through these APIs; x-ratelimit-* headers are reported when present. HERE_API_KEY values are never returned — only whether one is configured.

Turn a partial address/POI query into ranked suggestions using the HERE Autosuggest v7 API — the right tool when the user has typed only part of a name ("Manch", "Traff", "M6 Toll"). UK bias by default: without at, suggestions are restricted to a Great Britain bounding box (HERE Autosuggest does not accept a country-code filter). Pass at="lat,lng" to rank suggestions near a point (e.g. the driver's current location) instead. Suggestions include addresses, places, and query terms. Use here_geocode afterwards to resolve a chosen suggestion to coordinates if it has no position. For complete addresses or coordinates use here_geocode; for places around a point use here_search_places.

Decode a HERE Flexible Polyline (the compact geometry returned by HERE Routing v8, Isoline v8 and Map Image v3) into a [lat,lng] point list. Pure local computation — no HERE API call, no quota, no key. Use it when a route/isoline response includes "encoded" polylines and you need coordinates: distances, bounding boxes, drawing, or checking whether a stop lies on the route geometry. Also returns the encoding header (precision, third dimension type) and an optional GeoJSON LineString for direct rendering/mapping. Invalid encodings are rejected with a clear validation error rather than silently producing wrong coordinates.

Resolve a free-text address or place to WGS84 coordinates using the HERE Geocoding & Search v7 API. Use this first when you only have an address and need a point for routing, search or mapping. UK defaults: a country focus of GBR (set countryFocus to another ISO-3166-1 alpha-3 code, or "ANY" to search worldwide) and lang=en-GB. Examples: {"q":"10 Downing Street, London"}, {"q":"Trafford Park, Manchester"}, {"q":"M6 Toll","types":["place"]}. Returns a ranked list with formatted address components, lat/lng, bounding box and match score. Empty results are a success with count=0.

Calculate the area reachable from a point within one or more time or distance ranges (isochrone/isodistance) using HERE Isoline Routing v8. HGV support: transportMode="truck" plus the same "truck" profile as here_route (metres/kg) so reachability respects height/weight/hazmat/tunnel restrictions. rangeType="time" (ranges in seconds, default [900,1800,2700] = 15/30/45 min) or "distance" (ranges in metres, default [5000,10000,15000]). Returns one polygon per range as HERE Flexible Polyline geometry; set includePolygonPoints=true to also get decoded [lat,lng] rings (larger). UK defaults: departure now with live traffic, en-GB notices, metric.

Render a static HERE map (Map Image API v3) centred on a point, with optional numbered/pinned markers and an optional route line, then save it as a PNG/JPEG and return the local file path. UK default style "explore.day". width/height default 800×600. zoom default 13 (city level); 9-10 gives a regional overview for a long HGV route. Route line: pass routePolyline (the encoded HERE Flexible Polyline returned by here_route includePolyline) — it is sent as HERE's compact overlay, so long routes do not overflow the URL — OR routePoints as [[lat,lng],…] (downsampled to 200 points). Markers are formatted as pinned labels. The saved file can be opened with an image viewer / read_image tool. The returned URL is credential-free; the HERE API key is never exposed (the image is fetched server-side and written to HERE_MAP_OUTPUT_DIR). For a simple “where is this?” image omit markers; for a delivery map pass markers for each stop.

Convert WGS84 coordinates into the nearest address/street/locality using the HERE Reverse Geocoding v7 API. Useful for naming a route origin/destination or for reporting where an incident or vehicle is. radiusM limits the search around the point (HERE "circle" filter); omit it for the nearest match only. Returns formatted addresses with country/postcode/street/house number and the distance to the requested point.

Calculate a route with HERE Routing v8. Supports transportMode car | truck | pedestrian | bicycle | scooter. HGV routing: set transportMode="truck" and pass "truck" — e.g. {"heightM":4.2,"widthM":2.55,"lengthM":16.5,"grossWeightKg":44000,"weightPerAxleKg":11500,"axleCount":6,"trailerCount":1} — to honour height/width/weight/axle/hazmat/tunnel restrictions. Dimensions are metres and weights kg; they are converted to HERE vehicle[height] centimetres etc. Origin/destination/via accept either "lat,lng" or a free-text address (auto-geocoded, UK focus). departureTime or arrivalTime (RFC 3339 WITH offset, e.g. "2026-11-03T08:30:00+00:00") makes the route traffic-aware; without it the route is traffic-free (baseDuration == duration). By default returns a compact summary only (distance, duration, traffic delay, legs, critical notices). Opt in to polyline, turn-by-turn instructions, spans and tolls with the include* flags — polylines are large. UK defaults: units=metric, lang=en-GB, currency=GBP.

Calculate travel times (and distances when available) between many origins and destinations with HERE Matrix Routing v8. Handles the HERE async job flow internally: submits the matrix, polls the status URL, downloads the gzip result, and returns a 2D durations matrix in seconds. If the job is still running after waitSeconds it returns matrixId + status so you can call again with {"matrixId":"..."} to resume. Locations are "lat,lng" or addresses (UK focus auto-geocode). Origins and destinations are ordered as supplied and echoed in the response so rows/columns are unambiguous. VERIFIED CAVEAT: HERE Matrix v8 is car-based in practice. transportMode and the HGV "truck" profile are only sent when you explicitly ask for them; if HERE rejects them, retry without them. For per-route HGV restrictions use here_route (truck) instead. The request body is the minimal verified payload: origins, destinations and regionDefinition {type:"world"}. matrixAttributes is never sent (v8 rejects it).

Calculate the toll cost and toll systems for an HGV route using HERE Routing v8 return=tolls. Returns totalCost (cheapest fare option per toll), totalCostMax (dearest), currency, and per-section toll details including toll system names, country, and every fare product with its validity period and payment methods. Typical UK results include "UK HGV LEVY ENGLAND" (day/week/month passes) and motorway tolls such as the M6 Toll. Passes are alternatives — do NOT sum them; use totalCost for the trip cost. Uses the same "truck" profile (metres/kg) as here_route so toll class is based on real dimensions/axles/emissions. emissionType maps to HERE tolls[emissionType] for Euro-class discounts. For a route summary without tolls use here_route; for traffic incidents on the corridor use here_traffic_incidents.

Find places around a coordinate — fuel stations, truck stops, depots, services, restaurants, etc. Free-text search uses HERE Discover v7 ("q"). If you pass "categories" it uses HERE Browse v7 with HERE Places category IDs (e.g. "700-7600-0116" for petrol stations) and "name" filtering. Always ranked by importance/distance from the supplied "at" point; radiusM is a hard circle filter. UK default: 2 km radius, en-GB names. HGV tip: combine with here_route to check whether the access is suitable for a large vehicle — place categories alone do not encode HGV access. openNow is best-effort: HERE GS7 returns no opening-hours data, so when it cannot be determined the response carries openNowApplied=false plus a warning and unfiltered items.

Read live traffic flow for roads within a bounding box, circle or corridor using HERE Traffic API v7. Returns jamFactor (0 = free flow, 10 = blocked), current speed, uncapped speed, free-flow speed, confidence and traversability per road segment, plus a location description and OLR reference. locationReferencing is MANDATORY for flow (default ["olr"]). maxJamFactor defaults to 10 so congestion is NOT hidden (HERE's own default of 1.0 would only return free-flowing roads). For HGV route risk assessment: average jam factor and count of jams ≥5 across the corridor is a quick congestion indicator before calling here_route. Note: HERE returns all matching segments; limit truncates the returned list only.

List live traffic incidents within a bounding box, circle or corridor using HERE Traffic API v7. Returns incident id, type (accident/construction/roadClosure/roadHazard/…), criticality (low/minor/major/critical), localised description and summary, start/end time, road-closed flag, affected length and an OLR location reference. Filter by criticality and type. locationReferencing defaults to ["olr"]; use ["shape"] if you need geometry points (adds size). For HGV planning: roadClosures and critical incidents are the ones to surface to a driver first — combine with here_route avoid areas if a closure blocks the planned corridor. Note: HERE returns all matching incidents; limit truncates the returned list only.

Find the optimal visiting order for a multi-drop run using HERE Waypoints Sequence v8 (findsequence2). Provide a start (depot), an optional end, and the stops to visit. The response lists the optimised order with per-leg distance/time and totals — ideal for planning a delivery round for an HGV. improveFor="time" (default) or "distance". transportMode="truck" with the "truck" profile applies HGV restrictions for the whole sequence (metres/kg converted to HERE cm/kg with units). departureTime is RFC 3339 with offset; it defaults to "now" because live traffic is factored into the sequence. avoidFeatures uses HERE's mode route-features: tollroad, motorway, boatFerry, railFerry, tunnel, dirtRoad (strict avoidance).