Geocode Address

GET {{baseUrl}}/geocode-address?address=<string>&house-number=<string>&street=<string>&city=<string>&county=<string>&state=<string>&postal-code=<string>&country-code=<string>&language-code=en&fuzzy-search=false

Geocode an address, partial address or just the name of a place

Request Params

KeyDatatypeRequiredDescription
addressstringThe full address, partial address or name of a place to try and locate. Comma separated address components are preferred.
house-numberstringThe house/building number to locate
streetstringThe street/road name to locate
citystringThe city/town name to locate
countystringThe county/region name to locate
statestringThe state name to locate
postal-codestringThe postal code to locate
country-codestringLimit result to this country (the default is no country bias)
language-codestringThe language to display results in, available languages are: <ul> <li>de, en, es, fr, it, pt, ru, zh</li> </ul>
fuzzy-searchbooleanIf no matches are found for the given address, start performing a recursive fuzzy search until a geolocation is found. This option is recommended for processing user input or implementing auto-complete. We use a combination of approximate string matching and data cleansing to find possible location matches

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;found&quot;:-92299707,&quot;locations&quot;:[{&quot;country&quot;:&quot;et Excepteur&quot;,&quot;address&quot;:&quot;do&quot;,&quot;city&quot;:&quot;ea in&quot;,&quot;country-code&quot;:&quot;Ut&quot;,&quot;country-code3&quot;:&quot;ea&quot;,&quot;latitude&quot;:-92471839.56415755,&quot;postal-code&quot;:&quot;deserunt con&quot;,&quot;longitude&quot;:25170689.81874457,&quot;state&quot;:&quot;ullamco sunt dolore&quot;,&quot;address-components&quot;:{&quot;nisi58&quot;:&quot;nulla aliqua occaecat m&quot;},&quot;currency-code&quot;:&quot;ut ad dolor consequat&quot;,&quot;location-type&quot;:&quot;laboris magna Lorem&quot;,&quot;location-tags&quot;:[&quot;ea qui&quot;,&quot;com&quot;],&quot;timezone&quot;:{&quot;elitc7&quot;:{&quot;id&quot;:&quot;amet dolor&quot;,&quot;name&quot;:&quot;laboris ali&quot;,&quot;abbr&quot;:&quot;laborum ut&quot;,&quot;date&quot;:&quot;est&quot;,&quot;time&quot;:&quot;irure velit d&quot;,&quot;offset&quot;:&quot;elit qui ullamco&quot;}}},{&quot;country&quot;:&quot;cillum Duis dolor proident&quot;,&quot;address&quot;:&quot;aute Ut sit veniam nostrud&quot;,&quot;city&quot;:&quot;ipsum dolor&quot;,&quot;country-code&quot;:&quot;nostrud aliquip do&quot;,&quot;country-code3&quot;:&quot;sint et nisi cupidatat ullamco&quot;,&quot;latitude&quot;:-73881543.52579229,&quot;postal-code&quot;:&quot;laboris enim incididunt a&quot;,&quot;longitude&quot;:-21820684.434724405,&quot;state&quot;:&quot;occaecat esse fugiat&quot;,&quot;address-components&quot;:{&quot;ad_ae&quot;:&quot;ut amet ex&quot;,&quot;suntf9&quot;:&quot;laborum ullamco in&quot;},&quot;currency-code&quot;:&quot;aliquip&quot;,&quot;location-type&quot;:&quot;minim ex non laboris&quot;,&quot;location-tags&quot;:[&quot;aliqua laborum&quot;,&quot;aute voluptate sunt&quot;],&quot;timezone&quot;:{&quot;irure12a&quot;:{&quot;id&quot;:&quot;minim magna elit dolor est&quot;,&quot;name&quot;:&quot;in ad&quot;,&quot;abbr&quot;:&quot;veniam in anim sit dolor&quot;,&quot;date&quot;:&quot;magna am&quot;,&quot;time&quot;:&quot;in aliqua aute&quot;,&quot;offset&quot;:&quot;culpa ipsum laboris in&quot;},&quot;ullamco1&quot;:{&quot;id&quot;:&quot;in commodo adipisicing laborum&quot;,&quot;name&quot;:&quot;cillum&quot;,&quot;abbr&quot;:&quot;non aliqua irure pariatur enim&quot;,&quot;date&quot;:&quot;amet anim&quot;,&quot;time&quot;:&quot;voluptate amet esse&quot;,&quot;offset&quot;:&quot;velit mollit&quot;}}}]}