For Agents
Geocode addresses to coordinates, reverse geocode locations to addresses, discover nearby places by category, and look up place details by HERE ID.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the HERE Geocoding & Search API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with HERE Geocoding & Search API API.
Geocode free-text or structured addresses into latitude/longitude coordinates with field-level confidence scoring
Reverse geocode coordinates to the nearest street address with configurable result types and language localization
Discover places and addresses through free-form natural language queries within a geographic area
Browse points of interest by category around a specified location with name filtering
GET STARTED
Use for: I need to convert a street address into GPS coordinates, Find the nearest address for a given latitude and longitude, Search for restaurants near a specific location, Get autocomplete suggestions as a user types an address
Not supported: Does not handle routing, traffic, map tile rendering, or fleet management — use for geocoding and place search only.
Convert free-text addresses into geographic coordinates, reverse geocode coordinates back to addresses, and discover places by category or free-form search queries. The API supports autosuggest for real-time type-ahead, category-based browsing around a location, and place detail lookup by HERE ID, returning structured address components, access points for navigation, and match confidence scores across 6 dedicated service endpoints.
Provide real-time type-ahead suggestions combining places, addresses, and query term completions
Retrieve full place details including opening hours, contacts, and access points using a HERE place ID
Patterns agents use HERE Geocoding & Search API API for, with concrete tasks.
★ AI Agent Location Resolution
AI agents resolve ambiguous user location references into precise coordinates for downstream tasks such as ride booking, delivery scheduling, or weather lookups. The geocode endpoint converts free-text like '1600 Pennsylvania Ave NW' into exact lat/lng pairs, while autosuggest handles partial or misspelled inputs. Through Jentic, agents search for 'geocode an address' and receive the operation schema instantly, eliminating manual doc parsing.
Geocode '1600 Pennsylvania Ave NW, Washington DC' using the /geocode endpoint and return the latitude, longitude, and formatted address label
Reverse Geocoding for Fleet Tracking
Fleet management systems translate raw GPS coordinates from vehicle trackers into human-readable addresses for dispatch dashboards and delivery notifications. The reverse geocode endpoint accepts lat/lng pairs and returns the nearest street-level address, including the country, city, district, and house number. Results can be filtered by type (address, street, city) to control granularity.
Reverse geocode coordinates 52.5200,13.4050 using the /revgeocode endpoint and return the full formatted address label
Place Discovery for Travel Applications
Travel and hospitality apps let users search for hotels, restaurants, and attractions near their destination. The discover endpoint performs free-form search (e.g., 'sushi restaurants in Tokyo') while the browse endpoint filters by HERE category IDs within a radius. Results include place name, address, coordinates, distance from center, and contact details.
Search for 'coffee shops' near coordinates 40.7128,-74.0060 using the /discover endpoint with a limit of 5 results
Address Autocomplete for Forms
Web and mobile forms use type-ahead address completion to reduce user input errors and speed up checkout flows. The autosuggest endpoint returns a mix of place, address, and query-term suggestions as the user types, with character-level highlight positions for rendering bold matched text. It requires a search center (at parameter) to rank nearby results higher.
Get autosuggest results for partial query 'Alexanderpl' with search center at 52.5200,13.4050 and return the top 3 suggestions
6 endpoints — convert free-text addresses into geographic coordinates, reverse geocode coordinates back to addresses, and discover places by category or free-form search queries.
METHOD
PATH
DESCRIPTION
/geocode
Geocode a free-text address into coordinates
/revgeocode
Reverse geocode coordinates to nearest address
/autosuggest
Type-ahead search suggestions
/discover
Free-form place and address search
/browse
Browse places by category near a location
/lookup
Look up place details by HERE ID
/geocode
Geocode a free-text address into coordinates
/revgeocode
Reverse geocode coordinates to nearest address
/autosuggest
Type-ahead search suggestions
/discover
Free-form place and address search
/browse
Browse places by category near a location
Three things that make agents converge on Jentic-routed access.
Credential isolation
HERE API keys are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — the raw apiKey query parameter value never enters the agent's context window.
Intent-based discovery
Agents search by intent (e.g., 'geocode an address' or 'find nearby places') and Jentic returns matching HERE Geocoding & Search operations with their full input schemas, so the agent can call the correct endpoint without reading HERE developer documentation.
Time to first call
Direct HERE integration: 1-3 days for auth setup, endpoint discovery, and error handling. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
TomTom Search API
Similar fuzzy search and geocoding with POI data, plus along-route search
Choose TomTom when you need geometry-based search filtering, along-route POI discovery, or routed result sorting — features HERE Geocoding & Search does not offer.
LocationIQ API
OSM-based geocoding with routing, timezone, and lower pricing tiers
Choose LocationIQ when you need OpenStreetMap-based results, lower cost at scale, or combined geocoding and routing in a single vendor.
Geocodio
US/Canada-focused geocoding with congressional district and census data appends
Choose Geocodio when the use case is US/Canada-specific and you need data appends like congressional districts, school districts, or census tract information alongside coordinates.
Specific to using HERE Geocoding & Search API API through Jentic.
What authentication does the HERE Geocoding & Search API use?
The HERE Geocoding & Search API authenticates requests using an API key passed as the `apiKey` query parameter, or alternatively via an OAuth 2.0 bearer token in the Authorization header. Through Jentic, your HERE API key is stored encrypted in the MAXsystem vault — agents receive scoped access tokens without the raw key entering their context.
Can I geocode addresses in multiple languages with the HERE API?
Yes. Every endpoint accepts a `lang` parameter using BCP 47 language tags (e.g., 'de', 'fr', 'ja'). The response text, address formatting, and place names are returned in the specified language when translations are available.
What are the rate limits for the HERE Geocoding & Search API?
HERE returns HTTP 429 when rate limits are exceeded. The specific limits depend on your HERE plan tier — the Freemium plan allows 250,000 transactions per month with 5 requests per second. Paid plans scale to millions of transactions with higher concurrency.
How do I search for nearby restaurants through Jentic?
Install the Jentic SDK with `pip install jentic`, then search for 'find places near a location'. Jentic returns the /discover or /browse operation schemas. Use /browse with the `categories` parameter set to the restaurant category ID and `at` set to your coordinates. Execute the call through Jentic and receive structured place results.
What is the difference between the discover and browse endpoints?
The /discover endpoint performs free-text search (e.g., 'pizza in Berlin') and ranks results by relevance. The /browse endpoint filters by HERE category IDs around a location and is better when you know the exact category you want. Both accept geographic area constraints and return the same place result format.
Does the HERE API support batch geocoding?
The Geocoding & Search API processes one address per request. For batch processing, agents can make parallel requests to the /geocode endpoint. Each request supports structured queries via the `qq` parameter (e.g., city=Berlin;country=Germany) or free-text via the `q` parameter, with up to 100 results per call.
/lookup
Look up place details by HERE ID