Jentic OSThe workplace. An in-house AI platform for every employeeJentic OneSafe access. Agents reach your systems without holding keysJentic AIRThe foundation. Gets your existing platforms ready for AI
Pricing

GET STARTED

API DirectoryBrowse 10,000+ APIs ready for AI agent integrationDocumentationGuides and API reference

TOOLS

API ScoringCheck your AI readiness using our scorecardArazzo UIVisualize Arazzo workflows as interactive documentationArazzo EditorBuild and edit multi-step API workflows visually

COMMUNITY

GitHubOpen source projects and examplesOpen StandardsBuilt on open specs. Never locked in.
All ResourcesEverything in one placeBlogLatest articles and insightsTech Talk NewsletterAPIs, AI agents, architecture and strategyWebinarsLive sessions and on-demand recordingsReports & WhitepapersOriginal research on enterprise AI
About UsOur mission and teamCareersJoin our teamContactGet in touch
Try it now
Jentic OSJentic OneJentic AIR
Pricing
API DirectoryDocumentationAPI ScoringArazzo UIArazzo EditorGitHubOpen Standards
All ResourcesBlogTech Talk NewsletterWebinarsReports & Whitepapers
About UsCareersContact
Try it now
JenticJentic
Products
  • Jentic OS
  • Jentic One
  • Jentic AIR
For Developers
  • API Directory
  • Documentation
  • GitHub
Company
  • About Jentic
  • Careers
  • Contact Us
  • Trust Centre
ISO/IEC 27001:2022 certification badge issued by Prescient SecurityISO/IEC 27001:2022 certification badge issued by Prescient Security

Information Security Management System

Certified to ISO/IEC 27001:2022 by Prescient Security

AICPA SOC for Service Organizations logoAICPA SOC for Service Organizations logo

SOC 2® Type 1 report

Audited by Prescient Assurance

Terms & Conditions•Privacy Policy•
© 2026 Jentic Technology Ltd. All rights reserved.
2 Grattan Court East, Dublin, D02 VX86, Ireland
Switch to light modeSwitch to dark mode
APIs / Maps Geolocation / Locationiq / LocationIQ API
LocationIQ API logo

LocationIQ API

Browse all Locationiq APIs
Official vendor OpenAPI document · agent-readyMaps GeolocationGeocodingapiKey9 EndpointsREST

For Agents

Geocode addresses, reverse-geocode coordinates, find nearby places, and calculate driving directions worldwide using OpenStreetMap data.

Use for: I need to geocode a customer's mailing address, Reverse-geocode these GPS coordinates into a street address, Find all coffee shops within 500 metres of this point, Get the driving directions between two coordinates

Not supported: Does not handle map tile rendering, vector tile hosting, or commercial truck-specific routing - use for geocoding, reverse geocoding, autocomplete, and basic routing only.

LocationIQ provides global geocoding, reverse geocoding, routing, and place-search services backed by OpenStreetMap data and a worldwide datacentre footprint. The API supports forward, structured, and postal-code geocoding, autocomplete suggestions, nearby place search, time-zone lookups, and turn-by-turn directions across driving, cycling, and walking profiles. Account balance can be queried to track API usage against quota.

Jentic One on GithubView OpenAPI Document

Install Jentic One Beta

Connect the LocationIQ API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the LocationIQ 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.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

1

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Flocationiq.com%2Flocationiq-api" | sh
2

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Flocationiq.com%2Flocationiq-api" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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.

Capabilities

What an agent can do with LocationIQ API.

Convert free-form or structured addresses into latitude and longitude with the /search endpoint

Reverse-geocode coordinate pairs into formatted addresses via /reverse

Suggest matching addresses while users type using /autocomplete

Find points of interest within a radius of a coordinate through /nearby

Calculate driving, cycling, or walking routes with /directions/{profile}/{coordinates}

Resolve a coordinate to its IANA time zone using /timezone

Track remaining daily quota by querying /balance

Use Cases

Patterns agents use LocationIQ API for, with concrete tasks.

★ Address Autocomplete in Checkout

Reduce cart abandonment by suggesting validated addresses as shoppers type. The /autocomplete endpoint returns ranked address candidates that resolve to canonical coordinates, so downstream shipping and tax calculations use clean data. Integration is straightforward because results follow the standard Nominatim format.

Call /autocomplete with q='221b baker' and limit=5 to return the top five matching addresses worldwide.

Delivery Route Planning

Calculate driving directions between a depot and a delivery stop with the /directions/{profile}/{coordinates} endpoint. The response includes distance, duration, and turn-by-turn steps usable in dispatcher dashboards. Profiles cover driving, cycling, and walking so the same API powers both fleet and last-mile workflows.

Request /directions/driving/-73.989,40.733;-73.968,40.785 to get the driving route distance and duration in JSON.

Reverse Geocoding for Mobile Check-ins

Translate a phone's GPS reading into a human-readable address with /reverse. This powers check-in features, ride pickup confirmations, and field-service apps where the user does not type an address. Responses include house number, road, suburb, city, postcode, and country.

Send GET /reverse?lat=37.7749&lon=-122.4194&format=json and parse the display_name field.

AI Agent Location Lookup via Jentic

Agents that answer location questions can call LocationIQ through Jentic without managing API keys directly. Jentic exposes the geocoding, reverse-geocoding, and directions operations as MCP tools, so the agent picks the right one by intent rather than reading docs. The API key stays in your Jentic One instance.

Through Jentic, search 'geocode an address', load the LocationIQ /search schema, and execute it with the user's input string.

Key Endpoints

9 endpoints — locationiq provides global geocoding, reverse geocoding, routing, and place-search services backed by openstreetmap data and a worldwide datacentre footprint.

METHOD

PATH

DESCRIPTION

GET

/search

Forward geocoding from a free-form query

GET

/reverse

Reverse geocode coordinates to an address

GET

/autocomplete

Address autocomplete suggestions

GET

/nearby

Find places within a radius of a coordinate

GET

/directions/{profile}/{coordinates}

Get a route for a transport profile

GET

/timezone

Look up the time zone for a coordinate

GET

/balance

Check remaining account quota

GET

/search

Forward geocoding from a free-form query

GET

/reverse

Reverse geocode coordinates to an address

GET

/autocomplete

Address autocomplete suggestions

GET

/nearby

Find places within a radius of a coordinate

GET

/directions/{profile}/{coordinates}

Get a route for a transport profile

GET

/timezone

Look up the time zone for a coordinate

GET

/balance

Check remaining account quota

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring LocationIQ by hand means passing your access token as a query parameter on every request, picking the right US or EU endpoint host, and encoding geocoding and routing parameters yourself. Through Jentic you install once, import LocationIQ from the API Directory, store the key once, and your agent calls it.

Permission scoping

LocationIQ is a stateless geocoding service with no per-account resources in the URL path, so scoping is by operation: limit the agent to the operations it needs, such as forward geocoding and reverse geocoding, and leave out directions or nearby search if the agent does not need them.

Credential isolation

Your LocationIQ API key is stored once, encrypted, by your own Jentic One instance and appended to the request at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'geocode an address' or 'reverse geocode coordinates', and Jentic returns the matching LocationIQ operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

OpenCage Geocoding API

→

Another OpenStreetMap-backed geocoding API with a single global endpoint

Choose OpenCage when you want one unified endpoint that accepts both forward and reverse queries with the same parameter shape.

Alternative

HERE Maps API

→

Enterprise-grade geocoding, routing, and traffic data from a commercial provider

Pick HERE Maps when you need real-time traffic, truck-specific routing, or higher-accuracy commercial address data.

Complementary

GraphHopper Directions API

→

Specialised routing engine often paired with a separate geocoder

Use GraphHopper alongside LocationIQ when you need advanced route optimisation features like matrix routing or vehicle profiles beyond the basic three.

Alternative

Positionstack API

Forward and reverse geocoding API with global coverage

Choose Positionstack when you want a simple JSON geocoding API with bulk request support.

FAQs

Specific to using LocationIQ API through Jentic.

What authentication does the LocationIQ API use?

LocationIQ uses an API key passed as the `key` query parameter on every request. Through Jentic the key is stored in the encrypted vault and injected at execution time, so the key never appears in the agent's context.

Can I get turn-by-turn driving directions with the LocationIQ API?

Yes. Call GET /directions/{profile}/{coordinates} with profile set to driving, cycling, or walking and a semicolon-separated coordinate list. The response returns distance in metres, duration in seconds, and step-by-step instructions.

What are the rate limits for the LocationIQ API?

Rate limits depend on your plan tier. The free tier allows 5,000 requests per day at 2 requests per second. Use GET /balance to read your remaining quota at any time.

How do I geocode an address with LocationIQ through Jentic?

Run `pip install jentic`, then search Jentic for 'geocode an address', load the LocationIQ /search operation, and execute it with the address string. Jentic returns the JSON response with lat, lon, and the parsed address components.

Does LocationIQ support reverse geocoding for mobile coordinates?

Yes. Send GET /reverse with lat and lon parameters and the API returns a structured address including house number, road, city, postcode, and country, suitable for mobile check-in or ride-hailing apps.

Is the LocationIQ API free?

LocationIQ offers a free tier with 5,000 daily requests and paid tiers with higher quotas, commercial use rights, and SLA guarantees. Pricing is published at locationiq.com/pricing.

Can I limit what my agent is allowed to do with the LocationIQ API?

Yes. LocationIQ is a stateless geocoding service with no per-account resources in the URL path, so you scope access by operation in your own self-hosted Jentic One instance, where your rules decide which operations and credentials the agent may use. For example, you can allow the agent to call forward geocoding on /search and reverse geocoding on /reverse while leaving out /directions/{profile}/{coordinates} and /nearby if it does not need routing or place search. The stored API key is injected only for the operations you permit, so the agent can never reach an endpoint you have not enabled.

GET STARTED

Start building with LocationIQ API

Explore with Jentic One
View OpenAPI Document