This application requires JavaScript.
10,000 free geocoding requests · no card

Geocoding for Indian addresses

Address-to-coordinate resolution that expects landmark-relative addresses, returns a confidence score on every match, and lets you cache what you resolve.

What geocoding does

Geocoding turns a written address into a latitude and longitude that software can plot, measure, and route between. Reverse geocoding runs the other way, taking a coordinate from a device GPS or a dropped pin and returning the nearest addressable place.

Almost every location feature rests on one of these two operations: showing a delivery on a map, calculating distance to the nearest store, or validating that an address a customer typed actually exists.

Why Indian addresses break most geocoders

A large share of Indian addresses are landmark-relative rather than street-numbered. An address reading "opposite Ganesh temple, behind the bus depot" carries no house number and no formal street name, yet it is completely unambiguous to a local delivery rider. Building numbering is frequently non-sequential, the same locality name recurs across cities, and a PIN code can cover an area containing thousands of premises.

Geocoders built around Western street grids handle this by falling back to the centroid of whatever area they matched. The failure is quiet: the API returns a valid-looking coordinate with no indication it is a guess.

The same address, two match types
input
opposite Ganesh temple, Baner, Pune 411045
match_type
locality
confidence
0.31
result
Baner centroid, 1.4 km from the premises

maps.guru returns a confidence score and match type on every result, so your code can tell a premise-level match from an area centroid and prompt for a map pin instead of silently accepting the drift.

Which endpoint to use

Use search when you have a complete address string and want it resolved in one call, which is the right shape for cleaning up an existing database of customer records. Use autocomplete in any field where a person is typing: it is optimised for keystroke latency and returns ranked partial matches, so a checkout form resolves an address in a few characters rather than the full string.

Use reverse geocoding when you start from a coordinate, typically a device GPS fix or a pin the user dragged on a map, and need the nearest addressable place.

How to geocode an Indian address

Resolve a written Indian address to coordinates, and handle the landmark-relative case where a precise premise match does not exist.

  1. 1

    Get an API key

    Create a free account. A default key with the geocoding scope is generated automatically, and the free tier includes 10,000 geocoding requests a month with no card.

  2. 2

    Call the search endpoint

    Send the full address string to the search endpoint with your key. Include the PIN code when you have it: it is the single strongest disambiguator for Indian addresses, because locality names repeat across cities.

  3. 3

    Read the confidence score

    Each result carries a confidence score and a match type. A premise or street match is safe to use directly. A locality-level match means the geocoder fell back to an area centroid.

  4. 4

    Handle low-confidence matches

    On a locality-level match, prompt the user to confirm the pin on a map rather than accepting the centroid. For delivery routing, fall back to PIN-code zoning instead of treating the centroid as a doorstep.

  5. 5

    Cache what you resolve

    Store the resolved coordinate against your address record. Repeat deliveries to the same address then cost nothing, which is where most of the savings in an address-heavy application come from.

Geocoding terms, defined

The vocabulary behind address resolution, in plain language.

What is Geocoding?

The conversion of a written address or place name into a latitude and longitude coordinate pair that software can plot, measure, or route between.

What is Reverse geocoding?

The inverse of geocoding: taking a latitude and longitude, usually from a device GPS or a user-dropped pin, and returning the nearest addressable place.

What is Autocomplete?

A latency-optimised geocoding mode that returns ranked partial matches while a user is still typing, used in checkout and search fields rather than for batch processing.

What is Confidence score?

A numeric indication of how well a geocoder believes it matched the input. Low confidence on a landmark-relative Indian address is a signal to prompt the user for a map pin rather than silently accepting a locality centroid.

What is Locality centroid?

The geometric centre of a named area. When an address lacks a resolvable street or premise, a geocoder commonly falls back to this point, which can sit a kilometre or more from the intended destination.

Questions about geocoding

  • What is geocoding?

    Geocoding is the conversion of a written address or place name into a latitude and longitude coordinate pair. Reverse geocoding is the inverse: it takes a coordinate and returns the nearest address or place. A geocoding API exposes both operations over HTTP so an application can resolve user-entered addresses to points it can plot, measure, or route between.

  • Why are Indian addresses hard to geocode?

    Indian addresses are frequently landmark-relative rather than street-numbered. A delivery address may read "opposite Ganesh temple, behind the bus depot" with no house number and no formal street name. Building numbering is often non-sequential, the same locality name recurs across cities, and PIN codes cover areas large enough to contain thousands of premises. Geocoders trained mainly on Western street grids resolve these to the centroid of a locality, which can be a kilometre or more from the real premises.

  • How accurate is geocoding for Indian addresses?

    Accuracy varies by address completeness rather than by city tier. A full address with premise, street, locality, and PIN code usually resolves to the correct street segment. A landmark-only address typically resolves to the locality centroid. Every maps.guru geocoding response carries a confidence score and a match type so you can decide programmatically whether to accept the coordinate, prompt the user to drop a pin, or fall back to PIN-code-level delivery zoning.

  • What is the difference between search, autocomplete, and reverse geocoding?

    Search resolves a complete address string in one call and is the right choice for batch processing existing records. Autocomplete is optimised for keystroke latency and returns ranked partial matches as a user types, which is what an address field in a checkout flow needs. Reverse geocoding takes a coordinate, usually from a device GPS or a dropped pin, and returns the nearest addressable place.

  • How many free geocoding requests does maps.guru include?

    The free tier includes 10,000 geocoding requests per month with no credit card. The Pro tier raises that to 200,000 per month. Requests beyond the quota are declined rather than billed as overage, so a traffic spike cannot produce an unexpected invoice.

  • Can I cache geocoding results?

    Yes. maps.guru permits caching resolved coordinates in your own database indefinitely, which materially reduces cost for address books and repeat deliveries. This differs from some incumbent providers whose terms restrict how long geocoded coordinates may be stored outside their platform. Check the terms of any provider you compare against before you design a caching layer.

Ready to build with
beautiful basemaps?

Join developers worldwide who trust maps.guru for their mapping needs. Start free, no credit card required.

Contact us
Free forever plan
5-minute setup
No credit card