Geocode any city name to coordinates, bounding box, and full GeoJSON boundary polygon via a simple REST API. Get the exact shape of any city on Earth — not just a pin on a map. 5,000 free requests/month.
- Geocode city names to center coordinates, bounding box, and full GeoJSON boundary polygon
- Get exact city boundary shapes — draw any city outline on a map with one API call
- Disambiguate with optional state and country code parameters
- Worldwide coverage — every city OpenStreetMap has data for
- No rate limit headaches — unlike the official Nominatim API (1 req/sec)
- 5,000 requests/month on free tier
- Example Response:
{
"place_id": 419365556,
"osm_type": "relation",
"osm_id": 207359,
"addresstype": "city",
"name": "Los Angeles",
"display_name": "Los Angeles, Los Angeles County, California, United States",
"boundingbox": ["33.6595410", "34.3373060", "-118.6681798", "-118.1552983"],
"geojson": {
"type": "Polygon",
"coordinates": [[[-118.6681798, 34.1849312], "..."]]
},
"center_point": {
"latitude": 34.0536909,
"longitude": -118.242766
}
}Create an account at omkar.cloud to get your API key.
It takes just 2 minutes to sign up. You get 5,000 free requests every month — more than enough for most users to get their job done without paying a dime.
This is a well built product, and your search for the best Geocoding API with GeoJSON boundaries ends right here.
curl -X GET "https://nominatim-api.omkar.cloud/nominatim/geocode?city=San%20Francisco&state=California&country_code=us" \
-H "API-Key: YOUR_API_KEY"{
"place_id": 419365556,
"osm_type": "relation",
"osm_id": 207359,
"addresstype": "city",
"name": "Los Angeles",
"display_name": "Los Angeles, Los Angeles County, California, United States",
"boundingbox": ["33.6595410", "34.3373060", "-118.6681798", "-118.1552983"],
"geojson": {
"type": "Polygon",
"coordinates": [[[-118.6681798, 34.1849312], [-118.6681702, 34.1767647], "..."]]
},
"center_point": {
"latitude": 34.0536909,
"longitude": -118.242766
}
}pip install requestsimport requests
response = requests.get(
"https://nominatim-api.omkar.cloud/nominatim/geocode",
params={"city": "San Francisco", "state": "California", "country_code": "us"},
headers={"API-Key": "YOUR_API_KEY"}
)
print(response.json())GET https://nominatim-api.omkar.cloud/nominatim/geocode
| Parameter | Required | Default | Description |
|---|---|---|---|
city |
Yes | — | City name to geocode. |
state |
No | — | State or province name for disambiguation. |
country_code |
No | — | ISO 3166-1 alpha-2 country code (e.g., us, jp, gb). |
import requests
response = requests.get(
"https://nominatim-api.omkar.cloud/nominatim/geocode",
params={"city": "Los Angeles"},
headers={"API-Key": "YOUR_API_KEY"}
)
print(response.json())Sample Response (click to expand)
{
"place_id": 419365556,
"licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright",
"osm_type": "relation",
"osm_id": 207359,
"class": "boundary",
"type": "administrative",
"place_rank": 16,
"importance": 0.8410828881088647,
"addresstype": "city",
"name": "Los Angeles",
"display_name": "Los Angeles, Los Angeles County, California, United States",
"boundingbox": [
"33.6595410",
"34.3373060",
"-118.6681798",
"-118.1552983"
],
"geojson": {
"type": "Polygon",
"coordinates": [
[
[-118.6681798, 34.1849312],
[-118.6681702, 34.1767647],
[-118.6586162, 34.1767595],
[-118.6586436, 34.1694539],
[-118.6681798, 34.1849312]
]
]
},
"center_point": {
"latitude": 34.0536909,
"longitude": -118.242766
}
}response = requests.get(
"https://nominatim-api.omkar.cloud/nominatim/geocode",
params={"city": "San Francisco"},
headers={"API-Key": "YOUR_API_KEY"}
)
if response.status_code == 200:
data = response.json()
elif response.status_code == 401:
# Invalid API key
pass
elif response.status_code == 404:
# City not found
pass
elif response.status_code == 429:
# Rate limit exceeded
passCity Geocode returns per city:
- Place ID, OSM type, and OSM ID
- Address type and place rank
- City name and full display name (city, county, state, country)
- Bounding box (south, north, west, east coordinates)
- Full GeoJSON boundary polygon with exact city boundaries
- Center point coordinates (latitude, longitude)
- Importance score from OpenStreetMap
All in structured JSON. Ready to plot on a map or use in your app.
Data is sourced from OpenStreetMap via Nominatim. City boundaries, coordinates, and bounding boxes reflect the latest OpenStreetMap data. OSM is maintained by a global community of mappers and is the same data source used by Apple Maps, Facebook, and thousands of other services.
The official Nominatim API enforces a strict rate limit of 1 request per second. That's fine for a quick test, but it becomes a bottleneck fast when you're building a real product, with unpredictable usage demands.
With our API, you get high-throughput access without worrying about rate limits.
Center point gives you a single latitude/longitude coordinate for the city center. Good for placing a marker on a map.
Bounding box gives you the rectangular extent of the city — south, north, west, east edges. Good for setting map zoom levels or filtering locations within a region.
GeoJSON polygon gives you the actual city boundary shape. Good for geofencing, delivery zones, or drawing the exact city outline on a map.
Use state and country_code to disambiguate. For example, "Portland" exists in both Oregon State and Maine State.
city=Portland&state=Oregon&country_code=us— gets Portland, Oregon State, UScity=Portland&state=Maine&country_code=us— gets Portland, Maine State, US
Without disambiguation, the API returns the most prominent result.
Yes. Pass any city name and optionally a country_code (2-letter ISO code) to disambiguate. Works worldwide — US cities, European cities, Asian cities, everywhere OpenStreetMap has data. That's essentially every city on Earth.
| Plan | Price | Requests/Month |
|---|---|---|
| Free | $0 | 5,000 |
| Starter | $25 | 100,000 |
| Grow | $75 | 1,000,000 |
| Scale | $150 | 10,000,000 |
Reach out anytime. We will solve your query within 1 working day.
