Reverse Geocoding

Turn coordinates into a structured address.

Product pagePostman collectionOpenAPI spec

Base URL

https://use.api.co.id

Send coordinates in the lat and lon query parameters with the x-api-co-id header. The response contains structured location data: a human-readable address and its breakdown.

Returned data

• Detailed address breakdown with multiple components (road, city, country, and more).
• Bounding box information.
• Place ranking with importance scores.
• Built on OpenStreetMap data.

Reverse Geocode

GET/location/reverse-geocode

Convert coordinates (latitude, longitude) to a human-readable address. Returns detailed address breakdown with multiple components including road, city, country, postal code, and bounding box information.

Query parameters

Name	Type	Description
latRequired	number	Latitude coordinate (-90 to 90) Example: -6.2088
lonRequired	number	Longitude coordinate (-180 to 180) Example: 106.8456

Response fields

Name	Type	Description
is_successOptional	boolean	Example: true
messageOptional	string	Example: Success
dataOptional	object
data.place_idOptional	integer	Place ID from OpenStreetMap Example: 123456789
data.licenceOptional	string	License information Example: Data © OpenStreetMap contributors, ODbL 1.0
data.latOptional	number	Latitude Example: -6.2088
data.lonOptional	number	Longitude Example: 106.8456
data.display_nameOptional	string	Full formatted address Example: Jl. Merdeka Selatan No. 11, Gambir, Jakarta Pusat, DKI Jakarta 10110, Indonesia
data.addressOptional	object	Address components
data.address.roadOptional	string	Street name Example: Jl. Merdeka Selatan
data.address.house_numberOptional	string	House/building number Example: 11
data.address.suburbOptional	string	Suburb/neighborhood Example: Gambir
data.address.cityOptional	string	City name Example: Jakarta Pusat
data.address.stateOptional	string	State/province Example: DKI Jakarta
data.address.postcodeOptional	string	Postal code Example: 10110
data.address.countryOptional	string	Country name Example: Indonesia
data.address.country_codeOptional	string	Two-letter country code Example: id
data.boundingboxOptional	string[]	Bounding box coordinates [min_lat, max_lat, min_lon, max_lon] Example: ["-6.2091","-6.2085","106.8453","106.8459"]
data.importanceOptional	number	Place importance score (0.0 to 1.0) Example: 0.85

Request

curl -X GET "https://use.api.co.id/location/reverse-geocode?lat=-6.2088&lon=106.8456" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Address Retrieved

{  "is_success": true,  "message": "Success",  "data": {    "place_id": 123456789,    "licence": "Data © OpenStreetMap contributors, ODbL 1.0",    "lat": -6.2088,    "lon": 106.8456,    "display_name": "Jl. Merdeka Selatan No. 11, Gambir, Jakarta Pusat, DKI Jakarta 10110, Indonesia",    "address": {      "road": "Jl. Merdeka Selatan",      "house_number": "11",      "suburb": "Gambir",      "city": "Jakarta Pusat",      "state": "DKI Jakarta",      "postcode": "10110",      "country": "Indonesia",      "country_code": "id"    },    "boundingbox": [      "-6.2091",      "-6.2085",      "106.8453",      "106.8459"    ],    "importance": 0.85  }}