Geocoding API
Forward and reverse geocoding with MENA region optimization. Powered by Nominatim (OpenStreetMap) with automatic fallback to a curated 26-location MENA dataset. Includes Arabic names, landmark types, and nearby point-of-interest discovery.
/v1/geocodeTry it out
/v1/geocodeParameters
Code
curl -X GET "https://khaleejiapi.dev/api/v1/geocode?q=Burj%20Khalifa&lang=en&limit=10" \ -H "X-API-Key: your_api_key"Parameters
Provide either q for forward geocoding or lat + lng for reverse geocoding.
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | Optional | Place name for forward geocoding (address, landmark, city) |
| lat | number | Optional | Latitude for reverse geocoding (-90 to 90) |
| lng | number | Optional | Longitude for reverse geocoding (-180 to 180) |
| country | string | Optional | Country code filter (e.g. AE, SA) |
| lang | string | Optional | Language for results |
| limit | number | Optional | Max results to return (1–50) |
Geocoding Modes
Forward Geocoding — ?q=Burj Khalifa
Convert place names, addresses, or landmarks to coordinates. Returns multiple results ranked by relevance. MENA country biasing for better results.
Reverse Geocoding — ?lat=25.19&lng=55.27
Convert coordinates to addresses. Returns enriched result with nearby landmarks (Burj Khalifa, Palm Jumeirah, etc.) when in GCC region.
Response Fields
name / nameAr
Place name in English and Arabic
lat / lng
Latitude and longitude coordinates
country / countryCode
Country name and ISO code
address
Structured address: road, neighbourhood, city, state, postcode, full
type
Place type (city, attraction, building, etc.)
nearbyLandmarks
Nearby GCC landmarks (reverse geocoding only)
Rate Limits
| Plan | Requests/Month | Rate Limit |
|---|---|---|
| Free | 1,000 | 10 req/min |
| Starter | 10,000 | 60 req/min |
| Professional | 100,000 | 300 req/min |
| Business | 500,000 | 1,000 req/min |