Developers
Reverse Geocoding Concepts for Developers
What reverse geocoding is, how it differs from forward geocoding and location codes, and its limits for delivery and address data.
Updated 14 October 2026 · 2 min read
Reverse geocoding converts coordinates into a human-readable place, such as a street address. Forward geocoding does the opposite: text in, coordinates out. Understanding the difference, and the limits, helps you design location features that behave sensibly.
How it works
A reverse geocoder holds a dataset of roads, address points, building outlines and administrative boundaries. Given a latitude and longitude it searches nearby features and returns the closest or most probable one, usually with a structured breakdown: house number, street, locality, region, postal code and country.
Where it goes wrong
- Interpolation. In many places house numbers are estimated along a street, so the returned number may be off.
- Nearest, not correct. A point in a courtyard may return the street at the front.
- Missing data. In areas with sparse address data, results are coarse, perhaps only a town.
- Formatting differences. Address layouts vary by country, so do not assume a fixed set of fields. See designing address forms.
Code versus address
An address describes a place for people and postal systems. A location code identifies a cell on a grid. A UPCS code points to a 3 m by 3 m cell, whether or not a street name or number exists nearby, so it complements a conventional address rather than replacing it. Official postal codes remain the job of national postal operators.
Using it in an integration
When a customer picks a point with the embed, the result includes an address string and country_code; see handling the onSelect response. Treat that text as a helpful label to show the customer for confirmation, not as a validated postal address. Keep the customer's own address fields and let them correct anything.
Good practice
- Show the returned address to the user and let them edit it.
- Keep coordinates and code as the precise record: store them properly.
- Cache results; the answer for a cell rarely changes.
- Do not claim UPCS validates addresses; it does not provide that.
Frequently asked questions
Is reverse geocoding exact?
It returns the nearest or most likely address from a dataset, which may be a street segment or a building, depending on data quality. It is not a precise statement of who lives at a point.
Does UPCS reverse geocode?
Responses include an address string for the selected point, but UPCS is not offered as an address validation or autocomplete product.