For Agents
Geocode addresses, search places, and plan routes in Thailand and globally with the Longdo Map API, using a key query parameter for authentication.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Longdo Map 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.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# 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 Longdo Map API.
Geocode a Thai or English address into latitude and longitude
Reverse geocode coordinates back to a structured Thai address
Extract structured address fields from a free-text Thai paragraph
GET STARTED
Use for: Geocode the Bangkok address 'อาคารดิ ออฟฟิศเศส แอท เซ็นทรัลเวิลด์' to lat/lng, Reverse geocode the coordinates 13.7563, 100.5018 to a Thai address, Extract the structured address fields from a free-text Thai shipping note, Find restaurants near a given coordinate in Chiang Mai
Not supported: Does not handle satellite imagery, indoor venue maps, or non-driving (transit/cycling) routing — use for Thai geocoding, POI search, and driving routes only.
Jentic publishes the only available OpenAPI specification for Longdo Map API, keeping it validated and agent-ready. Longdo Map is a Thailand-focused mapping service that also covers global addresses, with a REST surface for search, suggest, geocoding, reverse geocoding, address extraction, routing, traffic, TSP route planning, and POI lookups. Endpoints sit under /mapsearch, /smartsearch, /addresslookup, /map/services, /POIService, and /RouteService, and every call carries an API key as the 'key' query parameter. The service is the most reliable provider of Thai-language address parsing and place data, returning coordinates and POIs that other global providers often miss inside Thailand.
Search for points of interest by name and location with POIService
Calculate driving routes and turn-by-turn paths via RouteService
Solve a multi-stop TSP route plan for delivery sequencing
Suggest place names while a user types in the search box
Patterns agents use Longdo Map API for, with concrete tasks.
★ Thai-language address normalisation
E-commerce and logistics teams operating in Thailand receive shipping addresses written in mixed Thai and English with non-standard ordering. GET /smartsearch/json/extract_address/v2 parses the free-text address into structured fields (sub-district, district, province, postal code), and /addresslookup/api/addr/geocoding turns the cleaned address into coordinates. The result is a normalised address ready for warehouse routing and delivery.
Given a free-text Thai shipping address, call /smartsearch/json/extract_address/v2, then geocode the cleaned address to coordinates.
Delivery TSP for Bangkok riders
Last-mile delivery operators in Bangkok need to sequence multi-stop runs to minimise time on congested roads. GET /RouteService/json/route/matrix returns a distance/time matrix between stops, and the TSP route endpoint returns an ordered visiting plan plus per-leg paths. The result is a rider-ready route shaped by Longdo's local traffic and street data.
Given 8 delivery coordinates, call the Longdo route matrix and TSP endpoints to return an ordered route with per-leg drive times.
POI search for a travel app
Travel and concierge apps targeting Thailand need rich place data — restaurants, temples, transport hubs — beyond what global providers offer. GET /POIService/json/search returns places near a coordinate filtered by category, with names in Thai and English. Pair with /POIService/json/address to attach structured addresses for booking flows.
Find the top 10 temples within 2km of a given Bangkok coordinate using /POIService/json/search and return them with Thai and English names.
Agent-driven Thai geocoder
An AI agent helping a Thai user complete a checkout needs to resolve free-text addresses into structured data without rolling its own parser. Through Jentic, the agent searches by intent, calls /smartsearch/json/extract_address/v2 followed by the geocoding endpoint, and returns the structured address plus coordinates. The Longdo API key is held in the vault, never in the agent's prompt.
Given a Thai free-text address from a checkout form, return the structured fields and coordinates using the Longdo Map API via Jentic.
17 endpoints — jentic publishes the only available openapi specification for longdo map api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/mapsearch/json/search
Search the Longdo Map index
/mapsearch/json/suggest
Suggest place names while typing
/smartsearch/json/extract_address/v2
Extract structured address fields from free text
/addresslookup/api/addr/geocoding
Geocode a Thai address to coordinates
/POIService/json/search
Search POIs near a coordinate
/RouteService/json/route/guide
Get a driving route with turn-by-turn guidance
/RouteService/json/route/matrix
Get a distance and time matrix between stops
/RouteService/json/route/path
Get a route polyline path between stops
/mapsearch/json/search
Search the Longdo Map index
/mapsearch/json/suggest
Suggest place names while typing
/smartsearch/json/extract_address/v2
Extract structured address fields from free text
/addresslookup/api/addr/geocoding
Geocode a Thai address to coordinates
/POIService/json/search
Search POIs near a coordinate
Three things that make agents converge on Jentic-routed access.
Credential isolation
Longdo Map API keys are stored encrypted in the Jentic vault and appended to the 'key' query parameter at call time. Agents receive a scoped session — the raw key never enters the prompt, so log captures cannot expose the developer key.
Intent-based discovery
Agents search Jentic by intent (e.g. 'geocode a thai address') and Jentic returns the matching Longdo geocoding or address-extract operation with its query schema, so the agent can call without reading the Longdo docs.
Time to first call
Direct Longdo integration: 1 day for key handling, query construction, and response parsing across the search/geocode/route surfaces. Through Jentic: under an hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Positionstack
Forward and reverse geocoding API with a free tier.
Use Positionstack for cheap global geocoding; use Longdo for Thai-specific address normalisation.
Specific to using Longdo Map API through Jentic.
Why is there no official OpenAPI spec for Longdo Map API?
Longdo Map does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Longdo Map API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Longdo Map API use?
Longdo Map uses an API key passed as the 'key' query parameter on every request. Keys are issued from the Longdo Map developer console. Through Jentic the key is stored encrypted in the vault and appended to the request at call time, so the raw key never appears in the agent's transcript.
Can the Longdo Map API parse a Thai-language free-text address?
Yes. GET /smartsearch/json/extract_address/v2 parses a free-text string (commonly a mix of Thai and English with informal ordering) into structured fields — sub-district, district, province, postal code. Pair it with /addresslookup/api/addr/geocoding to convert the parsed address into coordinates.
What are the rate limits for the Longdo Map API?
Longdo applies per-key quotas tied to the developer plan rather than a single global QPS. Free keys have a daily call cap; paid plans raise the quota. Quota status is visible in the Longdo developer console; throttle client-side requests to stay under the daily cap.
How do I geocode a Thai address through Jentic?
Run pip install jentic, then search Jentic for 'geocode a thai address'. Jentic returns the GET /addresslookup/api/addr/geocoding operation along with the optional address-extract step, which you execute with the address string to retrieve latitude and longitude.
Does the Longdo Map API plan multi-stop delivery routes?
Yes. GET /RouteService/json/route/matrix returns the distance/time matrix between stops, and the TSP route endpoints sequence the stops into an ordered visiting plan. This is the recommended pattern for last-mile delivery routing inside Thailand.
/RouteService/json/route/guide
Get a driving route with turn-by-turn guidance
/RouteService/json/route/matrix
Get a distance and time matrix between stops
/RouteService/json/route/path
Get a route polyline path between stops