What it Checks
Google ranks local results by where the searcher is. The tool builds a Google search URL that sets the location for you, so you can see the results a searcher in another city or country gets. It doesn't fetch or scrape the results: it opens them in a new tab of your own browser.
The URL is made of these parameters:
| Parameter | Sets |
|---|---|
q | The query. |
gl | The country of the results. |
hl | The interface language. |
pws=0 | Personalisation off. |
uule | The location: the place's coordinates in the record Google's own location setting sends, base64-encoded after a+. |
The search runs on the market's own Google domain, such as google.co.uk for the United Kingdom.
Run a Test
- Type the search query.
- Enter a location (a city, a region or a postal code), or leave it empty for country-level results.
- Pick the market and the language.
- Press Search. Google opens in a new tab and the page shows Search ready. with the URL.
To compare places, choose Several locations, enter up to 10 locations (one per line) and press Build links. Nothing opens by itself: the result lists each place with its own Open and Copy buttons, and the list exports to CSV or Excel. The locations are looked up one per second, with progress shown.
Open the Local Search ToolOptions
- Location. Any place name or postal code, such as San Francisco, CA or 97701. It is looked up with OpenStreetMap's Nominatim, in the selected market's country first (so Paris in the United States market is Paris, Texas), then anywhere. Add the country to reach a place elsewhere: Paris, France.
- Market. The country: it sets
gland the Google domain. United States, Canada, United Kingdom, Australia and India are listed first. - Language. The interface language (
hl). English is the default.
Reading the Result
- Query, Google, Location: what was searched, on which domain, and the place the location was resolved to (or Country level). Check the place name: a short name can match a town you didn't mean. A place outside the market is flagged: the results are then the market's Google as seen from that place.
- Searches (several locations): each location, the place found (or why none was), and its link.
- Search URL: the link, with Copy and Open, and each parameter explained. Share the link to show someone the same results.
Good to Know
- If the tab doesn't open, your browser blocked the pop-up: use the link on the page.
- Google shows a “unusual traffic” check page instead of results to networks it considers automated (VPNs, data centres). The link itself is fine: open it from another connection.
pws=0turns off personalisation from your history, but Google still sees your signed-in state and IP address. Use a private window for the cleanest view.
API
POST /api/geocode
The search URL is built in the browser. The only server call is the geocoder: send the place and, optionally, the market's country code to get its coordinates, full name and country. The place is searched in that country first, then anywhere; outside is true when it lies in another country. Lookups are cached and limited to one per second, as Nominatim's usage policy asks.
curl -X POST https://plumb.reacthive.dev/api/geocode \
-H "content-type: application/json" \
-d '{
"q": "Bend, OR",
"country": "US"
}'{
"lat": 44.0581728,
"lon": -121.3153096,
"name": "Bend, Deschutes County, Oregon, United States",
"country": "US",
"outside": false
}