LocationIQ drop-in replacement
LocationIQ's search, reverse, autocomplete and timezone endpoints answer at locationiq.mygeocode.com. The Nominatim-style JSON array with display_name, address and boundingbox is returned unchanged in shape.
Change one hostname
| Original host |
|
|---|---|
| Use instead | locationiq.mygeocode.com |
| Key parameter | key (put your My Geocode key here, or leave it out for the free 2,500 a day) |
curl "https://us1.locationiq.com/v1/search?key=YOUR_LOCATIONIQ_KEY&q=Sydney+Opera+House&format=json"curl "https://locationiq.mygeocode.com/v1/search?key=YOUR_MYGEOCODE_KEY&q=Sydney+Opera+House&format=json"Why people move
Same interface, larger free allowance, and a flat Unlimited plan for busy applications.
Try it before you sign up for anything. Requests to locationiq.mygeocode.com count toward the same 2,500 a day you get on our own endpoints, with no key and no account. Above that, credits at $0.001 per request or €50 a month unlimited. Signing up takes an email address and nothing else.
Endpoints
| Path on locationiq.mygeocode.com | What it does | Backed by |
|---|---|---|
/v1/search?q=...&format=json | Forward geocoding | Forward geocoding |
/v1/reverse?lat=...&lon=...&format=json | Reverse geocoding | Reverse geocoding |
/v1/autocomplete?q=... | Autocomplete | Address autocomplete |
/v1/timezone?lat=...&lon=... | Timezone | Timezone lookup |
Example response
This is what the request above returns. Field names, nesting and types follow LocationIQ. Only the data behind them is ours.
[
{
"place_id": "mg.au.poi.3b7e91c0",
"licence": "Data by My Geocode, https://mygeocode.com/terms/",
"osm_type": "way",
"osm_id": 4245932,
"boundingbox": ["-33.8576", "-33.8560", "151.2141", "151.2166"],
"lat": "-33.8567844",
"lon": "151.2152967",
"display_name": "Sydney Opera House, Bennelong Point, Sydney, New South Wales, 2000, Australia",
"class": "tourism",
"type": "attraction",
"importance": 0.8543,
"icon": "https://mygeocode.com/assets/img/icons/tourism.png",
"address": {
"name": "Sydney Opera House",
"road": "Bennelong Point",
"suburb": "Sydney",
"city": "Sydney",
"state": "New South Wales",
"postcode": "2000",
"country": "Australia",
"country_code": "au"
}
}
]Details and differences
- Both the us1 and eu1 hostnames map to the same host here. Requests are served from the region closest to the caller.
- The countrycodes, viewbox, bounded, limit, normalizecity, addressdetails, dedupe and accept-language parameters are honoured.
- The Nearby, Directions and Matrix endpoints are not included.
If your client depends on a field or behaviour that is not listed here, tell us. Compatibility gaps get fixed quickly because they are usually small.