OneMap Singapore API
Official vendor OpenAPI document · agent-readyMaps GeolocationGeocodinghttp11 EndpointsREST
For Agents
Geocode and reverse geocode Singapore addresses, get routes between points, convert coordinate systems, and read map themes from OneMap.
Use for: I need the coordinates for a Singapore postal code, Reverse geocode a latitude and longitude to an address, Get driving directions between two Singapore locations, Convert a coordinate from WGS84 to SVY21
Not supported: Covers Singapore locations only and does not provide global geocoding or live traffic. Use it for Singapore geocoding, reverse geocoding, routing, coordinate conversion, and map themes only.
The OneMap Singapore API geocodes and routes locations within Singapore using the national base map maintained by the Singapore Land Authority. Its search endpoint turns an address, postal code, or building name into coordinates with address details, and reverse geocoding turns coordinates back into the nearest addresses. Routing returns directions between two points, coordinate conversion moves between WGS84, SVY21, and Web Mercator systems, and theme services expose curated map layers. Developers building Singapore-focused apps use it as an authoritative local alternative to global geocoders, with data tuned to Singapore's addresses and street network.
Install Jentic One Beta
Connect the OneMap Singapore API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the OneMap Singapore 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%2Fonemap.gov.sg%2Fonemap" | sh2
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%2Fonemap.gov.sg%2Fonemap" | 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.
Capabilities
What an agent can do with OneMap Singapore API.
Search an address, postal code, or place name for coordinates and address details
Reverse geocode a coordinate to the nearest Singapore addresses
Get a route and directions between two points
Convert coordinates between WGS84, SVY21, and Web Mercator systems
Retrieve available map themes and their features
Obtain a session token for authenticated requests
Use Cases
Patterns agents use OneMap Singapore API for, with concrete tasks.
★ Singapore Address Geocoding
An agent turns a user-supplied address or postal code into coordinates by calling GET /api/common/elastic/search with the `searchVal` and geometry flags. Because the data is the national base map, matches for Singapore addresses are more reliable than a global geocoder.
Geocode a Singapore postal code and return its latitude and longitude with address details
Reverse Geocoding for Nearby Addresses
Given a coordinate from a device or map click, an agent calls GET /api/public/revgeocode to find the nearest buildings and addresses. This labels a map pin or resolves a GPS fix into a human-readable Singapore address.
Reverse geocode a latitude and longitude and return the nearest Singapore address
Point-to-Point Routing
For trip planning, an agent calls GET /api/public/routingsvc/route to get a route and directions between an origin and destination. This powers navigation and travel-time estimates using Singapore's street network.
Get a walking route between two Singapore coordinates and return the distance and steps
Coordinate System Conversion
When integrating with local GIS data, an agent converts between global and Singapore coordinate systems using GET /api/common/convert/4326to3857 and its siblings. This keeps map layers aligned when combining WGS84 inputs with SVY21 datasets.
Convert a WGS84 coordinate to Web Mercator for a mapping layer
Key Endpoints
11 endpoints — the onemap singapore api geocodes and routes locations within singapore using the national base map maintained by the singapore land authority.
METHOD
PATH
DESCRIPTION
GET
/api/common/elastic/search
Geocode an address, postal code, or place name
GET
/api/public/revgeocode
Reverse geocode a coordinate to nearby addresses
GET
/api/public/routingsvc/route
Get a route between two points
GET
/api/common/convert/4326to3857
Convert WGS84 coordinates to Web Mercator
POST
/api/auth/post/getToken
Obtain an access token for authenticated requests
GET
/api/common/elastic/search
Geocode an address, postal code, or place name
GET
/api/public/revgeocode
Reverse geocode a coordinate to nearby addresses
GET
/api/public/routingsvc/route
Get a route between two points
GET
/api/common/convert/4326to3857
Convert WGS84 coordinates to Web Mercator
POST
/api/auth/post/getToken
Obtain an access token for authenticated requests
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Using the OneMap Singapore API by hand means posting for a bearer token, refreshing it before it expires, and formatting each geocoding or routing call yourself. Through Jentic you install once, import the API from the API Directory, store the credential once, and your agent geocodes, reverse geocodes, and routes.
Permission scoping
OneMap exposes distinct operations for search, reverse geocode, routing, conversion, and themes, so scope by operation: allow an agent the lookups it needs and leave routing or theme services out of the allowed set until you add them.
Credential isolation
Your OneMap credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'geocode a Singapore address' or 'reverse geocode a coordinate', and Jentic returns the matching OneMap operation with its input schema so the agent calls the right endpoint.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using OneMap Singapore API through Jentic.
What does the OneMap Singapore API do?
It geocodes and routes locations within Singapore on the national base map. You can search an address or postal code for coordinates, reverse geocode a coordinate to nearby addresses, get routes between points, convert coordinate systems, and read curated map themes.
What authentication does the OneMap Singapore API use?
Most endpoints expect a bearer token in the Authorization header, which you obtain by posting your account email and password to the token endpoint. The spec notes a token stays valid for 3 days. Through Jentic the credential is held by your own instance and supplied at execution time.
How do I geocode a Singapore address?
Call GET /api/common/elastic/search with `searchVal` set to the address or postal code and the geometry flags you need. It returns matching results with coordinates and address details drawn from the national base map.
Can I convert between coordinate systems?
Yes. GET /api/common/convert/4326to3857 and its sibling endpoints convert between WGS84, SVY21, and Web Mercator, which keeps global inputs aligned with Singapore GIS datasets.
What are the rate limits for the OneMap Singapore API?
The OpenAPI specification does not declare rate limits. Cache repeated geocoding lookups and back off on error responses; confirm current limits in the OneMap developer documentation.
Do I need an MCP server to use the OneMap Singapore API with an agent?
You do not. Jentic connects the API to your agent directly from the API Directory: import it, store your credential once, and the agent calls the geocoding and routing operations without a separate server to run.
Can I limit what my agent is allowed to do with the OneMap Singapore API?
Yes. Because you run Jentic One yourself, you decide the allowed operations: an agent can be permitted to search and reverse geocode while routing and theme services stay excluded, and the token stays with your instance and is applied at call time.
GET STARTED