Reverse Geocoding API

Features

{
 "name": "San Francisco",
 "state": "California",
 "country_code": "US"
}

Get API Key

Quick Start

curl -X GET "https://reverse-geocoding-api.omkar.cloud/reverse-geocode?lat=37.7749&lon=-122.4194" \
 -H "API-Key: YOUR_API_KEY"

[
 {
 "name": "San Francisco",
 "state": "California",
 "country_code": "US"
 }
]

Installation

Python

pip install requests

import requests
response = requests.get(
 "https://reverse-geocoding-api.omkar.cloud/reverse-geocode",
 params={"lat": 37.7749, "lon": -122.4194},
 headers={"API-Key": "YOUR_API_KEY"}
)
data = response.json()[0]
print(f"Location: {data['name']}, {data['state']}, {data['country_code']}")

Node.js

npm install axios

import axios from "axios";
const response = await axios.get("https://reverse-geocoding-api.omkar.cloud/reverse-geocode", {
 params: { lat: 37.7749, lon: -122.4194 },
 headers: { "API-Key": "YOUR_API_KEY" }
});
console.log(`Location: ${response.data[0].name}, ${response.data[0].state}`);

API Reference

Endpoint

GET https://reverse-geocoding-api.omkar.cloud/reverse-geocode

Headers

Parameters

Response Fields

Examples

Get location from coordinates

response = requests.get(
 "https://reverse-geocoding-api.omkar.cloud/reverse-geocode",
 params={"lat": 40.7128, "lon": -74.0060},
 headers={"API-Key": "YOUR_API_KEY"}
)
location = response.json()[0]
print(f"{location['name']}, {location['state']}") # New York, New York

Tokyo coordinates

response = requests.get(
 "https://reverse-geocoding-api.omkar.cloud/reverse-geocode",
 params={"lat": 35.6762, "lon": 139.6503},
 headers={"API-Key": "YOUR_API_KEY"}
)
location = response.json()[0]
print(f"{location['name']}, {location['country_code']}") # Tokyo, JP

Error Handling

response = requests.get(
 "https://reverse-geocoding-api.omkar.cloud/reverse-geocode",
 params={"lat": 37.7749, "lon": -122.4194},
 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 == 429:
 # Rate limit exceeded
 pass

Rate Limits

Questions? We have answers.