Back to all APIs
Geocoding
MENA-focused forward and reverse geocoding powered by OpenStreetMap with Arabic name enrichment and structured address parsing
Category: GeolocationEndpoint:
/v1/geocodeAvg Response
<50ms
Uptime SLA
99.99%
Free Tier
1,000/mo
Quick Start
JavaScript / TypeScript
javascript
import { KhaleejiAPI } from '@khaleejiapi/sdk'; const client = new KhaleejiAPI('your_api_key'); // Forward geocoding (powered by OpenStreetMap Nominatim)const result = await client.geo.geocode({ address: 'Burj Khalifa' }); console.log(result.results[0]);// {// name: "Burj Khalifa", nameAr: "برج خليفة",// lat: 25.1972, lng: 55.2744,// country: "United Arab Emirates", countryAr: "الإمارات العربية المتحدة",// type: "landmark",// address: { city: "Dubai", state: "Dubai", full: "Burj Khalifa, ..." }// } // Reverse geocodingconst reverse = await client.geo.geocode({ lat: 25.1972, lon: 55.2744 });Python
python
from khaleejiapi import KhaleejiAPI client = KhaleejiAPI('your_api_key') # Forward geocoding with Arabic namesresult = client.geo.geocode(address="Burj Khalifa") for r in result["results"]: print(f"{r['name']} ({r['nameAr']}) — {r['country']}") # Reverse geocodingreverse = client.geo.geocode(lat=25.1972, lon=55.2744)print(reverse["results"][0]["address"]["full"])cURL
curl
# Forward geocodingcurl -X GET "https://khaleejiapi.dev/api/v1/geocode?q=Burj+Khalifa&lang=ar" \ -H "x-api-key: your_api_key" # Reverse geocodingcurl -X GET "https://khaleejiapi.dev/api/v1/geocode?lat=25.1972&lng=55.2744" \ -H "x-api-key: your_api_key"